冒险系统

该项目围绕游戏内管理进行设计。当某项功能会更改共享的游戏数据或服务器规则时，服务器保持权威性；仅客户端的展示功能则保留在客户端本地。配置界面使用 KineticCore 的 UI 和配置基础设施。

主要功能

• Curios 装备实用工具和可配置的饰品行为。
• 钱包、货币和商店系统，采用服务器权威规则。
• FTB Quests 物品/标签/NBT 绑定、快速导航和重复提交辅助工具。
• 根据维度、生物群系、结构、进度、物品栏和 Curios 装备筛选的情境提示。
• 语言感知的提示数据和游戏内可视化编辑。
• 可选集成 Refined Storage、Sophisticated Backpacks 和 JEI。

依赖项

类型	依赖
必需	Forge 47.4.0+
必需	KineticCore 26.9.8+
必需	Curios 5.10+
必需	FTB Library
必需	FTB Quests
必需	FTB Teams
可选	Refined Storage
可选	Sophisticated Backpacks
可选	JEI

访问与配置

• 通过其配置的 F6 入口打开 KineticCore 配置中心，然后选择 Adventure Systems。
• 服务器拥有的设置由服务器保存，并在功能需要客户端感知时同步。
• 仅客户端的展示设置保留在本地。
• 各个功能区域在下方记录了各自的数据/配置路径。
• 搜索、列表选择、物品/实体检查、工具提示和返回/导航控件在可用时复用 KineticCore UI 组件。

详细功能参考

Curios、钱包与商店

概述

Curios 与钱包系统 是一个饰品、钱包和钱包商店模组。它提供可配置的饰品机制、货币存储与兑换、商店交易，以及与任务、村民交易、Sophisticated Backpacks 和 Refined Storage 的可选集成。

主要功能

• 货币钱包，支持存入、取出、兑换、磁铁拾取和 HUD。
• 受保护/仅手动的货币。
• 可配置的钱包商店，支持买入/卖出条目、限制、任务要求和加权奖励池。
• 从玩家物品栏、Sophisticated Backpacks 和绑定的 Refined Storage 网络消耗材料。
• 钢铁之心饰品，具有战斗叠加和可配置的生命值/伤害行为。
• 失乐园饰品，具有基于食物多样性的机制。
• 悬浮背包饰品和击退相关行为。
• Curios 槽位/冲突处理和工具提示集成。

配置

config/kineticcore/curios.toml
config/kineticcore/currency_wallet_shop.toml
config/kineticcore/currency_wallet_shop_client.toml

 

功能参考

配置详情

项目	描述
钱包 HUD	为此客户端调整钱包余额叠加层。更改立即生效，且不会修改服务器设置。
编辑位置和缩放	打开实时预览编辑器。拖动叠加层以移动它，悬停时滚动以缩放它，或使用方向键进行精确移动。
Curio 与钱包机制	服务器权威的饰品机制和货币规则。单人游戏和多人游戏均通过活动服务器读取和保存；编辑需要权限等级 2。
钱包商店编辑器	通过服务器快照编辑钱包商店。远程编辑需要权限等级 2，服务器会验证并保存每一次更改。
打开商店编辑器	从当前服务器请求商店快照并直接进入编辑模式。无需装备钱包；服务器会拒绝权限不足的请求。
启用钢铁之心	控制钢铁之心是否注册为功能性饰品。需要重启游戏或服务器。
启用失乐园	控制失乐园是否注册为功能性饰品。需要重启游戏或服务器。
启用悬浮背包	控制悬浮背包是否注册为功能性饰品。需要重启游戏或服务器。
启用货币钱包	控制货币钱包及其货币功能是否启用。需要重启游戏或服务器。
蓄力冷却（秒）	蓄力攻击成功授予叠加层后的冷却时间。默认：3 秒。
额外伤害上限	由最大生命值转换的最终额外伤害的绝对上限。默认：3。
叠加生命值上限	可从叠加层获得的最大额外生命值，不包括基础生命值加成。默认：200。
每点生命值所需叠加层数	转换为 1 点最大生命值所需的叠加层数。必须至少为 1。默认：100。
基础生命值加成	装备钢铁之心时立即授予的最大生命值，无需叠加层。默认：10。
治疗倍率	蓄力攻击根据造成伤害进行治疗时使用的基础倍率。默认：2。
伤害窗口（刻）	蓄力后可应用额外伤害的持续时间。20 刻等于 1 秒。默认：5 刻。
每次命中最小叠加层数	一次成功蓄力攻击获得的最小随机叠加层数。不应超过最大值。默认：2。
每次命中最大叠加层数	一次成功蓄力攻击获得的最大随机叠加层数。不应低于最小值。默认：5。
每点生命值的伤害系数	最大生命值转换为额外伤害的比率。0.005 表示 0.5%，仍受伤害上限限制。
冲突饰品 ID	当装备任何列出的饰品时，钢铁之心被禁用。每行输入一个完整物品 ID，例如 enigmaticlegacy:cursed_ring。
最低营养值	营养值等于或低于此值的食物不计入多样性。值为 0 时忽略不恢复饥饿值的食物。
冲突饰品 ID	当装备任何列出的饰品时，失乐园被禁用。每行输入一个完整物品 ID。
额外腰带槽位	装备钱包时授予的额外 Curios 腰带槽位。更改后可能需要重新装备。
最大货币类型数	UI 和货币系统读取的最大货币类型数。运行时硬性上限为 10。
货币磁铁半径	装备钱包时收集货币掉落物的半径（以方块为单位）。值为 0 或更低时禁用磁铁。
磁铁检查间隔（刻）	附近货币扫描之间的间隔。较高的值减少服务器工作量，但增加拾取延迟；20 刻等于 1 秒。
货币定义	每行一个 item_id
单向兑换规则	每行一个 source_item_id->target_item_id 条目，用于找零和升级。需要时单独添加反向方向。
仅手动兑换货币	这些货币永远不会被村民交易、钱包商店或 FTB 虚拟支付自动消耗或拆分。每行输入一个物品 ID。

物品与 HUD

物品	描述
美食法则（无限成长）：	吞噬各种食物以永久获得最终伤害加成。

可编辑选项

• 余额叠加层
• 模块开关
• 钢铁之心
• 失乐园
• 货币钱包

配置默认值

键	默认值
currency_wallet.extraBeltSlots	1
currency_wallet.hudOffsetX	0
currency_wallet.hudOffsetY	0
currency_wallet.hudScale	0.75
currency_wallet.magnetIntervalTicks	10
currency_wallet.magnetRange	6.0
currency_wallet.maxCurrencyTypes	10
general.enable_currency_wallet	true
general.enable_heart_of_steel	true
general.enable_levitation_backpack	true
general.enable_paradise_lost	true
heart_of_steel.baseHealth	10.0
heart_of_steel.damageCap	3.0
heart_of_steel.damagePerHp	0.005
heart_of_steel.damageWindowTicks	5
heart_of_steel.growthInterval	3
heart_of_steel.healMultiplier	2.0
heart_of_steel.maxGain	5
heart_of_steel.maxHealthCap	200
heart_of_steel.minGain	2
heart_of_steel.stacksPerHp	100
paradise_lost.minNutrition	0

数据路径

主要配置/数据路径：

• config/kineticcore/curios.toml
• config/kineticcore/currency_wallet_shop.toml
• config/kineticcore/currency_wallet_shop_client.toml

FTB Quests 集成

概述

FTB Quests 集成 与 FTB Quests 集成。它将物品、物品标签和 NBT 变体绑定到任务页面，从物品工具提示提供直接的任务导航，并改进受支持的 FTB 物品任务的重复提交。

主要功能

• 绑定物品的任务跳转工具提示。
• G 打开默认链接任务。
• Alt + G 打开多任务选择器。
• 按物品设置收藏/默认任务选择。
• 物品、标签和模糊 NBT 绑定规则。
• 物品/标签/NBT 黑名单支持。
• F6 配置中心中的可视化绑定编辑器。
• 对符合条件的可重复 FTB ItemTasks 的多提交支持。
• 服务器端任务提交保持权威性。
• 用于工具提示和热键导航的本地客户端开关。
• 可选 JEI 集成。

配置

config/kineticcore/ftb_item_client.toml
config/kineticcore/ftb_item_quest_bindings.json
config/kineticcore/ftb_quest_favorites.json
config/kineticcore/ftb_item_blacklist.json

 

功能参考

配置详情

项目	描述
启用任务跳转	显示任务链接并为匹配的物品启用任务跳转快捷键。
打开物品绑定编辑器	编辑 FTB 任务物品绑定、收藏和黑名单条目。

GUI 与编辑器

项目	描述
submit	输入要提交的兑换次数。

物品与 HUD

物品	描述
收藏任务	右键点击将此任务设为默认打开目标
搜索任务	搜索与当前物品链接的任务。

可编辑选项

• [Mod Global]
• [Item Tag]

配置默认值

键	默认值
enableTaskJump	true

数据路径

主要配置/数据路径：

• config/kineticcore/ftb_item_blacklist.json
• config/kineticcore/ftb_item_client.toml
• config/kineticcore/ftb_item_quest_bindings.json
• config/kineticcore/ftb_quest_favorites.json

情境提示

概述

情境提示 是用于整合包、服务器、教程和故事驱动玩法的情境提示系统。提示可以在加载期间、游戏内或任何阶段出现，并可根据玩家当前维度、生物群系、结构、进度、物品栏物品和 Curios 装备进行筛选。

提示数据为服务器权威且具备语言感知。管理员可以通过游戏内可视化编辑器维护它，而无需手动编辑复杂的 JSON。

主要功能

多阶段提示

每个提示可以针对：

• loading
• game
• any

每个条目还有自己的显示持续时间。

情境条件

提示可能需要以下一项或多项：

• 维度
• 生物群系
• 结构
• 进度
• 物品栏物品
• Curios 物品

只有条件与当前玩家匹配的提示才有资格显示。

NBT 匹配

基于物品的条件支持：

• NONE：仅物品类型
• WEAK：弱 NBT 匹配
• STRONG：严格 NBT 匹配

这对于任务物品、自定义装备、枪械、饰品和其他 NBT 密集型物品非常有用。

按语言的提示文件

典型文件包括：

• tips_zh_cn.json
• tips_en_us.json

客户端报告其选择的语言，服务器发送匹配的运行时提示快照。当请求的语言文件不可用时，使用英语作为回退。

可视化编辑器

管理员可以：

• 添加、编辑、删除和搜索提示。
• 使用 Minecraft § 格式化代码编辑格式化文本。
• 设置阶段和持续时间。
• 选择维度、生物群系、结构和进度条件。
• 通过选择器添加物品栏物品和 Curios 要求。
• 循环切换 NBT 匹配模式。
• 通过右键操作移除条件。

服务器在接受数据之前会验证资源 ID、文本长度、NBT 语法、持续时间限制和条目数量。

服务器同步

• 提示数据从服务器加载。
• 编辑需要管理员权限。
• 服务器会再次验证每个保存请求。
• 更新的语言 JSON 在服务器端写入。
• 大型 JSON 负载使用 KineticCore 的压缩网络传输并带有大小限制。
• 更新的快照仅广播给使用相关语言的客户端。
• 集成单人游戏服务器使用相同的保存路径。

配置

基础设置：

• config/kineticcore/tips_settings.toml

提示目录：

• config/kineticcore/tips/

典型语言文件：

• config/kineticcore/tips/tips_zh_cn.json
• config/kineticcore/tips/tips_en_us.json

功能参考

配置详情

项目	描述
屏幕提示设置	控制加载、世界切换和暂停屏幕上的自定义提示。在此处编辑基本开关，并使用专用编辑器编辑提示内容和条件。
启用屏幕提示	禁用此项会隐藏自定义加载、世界切换和暂停提示，但不会删除提示数据。
打开提示编辑器	编辑提示文本、阶段、持续时间、生物群系/结构/维度/进度条件以及物品/Curios NBT 条件。在多人服务器上打开编辑器需要权限等级 2。

GUI 与编辑器

项目	描述
[Tip]	输入秒数（例如 5.0）

配置默认值

键	默认值
enableTips	true

数据路径

主要配置/数据路径：

• config/kineticcore/tips
• config/kineticcore/tips/
• config/kineticcore/tips/tips_en_us.json
• config/kineticcore/tips/tips_zh_cn.json
• config/kineticcore/tips_settings.toml

从源代码构建

• Minecraft：1.20.1
• Java：17
• ForgeGradle：6.0.24
• Gradle：项目固定使用 8.1.1 Wrapper；请勿直接使用 Gradle 9 导入。
• 本地开发 JAR 由 local_libs_dir 控制，可在 gradle.properties 中或通过项目属性覆盖。
• 典型构建命令：Windows 上为 gradlew.bat build，Linux/macOS 上为 ./gradlew build。
• 开发和发布构件使用 adventuresystems 作为当前项目标识符。