礼包系统与任务奖励

使用 /gifts 打开独立礼包库，查看礼包状态、绑定任务、必得物品、随机候选与无线 EU；不需要先建造猫猫售货机。普通玩家可查看奖励并领取属于自己的已解锁礼包。

礼包有三种触发方式：首次登录自动发放；完成绑定的 BetterQuesting 任务后解锁、由玩家手动领取；完成绑定任务后自动发放。解锁模式也要求任务已经完成，并非任务刚出现在任务书中就能领取。

新增的首次登录礼包只面向之后首次进入的玩家，不会向已经记录过登录的账号追发。默认 starter 继续兼容原来的新手领取标记。

手动礼包可在界面点击领取，也可使用 /gifts claim <id>。礼包包裹进入个人背包；暂时没有空位时保留待发放状态，腾出位置后重试。手持本人包裹右击开启，奖励依照授权时保存的清单发放。

生存与创造模式均按服务端授权快照的完整数量发奖，手持槽中的第一份奖励也保留其配置数量；背包不足时继续按包裹中的剩余奖励分次领取。

大礼包可分次取出：一次装不下的剩余奖励保留在包裹中，腾出背包后继续右击。全部物品取完后才完成开启与无线 EU 入账；包裹不会把放不下的奖励直接丢到地上。

任务完成时会记录当时 BetterQuesting 队伍的成员，包括离线成员；他们登录后再获得包裹，或在解锁模式下手动领取。登录时也会检查已完成的任务。BQ 缺失、任务不存在或查询失败时，任务礼包保持锁定。

领取记录按玩家与礼包 ID 保存。改名、编辑礼包或之后更换队伍不会重新发放；已有授权保留奖励快照。物品归授权玩家，无线 EU 归授权当时确定的 GT 无线电网身份，后续换队不会改变这笔奖励的目标。

默认提供新手、蒸汽、LV、MV、HV、EV、IV、LuV 八个礼包，对应稳定 ID 为 starter、steam、lv、mv、hv、ev、iv、luv。新手礼包首次登录自动发放，其余七个在完成整合包基线对应的时代入口任务后自动发放；更换任务包时应由管理员核对任务 ID。

默认 starter 必得面包 16、火把 64、床 1、箱子 8、普通猫猫币 1，并从五种候选功能戒指中不重复抽两种，各一枚。蒸汽礼包必得青铜镀层砖块 16、巨型粗青铜流体管道（GT++ Potin，pipeHuge）32、粗青铜流体管道（GT++ Potin，普通 pipeMedium 规格）256、高压太阳能锅炉（GT 高级太阳能锅炉）2。LV、MV、HV、EV、IV、LuV 各档礼包均为同电压机器外壳 4、电动泵 4、传送带模块 4、电动马达 8。时代礼包仅使用这些固定奖励；默认无线 EU 为零，管理员可设置非负整数奖励。

旧新手礼包清单会迁移到 starter，旧领取记录继续防重复；已经持有的旧包裹仍可开启。各服已修改的清单以该服礼包库为准。

礼包与贸易预设管理共用 config/gtit/default_content.cfg 的 permissions.managementOpLevel，专服默认要求 OP2，可设为 2–4，修改后重启生效。单人存档仅所有者可管理；恢复默认贸易仍需单人所有者或专服 OP4。礼包编辑器可新建、修改、删除礼包，设置 ID、名称、触发方式、任务 ID、无线 EU、启用状态，以及必得与随机奖励。物品编辑支持数量、metadata 与 NBT；保存前应检查奖励预览。

绑定区域展示 32 款已注册实体礼盒，选择后保存载体绑定与对应图标。全部采用 24×24 静态 RGBA 材质；图集展示原始资源，不是游戏界面运行截图。

礼包定义保存在 config/gtit/gifts.json，发放记录属于世界存档。打开管理窗口时有尚未忽略的默认更新才询问是否更新默认礼包？，只提供更新 / 暂不。暂不忽略当前内容版本，未来新版再问；关闭默认库时不弹出，也不会自动启用。

32 款礼盒均已注册为独立实体物品；八个默认礼包绑定对应载体，其余二十四款没有默认奖励定义，供管理员自建礼包后绑定。shellKey 决定正式发放的物品，奖励仍由服务器授权快照决定。

非新手裸壳不能直接开启；新手礼盒保留无发放 NBT 时可重复补发的兼容例外。有效授权包、旧包装和跨载体校验详见实体礼包载体与绑定文章。

作者默认库仍为 V2。选择更新会恢复全部八个作者默认定义，包括已修改或删除项；自建礼包、领取记录和已发奖励快照保留。旧的跳过选择继续保留；此前保存的关闭通知设置迁移为忽略当时已评估的内容版本，未来新版本仍可提示。

奖励幽灵槽保留所设物品数量与 NBT，不消耗原物品。单条奖励数量为 1–4096；单个物品 NBT 的二进制上限为 24 KiB，文本编辑另限 16384 字符并检查网络字节长度。非法或超限内容会被拒绝，不能通过静默删除 NBT 把它变成另一件奖励。

无法无损表示为可编辑文本的 NBT 保留原值并显示保留提示。需要改变此类 NBT 时，先替换物品或清除该行；不要把提示文字当成 SNBT 输入。未能保存的编辑不会覆盖原奖励。