RAGE Multiplayer Wiki - User contributions [en]

PlayerExitCheckpoint RU

2022-06-25T12:45:12Z

Kingdomstay: Kingdomstay moved page PlayerExitCheckpoint RU to Ru:PlayerExitCheckpoint: Header Unification

#REDIRECT [[Ru:PlayerExitCheckpoint]]

Ru:PlayerExitCheckpoint

2022-06-25T12:45:12Z

Kingdomstay: Kingdomstay moved page PlayerExitCheckpoint RU to Ru:PlayerExitCheckpoint: Header Unification

Срабатывает когда игрок выходит из зоны checkpoint-a.

==Parameters==
* '''player'''
* '''checkpoint'''

==Example==
<syntaxhighlight lang="javascript">
mp.events.add("playerExitCheckpoint", (player, checkpoint) => {
// Делай что хочешь.
});
</syntaxhighlight>

PlayerEnterCheckpoint RU

2022-06-25T12:44:04Z

Kingdomstay: Kingdomstay moved page PlayerEnterCheckpoint RU to Ru:PlayerEnterCheckpoint: Header Unification

#REDIRECT [[Ru:PlayerEnterCheckpoint]]

Ru:PlayerEnterCheckpoint

2022-06-25T12:44:04Z

Kingdomstay: Kingdomstay moved page PlayerEnterCheckpoint RU to Ru:PlayerEnterCheckpoint: Header Unification

Срабатывает, когда игрок заходит на checkpoint.

==Parameters==
* '''checkpoint'''

==Example==
<syntaxhighlight lang="javascript">
mp.events.add("playerEnterCheckpoint", (player, checkpoint) => {
// Код
});
</syntaxhighlight>

Getting Started with Server

2020-05-15T14:34:08Z

Kingdomstay: Added link on russian language section

== Introduction ==

*[[Ru:Getting Started with Server]]

This brief tutorial will show you how to run your server on both Windows and Linux distributions.

By default, the server makes use of port 22005 UDP for server access and the port after (here 22006) for the HTTP server hosting the client packages for the clients to download from. 
So make sure to have done the ports forwarding on your router process and have also unblocked the ports on your firewall before running the server.

=Bridge=
The following tutorial is found on [https://wiki.gtanet.work/index.php?title=Setting_up_the_Bridge_on_Linux/Windows Setting up the Bridge on Linux/Windows].

=Windows=
==Prerequisite==
For a hassle-free installation and operation, it is recommended to have the latest VC Redist.

[https://aka.ms/vs/15/release/VC_redist.x64.exe Microsoft Visual C++ Redistributable 2017]

==Setting up the server==
1. Download the latest [https://cdn.rage.mp/client/updater.exe updater.exe].
: '''Note:''' Server files are also already included with installation of RAGE-MP Client for Windows.

2. Run the downloaded '''updater.exe'''.

3. Launch '''server-files/server.exe''' and you should be able to connect to it (default local host IP: '''127.0.0.1:22005''').
: Read more about [https://wiki.rage.mp/index.php?title=Server_settings Server Settings].

==Next step==
[[Getting Started with Development]]

=Linux=
==Prerequisite==
It's recommended to use Debian or Ubuntu to set up a server if you're new to Linux.
*Debian 10 or above [https://distrowatch.com/table.php?distribution=debian See more]
*Ubuntu 18.10 or above [https://distrowatch.com/table.php?distribution=ubuntu See more]
*An OS that supports glibc v2.28

===Ubuntu===
<syntaxhighlight lang="bash">
sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
sudo apt update && sudo apt install libstdc++6
</syntaxhighlight>

===Debian===
<syntaxhighlight lang="bash">
echo 'deb http://httpredir.debian.org/debian testing main contrib non-free' > /etc/apt/sources.list
apt update && apt install -y -t testing libstdc++6
</syntaxhighlight>

==Setting up server==
This bash snippet should automate the server installation.
<syntaxhighlight lang="bash">
# Downloading server
wget https://cdn.rage.mp/lin/ragemp-srv-037.tar.gz

# Extract the server files
tar -xzf ragemp-srv-037.tar.gz

# Accessing the directory
cd ragemp-srv

# Set executable permission
chmod +x server

# Run the server
./server
</syntaxhighlight>

==Launching the server as a daemon (systemd)==
If you want to launch the server as a daemon on the latest version of Ubuntu/Debian/CentOS, you need to follow these steps:

1. We recommend move your server to /opt
e.g '''mv ./ragemp-srv /opt/'''

2. Create the systemd unit (e.g /etc/systemd/system/rageserv.service) and enter this config:

<syntaxhighlight lang="ini">
[Unit]
Description=RAGE-MP Dedicated server
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=1
; not safe, change root to another user
User=root
WorkingDirectory=/opt/ragemp-srv
ExecStart=/opt/ragemp-srv/server

[Install]
WantedBy=multi-user.target
</syntaxhighlight>

'''Important: If you have not moved the directory, you need to edit WorkingDirectory and ExecStart with new absolute paths.'''

3. After saving the new unit we recommend you to update your systemd unit's list.

4. Finally! Now you can enable and run the unit via these commands:
# systemctl enable rageserv
# systemctl start rageserv

If you want to watch status of your server you need enter:
<syntaxhighlight lang="bash">
systemctl status rageserv
</syntaxhighlight>

If you want to restart your server you need to enter:
<syntaxhighlight lang="bash">
systemctl restart rageserv
</syntaxhighlight>

More commands and other details can be found [https://www.freedesktop.org/software/systemd/man/systemctl.html#Unit%20File%20Commands here.]

==Installing screen (Optional)==
For running the server in the background, we recommend using screen, mainly for its ease of use.

===Debian based (Ubuntu & derivatives)===
<syntaxhighlight lang="bash">
sudo apt-get install screen
</syntaxhighlight>

===CentOS 6.x/7.x===
<syntaxhighlight lang="bash">
yum install screen
</syntaxhighlight>

===Starting the server===
<syntaxhighlight lang="bash">
screen -dmS GTASERVER -L bash -c 'cd ~/srv && ./server' &
</syntaxhighlight>
Parameter explanation:
* <syntaxhighlight lang="bash" inline>screen -dmS</syntaxhighlight> starts a separate shell without directly opening an interface towards it (detached mode). The <tt>S</tt> param defines a session name for the newly created session (in this case <code>GTASERVER</code>), so that it is easier to manage in the future.
* <syntaxhighlight lang="bash" inline>screen -L</syntaxhighlight> basically logs whatever error that is shown by the server through the separate shell into a file for easier reference in the future.
'''!IMPORTANT!'''
* Log output will be saved as <code>screenlog.''_number_''</code> in the server directory.
* <code>&</code> '''IS IMPORTANT''' IF YOU WANT TO TERMINATE THE PROCESS GRACEFULLY.

===Stopping the server===
There are usually two ways to stop the server; One that we call a '''graceful''' shutdown that sends the server a signal for termination and the other, well, a '''crash''' since it does not allow the code to run through the termination process correctly.

'''RECOMMENDED:'''
<syntaxhighlight lang="bash">
kill $(ps h --ppid $(screen -ls | grep GTASERVER | cut -d. -f1) -o pid)
</syntaxhighlight>

'''NOT RECOMMENDED:''' It does not shut down the server gracefully
<syntaxhighlight lang="bash">
screen -S GTASERVER -X quit
</syntaxhighlight>

=Troubleshooting=
==Linux==
<syntaxhighlight lang="bash">
./server: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by ./server)
</syntaxhighlight>

Make sure GCC/G++ 6 or newer is installed, follow the [[#Prerequisite_2|Prerequisite]].

= See also =
* [[Server settings]]
{{ScriptingTutorials}}

[[Category:Tutorials]]

Ru:Getting Started with Server

2020-05-15T14:28:43Z

Kingdomstay: Added section on Russian language

==Вступление==

Этот краткий обзор покажет вам, как запустить ваш сервер на платформах Windows или Linux.

По умолчанию сервер использует порт 22005 UDP для доступа к серверу и порт 22006 для HTTP-сервера, на котором размещаются клиентские файлы для клиентов, которые будут загружаться у игроков. 
Поэтому убедитесь, что вы выполнили переадресацию портов на вашем маршрутизаторе, а также разблокировали порты в брандмауэре перед запуском сервера.

=Bridge=
Учебник по Bridge вы можете найти тут [https://wiki.gtanet.work/index.php?title=Setting_up_the_Bridge_on_Linux/Windows Setting up the Bridge on Linux/Windows].

=Windows=
==Примечание==
Для корректной установки сервера рекомендуется установить последнюю версию VC Redist.

[https://aka.ms/vs/15/release/VC_redist.x64.exe Microsoft Visual C++ Redistributable 2017]

==Установка сервера==
1. Скачайте последнюю версию [https://cdn.rage.mp/client/updater.exe updater.exe].
: '''Замечание:''' Файлы сервера также уже включены в установленный RAGE-MP клиент Windows.

2. Запустите данный файл '''updater.exe'''.

3. Запустите '''server-files/server.exe''' и попробуйте подключиться на ваш сервер через клиент RAGE. По умолчанию IP локального сервера выглядит так: '''127.0.0.1:22005''').
: Узнать больше об этом можно здесь [https://wiki.rage.mp/index.php?title=Server_settings Server Settings].

==Следующий шаг==
[[Начало разработки]]

=Linux=
==Примечание==
Рекомендуется использовать Debian или Ubuntu для настройки сервера, если вы новичок в Linux.
*Используйте Debian 10 версии или выше [https://distrowatch.com/table.php?distribution=debian See more]
*Используйте Ubuntu 18.10 версии или выше [https://distrowatch.com/table.php?distribution=ubuntu See more]
*Либо используйте ОС, которая поддерживает glibc v2.28

===Ubuntu===
<syntaxhighlight lang="bash">
sudo add-apt-repository -y ppa:ubuntu-toolchain-r/test
sudo apt update && sudo apt install libstdc++6
</syntaxhighlight>

===Debian===
<syntaxhighlight lang="bash">
echo 'deb http://httpredir.debian.org/debian testing main contrib non-free' > /etc/apt/sources.list
apt update && apt install -y -t testing libstdc++6
</syntaxhighlight>

==Настройка сервера==
Этот bash скрипт должен упростить установку вашего сервера
<syntaxhighlight lang="bash">
# Загрузка серверных файлов
wget https://cdn.rage.mp/lin/ragemp-srv-037.tar.gz

# Распаковка серверных файлов
tar -xzf ragemp-srv-037.tar.gz

# Переход в каталог сервера
cd ragemp-srv

# Установка разрешений
chmod +x server

# Запуск сервера
./server
</syntaxhighlight>

==Запуск сервера на daemon (systemd)==
Если вы хотите запустить сервер на daemon в последней версии Ubuntu/Debian/CentOS, вам необходимо выполнить следующие шаги:

1. Мы рекомендуем переместить ваш сервер в /opt, например '''mv ./ragemp-srv /opt/'''

2. Создайте системный сервис, например '''/etc/systemd/system/rageserv.service''', и запишите туда эту конфигурацию:

<syntaxhighlight lang="ini">
[Unit]
Description=RAGE-MP Dedicated server
After=network.target
StartLimitIntervalSec=0

[Service]
Type=simple
Restart=always
RestartSec=1
; not safe, change root to another user
User=root
WorkingDirectory=/opt/ragemp-srv
ExecStart=/opt/ragemp-srv/server

[Install]
WantedBy=multi-user.target
</syntaxhighlight>

'''Важное замечание: Если вы не переместили каталог, вам нужно отредактировать WorkingDirectory и ExecStart с новыми абсолютными путями.'''

3. После сохранения нового сервиса мы рекомендуем обновить список своих системных сервисов.

4. Отлично! Теперь вы можете запустить сервис с помощью этих команд:
# systemctl enable rageserv
# systemctl start rageserv

Если вы хотите посмотреть статус вашего сервера, вам нужно ввести:
<syntaxhighlight lang="bash">
systemctl status rageserv
</syntaxhighlight>

Если вы хотите перезагрузить сервер, вам нужно ввести:
<syntaxhighlight lang="bash">
systemctl restart rageserv
</syntaxhighlight>

Больше команд и других деталей можно найти [https://www.freedesktop.org/software/systemd/man/systemctl.html#Unit%20File%20Commands здесь.]

==Установка screen (Необязательно)==
Для работы сервера в фоновом режиме мы рекомендуем использовать screen, в основном из-за простоты его использования.

===Debian (Ubuntu и его аналоги)===
<syntaxhighlight lang="bash">
sudo apt-get install screen
</syntaxhighlight>

===CentOS 6.x/7.x===
<syntaxhighlight lang="bash">
yum install screen
</syntaxhighlight>

===Запуск сервера===
<syntaxhighlight lang="bash">
screen -dmS GTASERVER -L bash -c 'cd ~/srv && ./server' &
</syntaxhighlight>
Описание параметров:
* <syntaxhighlight lang="bash" inline>screen -dmS</syntaxhighlight> запускает отдельную оболочку без непосредственного открытия интерфейса в ней (detached mode). Этот <tt>S</tt> параметр определяет имя сеанса для вновь созданного сеанса (в этом случае <code>GTASERVER</code>), так будет легче управлять в будущем.
* <syntaxhighlight lang="bash" inline>screen -L</syntaxhighlight> в основном, регистрирует любую ошибку, отображаемую сервером через отдельную оболочку в файл, для более удобного использования в будущем.
'''ВАЖНО'''
* Логи будут сохранены <code>screenlog.''_number_''</code> в каталоге сервера.
* <code>&</code> '''Это важно''' если вы хотите завершить процесс красиво.

===Остановка сервера===
Обычно есть два пути остановить сервер; Первый путь, который мы называем '''изящным''' выключением, посылает на сервер сигнал о завершении своего процесса, а второй называется '''падением''', поскольку он не позволяет программе правильно провести процесс остановки сервера.

'''РЕКОМЕНДУЕМЫЙ МЕТОД:'''
<syntaxhighlight lang="bash">
kill $(ps h --ppid $(screen -ls | grep GTASERVER | cut -d. -f1) -o pid)
</syntaxhighlight>

'''Не рекомендуемый:'''
<syntaxhighlight lang="bash">
screen -S GTASERVER -X quit
</syntaxhighlight>

=Проблемы при установке=
==Linux==
<syntaxhighlight lang="bash">
./server: /usr/lib/x86_64-linux-gnu/libstdc++.so.6: version `GLIBCXX_3.4.22' not found (required by ./server)
</syntaxhighlight>

Убедитесь, что у вас установлен GCC/G++ 6 или более новой версии, следуйте [[#Prerequisite_2|примечанию]].

= Смотрите также =
* [[Конфигурации сервера]]
{{ScriptingTutorials}}

[[Category:Tutorials]]