主页

TShock for Terraria

下载：TShock 的官方稳定版和预发布版本或实验版。
下载：可与 TShock 配合使用的插件，以及适用于 OTAPI、TSAPI 和 Terraria 的插件。
加入 Discord 服务器。
在 GitHub 讨论区交流，可寻求帮助、聊天或其他事宜。如果您不常用 Discord，这是获取帮助的最佳方式。
了解最新动态，请在 Twitter 上关注 @Pryaxis。
在 GitHub 上为项目贡献代码或参与开发。
可获取 TShock 和 TSAPI 的 Nuget 包。
如果是中文用户，可加入QQ群：816771079

TShock安装指南

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

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

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

如果你使用Windows 10或其他操作系统，请安装.NET Runtime 6.x版本；如果你打算构建和开发插件，则需安装.NET SDK 6.x。如果你使用的是Windows 11 22H2或更高版本，可能已经预装了.NET 6。
下载最新稳定版，然后使用你喜欢的解压缩工具解压文件夹。确保压缩包中的所有文件都解压到同一个文件夹中，这将是你服务器的存储位置。文件结构如下：
```
   TShock.Server.exe
   bin\
   |------HttpServer.dll
   |------ModFramework.dll
   |------OTAPI.dll
   |------OTAPI.Runtime.dll
   |------TerrariaServer.dll
   ServerPlugins\
   |------TShockAPI.dll
```
启动TShock.Server.exe（在其他平台上，在你选择的终端中输入./TShock.Server），TShock将启动并创建一个名为tshock的文件夹，用于存储其数据库和配置文件。填写好启动选项后，你就可以开始使用了。在后台，TShock会为你创建一些文件夹，我们稍后会再提到这些文件夹。
启动Terraria。通过IP连接到"多人游戏"服务器，如果你是在本地计算机上操作，请输入localhost。如果你是在其他计算机上操作，则需要该计算机的IP地址。
在服务器控制台中查找"setup code"。在游戏聊天中输入/setup [代码]（例如：/setup 12345），然后输入一个空格，然后在游戏聊天框中输入你在控制台看到的代码。这不是普通聊天，而是向服务器发送命令。这个命令会让你成为临时管理员。所有命令都以/或!（使其静默）为前缀。
使用游戏内命令/user add [账号名称] [密码] owner（例如：/user add shank lovely-grilled-cheese owner）创建一个账号。这将赋予你服务器的所有者权限，你可以在以后根据自己的喜好进行更多配置。
使用/login [账号名称] [密码]（例如：/login shank grilled-cheese）登录你新创建的账号。你应该会看到登录成功的消息。
使用/setup关闭认证系统，你的服务器就可以开始初始使用了。TShock还会在新的tshock文件夹中创建几个文件。这些文件包括config.json（我们的主要配置文件）、sscconfig.json（服务器端角色配置文件）和tshock.sqlite（存放各种内容的数据库）。不要丢失你的tshock.sqlite文件，否则你将不得不重新设置TShock。
要安装更多插件，将它们添加到ServerPlugins文件夹中。

升级指南

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

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

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

Apple Silicon

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

请勿通过Homebrew安装dotnet，请改为安装适用于x86的.NET 6 SDK。
将x64版本的.NET添加到路径中：export PATH=$PATH:/usr/local/share/dotnet/x64/。
若尚未安装Rosetta 2，请在终端中运行：sudo softwareupdate --install-rosetta --agree-to-license。
在终端中运行：xattr -r -d com.apple.quarantine TShock.Server，此操作将移除阻止打开TShock的com.apple.quarantine隔离标志。
在终端中运行：./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 才能使用这些链接。

主页

TShock安装指南

升级指南

从TShock 4升级？

Apple Silicon