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 运行时,请勿删除

首次设置超级管理员

  1. 首次开机后,在「控制台」中找到 /setup 验证码(一串数字)。也可以在「文件管理」中打开 tshock/setup-code.txt 查看。

  2. 用原版客户端进入服务器,按回车打开聊天框,输入:

    /setup 验证码
    
  3. 创建自己的管理员账号(owner 是最高权限组之一):

    /user add 用户名 密码 owner
    
  4. 登录这个账号:

    /login 用户名 密码
    
  5. 再输入一次 /setup,提示设置系统已关闭即完成,验证码随即失效。

之后在同一台设备上用同名角色进服会自动登录。

账号与权限组

  • 普通玩家可以用 /register 密码 注册账号,注册后用 /login 密码 登录。
  • 未登录的玩家属于 guest 组,注册登录后默认属于 default 组。
  • 给某个账号调整权限组:/user group 用户名 组名,常用组有 vip、newadmin、admin、trustedadmin、owner。
  • 给权限组添加权限:/group addperm 组名 权限。

角色名和已注册账号同名时,进服时要输入该账号的密码,而不是「服务器密码」。

旅行模式能力

旅行世界的研究(复制物品)、时间、天气、上帝模式等能力由权限组控制,默认只有 trustedadmin 及以上可用。要开放给所有玩家,在控制台执行:

group addperm guest tshock.journey.*

只开放研究功能用 tshock.journey.research。执行后立即生效。

安装插件

  1. 下载与当前 TShock 版本匹配的插件 .dll 文件。
  2. 在「文件管理」中上传到 server/ServerPlugins/。
  3. 重启服务器。

插件的配置文件一般生成在 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。