kercylan98
48 lines
1.9 KiB
Go
48 lines
1.9 KiB
Go
package game
|
|
|
|
import "github.com/kercylan98/minotaur/utils/huge"
|
|
|
|
// ItemContainer 物品容器
|
|
type ItemContainer[ItemID comparable, I Item[ItemID]] interface {
|
|
// GetSize 获取容器物品非堆叠数量
|
|
GetSize() int
|
|
// GetSizeLimit 获取容器物品非堆叠数量上限
|
|
GetSizeLimit() int
|
|
// SetExpandSize 设置拓展非堆叠数量上限
|
|
SetExpandSize(size int)
|
|
// GetItem 获取物品
|
|
GetItem(guid int64) (ItemContainerMember[ItemID, I], error)
|
|
// GetItems 获取所有非空物品
|
|
// - 物品顺序为容器内顺序
|
|
// - 空的容器空间将被忽略
|
|
GetItems() []ItemContainerMember[ItemID, I]
|
|
// GetItemsFull 获取所有物品
|
|
// - 物品顺序为容器内顺序
|
|
// - 空的容器空间将被设置为nil
|
|
// - 当容器非堆叠物品上限为0时，最后一个非空物品之后的所有空物品都将被忽略
|
|
// - 当容器非堆叠物品未达到上限时，其余空间将使用nil填充
|
|
GetItemsFull() []ItemContainerMember[ItemID, I]
|
|
// GetItemsMap 获取所有物品
|
|
GetItemsMap() map[int64]ItemContainerMember[ItemID, I]
|
|
// ExistItem 物品是否存在
|
|
ExistItem(guid int64) bool
|
|
// ExistItemWithID 是否存在特定ID的物品
|
|
ExistItemWithID(id ItemID) bool
|
|
// AddItem 添加物品
|
|
AddItem(item I, count *huge.Int) (guid int64, err error)
|
|
// DeductItem 扣除特定物品数量，当数量为0将被移除，数量不足时将不进行任何改变
|
|
DeductItem(guid int64, count *huge.Int) error
|
|
// TransferTo 转移特定物品到另一个容器中
|
|
TransferTo(guid int64, count *huge.Int, target ItemContainer[ItemID, I]) error
|
|
// CheckAllowAdd 检查是否允许添加特定物品
|
|
CheckAllowAdd(item I, count *huge.Int) error
|
|
// CheckDeductItem 检查是否允许扣除特定物品
|
|
CheckDeductItem(guid int64, count *huge.Int) error
|
|
// Remove 移除特定guid的物品
|
|
Remove(guid int64)
|
|
// RemoveWithID 移除所有物品ID匹配的物品
|
|
RemoveWithID(id ItemID)
|
|
// Clear 清空物品容器
|
|
Clear()
|
|
}
|