This server is a tool for Illarion script and map development. It allows you to test your scripts and maps locally before uploading them to the Illarion server. It can also be used for website development as well as for client development.
To use the local server you need
- to download and install Docker. Carefully follow the installation instructions for your OS.
- a local copy of this repository. You can find the official repository on GitHub.
You need both the script and the maps repository. Without both you cannot use the server. For website development you will also need the website repository.
- Copy the file
.env.distand name that copy.env. - Using a text editor, fill in local repository paths in
.env. You need to use absolute paths. - For unused repositories, paths can be left blank.
If you were asked to test a specific new feature, you have been given URLs to snapshots of both the scripts (Illarion-Content) and maps (Illarion-Maps) repositories on GitHub. These will look like this:
- Scripts: https://github.com/some-user-name/Illarion-Content/tree/some-feature-name
- Maps: https://github.com/some-user-name/Illarion-Map/tree/some-feature-name
- For each, click the green button labeled "Code" and select "Download ZIP".
- Unzip each to a convenient location.
- Enter the paths to these locations into your
.envfile.
Some tests also require changes to the database. In that case, you will have received a set of SQL commands.
You are now ready for testing.
While you can clone the official GitHub repositories to your disk directly, it is highly recommended that you fork them on GitHub first and clone from your own fork. This way you can push changes to your GitHub repository and then issue a pull request against the official repository to have your changes included.
- Scripts: https://github.com/Illarion-eV/Illarion-Content
- Maps: https://github.com/Illarion-eV/Illarion-Map
- Website: https://github.com/Illarion-eV/Illarion-Website
- Scripts: ssh://git@illarion.org:1010/scripts
- Maps: ssh://git@illarion.org:1010/maps
- Website: ssh://git@illarion.org:1010/website
- To start the game server, open a console and run
starton Linux orstart.baton Windows. - Press ctrl+c in that console to stop the server.
- To additionally run the webserver, run
start-with-webserverinstead. - You can reload maps while the server is running by executing
reload-maps.
Fire up the Illarion loader as usual.
You want to use the development client, so in your Illarion loader you need to adjust the update channel under "Options" accordingly.
After launching the client, select the local server. Now you can login with the default character:
- Name: Testserver One
- Password: test
The character "Testserver Two" is also provided, if you need to test with multiple characters. Of course you can also add new characters to the database.
Follow these steps every time you get new URLs or SQL statements for testing:
- While the server is not running, run
reset-databaseto get a clean database. - Start the server by running
start. - Reload your maps by running
reload-maps. - If you have received SQL commands:
- connect to the database.
- In the left column select
Local Illarion>illarion>illarionserver. - Click
SQLin the very top right, paste your commands in the large text box and execute them.
- Connect to the game.
- Run !fr inside the game to reload the database.
- Conduct your tests.
- Give a test report in the pull request you got the URLs from.
Reloading scripts on the local server works as it does on the official server. You need to use the reload command (!fr) in-game for the server to load all scripts.
This server reads scripts directly from your working copy of the scripts repository. This means you do not need to commit them for testing. You can commit whenever a logical step has been completed.
You need to commit and push your changes in order to allow others to see and test them. If you are unfamiliar with Git, you could take a look at the Pro Git book or other tutorials, depending on your preference.
Each feature you are working on should have its own dedicated branch.
- You can create a branch for working on magic with
git branch feature/magic. - Switching to that branch is done by
git checkout feature/magic. - You can even push your branches to your github account to share your work with others for collaboration and testing.
- To merge your work on magic into develop, simply checkout develop and then run
git merge feature/magic.
While the server is running, access the database within your browser: http://localhost:8080/
Login information:
- User: illarion
- Password: illarion
If you prefer other tools like pgAdmin or psql you will need additional connection details:
- Hostname: localhost
- Port: 15432
You should keep your local copy of this repository up-to-date.
The database is initially created as a copy of the official development server database excluding
character data. You may update the database at any time to incorporate
changes made to the online database. However, be aware that
this will overwrite any changes you made to the local database.
To update the database run reset-database while the server is down.
You can also use the local server for website development. For that you need to set up the website folder as described in step 2 prior to starting the server. Also you need to make your system believe that your server is actually illarion.org by editing your hosts config file.
Open the file with admin privileges and add a line at the end:
127.0.0.1 illarion.org
When the server is running you can now access your local copy of the website at https://illarion.org
Website Login:
- User: test
- Password: test