👜 容器对象 API

在脚本引擎中，使用「容器对象」来操作拥有格子、可以储存和放置物品的容器的相关信息。
此处的容器是一种宽泛的概念，除了箱子、桶这些传统的容器之外，如玩家物品栏、羊驼携带的箱子等这些也统统可以作为「容器」处理，获取并使用容器对应的API

通过注册事件监听函数，或者调用某些返回容器对象的函数，来获取到BDS给出的容器对象
详见事件监听文档 - EventAPI

通过玩家对象的各个成员函数，来获取一个玩家物品栏、盔甲栏、末影箱对应的容器对象
详见玩家对象 API

对于可以容纳物品的方块，通过方块对象的成员函数，来他所对应的对应的容器对象
详见方块对象 API

注意：不要长期保存一个容器对象
当容器对象对应的实体 / 方块被销毁时，对应的容器对象将同时释放。因此，如果有长期操作某个容器的需要，请通过上述途径获取实时的容器对象

每一个容器信息对象都包含一些固定的对象属性。对于某个特定的容器对象ct，有以下这些属性

属性	含义	类型
ct.size	容器拥有的格子总数	`Integer`
ct.type	容器的类型名	`String`

每一个容器对象都包含一些可以执行的成员函数（成员方法）。对于某个特定的容器对象ct，可以通过以下这些函数对这个容器进行一些操作

注意！在修改完玩家物品栏对应的物品之后，不要忘记使用玩家对象的成员函数pl.refreshItems，刷新客户端显示的玩家物品栏

ct.addItem(item[, amount])

参数：
item : Item
待增加的物品对象
amount: Integer

（可选）欲添加物品数量，若提供此参数，item对象本身的count属性将被忽略。 - 返回值：是否成功增加 - 返回值类型：Boolean

ct.addItemToFirstEmptySlot(item)

和上述函数不同，此函数将不会堆叠至容器内现有的物品堆中

ct.hasRoomFor(item)

ct.removeItem(index,count)

ct.getItem(index)

此处获取的物品对象为引用。也就是说，修改此处返回的物品对象，或使用其API，就相当于直接操作容器中对应的物品

ct.setItem(index,item)

ct.getAllItems()

此处获取的物品对象均为引用。也就是说，修改此处返回的物品对象，或使用其API，就相当于直接操作容器中对应的物品

ct.removeAllItems()

ct.isEmpty()