WurstScript is a programming language and modding toolkit working in unison to create awesome Warcraft 3 maps. In this guide we will show you how to install WurstScript and set up your first project.
WurstScript and its related tools require Java 11+ to run. Editor support is provided via a VSCode extension.
Download the Java Runtime appropriate for your system and follow the installation procedure.
Now we will setup a Wurst compiler environment and create a project using the the WurstSetup, also known as
Download WurstSetup and perform installation by running
java -jar WurstSetup.jar install wurstscript or double-clicking to start the graphical user interface.
Now you need to add the
~/.wurst folder to your PATH environment variable, so that
grill is recognized from the commandline. Refer to this tutorial.
grill from the commandline you can now start with generating a new project or installing an existing project. The user experience is similar to tools such as
Use the special
wurstscript keyword to install or update wurst on your system for the current user.
grill install wurstscript
generate to create new projects. The project will be generated in a folder inside your current location with the name provided.
grill generate my-wurst-project
After you finished installation and project setup, you can open the project’s root folder in VSCode.
Make sure you are opening the project’s root folder (contains wurst.build file) using
File -> Open Folder
Once the project is opened, you can click the
Hello.wurst file on the left to activate the Wurst plugin. The code should compile and the setup should be done. Using VSCode’s command console (
F1) you can execute wurst commands such as running or building your map.
If you are new to WurstScript but not new to programming, you probably want to continue with the Beginner’s Guide
install command to update your project’s dependencies, or to initially setup a fresly cloned project to work on your machine.
To add a new dependency, run the
install command with a second parameter that points to a git repo.
grill install https://github.com/Frotty/wurst-astar-jps
By running the
WurstSetup.jar without any arguments or simply by double-clicking, you can alternatively use the deprecated, graphical user interface.