Цей посібник охоплює налаштування адміністратора, команди адміністратора в грі, конфігурацію RCON та команди керування сервером для вашого виділеного сервера Soulmask на Legion Hosting. Щодо налаштування та конфігурації сервера див. Soulmask Server Setup Guide.
Панель сервера: Усе керування сервером здійснюється через GPanel за адресою gpanel.legionhosting.net. Використовуйте File Manager або SFTP для редагування конфігураційних файлів.
Встановлення прав адміністратора
Soulmask використовує систему адміністрування на основі пароля. Щоб стати адміністратором, вам потрібно встановити пароль адміністратора в конфігурації запуску сервера, а потім автентифікуватися в грі.
Крок 1: Встановіть пароль адміністратора
- В GPanel виберіть свій сервер Soulmask.
- Натисніть вкладку Startup.
- Встановіть змінну
ADMIN_PASSWORDна надійний унікальний пароль. Це відповідає параметру командного рядка-adminpsw. - Перезапустіть сервер, щоб зміна набрала чинності.
Тримайте свій пароль адміністратора в таємниці. Будь-хто, хто знає пароль адміністратора, може отримати повні права GM на вашому сервері. Діліться ним лише з довіреними співадміністраторами.
Крок 2: Автентифікація в грі
- Приєднайтеся до свого сервера Soulmask як гравець.
- Відкрийте консоль у грі, натиснувши клавішу ` (гравіс/тильда) або Numpad - (мінус на цифровій клавіатурі).
- Введіть таку команду та натисніть Enter:
gm key YOUR_ADMIN_PASSWORD - Якщо пароль правильний, ви побачите повідомлення про підтвердження та отримаєте права адміністратора GM (Game Master).
- Ви також можете натиснути кнопку "Become the admin", яка з’являється в інтерфейсі панелі GM.
Автентифікація на основі сеансу. Ви маєте повторно автентифікуватися щоразу, коли приєднуєтеся до сервера. Статус адміністратора не зберігається між сеансами — вам потрібно буде запускати
gm key щоразу під час входу.
Команди адміністратора в грі
Після автентифікації як адміністратор відкрийте консоль (` або Numpad -) та вводьте команди. Усі команди адміністратора починаються з префікса gm.
Керування гравцями
| Команда | Опис |
|---|---|
gm AddExp [value] |
Додає загальні очки досвіду вашому персонажу. |
gm Addmjexp [value] |
Додає досвід маски вашому персонажу (підвищує рівень маски). |
gm Addshoulieexp [value] |
Додає досвід полювання вашому персонажу. |
gm XiDian |
Скидає всі очки навичок для вашого персонажа, дозволяючи перерозподіл. |
gm FuHuo |
Воскрешає вашого персонажа (використовуйте, коли мертві). |
gm ZiSha 1 |
Вбиває вашого власного персонажа (команда самогубства). |
gm shanhao |
Видаляє ваш обліковий запис/персонажа із сервера. Використовуйте з надзвичайною обережністю — це незворотно. |
gm ShowInfo 1 |
Відображає детальну інформацію про вашого власного персонажа (характеристики, ID, позиція). |
gm ShowInfo 0 |
Відображає детальну інформацію про поточного вибраного персонажа або NPC. |
gm ChongZhiRenWu |
Скидає всі навчальні та довідкові завдання для вашого персонажа. |
Навігація та видимість
| Команда | Опис |
|---|---|
gm Go [x] [y] [z] |
Телепортує до конкретних світових координат. Спочатку використовуйте GPS, щоб знайти свої поточні координати. |
GPS |
Відображає ваші поточні світові координати (X, Y, Z). Корисно для цілей телепортації. |
gm SetAttr YinShen 1 |
Вмикає невидимість. Монстри та NPC не можуть вас виявити. |
gm SetAttr YinShen 0 |
Вимикає невидимість. Повертає до звичайної видимості. |
gm ShowMap |
Відкриває всю карту, знімаючи весь туман війни для вашого персонажа. |
Керування NPC та світом
| Команда | Опис |
|---|---|
gm ZhaoMu |
Миттєво вербує цільового NPC до вашого племені. |
gm ClearAllNpc |
Видаляє всіх NPC (не гравців) із сервера. Використовуйте з обережністю — впливає на всіх NPC по всьому серверу. |
gm ClearSelect |
Видаляє поточну вибрану/цільову сутність (NPC, істоту або об’єкт). |
gm ShuaXinZhiBei |
Оновлює та відрощує всю прилеглу рослинність і збиральні рослини. |
gm KeJiShu |
Розблоковує всі вузли дерева технологій для вашого персонажа. |
Керування вторгненнями та рівнем загрози
| Команда | Опис |
|---|---|
gm ShowReDu |
Відображає поточну діаграму рівня загрози вторгнень, показуючи рівні загрози в різних областях. |
gm ClearAllReDu |
Очищає весь рівень загрози вторгнень по карті, скидаючи рівні загрози до нуля. |
gm AddReDu [value] |
Вручну збільшує рівень загрози вторгнень на вказану величину. Вищий рівень загрози приваблює більше вторгнень. |
Сервер та налагодження
| Команда | Опис |
|---|---|
gm exit |
Коректно вимикає сервер зі збереженням. Це найбезпечніший спосіб зупинити сервер із гри. |
Debuginfo 1 |
Вмикає накладку моніторингу продуктивності сервера, показуючи частоту тіків, кількість сутностей та використання ресурсів. |
Debuginfo 0 |
Вимикає накладку моніторингу продуктивності сервера. |
Використовуйте команди економно. Команди адміністратора можуть суттєво вплинути на стабільність сервера та досвід гравців. Створення великої кількості сутностей, очищення NPC по всьому серверу або швидка зміна даних світу можуть спричинити лаги або збої. Спочатку тестуйте команди в період низької кількості гравців.
Команди керування сервером
Ці команди використовуються для керування всім сервером і можуть виконуватися як у грі (через консоль), так і віддалено (через RCON/Telnet).
Керування сервером
| Команда | Опис |
|---|---|
SaveWorld |
Примусово виконує негайне збереження світу в пам’ять (і опціонально на диск). Використовуйте перед виконанням ризикованих операцій. |
SaveAndExit [seconds] |
Зберігає світ і вимикає сервер після вказаної кількості секунд. Гравці отримують попереджувальний зворотний відлік. |
StopCloseServer |
Скасовує очікуване вимкнення, ініційоване командою SaveAndExit. |
shutdown [seconds] |
Ініціює коректне вимкнення сервера з вказаним зворотним відліком у секундах. |
broadcast [message] |
Надсилає глобальне повідомлення всім підключеним гравцям. Корисно для оголошень та попереджень. |
Адміністрування гравців (віддалено)
| Команда | Опис |
|---|---|
List_AllPlayers |
Перелічує всі облікові записи гравців, зареєстровані на сервері (онлайн та офлайн). |
List_OnlinePlayers |
Перелічує всіх поточних підключених гравців з їхніми Steam ID та іменами персонажів. |
List_Guilds |
Перелічує всі племена (гільдії) на сервері з кількістю учасників. |
kick [PlayerName] |
Виключає гравця із сервера за іменем персонажа. |
ban [PlayerName] |
Блокує гравця на сервері. Він не зможе повторно підключитися. |
CreateItemForPlayer [SteamID] [ItemID] [Amount] |
Додає предмети безпосередньо до інвентарю конкретного гравця за Steam ID. |
GotoPosition [SteamID] [x] [y] [z] |
Телепортує конкретного гравця до світових координат. |
FlyMode [SteamID] [0/1] |
Вмикає (1) або вимикає (0) режим привида/польоту для гравця. |
Інформація про сервер
| Команда | Опис |
|---|---|
ServerFPS |
Відображає поточну частоту тіків сервера (FPS). Здорові сервери мають підтримувати 30+ FPS. |
Show_Coefficient_Settings |
Перелічує всі поточні налаштування коефіцієнтів геймплею з GameXishu.json. |
Set_Coefficient [key] [value] |
Змінює коефіцієнт геймплею під час роботи без редагування файлів. Зміни набирають чинності негайно. |
List_AllTalent [level] |
Переглядає всі природні дари (таланти), доступні на вказаному рівні. |
Налагодження та розширені
| Команда | Опис |
|---|---|
Dump_AllActorPositions |
Експортує всі позиції акторів у файл даних для налагодження стану світу. |
DrawActorImage |
Генерує візуалізацію позицій акторів на карті. |
ExecScriptCommands [filename] |
Запускає пакетний файл команд. Корисно для виконання кількох команд одночасно. |
Доступ через RCON
RCON (Remote Console) дозволяє виконувати команди сервера віддалено без підключення до гри. Soulmask підтримує як RCON, так і Telnet для віддаленого адміністрування.
Увімкнення RCON
RCON вимкнений за замовчуванням і має бути увімкнений через параметри запуску:
- В GPanel перейдіть до вкладки Startup.
- Додайте такі параметри (через додаткові параметри запуску або звернувшись до підтримки, щоб їх додали):
-rconpsw="YOUR_RCON_PASSWORD" -rconport=19000 - Перезапустіть сервер.
Безпека RCON. Реалізація RCON у Soulmask використовує білий список IP для безпеки. Лише IP-адреси з білого списку можуть підключатися до служби RCON. Перевірте документацію сервера або конфігураційні файли щодо розташування білого списку, якщо вам потрібно додати свою IP.
Підключення через RCON
Після увімкнення RCON ви можете підключитися за допомогою будь-якого стандартного RCON-клієнта:
- Завантажте RCON-клієнт, наприклад rcon-cli або інструмент із графічним інтерфейсом, наприклад mcrcon.
- Підключіться до свого сервера, використовуючи:
- Host: IP-адреса вашого сервера
- Port: Порт RCON (за замовчуванням
19000) - Password: Пароль RCON, який ви встановили за допомогою
-rconpsw
- Після підключення введіть
help, щоб побачити список доступних команд.
Доступ через Telnet
Soulmask також підтримує адміністрування на основі Telnet на Echo Port (за замовчуванням 18888). Telnet за замовчуванням обмежений лише локальними підключеннями і не вимагає додаткового переадресування портів. Це переважно використовується для скриптованого адміністрування на самій машині сервера.
Приклад сеансу RCON
# Connect to RCON (using rcon-cli as example)
rcon -a your.server.ip:19000 -p YOUR_RCON_PASSWORD
# Check server performance
ServerFPS
# List online players
List_OnlinePlayers
# Send a global message
broadcast Server restart in 10 minutes!
# Initiate a 600-second (10-minute) shutdown countdown
SaveAndExit 600
# Cancel the shutdown if needed
StopCloseServerПравильне вимкнення сервера
Існує кілька безпечних методів вимкнення сервера Soulmask. Завжди використовуйте один із них, щоб запобігти втраті даних:
- Кнопка Stop у GPanel: Найпростіший метод. Натисніть Stop на вкладці Console в GPanel.
- Команда в грі: Автентифікуйтеся як адміністратор і запустіть
gm exit, щоб зберегти та вимкнути. - RCON/Telnet: Запустіть
shutdown [seconds]абоSaveAndExit [seconds]для вимкнення зі зворотним відліком, що дає гравцям час підготуватися.
Уникайте примусового завершення роботи сервера. Використання кнопки Kill у GPanel або примусове завершення процесу пропустить крок збереження. Будь-який прогрес з моменту останнього автоматичного резервного копіювання на диск буде втрачено. Використовуйте Kill лише як останній засіб, коли сервер повністю не відповідає.
Поради для адміністраторів сервера
- Налаштуйте автоматичні резервні копії. Використовуйте
-initbackupта-backupinterval=30для створення регулярних знімків резервного копіювання. - Відстежуйте FPS сервера. Регулярно використовуйте команду
ServerFPS. Якщо частота тіків падає нижче 15-20 FPS, сервер має труднощі і може потребувати оптимізації або перезапуску. - Використовуйте
Set_Coefficientдля живого налаштування. Ви можете коригувати налаштування геймплею під час роботи без перезапуску сервера. Спочатку запустітьShow_Coefficient_Settings, щоб побачити поточні значення. - Плануйте регулярні перезапуски. Перезапускайте сервер щодня, щоб очищати витоки пам’яті та застосовувати будь-які очікувані оновлення.
- Транслюйте повідомлення перед обслуговуванням. Завжди використовуйте команду
broadcast, щоб попередити гравців перед перезапусками сервера або вікнами обслуговування. - Використовуйте
SaveWorldперед ризикованими операціями. Примусово виконайте збереження перед внесенням значних змін, наприклад очищенням NPC або зміною коефіцієнтів.
Пов’язані статті
- Soulmask Server Setup Guide
- How to Find Your Server IP and Port
- How to Upload Files via SFTP
- Getting Started with Your New Server
Потрібна допомога?
Якщо вам потрібна додаткова допомога з командами адміністратора Soulmask або керуванням сервером, будь ласка, відкрийте тікет підтримки, і наша команда буде рада вам допомогти.
