ZScript Documentation (2021 Redux!)
Moderator: GZDoom Developers
Forum rules
Before asking on how to use a ZDoom feature, read the ZDoom wiki first. If you still don't understand how to use a feature, then ask here.
Please bear in mind that the people helping you do not automatically know how much you know. You may be asked to upload your project file to look at. Don't be afraid to ask questions about what things mean, but also please be patient with the people trying to help you. (And helpers, please be patient with the person you're trying to help!)
Before asking on how to use a ZDoom feature, read the ZDoom wiki first. If you still don't understand how to use a feature, then ask here.
Please bear in mind that the people helping you do not automatically know how much you know. You may be asked to upload your project file to look at. Don't be afraid to ask questions about what things mean, but also please be patient with the people trying to help you. (And helpers, please be patient with the person you're trying to help!)
-
-
- Posts: 1198
- Joined: Tue Feb 26, 2013 2:48 pm
- Preferred Pronouns: No Preference
- Operating System Version (Optional): Arch Linux
- Graphics Processor: ATI/AMD with Vulkan/Metal Support
ZScript Documentation (2021 Redux!)
Rendered HTML: Stable (currently unavailable) / Staging
Git Repositories: Stable (currently unavailable) / Staging
Contributions welcome! Pull requests are appreciated. If you want organization access, ask me in PMs here. If you want help contributing, you can reach me on Discord (@Marrub#5455) or on my Discord server in the channel #eldritch-rust.
Git Repositories: Stable (currently unavailable) / Staging
Contributions welcome! Pull requests are appreciated. If you want organization access, ask me in PMs here. If you want help contributing, you can reach me on Discord (@Marrub#5455) or on my Discord server in the channel #eldritch-rust.
Last edited by Marrub on Mon May 10, 2021 2:14 pm, edited 6 times in total.
-
- Posts: 111
- Joined: Wed Jun 15, 2016 2:49 pm
Re: ZScript Language Documentation (WIP)
This should get pinned, it's great! Is this information going to eventually be migrated to the wiki?
-
- Posts: 131
- Joined: Wed Nov 30, 2016 12:51 am
- Graphics Processor: nVidia with Vulkan support
Re: ZScript Language Documentation (WIP)
@Marrub I honestly cannot thank you enough for this!
I believe that the documentation on ZScript, over a year later, is frankly insufficient, and that this kind of documentation is what we really need so that people can document it on the wiki for everybody else.
I have a couple friends who'd love to start using ZScript, but then I end up feeling a sense of guilt when telling them to start using ZScript instead of DECORATE, because I know they are nowhere near capable enough of using it. And without ample, adequate documentation in the wiki, it becomes tacky and rough swiftly for them. The best they can do is convert DECORATE to ZScript, but then they get lost from there when they are interested in making their own functions and doing some of the intermediate things.
So seriously, please keep doing what you're doing! <3
I believe that the documentation on ZScript, over a year later, is frankly insufficient, and that this kind of documentation is what we really need so that people can document it on the wiki for everybody else.
I have a couple friends who'd love to start using ZScript, but then I end up feeling a sense of guilt when telling them to start using ZScript instead of DECORATE, because I know they are nowhere near capable enough of using it. And without ample, adequate documentation in the wiki, it becomes tacky and rough swiftly for them. The best they can do is convert DECORATE to ZScript, but then they get lost from there when they are interested in making their own functions and doing some of the intermediate things.
So seriously, please keep doing what you're doing! <3
I wholeheartedly agree that this is great information, and that it may be migrated to the wiki, but I'm sure that Marrub doesn't wanna plot this all into the wiki for the same reason that Major Cooke didn't wanna contribute very much before (i.e. making mistakes or accidentally giving out erroneous information).ZippeyKeys12 wrote:This should get pinned, it's great! Is this information going to eventually be migrated to the wiki?
-
- Posts: 7402
- Joined: Fri Oct 22, 2004 9:22 am
- Graphics Processor: nVidia with Vulkan support
- Location: MAP33
Re: ZScript Language Documentation (WIP)
ZippeyKeys12 wrote:This should get pinned, it's great! Is this information going to eventually be migrated to the wiki?
Reading is FUNdamental!nazakomu wrote:I wholeheartedly agree that this is great information, and that it may be migrated to the wiki, but I'm sure that Marrub doesn't wanna plot this all into the wiki for the same reason that Major Cooke didn't wanna contribute very much before (i.e. making mistakes or accidentally giving out erroneous information).
Marrub wrote:This isn't on the wiki because I really don't like writing wikitext and because it isn't finished yet.
-
-
- Posts: 1198
- Joined: Tue Feb 26, 2013 2:48 pm
- Preferred Pronouns: No Preference
- Operating System Version (Optional): Arch Linux
- Graphics Processor: ATI/AMD with Vulkan/Metal Support
Re: ZScript Language Documentation (WIP)
Yeah, when it's done I'll migrate it to the wiki. Anyone is free to use this information to further the wiki of course, but again, it's not finished, so a lot of it either needs verification, rewording, or generally improvement before it's suitable for that.
-
-
- Posts: 4724
- Joined: Mon Apr 10, 2006 1:49 pm
- Preferred Pronouns: He/Him
Re: ZScript Language Documentation (WIP)
I need to read this cover to cover because so much of Programming Languages 101 (that isn't ACS) still eludes me.
Top stuff, Marrub.
Top stuff, Marrub.
-
- Lead GZDoom+Raze Developer
- Posts: 49177
- Joined: Sat Jul 19, 2003 10:19 am
- Location: Germany
Re: ZScript Language Documentation (WIP)
Thanks for taking the effort. I've been hoping for all that time that someone would take on the task. I am simply a shitty docs writer, like probably most programmers so I'd never be able to write comprehensive docs myself.
-
- Admin
- Posts: 6190
- Joined: Thu Feb 26, 2004 3:02 pm
- Preferred Pronouns: He/Him
Re: ZScript Language Documentation (WIP)
Would it be okay if I added a link to this on the wiki at least? That way it's not lost in the forums or Discord chat in the meantime.
Meh, added at the bottom of the page. Better to beg forgiveness than ask permission, yada yada.
Meh, added at the bottom of the page. Better to beg forgiveness than ask permission, yada yada.
-
- Posts: 9696
- Joined: Sun Jan 04, 2004 5:37 pm
- Preferred Pronouns: They/Them
- Operating System Version (Optional): Debian Bullseye
- Location: Gotham City SAR, Wyld-Lands of the Lotus People, Dominionist PetroConfederacy of Saudi Canadia
Re: ZScript Language Documentation (WIP)
Dang, this is good.
-
- Posts: 360
- Joined: Mon May 08, 2017 3:23 am
- Graphics Processor: Intel with Vulkan/Metal Support
- Location: The Netherlands
Re: ZScript Language Documentation (WIP)
This is really appreciated. Not easy at all to write good documentation.
-
-
- Posts: 523
- Joined: Mon Apr 09, 2012 12:27 pm
Re: ZScript Language Documentation (WIP)
This is incredibly valuable, thank so much for putting in the time and effort for this.
-
- Posts: 38
- Joined: Thu Mar 08, 2018 3:40 am
Re: ZScript Language Documentation (WIP)
Thanks for sharing this! It's an awesome resource.
-
- Posts: 412
- Joined: Fri Nov 25, 2016 7:17 am
- Location: some northern german shithole
Re: ZScript Language Documentation (WIP)
Looks way more useful then the zdoom wiki
-
- Posts: 8196
- Joined: Sun Jan 28, 2007 3:55 pm
- Preferred Pronouns: He/Him
- Location: QZDoom Maintenance Team
Re: ZScript Language Documentation (WIP)
I know what you mean.Graf Zahl wrote:Thanks for taking the effort. I've been hoping for all that time that someone would take on the task. I am simply a shitty docs writer, like probably most programmers so I'd never be able to write comprehensive docs myself.
Though in my case, things were confusing when it came to such parts like the menus and due to my lack of understanding on how certain things function, I didn't want to repeat what happened with the acceptable sound formats when (G)Zdoom still had FMOD and give people the wrong idea.
Big thanks, Marrub!
-
- Posts: 8196
- Joined: Sun Jan 28, 2007 3:55 pm
- Preferred Pronouns: He/Him
- Location: QZDoom Maintenance Team
Re: ZScript Language Documentation (WIP)
Quick note about properties, you can only use int, double, bool, class<name>, strings and names. I haven't had any luck using vectors.