TShock 指南：安装设置、命令与权限
本页内容
TShock 能把普通的 Terraria 服务器变成真正可以由管理员掌控的服务器：账号与组、封禁、保护区域、物品和怪物命令、服务器端角色以及反作弊。它是公开 Terraria 服务器的标准选择。
本指南介绍首次设置、组与权限、日常会用到的命令、区域、服务器端角色、REST API 以及主要的配置项。
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，或稍后在面板中切换：HytHost Terraria 主机 €2.59/月起。
查看 Terraria 套餐组与权限
每个玩家都属于一个组，权限由组持有。TShock 默认创建以下组：guest（未登录）、default（已注册玩家）、vip、newadmin、admin、trustedadmin 和 owner。
| 命令 | 作用 |
|---|---|
/group add builder | 创建一个组 |
/group parent builder default | 让它继承另一个组的权限 |
/group addperm builder tshock.world.editregion | 添加权限 |
/group delperm builder tshock.world.editregion | 移除权限 |
/group listperm builder | 列出该组的权限 |
/user group Alex builder | 把玩家账号移入某个组 |
玩家用 /register password 自行注册账号，并用 /login 登录。若要禁止未注册玩家建造，请在配置中将 RequireLogin 设为 true。
TShock 命令（Terraria 服务器命令）
| 命令 | 作用 |
|---|---|
/kick Name reason | 踢出玩家 |
/ban add Name reason 7d | 封禁玩家，此例为 7 天；不填时长则为永久封禁 |
/ban list / /ban del 3 | 列出封禁，或删除编号为 3 的封禁 |
/mute Name | 在聊天中禁言玩家 |
/tp Name / /tphere Name | 传送到玩家身边，或把玩家传送到你身边 |
/item "Iron Pickaxe" 1 | 给自己一件物品 |
/give "Healing Potion" Name 10 | 给另一名玩家物品 |
/butcher | 杀死所有敌对 NPC |
/time day | 设置时间：day、night、noon、midnight |
/spawnmob Zombie 5 | 在你附近生成怪物 |
/save / /off | 保存世界，或保存后关闭服务器 |
/reload | 重新加载配置和权限 |
命令以 / 开头；改用 ! 开头则会静默执行，不会通知其他玩家。带空格的名称需要加引号。
用区域保护建筑
区域可以阻止其他玩家改动某块地方，例如出生点或城镇。
/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 导入已有角色。后期才开启会让老玩家措手不及。
配置文件与 REST API
TShock 的设置位于 tshock/config.json。大多数服务器会修改的项：
ServerPassword：加入服务器的密码；MaxSlots：玩家上限（默认 8）；RequireLogin：玩家必须登录后才能游戏；EnableWhitelist：只有允许的地址才能加入；BackupInterval：TShock 保存世界备份的频率。
用 /reload 应用更改，需要重启的设置则重启服务器。
REST API 允许网站和工具通过 HTTP 控制服务器，默认端口为 7878。它默认关闭（RestApiEnabled），除非确有需要，否则应保持关闭：REST 令牌能以其所属账号的权限执行任何服务器命令。如果要使用，请只给令牌所属账号授予工具所需的权限，并且绝不要公开令牌。
HytHost 上的 TShock
在 HytHost Terraria 主机上，TShock 一键即可启用：下单时选择，或稍后在面板的 Software 选项卡中切换，你的世界、密码、MOTD 和玩家位都会保留。服务器运行适用于 Terraria 1.4.5.8 的 TShock 6.2.1，REST API 默认关闭。
首次启动时，设置码会显示在面板控制台中，你可以在文件管理器里编辑 config.json 和 sscconfig.json。
常见问题
首次启动时，使用控制台中的设置码：/setup code，然后 /user add Name Password owner、/login Name Password，再输入一次 /setup 关闭设置。
TShock 会在首次启动时把它打印到服务器控制台，并保存到 tshock/setup-code.txt。它只在第一个账号创建之前有效。
TShock 6.2.1 支持 Terraria 1.4.5.8。每个 TShock 版本只对应一个 Terraria 版本，玩家必须使用与服务器相同的版本。
用区域保护它：用 /region set 1 和 /region set 2 标记两个角，/region define spawn，再执行 /region protect spawn true。
只有在某个工具需要时才启用。REST API 能执行任何服务器命令，所以默认保持关闭，给令牌分配一个权限最少的账号，并且绝不分享令牌。
运行 TShock 服务器
HytHost Terraria 主机包含 TShock、Vanilla 和 tModLoader，可在面板中切换，€2.59/月起。
Live chat 8 AM – 11 PM (Chișinău time) · tickets answered during business hours这篇指南对你有帮助吗？
