->New guide available!<-== Atrinik-Development for Windows tutorial
Atrinik-Development is where the magic happens. In this tutorial you will get, build and run the development version of the Atrinik server and client. This tutorial does not discuss editing content with Gridarta (AtrinikEditor). If you want others to be able to connect to your server read how to Add your server to the public list.=0= Tutorial assumptions
Using a Windows 8.1 64-bit system and installing the free Code:Blocks IDE with MinGW compiler to build a 32-bit Atrinik server and client.
You will probably also be able to follow this tutorial on an updated XP, Vista or Windows 7/8/8.1 system that is either 32-bit or 64-bit.=1= Getting Source
To get started, download the latest GitHub for Windows
directly from windows.github.com
When you start the app, you'll be given the option to either log into your GitHub account, or create a new one.
Log in to your (new) GitHub account on https://github.com/atrinik/atrinik/
and click the button "Clone in Desktop" on the right. This will link to github-windows://openRepo/https://github.com/atrinik/atrinik
and open GitHub for Windows.
After cloning the repository it can be found in file:///%USERPROFILE%/Documents/GitHub/atrinik=2= Getting MIDI support for Atrinik Client
Download latest WinRAR
(Graphic and command line) (winrar-x64-501.exe
) from http://www.rarlab.com/download.htm
For MIDI support on Windows, you will need to download GUS patches from http://www.libsdl.org/projects/SDL_mixer/timidity/timidity.tar.gz
Double-click the downloaded file to open with WinRAR, click "Extract To" and enter the path atrinik/client
followed by clicking OK.
Now copy the file atrinik/client/make_win32/timidity.cfg
to the atrinik/client/
folder.=3= Building Atrinik Client for Windows using Code::Blocks with MinGW
Download latest Code::Blocks for Windows with MinGW
) from http://www.codeblocks.org/downloads/binaries
and do a "Full" install.
After install run Code::Blocks for the first time, set GNU GCC Compiler as default and click OK.
Next it will ask if you want to associate Code::Blocks with certain file extensions, this is up to you.
You may close the Scripting Console if in the way. Then go to the File menu and click Open...
From the Build menu pick "Rebuild workspace". Tick "Don't annoy me again!" and click Yes.
The Atrinik Client is now being compiled, this should take about half a minute or longer depending on your hardware.=4= Running compiled Atrinik Client
Now start Atrinik Client using atrinik/w32_start_client.bat
NOTE: If the client won't start, you probably need to remove (or back-up) your Atrinik Client settings in %AppData%\.atrinik
NOTE: You might not be able to connect to the official server.
NOTE: Windows Firewall and Virusscanners might ask to allow or scan Atrinik Client upon first run, accept this.=5= Building Atrinik Server for Windows using Code::Blocks with MinGW
Download latest Python 3.x.x Windows x86 MSI installer (python-3.3.3.msi
) from http://www.python.org/download/releases/
and install to %SystemDrive%\Python33\
(which is the default).
NOTE: Atrinik uses Python 32-bit version, not 64-bit!
NOTE: If you want to install Python somewhere else you need to change the paths in atrinik/server/make_win32/CodeBlocks/plugin_python.cbp
Start Code::Blocks if you haven't already done so and open atrinik/server/make_win32/CodeBlocks/atrinik.workspace
From the Build menu pick "Rebuild workspace". This should take about a minute or longer depending on your hardware.=6= Collecting arches
Go to atrinik/tools
and double-click collect.py
Wait for the console window to close and you're done.=7= Running compiled Atrinik Server
NOTE: Collecting arches is necessary before running the server the first time and when arches have been modified.
Now start Atrinik Server using atrinik/w32_start_server.bat
NOTE: Windows Firewall and Virusscanners might ask to allow or scan Atrinik Server upon first run, accept this.=8= Connecting to your server
Assuming you have started Atrinik Server and Client, connect to "Localhost" in the server list.
Have fun doing tests, tweaking and hacking the source code, or just exploring the new content and (ab)using [OP] powers!
Feel free to ask questions. Comments on this tutorial are also appreciated.