TerrariaModder - 1.4.5 Modding Framework

TerrariaModder - 1.4.5 Modding Framework

泰拉瑞亚Modder是一个轻量级的Mod框架，用于Terraria 1.4.5+。包含游戏内Mod菜单、每个Mod的配置、小部件库、键位重新绑定以及为Mod制作者提供完整文档的wiki。

实用工具

TerrariaModder - 1.4.5 Modding Framework预览查看大图

泰拉瑞亚模组制作者

一个面向泰拉瑞亚的轻量级模组框架，支持最新版本 1.4.5。无需安装 tModLoader，且不会影响原版存档。 要安装，请使用 TerrariaModder 存储库，这是 TerrariaModder 的官方启动器和安装程序。 有关手动操作说明，请参见下文。

YouTube视频

要运行的话，点击“Run Modded”（模组启动）或手动启动 TerrariaInjector.exe。 想切换回原版？直接运行你的普通 Terraria.exe 即可，无需卸载。 更多细节如下！

有疑问吗？在 Discord 上找我：https://discord.gg/VvVD5EeYsK 如果您喜欢这个模组，请点击上方的“推荐”以帮助他人找到它！

核心功能
  • 完整文档： 模组制作者可以查看完整源代码、维基及示例模组 Github
  • 游戏内模组菜单 (F6)：无需离开游戏即可启用/禁用模组、更改设置和重新绑定按键
  • 热重载：配置变更即时生效，无需重启
  • 按键绑定系统: 支持使用修饰键（Ctrl+键、Shift+键）进行按键重绑定
  • 原生色盲模式：正常、红绿色盲、蓝黄色盲和高对比度配色方案
  • 每个模组配置：每个模组都有自己的设置，且会在模组菜单中自动生成用户界面。
可用模组

这个初始版本中包含了许多模组，这些模组由框架作者创建和维护。 所有模组均可单独下载。只需安装你需要的部分。

存储枢纽 (F5)

将所有箱子连接成一个可搜索的界面。从合并仓库中制作物品，批量闪烁物品，通过升级系统提升范围，并通过中继点扩展距离。 下载 Storage Hub

种子实验室（F10）

从全部 15 种秘密种子中挑选单个特性。构建带有 FTW 陷阱+醉酒世界矿石+重混地形的自定义世界，或在游戏中切换敌人强度缩放和 Boss AI 变化。跨越世界生成和游戏玩法的 60 多项开关设置。 下载种子实验室

管理面板（反斜杠）

单人模式的快速作弊面板。无敌模式（F9）、即时恢复生命/魔力、移动速度倍率（1-10 倍）、带有预设和速度滑块的时间控制、传送到出生点/地牢/地狱/海滩/床、以及可配置的重生时间。 下载管理员面板

物品生成器（插入键）

可搜索的物品生成器，包含游戏中的所有物品。输入文字进行搜索，点击即可生成。 下载物品生成器

快捷键（波浪号、Home 键、End 键、K 键）

便捷操作快捷键：自动将火把放置在光标附近、瞬间召回、快速堆叠至附近箱子、标尺距离覆盖显示，以及可选的扩展快捷键栏第 11-20 格（通过数字小键盘）。 下载快速键位

FPS 解锁

通过平滑帧插值解锁《泰拉瑞亚》的帧率，使其超过 60 帧/秒。游戏逻辑保持在 60Hz，而渲染则以你的显示器刷新率运行。支持垂直同步、帧率限制或无限制模式。 下载 FPS 解锁

生物群落蔓延控制

阻止腐化、猩红和神圣蔓延至新地块。随时可通过模组菜单开关此功能。 下载“生物群落扩散控制”模组

随机化（数字键盘 /）

带有种子系统的模块化随机化器。可独立开关地随机化宝箱、掉落物、配方、商店、钓鱼、生成、物品属性、起始物品、重力及天气。 下载随机化模组

自动家具增益

自动从附近的增益站（水晶球、妖术桌、弹药箱、磨刀站、战争桌、蛋糕切片）施加增益效果。再也不用在每次战斗前逐个右键点击它们了。 下载自动家具增益

所有宠物都是存钱罐

右键点击你的宠物将其用作便携式存钱罐。适用于任何活跃的光宠或普通宠物。 下载所有宠物都是存钱罐

撤回鞭子堆叠削弱

恢复 1.4.5 版本之前的鞭子标记叠加效果。多个鞭子标记可以同时作用于 NPC 上，而不仅仅是最后一个标记。 下载“恢复鞭子堆叠削弱”

无介绍

跳过启动时的 Re-Logic 启动画面。让您更快进入标题画面。 下载无开场动画

调试工具 (Ctrl+`)

给模组开发者和高级用户使用的。包含游戏内控制台、HTTP 调试服务器、虚拟输入注入、游戏状态 API 以及用于无头操作的窗口管理功能。正常使用无需此功能。

创建你自己的模组

TerrariaModder 从底层设计就考虑到了模组制作者的便捷性。该框架使用 C# 编写，并采用 Harmony 进行运行时修补，因此你可以挂钩游戏中的任何方法，无需重新编译任何内容。 您开始所需的一切都已包含在内：

  • 完整维基：涵盖模组生命周期、配置系统、按键绑定、UI 控件、Harmony 补丁等内容的指南
  • 入门模板：包含在 GitHub 仓库中的即用型模组模板，助您几分钟内创建可运行模组
  • 示例模组：本页面上的每个模组都是开源的，并提供完整的源代码。请将它们作为真实开发模式的参考。
  • 内置 UI 库：面板、按钮、滑块、文本输入框、可滚动列表、标签页等，均支持自动色盲辅助功能。
  • 自动配置界面：定义您的配置字段，模组菜单会自动生成设置界面。
  • 调试工具：游戏内控制台、HTTP API 及游戏状态检查器，以加速开发

TerrariaModder Vault 现已可用——在一个地方安装、更新和管理你所有的模组。

安装

使用 TerrariaModder Vault 安装

手动安装： 如果您愿意，也可以手动安装：

  1. 从本页下载 Core 压缩包
  2. 将其解压到你的泰拉瑞亚文件夹（即 Terraria.exe 所在的文件夹）中
  3. 运行 TerrariaInjector.exe 而不是 Terraria.exe
  4. 在游戏中按 F6 打开模组菜单

解压后，您的文件夹应如下所示：

泰拉瑞亚/
+-- Terraria.exe
+-- TerrariaInjector.exe      （新增）
+-- TerrariaModder/           (新建)
+-- core/
|   +-- TerrariaModder.Core.dll
|   +-- 依赖项/
+-- mods/

安装模组

使用 TerrariaModder Vault 安装模组（推荐），或手动操作：从此页面或上述链接的模组独立页面下载模组压缩包，并将其解压至 Terraria 文件夹。每个模组会在 TerrariaModder/mods/ 下添加一个文件夹。

常见问题解答

这个能在 Terraria 1.4.5 中使用吗？

  • 是的，TerrariaModder 是为最新版本的《泰拉瑞亚》（1.4.5）构建的。它将随着未来的补丁保持更新。

我需要 tModLoader 吗？

  • 不，TerrariaModder 与 tModLoader 完全分离。它直接作用于原版泰拉瑞亚。

这会导致我的存档损坏吗？

  • 不，TerrariaModder 不会修改任何游戏文件。您的存档永远不会被更改，您只需直接运行 Terraria.exe 即可随时卸载，甚至无需移除任何模组。如果您不使用补丁注入器，原版泰拉瑞亚会自动加载，无需任何修改。要运行模组版，请通过我们的 exe 启动。

我可以在多人游戏中使用这个吗？

  • 泰拉瑞亚模组修改器仅为客户端模组。仅影响玩家自身的模组（如按键绑定、界面覆盖和增益效果）可在多人游戏中正常使用。修改共享游戏状态（宝箱、时间、NPC）的模组目前仅限单人模式。每个模组页面会标注其多人游戏状态。完整的多人游戏支持正在开发中，将在未来的更新中尽快加入。

我该如何卸载？

  • 运行 Terraria.exe 而不是 TerrariaInjector.exe。如果你不使用注入器正常启动游戏，将不会进行任何补丁修改，游戏会正常启动。所有修改均非永久性的。
  • 要完全移除，请删除添加到 Terraria 文件夹中的 TerrariaInjector.exe 和 TerrariaModder 文件夹。

我可以和 tModLoader 模组一起使用吗？

  • 《泰拉瑞亚》模组制作者和 tModLoader 是两个独立的模组系统，不能同时使用。您可以同时安装两者，但每次只能运行其中一个。
  • 具体来说——tModLoader 是泰拉瑞亚的一个重新编译版本，拥有自己的可执行文件。而 TerrariaModder 则直接修补原版泰拉瑞亚，无需单独安装。

你可以在未来的更新中添加 X 功能吗？

  • 或许吧！我总会考虑各种建议。在 Discord 上留言告诉我你想看到什么内容吧。
需求
  • 泰拉瑞亚 1.4.5+
  • Windows 10 或 11
多人游戏

泰拉瑞亚模组仅支持客户端。只影响自身玩家（如按键绑定、UI 和增益效果）的模组在多人游戏中可以正常工作。修改共享游戏状态（如箱子、时间、NPC）的模组目前仅限单人模式使用。每个模组页面会标注其多人游戏状态。未来更新计划实现完整的多人游戏支持。

文档

完整维基 — 指南、教程、API 参考和模组攻略

源代码

GitHub 仓库 框架和所有模组的完整源代码。包含用于创建你自己的模组的模组模板和文档。

致谢

特别感谢 ConfuzzedCat 提供的 TerrariaInjector，正是这个注入器使得整个项目得以实现。 使用 Harmony（补丁）和 Mono.Cecil（程序集检查）构建。 我的所有模组始终免费，但如果你想支持开发，点这里给我买杯咖啡 :)