КАК ПОНЯТЬ? - Часть 2: Конфиг файл

[Osmith]

Приветствую во второй части рубрики "КАК ПОНЯТЬ?", которая посвящена конфигурационному файлу сервера. Тут мы разберемся для чего он предназначен, и за что отвечает каждая настройка.

Конфигурационные файлы (или конфиги) - файлы, которые используются для установки параметров и начальных настроек программы 

Wikipedia

На примере Gothic 2 Online, конфиг устанавливает параметры вроде названия сервера, максимального числа игроков, или список загружаемых скриптов. Найти конфиг файл вы можете в корневой папке сервера, он носит название config.xml. Конфиги записываются в разном виде, но в Gothic 2 Online он записан в XML формате.

Теперь рассмотрим каждый пункт конфига и разберемся за что он отвечает.

• Все настройки (тэги) заключены между тегами <server> </server>.
  

Code:

<server>

</server>

• Основные настройки сервера находятся в тэге <config>, который имеет следующие параметры:
  

1. public - булевое значение, которое отвечает за отображение вашего сервера в общем списке серверов.
   
2. host_name - название вашего сервера, отображаемое в лаунчере.
   
3. max_slots - максимальное количество одновременно подключенных игроков.
   
4. port - порт для подключений.
   
5. rcon_pass - пароль для доступа во встроенную панель управления сервером.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
</server>

• Настройки по подключению к общему списку серверов заключены в теге <master>, который имеет следующие параметры:
  

1. host - сервер общего списка серверов.
   
2. port - порт для внешних подключений.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
</server>

• В тэге <version> заключена настройка версии для подключаемых игроков. Включает один параметр.
  

1. build - настройка сброки. Если указана цифра 0, то смогут подключаться игроки с версии *.*.*.0 версии и выше, если 1, то *.*.*.1 версии и выше, и так далее. Например, на момент написания статьи последняя версия - 0.1.4.2. Если вы укажите цифру 1 в параметре build, то подключиться к вашему серверу смогут игроки с версией 0.1.4.1 и выше, а 0.1.4.0 уже будут не допущены.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
</server>

• Тэг <world> определяет загружаемый мир по умолчанию (при входе на сервер). Включает один параметр.
  

1. name - путь к вашему миру (.ZEN файлу), начиная из папки Worlds. Например, локация "Долина Рудников" расположена по пути "Gothic 2\\_work\\data\\Worlds\\OldWorld\\OldWorld.zen", но в параметре name достаточно лишь указать "OldWorld\\OldWorld.zen".
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
</server>

• Тэг <description> устанавливает описание вашего сервера в лаунчере. Включает один параметр.
  

1. text - текст описания. Поддерживает некоторые HTML тэги.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />
</server>

• Тэги <items> и <mds> отвечают за загрузку файлов с предметами и анимациями, которые по умолчанию находятся в корневой папке сервера под именами items.xml и mds.xml. Оба тэга имеют один параметр.
  

1. src - путь к файлу.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />

  <items src="items.xml" />
  <mds src="mds.xml" />
</server>

• Тэг <modification> включает настройку, которая позволяет играть на сервере со сторонними модификациями, или нет. Включает один параметр.
  

1. enabled - булевый параметр, который включает или отключает использование сторонних модификаций.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />

  <items src="items.xml" />
  <mds src="mds.xml" />

  <modification enabled=true />
</server>

Теперь поговорим об "опциональных" тэгах, которых может быть несколько.

• Тэг <import> загружает настройки из стороннего XML файла. Этот файл должен иметь структуру основного конфига. Включает один параметр.
  

1. src - путь к загружаемому файлу.
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />

  <items src="items.xml" />
  <mds src="mds.xml" />

  <modification enabled=true />

  <import src="default/scripts.xml" />
  <import src="gamemodes/prototype/scripts.xml" />
</server>

• Тэг <script> отвечает непосредственно за загрузку скриптов серверной и клиентской части. Имейте ввиду, что в каком порядке вы прописываете их в конфиге, в таком они и будут загружаться и обрабатываться. Имеет два параметра.
  

1. src - путь к файлу скрипта.
   
2. type - как его загружать, как серверный ("server") или клиентский ("client").
   

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />

  <items src="items.xml" />
  <mds src="mds.xml" />

  <modification enabled=true />

  <import src="default/scripts.xml" />
  <import src="gamemodes/prototype/scripts.xml" />

  <script src="server-scripts/player.nut" type="server" />
  <script src="server-scripts/session_info/sessions.nut" type="server" />
</server>

• Тэг <module> загружает сторонние модули. Имеет ровно те же параметры, что и тэг <script>.
  

Code:

<server>
  <config public=true host_name="Gothic 2 Online" max_slots=32 port=28970 rcon_pass="SomePassword" />
  <master host="185.5.97.181" port=7777 />
  <version build=0 />
  <world name="OLDWORLD\\MAINWORLD.ZEN" />
  <description text="<center><b><font color=blue>Gothic</font> 2 <font color=red>Online</font></b></center>" />

  <items src="items.xml" />
  <mds src="mds.xml" />

  <modification enabled=true />

  <import src="default/scripts.xml" />
  <import src="gamemodes/prototype/scripts.xml" />

  <module src="modules/MySQL.dll" type="server" />

  <script src="server-scripts/player.nut" type="server" />
  <script src="server-scripts/session_info/sessions.nut" type="server" />

</server>

По сути, на этом все. Если у Вас возникли какие-либо вопросы, предложения, или замечания - пишите это в комментариях, или вы можете связаться со мной через контакты ниже.

Автор статьи: Osmith.
Используемые материалы:

• Wikipedia - (https://en.wikipedia.org).
  
• Gothic 2 Online Wiki - (http://gothic-online.com.pl/new_wiki/).