// 使用道具事件
forward oo_on_gameitem_use(id, GameItem:item_o);

// 道具可不可以使用
// return PLUGIN_CONTINUE 为可以, PLUGIN_HANDLED 为不可以
forward oo_on_gameitem_can_use(id, GameItem:item_o);

// 初始化道具容器 (可自定义 GameItemManager 类别或物件, 用于如果你已经继承了 GameItemManager 类别并覆写原有类别的东西)
// @param class 容器的类别名称
// @param manager_o 容器的hash
//   若 manager_o 不是 @null, 将使用 manger_o 作为容器
//   否则使用 class 的 GetInstance() 方法来获取容器的hash
// @return 该物件的hash
stock GameItemManager:oo_gameitem_init(const class[]="GameItemManager", GameItemManager:manager_o=@null)

// 加入新道具到容器
// @param item_o 道具的hash
// @return 加入的索引位置
stock oo_gameitem_add(GameItem:item_o)

// 从容器中移除道具
// @param index 索引位置
// @param delete 是否也删除物件
//   若 delete=true 则同时删除物件
// @noreturn
stock oo_gameitem_remove(index, bool:delete=false)

// 从容器中获取道具的阵列
// @return 阵列的 array id
stock Array:oo_gameitem_get_items()

// 从容器中获取道具的数量
// @return 道具的数量
stock oo_gameitem_get_count()

// 从容器中以类别名称搜寻道具所在的索引位置
// @param class 类别的名称
// @return 索引位置
stock oo_gameitem_find_index(const class[])

// 从容器中以类别名称搜寻道具的hash
// @param class 类别的名称
// @return 道具的hash
stock GameItem:oo_gameitem_find_obj(const class[])

// 从容器中以指定索引位置存取道具的hash
// @param class 索引位置
// @return 道具的hash
stock GameItem:oo_gameitem_at(index)

// 从容器中移除所有道具
// @param delete 是否也删除物件
//   若 delete=true 则同时删除所有物件
// @noreturn
stock oo_gameitem_clear(bool:delete=false)

// 获取道具的名称
// @param item_o 道具的hash
// @param name 输出的字串
// @param maxlen 字串长度
// @noreturn
stock oo_gameitem_get_name(GameItem:item_o, name[], maxlen)

// 获取道具的注解
// @param item_o 道具的hash
// @param name 输出的字串
// @param maxlen 字串长度
// @noreturn
stock oo_gameitem_get_desc(GameItem:item_o, name[], maxlen)

// 获取道具的类别名称
// @param item_o 道具的hash
// @param name 输出的字串
// @param maxlen 字串长度
// @noreturn
stock oo_gameitem_get_class(GameItem:item_o, name[], maxlen)

// 获取道具的堆叠数量
// @param item_o 道具的hash
// @return 堆叠数量
stock oo_gameitem_get_stacks(GameItem:item_o)

// 建立背包实例的事件
// 在 forward 中 return PLUGIN_HANDLE 可以阻止原有的事件, 
// 然后可使用 oo_inventory_set_instance() 取代原有的实例
// 以上方法用于如果你继承了新的 PlayerInventory 类别, 想使用新的类别作为实例
forward oo_on_inventory_new(id);

// 背包的建构事件
forward oo_on_inventory_ctor(id);

// 背包的解构事件
forward oo_on_inventory_dtor(id);

// 背包给予道具事件
forward oo_on_inventory_give(id, GameItem:item_o, amount);

// 背包选项进行事件
// return PLUGIN_HANDLE 可阻止事件进行
forward oo_on_inventory_perform_option(id, option, slot);

// 给道具进背包
// @param id 玩家
// @param item_o 道具的hash
// @param amount 给予的数量
// @param check_space 是否先检查有没有足够空间, 若空间不足则不给予
// @return 给了多少个
stock oo_inventory_give_item(id, GameItem:item_o, amount=1, bool:check_space=false)

// 移除指定背包栏位的道具
// @param id 玩家
// @param slot 栏位的索引位置
// @param amount 移除的数量, 若为 0 则移除该栏位的全部
// @noreturn 
stock oo_inventory_remove_slot(id, slot, amount=0)

// 移除背包中的指定一种道具
// @param id 玩家
// @param item_o 道具的hash
// @param amount 移除的数量
// @return 移除了多少个 
stock oo_inventory_remove_item(id, GameItem:item_o, amount=1)

// 计算背包中指定一种道具的数量
// @param id 玩家
// @param item_o 道具的hash
// @return 计算后的数量
stock oo_inventory_count_item(id, GameItem:item_o)

// 整理背包
// @param id 玩家
// @noreturn 
stock oo_inventory_organize(id)

// 复制背包内容
// @param id 玩家
// @param inventory_o 要被复制的背包的hash
// @param resize 是否改变背包大小 (若玩家背包大小跟要被复制的背包大小不一样)
// @noreturn
stock oo_inventory_copy(id, PlayerInventory:inventory_o, bool:resize=false)

// 获取背包的大小
// @param id 玩家
// @noreturn
stock oo_inventory_get_size(id)

// 清空背包
// @param id 玩家
// @noreturn
stock oo_inventory_clear(id)

// 获取背包中指定栏位中的资料 (包括道具hash 和 堆叠数量)
// @param id 玩家
// @param slot_id 栏位的索引位置
// @param slot_data 栏位的资料 (详见 oo_inventory_const.inc 的 PlayerInventorySlot)
// @noreturn
stock oo_inventory_get(id, slot_id, slot_data[PlayerInventorySlot])

// 改变背包中指定栏位中的资料 (包括道具hash 和 堆叠数量)
// @param id 玩家
// @param slot_id 栏位的索引位置
// @param slot_data 栏位的资料 (详见 oo_inventory_const.inc 的 PlayerInventorySlot)
// @noreturn
stock oo_inventory_set(id, slot_id, slot_data[PlayerInventorySlot])

// 显示背包选单
// @param id 玩家
// @param page 显示页数
// @param time 显示时间 (若为 -1 则永久显示)
// @return 选单的id
stock oo_inventory_show_menu(id, page=0, time=-1)

// 获取背包的操作选项
// @param id 玩家
// @param options 输出到的阵列
// @noreturn
stock oo_inventory_get_options(id, options[MAX_INVENTORY_OPTIONS])

// 进行背包的选项
// @param id 玩家
// @param option_id 选项的id
// @param slot_id 背包栏位的id
// @return false 为进行失败, true 则为成功
stock bool:oo_inventory_perform_option(id, option_id, slot_id)

// 获取背包的实例
// @param id 玩家
// @return 实例的hash
stock PlayerInventory:oo_inventory_get_instance(id)

// 改变背包的实例
// @param id 玩家
// @param instance_o 实例的hash
// @noreturn
stock oo_inventory_set_instance(id, PlayerInventory:instance_o)

new GameItem:shit_o = oo_gameitem_find_obj("shit");
oo_inventory_give_item(id, shit_o, 5);