Это руководство охватывает настройку администратора, внутриигровые команды администратора, конфигурацию RCON и команды управления сервером для вашего выделенного сервера Soulmask на Legion Hosting. Для настройки и конфигурации сервера см. Руководство по настройке сервера Soulmask.
Панель сервера: Всё управление сервером осуществляется через GPanel по адресу gpanel.legionhosting.net. Используйте файловый менеджер или 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, или GUI-инструмент, например mcrcon.
- Подключитесь к своему серверу, используя:
- Хост: IP-адрес вашего сервера
- Порт: Порт RCON (по умолчанию
19000) - Пароль: Пароль 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
- Как найти IP-адрес и порт вашего сервера
- Как загружать файлы через SFTP
- Начало работы с вашим новым сервером
Нужна помощь?
Если вам нужна дополнительная помощь с командами администратора Soulmask или управлением сервером, пожалуйста, создайте тикет в службу поддержки, и наша команда будет рада вам помочь.
