FTB Quest Missing Item Fix

Description: English / 简体中文

FTB Quest Missing Item Fix

If you are a modpack creator, you may have encountered this situation:

After removing a mod, items from that mod in FTB Quests are replaced with Missing Items. Even if the mod is reinstalled later, those items are not automatically restored.

FTB Quest Missing Item Fix allows administrators to repair a specific chapter or reward table, restoring eligible Missing Items whose original items are available again.

Warning:

This mod is currently in Beta. Because it directly modifies FTB Quests SNBT files, please create an additional backup of your modpack or server directory before using it!

Before you start, make sure that:

· The mod containing the original items has been reinstalled and loaded successfully.
· The namespace of the target items has been added to the configuration allowlist.
· The player executing the command has at least permission level 2.

For example, to allow items from Create and Applied Energistics 2 to be restored:

recoverableNamespaces = ["create", "ae2"]

Enter resource namespaces here—not mod display names or complete item IDs.

Usage

Repair a Chapter: /ftbqfix chapter 

This command only searches: config/ftbquests/quests/chapters/, It will not search reward tables or any other directory.

Repair a Reward Table: /ftbqfix reward_table

This command only searches: config/ftbquests/quests/reward_tables/, It will not search chapters or any other directory.

Automated Execution:

This mod can be triggered using an FTB Quests Command Reward.

By default, repairs require confirmation. After running a chapter or reward table repair command, a confirmation prompt will appear in chat, allowing an administrator to continue by clicking the confirmation button.

To run repairs automatically through a Command Reward, disable confirmation in the configuration:

requireConfirmation = false

You must also ensure that the FTB Quests Command Reward has sufficient command permissions.

Safety Measures:

This mod directly modifies selected FTB Quests SNBT files, so it uses a strict repair process:

· Saves the current FTB Quests data.
· Locates the unique target file using its top-level ID.
· Checks for eligible Missing Items.
· Creates a byte-for-byte backup of the original file.
· Writes and validates a temporary file.
· Checks whether the original file was externally modified during processing.
· Safely replaces the target file.
·  Hot-reloads the quests and synchronizes all online clients.

Only valid Missing Items within the specified chapter or reward table are repaired. If the target cannot be found, is not unique, or contains no eligible items, the original file will not be modified.

FTB任务缺失物品修复工具

如果你是一名整合包作者，是否遇到过这种情况：

移除某个模组后，FTB任务中来自该模组的物品变成了缺失物品。即使之后重新安装该模组，这些物品也不会自动恢复。

这个模组可以修复指定的章节或奖励表，将其中确认已重新存在的缺失物品恢复为原来的真实物品。

警告：

模组目前仍处于Beta阶段。由于模组会直接修改FTB任务的.snbt文件，请额外备份整合包或服务器目录！

使用前请确保：

· 原物品所属模组已经重新安装并成功加载。
· 目标物品的命名空间已加入配置白名单。
· 执行命令的玩家拥有至少 2 级命令权限。

例如，在配置中允许恢复机械动力和应用能源2的物品：

recoverableNamespaces = ["create", "ae2"]

这里填写的是资源命名空间，不是模组显示名称或者完整物品ID。

使用方法：

修复章节中的缺失物品：/ftbqfix chapter <章节ID>

该命令只会搜索：config/ftbquests/quests/chapters/，不会搜索奖励表目录或其他目录。

修复奖励表：/ftbqfix reward_table <奖励表ID>

该命令只会搜索：config/ftbquests/quests/reward_tables/，不会搜索章节目录或其他目录。

自动化修复：

模组支持通过FTB任务的指令奖励执行修复命令。

默认配置下，修复操作需要二次确认。执行章节或奖励表修复命令后，聊天栏会显示确认提示，OP可以点击按钮继续操作。

如果需要通过指令奖励自动执行，请在配置中关闭二次确认：

requireConfirmation = false

同时，请确保FTB任务的指令奖励拥有足够的命令执行权限。

安全设计：

模组会直接修改选定的FTB任务的.snbt文件，因此采用了较为严格的安全流程：

1. 保存当前FTB任务数据。
2. 根据顶层 ID 定位唯一目标文件。
3. 检查其中可恢复的缺失物品。
4. 创建原文件的逐字节备份。
5. 写入并重新验证临时文件。
6. 检查处理期间原文件是否被外部修改。
7. 安全替换目标文件。
8. 热重载任务并同步在线客户端。

只有指定章节或奖励表中的有效缺失物品会被修复。找不到目标、目标不唯一或没有可恢复物品时，不会修改原文件。