Server Manual
(Marked this version for translation) |
|||
| Line 1: | Line 1: | ||
__TOC__ | __TOC__ | ||
<translate> | <translate> | ||
| − | == Installing the server == | + | == Installing the server == <!--T:1--> |
| + | <!--T:2--> | ||
Download the corrent server package for your operating system from [http://liberty-unleashed.co.uk/downloads.html http://liberty-unleashed.co.uk/downloads.html]. This package includes the server binary, default Squirrel modules as well as basic configuration files and scripts. 3rd party modules and scripts can be downloaded from the [http://forum.liberty-unleashed.co.uk/index.php#6 scripting boards]. Copyrighted files such as GTA data files are not included with the server. | Download the corrent server package for your operating system from [http://liberty-unleashed.co.uk/downloads.html http://liberty-unleashed.co.uk/downloads.html]. This package includes the server binary, default Squirrel modules as well as basic configuration files and scripts. 3rd party modules and scripts can be downloaded from the [http://forum.liberty-unleashed.co.uk/index.php#6 scripting boards]. Copyrighted files such as GTA data files are not included with the server. | ||
| + | <!--T:3--> | ||
* '''Windows server:''' Make sure that you have ''Updater.exe'' in your server root directory if you wish to use automatic updates. | * '''Windows server:''' Make sure that you have ''Updater.exe'' in your server root directory if you wish to use automatic updates. | ||
* '''Linux server:''' Make sure that the server binary is executable (''chmod u+x Server.bin''). | * '''Linux server:''' Make sure that the server binary is executable (''chmod u+x Server.bin''). | ||
| − | == Configuring the server == | + | == Configuring the server == <!--T:4--> |
| + | <!--T:5--> | ||
A default file structure for a Liberty Unleashed server would look like this: | A default file structure for a Liberty Unleashed server would look like this: | ||
| + | <!--T:6--> | ||
* server.conf | * server.conf | ||
* Logs/ | * Logs/ | ||
| Line 26: | Line 30: | ||
* Scripts/ | * Scripts/ | ||
| + | <!--T:7--> | ||
''server.conf'' controls the core settings for your server. ''LU/'' is the main content folder for Liberty Unleashed (the same way ''VU/'' is for Vice Unleashed), and ''content.xml'' controls the game-specific contents for your server. These are the main config files of your server. | ''server.conf'' controls the core settings for your server. ''LU/'' is the main content folder for Liberty Unleashed (the same way ''VU/'' is for Vice Unleashed), and ''content.xml'' controls the game-specific contents for your server. These are the main config files of your server. | ||
| − | === server.conf === | + | === server.conf === <!--T:8--> |
| + | <!--T:9--> | ||
'''''server.conf''''' controls the game-independent configuration options of your server. These include for example the name of your server, the game your server is running, and many network related settings. A more detailed description of the file is available [[server.conf|here]]. | '''''server.conf''''' controls the game-independent configuration options of your server. These include for example the name of your server, the game your server is running, and many network related settings. A more detailed description of the file is available [[server.conf|here]]. | ||
| − | === content.xml === | + | === content.xml === <!--T:10--> |
| + | <!--T:11--> | ||
'''''content.xml''''' contains the main game-dependent content (such as vehicles, pickups, scripts). More detailed info about the file and modifying it, click [[content.xml|here]]. | '''''content.xml''''' contains the main game-dependent content (such as vehicles, pickups, scripts). More detailed info about the file and modifying it, click [[content.xml|here]]. | ||
| − | === Unleashed Anticheat === | + | === Unleashed Anticheat === <!--T:12--> |
| + | <!--T:13--> | ||
Unleashed Anticheat allows you to add custom file checks for any client-side game data files. These filechecks are controlled by '''''Anticheat.uac''''', which is located in server content folder (''LU/'' for Liberty Unleashed or ''VU/'' for Vice Unleashed). ''Anticheat.uac'' is a list of files located within ''data/'' folder, separated by line breaks. If UAC has been enabled, it will read the file list from ''Anticheat.uac'' and calculate checksums for the specified files. These checksums are then compared to the ones of every incoming client. This feature allows server owners to run servers for GTAIII / VC mods and total conversions without a fear that any of the clients who connect the server might not be using correct files for the mod. | Unleashed Anticheat allows you to add custom file checks for any client-side game data files. These filechecks are controlled by '''''Anticheat.uac''''', which is located in server content folder (''LU/'' for Liberty Unleashed or ''VU/'' for Vice Unleashed). ''Anticheat.uac'' is a list of files located within ''data/'' folder, separated by line breaks. If UAC has been enabled, it will read the file list from ''Anticheat.uac'' and calculate checksums for the specified files. These checksums are then compared to the ones of every incoming client. This feature allows server owners to run servers for GTAIII / VC mods and total conversions without a fear that any of the clients who connect the server might not be using correct files for the mod. | ||
| − | === GTA data files === | + | === GTA data files === <!--T:14--> |
| + | <!--T:15--> | ||
It is possible to sync some of the core GTA data files (located in ''data/'') for all clients. These files are automatically loaded and shared to all clients when they are placed in ''LU/data'' folder (or ''VU/data'' for Vice Unleashed): | It is possible to sync some of the core GTA data files (located in ''data/'') for all clients. These files are automatically loaded and shared to all clients when they are placed in ''LU/data'' folder (or ''VU/data'' for Vice Unleashed): | ||
| + | <!--T:16--> | ||
* [[carcols.dat|'''carcols.dat''']] - Defines the default colours used by GTA when spawning vehicles and sets allowed random colour IDs for every vehicle model. | * [[carcols.dat|'''carcols.dat''']] - Defines the default colours used by GTA when spawning vehicles and sets allowed random colour IDs for every vehicle model. | ||
* [[handling.cfg|'''handling.cfg''']] - Vehicle handling settings. Controls many performance and behaviour values for each vehicle model. | * [[handling.cfg|'''handling.cfg''']] - Vehicle handling settings. Controls many performance and behaviour values for each vehicle model. | ||
| Line 49: | Line 59: | ||
* [[weapon.dat|'''weapon.dat''']] - Settings for weapons. Defines weapon properties like caused damage, fire rate etc. | * [[weapon.dat|'''weapon.dat''']] - Settings for weapons. Defines weapon properties like caused damage, fire rate etc. | ||
| + | <!--T:17--> | ||
For more information about each file and the values they control, click on the file name. Most data within these files can also be changed run-time via scripts. | For more information about each file and the values they control, click on the file name. Most data within these files can also be changed run-time via scripts. | ||
| − | == Squirrel scripts == | + | == Squirrel scripts == <!--T:18--> |
| − | === Squirrel modules === | + | === Squirrel modules === <!--T:19--> |
| + | <!--T:20--> | ||
You can extend the server-side scripting using official or 3rd party [[Modules|Squirrel modules]]. These modules should be located within the ''Modules/'' folder. There they can be loaded by individual scripts using the built-in function [[Squirrel/Server/Functions/Scripts/LoadModule|LoadModule]]. | You can extend the server-side scripting using official or 3rd party [[Modules|Squirrel modules]]. These modules should be located within the ''Modules/'' folder. There they can be loaded by individual scripts using the built-in function [[Squirrel/Server/Functions/Scripts/LoadModule|LoadModule]]. | ||
| − | === Custom files === | + | === Custom files === <!--T:21--> |
| + | <!--T:22--> | ||
A set of custom sounds and images can be loaded on server start for scripts to use. These files will be downloaded by the client upon connect. Custom files, such as modules, are controlled by scripts. | A set of custom sounds and images can be loaded on server start for scripts to use. These files will be downloaded by the client upon connect. Custom files, such as modules, are controlled by scripts. | ||
| − | == Running the server == | + | == Running the server == <!--T:23--> |
| − | === Windows === | + | === Windows === <!--T:24--> |
| + | <!--T:25--> | ||
After you have configured the server and uploaded scripts and files, as well as made sure Updater.exe exists in the server root directory, just run Server.exe. | After you have configured the server and uploaded scripts and files, as well as made sure Updater.exe exists in the server root directory, just run Server.exe. | ||
| − | === Linux === | + | === Linux === <!--T:26--> |
| + | <!--T:27--> | ||
After you have configured the server and uploaded scripts and files, as well as made sure the server has correct permissions, just execute Server.bin: ''./Server.bin''<br> | After you have configured the server and uploaded scripts and files, as well as made sure the server has correct permissions, just execute Server.bin: ''./Server.bin''<br> | ||
'''NOTES:''' If you are connected to server via SSH, use [http://www.gnu.org/software/screen/ GNU Screen] for run server in the background. | '''NOTES:''' If you are connected to server via SSH, use [http://www.gnu.org/software/screen/ GNU Screen] for run server in the background. | ||
| − | === Command line arguments === | + | === Command line arguments === <!--T:28--> |
| + | <!--T:29--> | ||
When launching the server it is possible to pass some optional launch arguments: | When launching the server it is possible to pass some optional launch arguments: | ||
| + | <!--T:30--> | ||
* '''-noinput''' - Does not print messages to the server console. | * '''-noinput''' - Does not print messages to the server console. | ||
* '''-maxplayers''' ''<players>'' - Forces the max player count. When used the max player count can't be set over this value using the config file or scripting functions. | * '''-maxplayers''' ''<players>'' - Forces the max player count. When used the max player count can't be set over this value using the config file or scripting functions. | ||
* If there are other arguments than the ones mentioned above, the first one will be the server config file. This allows you to run multiple servers with different configs using the same binary and script files. | * If there are other arguments than the ones mentioned above, the first one will be the server config file. This allows you to run multiple servers with different configs using the same binary and script files. | ||
| − | === Server commands === | + | === Server commands === <!--T:31--> |
| + | <!--T:32--> | ||
You can control your server by typing commands to the server console while it's running. Everything listed in [[server.conf|''server.conf'']] is a valid console command. In addition, a few extra commands can be used: | You can control your server by typing commands to the server console while it's running. Everything listed in [[server.conf|''server.conf'']] is a valid console command. In addition, a few extra commands can be used: | ||
| + | <!--T:33--> | ||
* '''say''' ''<message>'' - Sends an admin message in-game. | * '''say''' ''<message>'' - Sends an admin message in-game. | ||
* '''quit''' - Shuts down the server. | * '''quit''' - Shuts down the server. | ||
Revision as of 16:20, 26 July 2012
Contents |
Installing the server
Download the corrent server package for your operating system from http://liberty-unleashed.co.uk/downloads.html. This package includes the server binary, default Squirrel modules as well as basic configuration files and scripts. 3rd party modules and scripts can be downloaded from the scripting boards. Copyrighted files such as GTA data files are not included with the server.
- Windows server: Make sure that you have Updater.exe in your server root directory if you wish to use automatic updates.
- Linux server: Make sure that the server binary is executable (chmod u+x Server.bin).
Configuring the server
A default file structure for a Liberty Unleashed server would look like this:
- server.conf
- Logs/
- LU/
- LU/Anticheat.uac
- LU/content.xml
- LU/data/
- LU/data/carcols.dat
- LU/data/handling.cfg
- LU/data/surface.dat
- LU/data/weapon.dat
- Modules/
- Sounds/
- Scripts/
server.conf controls the core settings for your server. LU/ is the main content folder for Liberty Unleashed (the same way VU/ is for Vice Unleashed), and content.xml controls the game-specific contents for your server. These are the main config files of your server.
server.conf
server.conf controls the game-independent configuration options of your server. These include for example the name of your server, the game your server is running, and many network related settings. A more detailed description of the file is available here.
content.xml
content.xml contains the main game-dependent content (such as vehicles, pickups, scripts). More detailed info about the file and modifying it, click here.
Unleashed Anticheat
Unleashed Anticheat allows you to add custom file checks for any client-side game data files. These filechecks are controlled by Anticheat.uac, which is located in server content folder (LU/ for Liberty Unleashed or VU/ for Vice Unleashed). Anticheat.uac is a list of files located within data/ folder, separated by line breaks. If UAC has been enabled, it will read the file list from Anticheat.uac and calculate checksums for the specified files. These checksums are then compared to the ones of every incoming client. This feature allows server owners to run servers for GTAIII / VC mods and total conversions without a fear that any of the clients who connect the server might not be using correct files for the mod.
GTA data files
It is possible to sync some of the core GTA data files (located in data/) for all clients. These files are automatically loaded and shared to all clients when they are placed in LU/data folder (or VU/data for Vice Unleashed):
- carcols.dat - Defines the default colours used by GTA when spawning vehicles and sets allowed random colour IDs for every vehicle model.
- handling.cfg - Vehicle handling settings. Controls many performance and behaviour values for each vehicle model.
- surface.dat - Controls traction values for different surface types.
- weapon.dat - Settings for weapons. Defines weapon properties like caused damage, fire rate etc.
For more information about each file and the values they control, click on the file name. Most data within these files can also be changed run-time via scripts.
Squirrel scripts
Squirrel modules
You can extend the server-side scripting using official or 3rd party Squirrel modules. These modules should be located within the Modules/ folder. There they can be loaded by individual scripts using the built-in function LoadModule.
Custom files
A set of custom sounds and images can be loaded on server start for scripts to use. These files will be downloaded by the client upon connect. Custom files, such as modules, are controlled by scripts.
Running the server
Windows
After you have configured the server and uploaded scripts and files, as well as made sure Updater.exe exists in the server root directory, just run Server.exe.
Linux
After you have configured the server and uploaded scripts and files, as well as made sure the server has correct permissions, just execute Server.bin: ./Server.bin
NOTES: If you are connected to server via SSH, use GNU Screen for run server in the background.
Command line arguments
When launching the server it is possible to pass some optional launch arguments:
- -noinput - Does not print messages to the server console.
- -maxplayers <players> - Forces the max player count. When used the max player count can't be set over this value using the config file or scripting functions.
- If there are other arguments than the ones mentioned above, the first one will be the server config file. This allows you to run multiple servers with different configs using the same binary and script files.
Server commands
You can control your server by typing commands to the server console while it's running. Everything listed in server.conf is a valid console command. In addition, a few extra commands can be used:
- say <message> - Sends an admin message in-game.
- quit - Shuts down the server.
- load_script <script folder> - Loads a script folder located in Scripts/.
- unload_script <script folder> - Unloads a script folder located in Scripts/.
- reload_scripts - Reloads all scripts loaded from content.xml.
- reload_content - Reloads content.xml.
- checkupdates - Checks if there are any updates for the server.
