Server configuration

AUTHOR DISCLAIMER: This article is "Work in progress"!! some items are not verified..
DATE: 7 Feb 2009
AUTHOR: Zapper

Required knowledge

The content of this article acquire common knowledge on how to alter the registry and running services on a server platform.

Required software

Alleg server version R4
TAG2014
Artwork

The folder hierarchy

• Server

This folder contain the server app and files assoiated with the server app

• • Artwork

This folder contain artwork and configuration files

• • TAG

This folder contain TAG service and files associated to TAG

Default registry settings

The settings listed are values which can be modified by the admin and are either mandatory or optional.

Server configuration files

These files are not included in the current installation package.
The list contain files that are to be made after or prior the installation, they contain values which is loaded by the server app.
Files located in the main server folder

• allegianceserver.cfg

Files located in the artwork folder

• ranks.txt
• cores.txt
• maps.txt

Autonomy and syntax of the server configuration files

Basic Syntax of the configuration files

WARNING: The example are not a valid config file, it contain comments that will cause a crash in the alleg server application!!

ranks.txt

31  <--- this number represent the total number of level/ranks in the file
0,Newbie <--- the FIRST level/rank. The number 0 is the level, the Newbie is the name of the level
1,Novice 1
2,Novice 2
3,Novice 3
4,Novice 4
5,Novice 5
6,Novice 6
7,Novice 7
8,Inter. 1
9,Inter. 2
10,Inter. 3
11,Inter. 4
12,Inter. 5
13,Inter. 6
14,Inter. 7
15,Veteran 1
16,Veteran 2
17,Veteran 3
18,Veteran 4
19,Veteran 5
20,Veteran 6
21,Veteran 7
22,Expert 1
23,Expert 2
24,Expert 3
25,Expert 4
26,Expert 5
27,Expert 6
28,Expert 7
29,Expert 8
30,Expert 9
31,Expert 9

cores.txt

7 <--- this number represent the total number of cores in the file. If the number dont 
       add up with the number of cores in the file it will cause a server crash!!
cc_03 <--- this is name of the core WITHOUT the .igc extension, the name is case sensitive!!
GoDII_05
plus15b7
RTc006a
rps55
PC2_019
sw_a102

maps.txt

1  <--- the number represent the number or maps in the file, if the number dont 
        add up with number of maps in the file it will cause a server crash.
2,Limited,m2xiblimited  <--- Size,Display name,Mapfile name.

Maplist explained:

The map list line	Map size	Map Displayname	The mapfile name without the .igc extension
2,Polished,m2xibpolishe	2	Polished	m2xibpolishe

The size value show how big the map is. The Display name is shown to the user. 2,Polished,m2xibpolishe

Autonomy of the server configuration files

ranks.txt

Filename: ranks.txt
Location: artwork folder Description: The file contain the ranks displayed in the lobby of a running game.
The file is Mandatory.
THE CONTENT IS A VALID FILE AND MUST NOT BE ALTERED.
THE LEVEL AND NAME IS GENERIC IN ALLEG, IF IT'S ALTERED THE SERVER IS REMOVED FROM THE LOBBY!!. Content:

31
0,Newbie
1,Novice 1
2,Novice 2
3,Novice 3
4,Novice 4
5,Novice 5
6,Novice 6
7,Novice 7
8,Inter. 1
9,Inter. 2
10,Inter. 3
11,Inter. 4
12,Inter. 5
13,Inter. 6
14,Inter. 7
15,Veteran 1
16,Veteran 2
17,Veteran 3
18,Veteran 4
19,Veteran 5
20,Veteran 6
21,Veteran 7
22,Expert 1
23,Expert 2
24,Expert 3
25,Expert 4
26,Expert 5
27,Expert 6
28,Expert 7
29,Expert 8
30,Expert 9
31,Expert 9

cores.txt

Filename: cores.txt
Location: artwork folder Description: The file contain the cores available the cores are displayed when a user creates a game in the main server lobby.
The file is Mandatory.
THE CONTENT OF THIS FILES MUST DISPLAY THE CORES WHICH IS AVAILABLE IN THE ARTWORK FOLDER, IF THE FILE CONTAIN CORES NOT AVAILABLE IN THE ARTWORK FOLDER IT WILL CAUSE A CRASH IN THE ALLEG SERVER APPLICATION.
THE CONTENT MUST REFLECT THE CORE FILES LOCATED IN THE ARTWORK FOLDER!!

7
cc_03
GoDII_05
plus15b7
RTc006a
rps55
PC2_019
sw_a102

maps.txt

Filename: maps.txt
Location: artwork folder Description: The file contain a list of maps available when a user have created a game, and are altering the game setting for this particular game. The list of maps are only visible to a commander with game control
The file is Mandatory.
THE CONTENT OF THIS FILE MUST DISPLAY THE MAPS WHICH IS AVAILABLE IN THE ARTWORK FOLDER, IF THE FILE CONTAIN MAPS NOT AVAILABLE IN THE ARTWORK FOLDER IT WILL CAUSE A CRASH IN THE ALLEG SERVER APPLICATION.
THE CONTENT MUST REFLECT THE MAPS AVAILABLE IN THE ARTWORK FOLDER!!!.

28
2,Limited,m2xiblimited
2,Polished,m2xibpolishe
2,Blender,m2xibblender
2,Bowtie,m2xibbowtie
2,Emerald,m2xibemerald
2,Sapphire,m2xibsapphir
2,Splitmix,m2xibsplitmi
2,Starflake,m2xibstarfl
2,Chaos,m2xibchaos
2,Octagon,m2xiboctagon
2,Topaz,m2xibtopaz
2,Pentagram,m2xibpentag
2,Dual,m2xibdual
2,Ruby,m2xibruby
2,Sliver,m2xibsliver
2,Obsidian,m2xibobsidia
2,Escher,m2xibescher
2,Amethyst,m2xibamethy
2,Crush,m2xibcrush
2,Kill,m2xibkill
2,Destroy,m2xibdestroy
2,Gold,m2xibgold
2,Nova,m2xibnova
2,Jade,m2xibjade
2,Quartz,m2xibquartz
2,Rhodium,m2xibrhodium
2,Platinum,m2xibplatinu
2,Palladium,m2xibpallad