TShock 插件服
泰拉瑞亚 TShock 插件服的首次设置超级管理员、账号与权限组、安装插件、config.json 与欢迎语、自动备份和常用控制台命令。
泰拉瑞亚 · 更新于
TShock 是基于官方原版服务端的插件服,玩家用原版客户端加入,服务器端多了账号、权限组、反作弊、封禁管理和插件支持。开服流程和通用参数见 泰拉瑞亚开服入门。
目录结构
| 路径 | 用途 |
|---|---|
worlds/ |
世界存档,和原版 .wld 通用 |
tshock/config.json |
TShock 主配置 |
tshock/tshock.sqlite |
账号、权限组、封禁等数据 |
tshock/motd.txt |
进服欢迎语 |
tshock/logs/ |
日志,超过 30 天的会在开机时自动删除 |
tshock/backups/ |
TShock 自动备份的世界 |
server/ServerPlugins/ |
插件目录 |
server/、dotnet/ |
TShock 程序和 .NET 运行时,请勿删除 |
首次设置超级管理员
-
首次开机后,在「控制台」中找到
/setup验证码(一串数字)。也可以在「文件管理」中打开tshock/setup-code.txt查看。 -
用原版客户端进入服务器,按回车打开聊天框,输入:
/setup 验证码 -
创建自己的管理员账号(
owner是最高权限组之一):/user add 用户名 密码 owner -
登录这个账号:
/login 用户名 密码 -
再输入一次
/setup,提示设置系统已关闭即完成,验证码随即失效。
之后在同一台设备上用同名角色进服会自动登录。
账号与权限组
- 普通玩家可以用
/register 密码注册账号,注册后用/login 密码登录。 - 未登录的玩家属于
guest组,注册登录后默认属于default组。 - 给某个账号调整权限组:
/user group 用户名 组名,常用组有vip、newadmin、admin、trustedadmin、owner。 - 给权限组添加权限:
/group addperm 组名 权限。
角色名和已注册账号同名时,进服时要输入该账号的密码,而不是「服务器密码」。
旅行模式能力
旅行世界的研究(复制物品)、时间、天气、上帝模式等能力由权限组控制,默认只有 trustedadmin 及以上可用。要开放给所有玩家,在控制台执行:
group addperm guest tshock.journey.*
只开放研究功能用 tshock.journey.research。执行后立即生效。
安装插件
- 下载与当前 TShock 版本匹配的插件
.dll文件。 - 在「文件管理」中上传到
server/ServerPlugins/。 - 重启服务器。
插件的配置文件一般生成在 tshock/ 目录中。重新安装时自己上传的插件会保留;升级 TShock 后与新版本不匹配的插件会被跳过,需要换成插件作者发布的新版本。
config.json
tshock/config.json 可以在「文件管理」中编辑,修改后重启生效,部分设置也可以在控制台执行 reload 重新加载。以下三项由「环境变量」管理,每次开机都会被改写,请到「环境变量」中修改:
| 配置项 | 对应的环境变量 |
|---|---|
ServerPassword |
服务器密码 |
ServerPort |
由平台设置,请勿修改 |
MaxSlots |
最大玩家数 |
ReservedSlots(预留给管理员的位置)默认为 0。如果要设置,MaxSlots 加 ReservedSlots 不能超过 255。
欢迎语
TShock 下「欢迎消息」变量无效,进服欢迎语在 tshock/motd.txt,编辑保存后对之后进服的玩家立即生效。可用的占位符:
| 占位符 | 含义 |
|---|---|
%map% |
世界名 |
%players% |
在线玩家名单 |
%onlineplayers% |
在线人数 |
%serverslots% |
人数上限 |
%specifier% |
命令前缀 / |
自动备份
TShock 默认每 10 分钟把世界备份到 tshock/backups,保留 4 小时,可以在 config.json 的 BackupInterval(分钟)和 BackupKeepFor(分钟)调整。这些备份和实例在同一块磁盘上,重要的世界仍要定期下载到本地。
控制台命令
TShock 的控制台命令始终是英文,在面板「控制台」中输入时不需要加 /,在游戏聊天框中使用时要加 /。
| 命令 | 作用 |
|---|---|
help |
查看命令列表 |
who |
在线玩家 |
save |
立即保存世界 |
say 消息 |
全服广播 |
kick 玩家名 原因 |
踢出玩家 |
ban add 玩家名 原因 |
封禁玩家 |
user add 用户名 密码 组名 |
创建账号 |
reload |
重新加载配置 |
exit |
保存并关闭服务器 |
点「关机」时平台会发送 exit,世界保存后约 1 秒关闭。首次生成世界期间关机要等生成结束才会执行,超过 30 秒会被强制停止,此时不会留下存档,下次开机重新生成。
服务器语言
「服务器语言」决定控制台输出和 TShock 发给玩家的提示语言。它作为启动参数传入,修改后需要在「启动设置」中点「保存启动参数」重建,再开机才会生效。tshock/motd.txt 只在首次安装时按语言生成,之后改语言不会改变它。
升级 TShock
「TShock 版本」为 latest 时不会自动更新。TShock 发布新版本后,点实例卡片底部操作栏的「重新安装」即可升级,世界、tshock/ 目录、serverconfig.txt 和自己上传的插件都会保留。客户端版本要和新版 TShock 支持的泰拉瑞亚版本一致,例如 TShock 6.2.1 对应 1.4.5.8。
