[TOOL] Zandronum Easy Windows Compilation / Build Script

Looking for Resources for your mod/project? Want to share some of your creations so others can use them? Post them here!
Post Reply
Catastrophe
Retired Staff / Community Team Member
Posts: 2569
Joined: Sat Jun 02, 2012 2:44 am

[TOOL] Zandronum Easy Windows Compilation / Build Script

#1

Post by Catastrophe » Wed Jul 09, 2025 4:28 pm

Image

Fun fact: Windows has a 70% market share for Desktops, and yet developers on Windows are a rare breed on this port. I think this is mostly because of the torture session involved to get Zandronum running for developers. In the past it wasn't uncommon to see this trial dissuading people from making contributions towards the code. But instead of just kicking the can down the road, this project aims to fix it completely once and for all. How? Well I managed to condense the entire Windows onboarding process to just a single command. Yes, that's right. Just one.

In one fell swoop with this project, you can now...

1. Clone Zandronum
2. Download all necessary dependencies
3. Compile it
4. Create a build
5. And be code ready

What's more is that I went the extra mile and made it so that builds automatically have Freedoom packed with them so any programmer that wants to tinker with the engine can do so even without owning Doom or downloading Megaman. And also I wrote a a CI/CD pipeline so you can rest assured that the script still works on the latest Windows. And in case I disappear? It's open source so anyone can clone it, fork it, do whatever. As long as you give me credit somewhere, it's all good by me.

Anywho, I hope this can help others with onboard anxiety and get coding. There are still some wishlist items I need to get around to implementing, but if there's any suggestions or other processes that can be made easier let me know. I'll keep an eye out on this thread

Note: This was only tested on Windows 11. If you are on Windows 10 and are running into problems please post
Last edited by Catastrophe on Thu Aug 07, 2025 1:49 pm, edited 2 times in total.

User avatar
Fused
Contributor
Posts: 682
Joined: Sat Nov 09, 2013 9:47 am
Location: Netherlands
Contact:

Re: [TOOL] Zandronum Easy Compilation / Build Script for Windows

#2

Post by Fused » Wed Jul 09, 2025 8:51 pm

Thank you for this. I have been interested in doing some contributions of my own, but the task of compiling Zandronum have prevented me from actually undertaking this. I think this is going to prove incredibly useful.
My mods
Image Image

My socials
Image Image

Catastrophe
Retired Staff / Community Team Member
Posts: 2569
Joined: Sat Jun 02, 2012 2:44 am

Re: [TOOL] Zandronum Easy Windows Compilation / Build Script for Windows

#3

Post by Catastrophe » Thu Aug 07, 2025 1:47 pm

Update
Validated that the easy build script works with 3.2.1 here: https://github.com/rc4l/zandronum-windo ... 6805931331

If you're new you can just download the repo and run ./build.ps1 to get going on 3.2.1
If you have existing code from 3.2, you'll want to 'git pull origin main' to update the build script, and also run 'hg update ZA_3.2.1' inside src/zandronum separately and resolve any potential conflicts.

Happy coding.

Post Reply