(中文)主页
肝帝熙恩 edited this page 2025-06-11 15:59:21 +08:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

TShock for Terraria


TShock安装指南

如果你需要更详细的中文教程与内容,请访问TShock 导航指南

TShock支持所有.NET 6兼容的系统。你可以在macOS、Windows或Linux的x86、x86_64、arm32、arm64和arm64e架构上运行TShock。借助非官方版本的.NETTShock也能在FreeBSD上成功运行。

通常情况下TShock至少需要1GB内存但使用替代图块提供程序可能会降低最低内存要求。你还需要一台性能较好的计算机。树莓派4可以用于搭建超小型服务器但实际上我们建议使用性能更强的设备。

  1. 如果你使用Windows 10或其他操作系统请安装.NET Runtime 6.x版本;如果你打算构建和开发插件,则需安装.NET SDK 6.x。如果你使用的是Windows 11 22H2或更高版本可能已经预装了.NET 6。

  2. 下载最新稳定版,然后使用你喜欢的解压缩工具解压文件夹。确保压缩包中的所有文件都解压到同一个文件夹中,这将是你服务器的存储位置。文件结构如下:

       TShock.Server.exe
       bin\
       |------HttpServer.dll
       |------ModFramework.dll
       |------OTAPI.dll
       |------OTAPI.Runtime.dll
       |------TerrariaServer.dll
       ServerPlugins\
       |------TShockAPI.dll
    
  3. 启动TShock.Server.exe(在其他平台上,在你选择的终端中输入./TShock.ServerTShock将启动并创建一个名为tshock的文件夹用于存储其数据库和配置文件。填写好启动选项后你就可以开始使用了。在后台TShock会为你创建一些文件夹我们稍后会再提到这些文件夹。

  4. 启动Terraria。通过IP连接到"多人游戏"服务器,如果你是在本地计算机上操作,请输入localhost。如果你是在其他计算机上操作则需要该计算机的IP地址。

  5. 在服务器控制台中查找"setup code"。在游戏聊天中输入/setup [代码](例如:/setup 12345),然后输入一个空格,然后在游戏聊天框中输入你在控制台看到的代码。这不是普通聊天,而是向服务器发送命令。这个命令会让你成为临时管理员。所有命令都以/!(使其静默)为前缀。

  6. 使用游戏内命令/user add [账号名称] [密码] owner(例如:/user add shank lovely-grilled-cheese owner)创建一个账号。这将赋予你服务器的所有者权限,你可以在以后根据自己的喜好进行更多配置。

  7. 使用/login [账号名称] [密码](例如:/login shank grilled-cheese)登录你新创建的账号。你应该会看到登录成功的消息。

  8. 使用/setup关闭认证系统你的服务器就可以开始初始使用了。TShock还会在新的tshock文件夹中创建几个文件。这些文件包括config.json(我们的主要配置文件)、sscconfig.json(服务器端角色配置文件)和tshock.sqlite(存放各种内容的数据库)。不要丢失你的tshock.sqlite文件否则你将不得不重新设置TShock。

  9. 要安装更多插件,将它们添加到ServerPlugins文件夹中。

升级指南

要将 TShock 5 升级到更高版本的 TShock 5只需下载最新版本解压文件然后将新版本中的所有文件与你现有安装的文件合并即可。tshock 文件夹包含用户数据,任何数据库变更都会自动执行,以使你的服务器与我们的最新功能保持同步。

从TShock 4升级

如果你是从TShock 4升级我们建议下载TShock的新版本tshock配置文件夹(包含sqlitedb文件以及json配置文件等复制到新服务器然后以这种方式启动新服务器。这是因为TShock 4中的许多文件已被移除不再需要。此外你现在需要运行的新二进制文件名为TShock.Server.exeTShock.Server,而不是TerrariaServer.exe

此外,在非 Windows 操作系统上,你不再需要安装 mono-completemono。这意味着你不能再使用 mono 命令启动服务器。在基于 Linux 的操作系统上,要运行新的二进制文件(TShock.Server),只需输入 ./TShock.Server

Apple Silicon

在Apple Silicon上你可以使用Rosetta 2运行TShock。这需要使用TShock及其相关插件的x64版本。请确保下载的是该版本。

  1. 请勿通过Homebrew安装dotnet请改为安装适用于x86的.NET 6 SDK
  2. 将x64版本的.NET添加到路径中export PATH=$PATH:/usr/local/share/dotnet/x64/
  3. 若尚未安装Rosetta 2请在终端中运行sudo softwareupdate --install-rosetta --agree-to-license
  4. 在终端中运行:xattr -r -d com.apple.quarantine TShock.Server此操作将移除阻止打开TShock的com.apple.quarantine隔离标志。
  5. 在终端中运行:./TShock.Server

如果你遇到类似这样的错误:

rosetta error: /var/db/oah/2c885558d6a2ecad3098d24447a4071ee679371339e97846cd3d03a3b2bf5ab4/
b45bd88b435cac41689c907440d5761e7182a4da0cbacaea5b1310d4f7e965d0/TShock.Server.aot:
attachment of code signature supplement failed: 1

请尝试重启你的Mac、重新下载服务器、安装更新或重新运行softwareupdate --install-rosetta

由于W^X内存保护和其他MonoMod尚未支持的功能TShock需要在Rosetta 2下运行。MonoMod仓库上有一个关于支持Apple Silicon的问题

实验版下载

要下载 TShock 的实验版本您有两种选择AppVeyor 构建版本或 GitHub 构建版本。请注意TShock 的实验版本是临时发布的,我们不提供技术支持。如果您需要报告问题,请明确说明您下载的构建版本来自哪个提交或分支、使用的服务内容,以及适用的构建编号。

AppVeyor点击History历史记录找到您想要的构建版本点击Commit Message提交信息然后点击Artifacts构建产物 标签页。您可以下载Debug调试版 或 Release发布版构建。不过AppVeyor 只保留 6 个月的构建记录,并且有带宽限制。

GitHub点击Actions操作然后在您想要的提交或分支上点击 "CI OTAPI3"。如果构建成功您可以Artifacts产物下载实验发布版或调试版构建包。您必须登录 GitHub 才能使用这些链接。