Гайд по TShock: установка, команды и права

Версии TShock и Terraria

TShock собирается под одну конкретную версию Terraria. Текущий релиз, TShock 6.2.1, работает с Terraria 1.4.5.8. Игроки должны использовать ту же версию Terraria, что и сервер.

Когда выходит обновление Terraria, дождитесь соответствующего релиза TShock, прежде чем обновлять сервер. Перед обновлением TShock сделайте резервную копию tshock.sqlite и всей папки tshock: там хранятся ваши аккаунты, группы, баны и регионы.

Настройка самого сервера, с портами и мирами, описана в гайде как создать сервер Terraria.

Первая настройка: создайте аккаунт владельца

При первом запуске TShock выводит в консоль код настройки и сохраняет его в tshock/setup-code.txt. Зайдите на сервер и введите:

/setup 123456
/user add YourName YourPassword owner
/login YourName YourPassword
/setup

Первая строка открывает настройку по коду, вторая создаёт ваш аккаунт в группе owner, третья выполняет вход, а последняя выключает режим настройки. Как только появился хотя бы один аккаунт, настройку повторно использовать нельзя.

Играйте из группы owner. В TShock есть и встроенный superadmin, но разработчики не советуют играть под ним: он обходит всё, включая серверных персонажей.

Группы и права

Каждый игрок состоит в группе, а у групп есть права. По умолчанию TShock создаёт такие группы: guest (без входа), default (зарегистрированные игроки), vip, newadmin, admin, trustedadmin и owner.

Игроки сами создают аккаунты командой /register password и входят через /login. Чтобы незарегистрированные игроки не могли строить, установите RequireLogin в true в конфиге.

Команды TShock (команды сервера Terraria)

Команды начинаются с /; если начать команду с !, она выполнится тихо, без оповещения других игроков. Имена с пробелами берутся в кавычки.

Защита построек регионами

Регионы не дают другим игрокам менять участок карты, например спавн или город.

/region set 1
/region set 2
/region define spawn
/region protect spawn true
/region allow Alex spawn
/region allowg builder spawn

После /region set 1 ударьте по блоку, чтобы отметить первый угол; то же самое сделайте для угла 2. Затем дайте региону имя и включите защиту. allow разрешает строить внутри одному игроку, allowg — целой группе. /region list и /region info spawn показывают, что уже создано.

Учтите, что начиная с TShock 6 автоматическая защита спавна по умолчанию выключена (SpawnProtection в конфиге). Регион вокруг спавна в любом случае даёт более точный контроль.

Серверные персонажи

Обычно персонаж каждого игрока вместе с инвентарём хранится на его собственном компьютере, поэтому игроки могут принести предметы из других миров или отредактированных персонажей. Серверные персонажи (SSC) хранят персонажей на сервере, и все развиваются честно.

• Включите их в tshock/sscconfig.json через "Enabled": true и перезапустите сервер.
• Задайте, с чем начинают новые персонажи: StartingHealth, StartingMana и StartingInventory.
• Админы с правом tshock.ignore.ssc не сохраняются в SSC.

Решите заранее: после включения SSC игроки начинают со стартовым инвентарём, а существующего персонажа админ должен импортировать командой /uploadssc. Если включить SSC позже, постоянные игроки будут неприятно удивлены.

Файл конфига и REST API

Настройки TShock хранятся в tshock/config.json. Те, что меняют на большинстве серверов:

• ServerPassword: пароль для входа на сервер;
• MaxSlots: лимит игроков (по умолчанию 8);
• RequireLogin: игроки должны войти в аккаунт, прежде чем играть;
• EnableWhitelist: подключаться могут только разрешённые адреса;
• BackupInterval: как часто TShock сохраняет резервную копию мира.

Применяйте изменения командой /reload или перезапуском, если настройка этого требует.

REST API позволяет сайтам и утилитам управлять сервером по HTTP, по умолчанию на порту 7878. По умолчанию он выключен (RestApiEnabled), и лучше не включать его без необходимости: REST-токен может выполнить любую команду сервера с правами аккаунта, которому он принадлежит. Если используете его, дайте аккаунту токена только те права, которые нужны утилите, и никогда не публикуйте токен.

TShock на HytHost

На хостинге Terraria от HytHost TShock включается в один клик: выберите его при заказе или переключитесь позже на вкладке Software в панели — мир, пароль, MOTD и слоты сохранятся. Сервер работает на TShock 6.2.1 для Terraria 1.4.5.8, REST API по умолчанию выключен.

Код настройки появляется в консоли панели при первом запуске, а config.json и sscconfig.json редактируются в файловом менеджере.