Here is a comprehensive guide on how to install SPWN for Geometry Dash.
SPWN is a specialized programming language that simplifies the creation of complex levels by compiling code into in-game objects and triggers, which is ideal for advanced level designers.
***Disclaimer:*The installation instructions provided below are based on the latest releases available at the time of writing. The process may change with new versions. Always check the official SPWN GitHub repository for the most up-to-date information.
Part 1: Download and install SPWN
The installation process varies by operating system.
For Windows users
- Go to the SPWN releases page. Navigate to the official SPWN-language repository on GitHub and click the "releases" tab or visit the official SPWN documentation for the download link.
- Download the installer. Look for the latest release and download the
.msifile, which is the Windows installer package. - Run the installer. Open the downloaded
.msifile.- Bypass SmartScreen (if needed): If Windows' SmartScreen filter flags the file, click "More info," then "Run anyway".
- Follow the wizard: Complete the installation by following the on-screen instructions.
For macOS users
- Go to the SPWN releases page. Find the latest release on the official SPWN GitHub repository.
- Download the installer. Download the
.pkginstaller file for macOS. - Run the installer. Open the downloaded
.pkgfile.- Bypass unidentified developer warning: If you receive a warning that you cannot open files from unidentified developers, follow these steps:
- Open System Settings (or System Preferences).
- Navigate to Security & Privacy.
- Click "Open Anyway" on the "General" menu.
- Complete the wizard: Follow the install wizard to finish the installation.
- Bypass unidentified developer warning: If you receive a warning that you cannot open files from unidentified developers, follow these steps:
For Linux users
There are multiple methods for installing SPWN on Linux, depending on your distribution.
Generic Installation (for any distro):
- Download the compressed file. Get the
spwn-x.x.x-x86_64.tar.gzfile from the latest release on GitHub. - Extract the archive. Open a terminal and use the command
tar -xvf spwn-x.x.x-x86_64.tar.gz. - Add SPWN to your path (optional but recommended): This allows you to run the
spwncommand from any directory. Open your.bashrcor.zshrcfile and addexport PATH=$PATH:/path/to/extracted/spwn.
Debian-based (e.g., Ubuntu, Mint):
- Download the Debian package. Download the
.debfile from the GitHub releases page. - Install with
dpkg. Open a terminal in the same directory as the downloaded file. Runsudo dpkg -i spwn_x.x.x-x_amd64.deb.
Arch-based (e.g., Manjaro, Artix):
- Download the Arch package. From the GitHub releases page, download the
.pkg.tar.zstfile. - Install with
pacman. Runpacman -U spwn-x.x.x_amd64.pkg.tar.zstin the terminal. - Use an AUR helper (alternative): If an AUR helper like
yayis available, runyay -S spwn-bin.
Part 2: Set up your code editor
Using an editor with dedicated language support is highly recommended, although SPWN code can be written in any text editor. Visual Studio Code (VSCode) is a popular choice with excellent support.
For Visual Studio Code (VSCode)
- Install the SPWN extension:
- Open VSCode.
- Go to the Extensions view by clicking the square icon on the sidebar or pressing
Ctrl+Shift+X. - Search for "SPWN" and click "Install" on the extension by Spu7Nix.
- Verify the extension: Create a new file, save it with the
.spwnextension, and check the bottom right of the VSCode window. The language mode should automatically change to SPWN. If it doesn't, click the language mode indicator and select SPWN from the list.
For Sublime Text
- Install Package Control: Open the command palette (
Ctrl+Shift+P), type "Install Package Control," and press Enter. - Install SPWN Language: Open the command palette again, type "install," select "Package Control: Install Package," and then search for and install "SPWN Language".
Part 3: Compile your first SPWN script
This step connects the code to Geometry Dash by compiling the SPWN script into objects that can be added to a level.
- Create a new level in Geometry Dash. Open the game and create a new, empty level. The code will be placed in this level.
- Write your SPWN script. In your code editor, create a new file (e.g.,
test.spwn) and write a simple script. An example from the documentation:``` test = 5g -> test.move(5, 100, 0.25) test.move(10, -10, 2)This script creates an object and then applies move triggers to it. - Save the file. Ensure the
.spwnfile is saved in a location accessible from the command line terminal. - Open your terminal.
- Windows: Use the Command Prompt or PowerShell.
- macOS/Linux: Use the Terminal application.
- Navigate to your script's directory. Use the
cdcommand to change directories. For example:cd C:\Users\YourName\Documents\SPWN_Levels - Run the
spwn buildcommand. Execute the command, replacingtest.spwnwith your filename:``` spwn build test.spwn - Open Geometry Dash. After the command finishes, launch Geometry Dash (it must be closed during the build process). Open the level created. You will see the objects and triggers generated by your SPWN code.
The official SPWN documentation offers more advanced features.