GUILD.md 1.2 KB

GameItems模块

游戏物品管理核心模块

1. 核心功能

物品管理

  • 物品基础属性管理(名称、TID、类型、稀有度等)
  • 物品获取与消耗逻辑
  • 物品库存管理(包含库存变更事件)
  • 物品交易系统
  • 特殊物品效果实现(如BUFF效果、任务触发等)
  • 物品附加属性

宝箱系统

  • 宝箱类物品管理与开启机制
  • 宝箱内容配置与概率控制
  • 宝箱开启记录
  • 多物品掉落机制
  • 宝箱类型管理(普通、稀有、限定等)

过期管理

  • 全局过期时间(所有用户统一过期)
  • 用户特定过期时间(每个用户独立过期)
  • 过期物品自动清理

2. 模块交互

与用户模块

  • 用户物品展示
  • 等级奖励发放

与商店模块

  • 物品购买/出售
  • 物品信息展示

与任务模块

  • 任务奖励发放
  • 任务进度检查

与战斗模块

  • 消耗品使用
  • 战斗掉落发放

3. 核心特点

  1. 多物品宝箱系统

    • 支持多物品同时掉落
    • 可配置数量范围和概率
  2. 灵活的过期机制

    • 支持全局和用户级过期
    • 自动清理机制
  3. 属性扩展系统

    • 键值对属性存储
    • 支持复杂效果实现