Pterohost docs

Terraria: команды сервера и управление

Полный справочник команд Terraria-сервера: TShock и Vanilla. Консоль, чат-команды, ban, kick, save, права, serverconfig.txt - всё в одной статье.

Кратко: Terraria-сервер управляется через консоль (TerrariaServer.exe) или чат-команды TShock. Базовые операции - say, kick, ban, save - доступны сразу; тонкая настройка прав, плагинов и автозапуска требует TShock 5.x и файла конфигурации.

Terraria: команды сервера и управление

Terraria в 2026 году по-прежнему остаётся одной из самых популярных 2D-игр для совместной игры, и правильная настройка сервера напрямую влияет на опыт всех участников. Ванильный сервер (TerrariaServer) даёт минимальный набор консольных команд, тогда как TShock - open-source-мод на API TML/TShock 5.x - расширяет управление до полноценной системы прав, плагинов, логирования и детальных команд чата. В этой статье разобраны реальные команды обоих вариантов, структура serverconfig.txt, работа с банами, бэкапами и настройка MOTD. Всё на примерах с актуальными значениями для Terraria 1.4.x и TShock 5.x.

Pterohost - игровой хостинг Terraria с NVMe-дисками, DDoS-защитой и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать сервер Terraria

Ванильный сервер: консольные команды

Ванильный TerrariaServer управляется через консоль процесса. Команды вводятся без слеша прямо в консоль.

Полный список команд ванильного сервера

КомандаОписание
helpСписок доступных команды
playingПоказать список игроков онлайн
clearОчистить консоль
exitКорректно завершить сервер (сохраняет мир)
exit-nosaveЗавершить без сохранения мира
saveСохранить мир прямо сейчас
kick <имя>Кикнуть игрока по имени
ban <имя>Забанить игрока (добавляет в banlist.txt)
password <пароль>Установить или изменить пароль сервера
versionПоказать версию Terraria
timeПоказать игровое время
portПоказать текущий порт сервера
maxplayersПоказать максимум игроков
say <сообщение>Отправить сообщение от имени сервера
motdПоказать текущий MOTD
motd <текст>Установить новый MOTD
dawnУстановить время - рассвет
noonУстановить время - полдень
duskУстановить время - закат
midnightУстановить время - полночь
settleПринудительно осадить все жидкости в мире

Пример использования:

say Сервер перезапустится через 5 минут
kick ГриферИванов
save
exit

Файл banlist.txt

Ванильный сервер хранит баны в banlist.txt рядом с исполняемым файлом. Формат - один Steam-ID или имя игрока на строку. Можно редактировать вручную.


Настройка serverconfig.txt

Файл serverconfig.txt позволяет запустить сервер с нужными параметрами без интерактивного меню. Запуск с конфигом:

TerrariaServer.exe -config serverconfig.txt

Пример serverconfig.txt с пояснениями

# Порт сервера (по умолчанию 7777)
port=7777

# Максимум игроков
maxplayers=16

# Путь к файлу мира (.wld)
world=/root/.local/share/Terraria/Worlds/MyWorld.wld

# Автоматически выбрать мир (1 = первый мир в списке)
autocreate=0

# Пароль для входа (оставить пустым - без пароля)
password=

# Имя сервера в списке серверов
worldname=MyWorld

# Язык мира (en-US, ru-RU, etc.)
lang=ru-RU

# Приоритет процесса (0-5, 1 = нормальный)
priority=1

# Автосохранение мира каждые N минут (0 = отключено)
autocreate=0

# Настройки сложности при создании нового мира
# 0 = Normal, 1 = Expert, 2 = Master, 3 = Journey
difficulty=0

# Разрешить банлист (1 = да)
secure=1

# MOTD
motd=Добро пожаловать на сервер!

На хостинге pterohost параметры сервера задаются через переменные окружения в панели Pterodactyl, а serverconfig.txt генерируется автоматически при старте контейнера.


TShock: установка и первый запуск

TShock - это серверный мод, который полностью заменяет ванильный TerrariaServer и добавляет систему прав, REST API, плагины и расширенные команды. Актуальная версия на 2026 год - TShock 5.x для Terraria 1.4.4+.

Первоначальная настройка

При первом запуске TShock создаёт токен суперадминистратора в консоли:

[TShock] To setup the server, join the game and type /setup <TOKEN>
[TShock] Setup token: 12345678

В игре введите /setup 12345678 - это даст временные права суперадминистратора. Затем создайте постоянного администратора:

/user add adminname пароль superadmin

После этого отзовите временный токен:

/setup clear

Файлы конфигурации TShock

TShock хранит конфиги в папке tshock/:

ФайлНазначение
tshock/config.jsonОсновные настройки сервера
tshock/sscconfig.jsonНастройки SSC (ServerSideCharacters)
tshock/userdata.sqliteБаза данных пользователей и банов
tshock/groups.jsonГруппы и права (устаревший формат; в 5.x - SQLite)

TShock: команды в игровом чате

Все команды TShock в чате начинаются со слеша /. Права на команды определяются группой игрока.

Управление игроками

КомандаПравоОписание
/kick <имя> [причина]tshock.admin.kickКикнуть игрока
/ban add <имя> [причина]tshock.admin.banЗабанить по нику
/ban addip <ip>tshock.admin.banЗабанить по IP
/ban del <id>tshock.admin.banУдалить бан по ID
/ban listtshock.admin.banСписок банов
/mute <имя>tshock.admin.muteЗаглушить игрока
/unmute <имя>tshock.admin.muteСнять мут
/tp <игрок>tshock.teleport.tpТелепортироваться к игроку
/tphere <игрок>tshock.teleport.tphereТелепортировать игрока к себе
/kill <игрок>tshock.admin.killУбить игрока
/who-Список игроков онлайн

Управление миром и сервером

КомандаПравоОписание
/savetshock.world.saveСохранить мир
/restarttshock.utils.restartПерезапустить сервер
/offtshock.utils.shutdownОстановить сервер
/off -savetshock.utils.shutdownОстановить с сохранением
/world-Информация о текущем мире
/time <значение>tshock.world.time.setУстановить время (0.0-24.0)
/time noontshock.world.time.setПолдень
/time midnighttshock.world.time.setПолночь
/toggledownfalltshock.world.rainВключить/выключить дождь
/bloodmoon [true/false]tshock.world.bloodmoonКровавая луна
/eclipse [true/false]tshock.world.eclipseСолнечное затмение

Управление пользователями и группами

КомандаПравоОписание
/user add <имя> <пароль> <группа>tshock.user.manageСоздать пользователя
/user del <имя>tshock.user.manageУдалить пользователя
/user group <имя> <группа>tshock.user.manageИзменить группу
/user password <имя> <пароль>tshock.user.manageИзменить пароль
/group add <группа>tshock.group.manageСоздать группу
/group del <группа>tshock.group.manageУдалить группу
/group addperm <группа> <право>tshock.group.manageДобавить право группе
/group delperm <группа> <право>tshock.group.manageУбрать право у группы
/group list-Список групп

Команды чата и уведомлений

КомандаПравоОписание
/say <сообщение>tshock.admin.sayСообщение от имени сервера
/broadcast <сообщение>tshock.admin.broadcastШироковещательное сообщение
/me <действие>-Эмоция (как /me в IRC)
/motd-Показать MOTD
/rules-Показать правила сервера
/config set motd <текст>tshock.cfg.updateОбновить MOTD

TShock: консольные команды

В консоли сервера TShock работают те же команды, что и в игровом чате, но без слеша. Исключение - консоль не требует проверки прав.

# Примеры консольных команд TShock (без слеша):
user add admin1 securepassword superadmin
kick ГриферПетров "нарушение правил"
ban add ВандалСидоров "уничтожение построек"
save
broadcast Сервер уходит на тех. обслуживание через 10 минут
off -save

Система прав TShock: группы и права

TShock использует систему групп. По умолчанию есть группы: default, vip, trustedadmin, superadmin, newadmin.

Встроенные группы

ГруппаОписание
defaultГости без регистрации
newadminНовый администратор с базовыми правами
trustedadminДоверенный администратор
superadminПолные права (обходит большинство проверок)

Создание кастомной группы

# В консоли TShock (без слеша):
group add moder
group addperm moder tshock.admin.kick
group addperm moder tshock.admin.ban
group addperm moder tshock.admin.mute
group addperm moder tshock.world.save
group addperm moder tshock.teleport.tp

Назначение группы игроку

user add moderator1 password123 moder

Или изменение существующего:

user group имяигрока moder

Настройка tshock/config.json

Основные параметры файла tshock/config.json (выборка важных):

{
  "ServerPassword": "",
  "ServerPort": 7777,
  "MaxSlots": 16,
  "ReservedSlots": 2,
  "ServerName": "Мой Terraria-сервер",
  "UseServerName": true,
  "LogPath": "tshock/logs",
  "LogClearOnRestart": false,
  "AutoSave": true,
  "BackupInterval": 10,
  "BackupKeepFor": 240,
  "SaveWorldOnCrash": true,
  "EnableWhitelist": false,
  "InvasionMultiplier": 1,
  "KickOnHardcoreDeath": false,
  "BanOnHardcoreDeath": false,
  "DisableLoginBeforeJoin": false,
  "RequireLogin": false,
  "AllowRegisterAnyUsername": true,
  "DefaultRegistrationGroupName": "default",
  "DefaultGuestGroupName": "default",
  "MaxDamage": 175,
  "MaxProjDamage": 175,
  "KickOnDamageThresholdBroken": false,
  "BroadcastRGB": [127, 255, 212],
  "PvPMode": "normal",
  "SpawnProtection": true,
  "SpawnProtectionRadius": 10,
  "RangeChecks": true,
  "MOTD": "Добро пожаловать! Правила: /rules",
  "ServerSideCharacter": false
}

Параметры BackupInterval и BackupKeepFor задаются в минутах. При BackupInterval=10 TShock сохраняет копию мира каждые 10 минут. При BackupKeepFor=240 хранит бэкапы последних 4 часов.


Бэкап мира: ручной и автоматический

Ручное сохранение и бэкап

# Консоль сервера (без слеша в TShock):
save

Файл мира *.wld хранится в:

  • Linux: /root/.local/share/Terraria/Worlds/
  • Windows: %USERPROFILE%\Documents\My Games\Terraria\Worlds\

На хостинге pterohost путь к миру виден в переменных окружения контейнера.

Автоматический бэкап через TShock

TShock сохраняет бэкапы в папку tshock/backups/. Имя файла включает метку времени:

tshock/backups/MyWorld-2026-06-05_14-30-00.wld

Для настройки частоты - параметр BackupInterval в config.json (минуты). 0 отключает автобэкап.

Бэкап через cron (дополнительно)

Если нужны внешние бэкапы:

# Скопировать мир на внешнее хранилище каждый час
0 * * * * cp /root/.local/share/Terraria/Worlds/MyWorld.wld /backup/terraria/MyWorld-$(date +\%Y\%m\%d-\%H\%M).wld

ServerSideCharacters (SSC): защита инвентаря

SSC - режим, при котором инвентарь игроков хранится на сервере, а не на клиенте. Это защищает от читерских клиентов.

Включение SSC в tshock/config.json:

"ServerSideCharacter": true

После включения SSC настройте параметры в tshock/sscconfig.json:

{
  "Enabled": true,
  "LogonDiscardThreshold": 250,
  "MediumcoreOnly": false,
  "HardcoreOnly": false,
  "StartingHealth": 100,
  "StartingMana": 20,
  "StartingInventory": [
    { "netID": 267, "prefix": 0, "stack": 1 }
  ]
}

Параметр StartingInventory - стартовый набор предметов для новых игроков. netID=267 - это Iron Shortsword; замените на нужный ID предмета.

Команды SSC:

/overrideSSC <игрок>    - разрешить игроку загрузить свой локальный инвентарь (один раз)

Whitelist и контроль доступа

TShock поддерживает whitelist через конфиг:

"EnableWhitelist": true

Управление whitelist в консоли:

# Добавить в whitelist:
whitelist add ИмяИгрока

# Удалить из whitelist:
whitelist del ИмяИгрока

# Посмотреть список:
whitelist list

Файл whitelist хранится в tshock/whitelist.txt. Можно редактировать вручную - одно имя на строку.


Связанные материалы

Если вы управляете несколькими серверами выживания, обратите внимание на аналогичные гайды: настройка и команды сервера Palworld, развёртывание выделенного сервера Valheim, а также полный разбор команд и конфигурации сервера 7 Days to Die. Принципы управления во многом схожи: системы прав, консольные команды, файлы конфигурации.

Заключение

Ванильный Terraria-сервер подходит для небольшой компании друзей - там достаточно команд say, kick, ban, save и параметров serverconfig.txt. Для серьёзного проекта с ролевой системой, защитой инвентаря через SSC, плагинами и детальным контролем прав нужен TShock 5.x. Главное при работе с TShock - правильно выстроить иерархию групп сразу, не раздавая права superadmin всем подряд. Бэкапы через BackupInterval и ручное save перед рестартом сохранят прогресс игроков. Если хотите сосредоточиться на игре, а не на администрировании инфраструктуры - делегируйте хостинг.

Pterohost - хостинг Terraria на NVMe с автоматическим бэкапом, DDoS-защитой и поддержкой 24/7: панель Pterodactyl, один клик до TShock. Промокод 4START даёт -20% на первый заказ. Заказать сервер Terraria