Inventory System 是一个游戏背包/物品系统设计蓝图,来源于 thedivergentai/game-design-agentic-skills 技能库。它针对槽位管理、堆叠逻辑与基于资源的物品设计,提供了一套相对完整的参考实现与最佳实践说明。
用途与定位 该蓝图用于构建游戏中的背包系统,覆盖基于槽位的容器、物品堆叠、重量限制、装备系统以及合成系统等常见需求。资料称其参考了 Diablo、Resident Evil、Minecraft 等游戏的背包机制,适合需要网格背包、物品管理与装备逻辑的项目作为设计参考。
主要能力与核心架构 资料给出的核心类包括:Item(继承 Resource),带有 id、display_name、icon、max_stack、weight、description 等导出属性;Inventory(继承 Resource),管理 slots 数组、max_slots 与 max_weight,提供 add_item、remove_item、has_item、find_empty_slot、get_total_weight 等方法,并定义 item_added、item_removed、inventory_changed 信号;InventorySlot(继承 Resource)保存 item 与 amount,提供 is_empty、clear;Equipment(继承 Resource)管理 weapon、armor、accessory 三个槽位,提供 equip、unequip、get_total_stats。
物品添加逻辑会先尝试堆叠到已有未满槽位,再放入空槽位,并在物品栏满时返回失败。移除逻辑按槽位逐个扣减,数量归零时清空槽位。库存管理器还会通过 get_total_weight 计算总重量。
装备系统支持按槽位字符串(weapon、armor、accessory)装备与卸下物品,并在装备时返回旧物品、发射 equipment_changed 信号;get_total_stats 会汇总武器、护甲、饰品的属性,用于计算攻击、防御、速度等数值。
UI 集成采用信号驱动方式:InventoryUI 在 _ready 时连接 inventory_changed 信号并调用 refresh_ui,刷新时先清空 GridContainer 子节点,再为每个槽位创建 InventorySlotUI。
合成系统通过 CraftingRecipe(继承 Resource)定义 result、result_amount 与 requirements,can_craft 检查库存是否满足全部需求,craft 先移除材料再添加产物。
存档方面,资料提供了 save_inventory 与 load_inventory 的示例,分别把槽位序列化为字典并恢复。
使用方式与最佳实践 资料给出的最佳实践包括:使用 Resources 表示物品,而不是类实例;UI 采用信号驱动,由模型发射信号、UI 监听刷新;添加物品前始终先检查 max_stack 做堆叠;添加前校验重量限制。
资料还列出若干“绝不要做”的实践:不要用 Node 表示物品,否则 100 件物品会产生 100 个节点,带来内存问题;添加前不要忘记检查 max_stack,否则物品会静默消失,应先堆叠再创建新槽位;不要从 UI 直接修改库存,否则状态会不同步,应由 UI 发信号、模型更新、再通过信号刷新 UI;不要用 float 表示物品数量,因为浮点误差会导致计数错误,可数物品用 int,重量/体积限制才用 float;添加前不要跳过重量/容量校验;不要在循环内发射 inventory_changed,批量操作应只在循环结束后发射一次,避免 UI 反复刷新造成卡顿。
脚本资源 资料列出两个可用脚本:grid_inventory_logic.gd,用于支持俄罗斯方块式放置逻辑的网格背包;inventory_grid.gd,用于基于网格的背包控制器,包含拖放基础与自动排序。
适用场景 适用于使用 Godot 引擎开发、需要网格背包、物品堆叠、重量限制、装备与合成系统的游戏项目。
限制与未提供信息 资料未说明该蓝图的授权方式、依赖的 Godot 版本、安装方式、收费模式、支持平台以及实际运行效果。相关价格与获取条件暂未提供。