Skip to content
HoCha113 edited this page Jun 21, 2026 · 19 revisions

1727243702853欢迎来到 InnoVault Wiki!1727243710531

English version

这个项目是做什么的?

InnoVault(当前版本 1.9.89)是轻量级 API 前置模组,为 tModLoader 模组开发提供共享库。

目前包含以下核心系统:

系统 说明 文档
模组前置引用 build.txt 配置、DLL 引用与 IVaultLoader 接入 查看文档
VaultLoaden 自动资源加载 通过特性标签自动加载纹理、音效、着色器等资源 查看文档
PRT 粒子系统 自定义粒子,多种混合模式与分层绘制 查看文档
RenderHandle 渲染管线 客户端分层绘制与 RT 后处理;PRT / Models3D / Actor 的共享渲染基类 查看文档
TP 物块实体系统 物块处理器,网络同步与持久化 查看文档
UI 系统 UIHandle:多层渲染与独立逻辑更新 查看文档
SaveContent 保存系统 基于 NBT 的泛型数据持久化框架 查看文档
Override 覆写系统 物品/玩家/NPC 行为覆写(ItemOverride、PlayerOverride、NPCOverride) 查看文档
SyncVar 网络同步 基于特性标签的字段网络自动同步 查看文档
Actor 实体系统 独立于原生实体的自定义实体框架,支持多层绘制与网络同步 查看文档
DataModules 数据模块 通用模块化保存单元;多模块 NBT 聚合(任务、好感、叙事进度) 查看文档
Narrative 叙事系统 声明式对话 / 选项 / 弹窗;含 Policy 自动调度与进度存储 查看文档
Models3D 三维模型 OBJ / glTF 加载、蒙皮动画、分层 3D 渲染(RenderHandle 管线) 查看文档

建议阅读顺序

按以下顺序阅读可循序渐进掌握 InnoVault 各系统(每页底部 上一页 | 首页 | 下一页 与此顺序一致):

  1. 模组前置引用 — 配置 build.txt 与 DLL 引用
  2. 基础自动加载标签 — VaultLoaden 资源加载
  3. 基础PRT粒子系统 — 粒子效果
  4. RenderHandle渲染管线 — 分层绘制与后处理
  5. 基础TP物块实体 — 物块处理器
  6. 基础UI系统 — UIHandle 界面
  7. SaveContent保存系统 — NBT 持久化
  8. Override覆写系统 — 物品/玩家/NPC 覆写
  9. SyncVar网络同步 — 字段网络同步
  10. Actor实体系统 — 自定义实体
  11. DataModules数据模块 — 模块化保存
  12. Narrative叙事系统 — 对话与叙事
  13. Models3D三维模型系统 — 3D 模型与动画

进阶系统阅读建议: RenderHandle、DataModules、Narrative、Models3D 按「五分钟上手 → Level 1/2/3 → API 速查 → FAQ」组织。叙事进度持久化先读 DataModules 再读 Narrative;Models3D 前先读 RenderHandle。

如何使用这个模组?

build.txt 添加 modReferences = InnoVault@1.9,引用 InnoVault.dll 后即可调用其 API。详细步骤见 模组前置引用

示例模组

推荐参考 InnoVaultExample,含各系统的可运行示例。

注意事项

开发者可自由使用、修改 InnoVault 源码,但不要将源码直接打包进你的模组(违反开源协议)。

若内置 InnoVault.dll 而不设前置,请在模组简介中注明 InnoVault


导航

上一页 首页 下一页
Models3D三维模型系统 首页 模组前置引用

Clone this wiki locally