Documentation
¶
Index ¶
- Variables
- type Armour
- func (a *Armour) Boots() item.Stack
- func (a *Armour) Chestplate() item.Stack
- func (a *Armour) Clear()
- func (a *Armour) Close() error
- func (a *Armour) Handle(h Handler)
- func (a *Armour) Helmet() item.Stack
- func (a *Armour) Inventory() *Inventory
- func (a *Armour) Items() []item.Stack
- func (a *Armour) Leggings() item.Stack
- func (a *Armour) Set(helmet, chestplate, leggings, boots item.Stack)
- func (a *Armour) SetBoots(boots item.Stack)
- func (a *Armour) SetChestplate(chestplate item.Stack)
- func (a *Armour) SetHelmet(helmet item.Stack)
- func (a *Armour) SetLeggings(leggings item.Stack)
- func (a *Armour) Slots() []item.Stack
- func (a *Armour) String() string
- type Handler
- type Inventory
- func (inv *Inventory) AddItem(it item.Stack) (n int, err error)
- func (inv *Inventory) Clear()
- func (inv *Inventory) Close() error
- func (inv *Inventory) ContainsItem(it item.Stack) bool
- func (inv *Inventory) ContainsItemFunc(n int, comparable func(stack item.Stack) bool) bool
- func (inv *Inventory) Empty() bool
- func (inv *Inventory) First(item item.Stack) (int, bool)
- func (inv *Inventory) FirstEmpty() (int, bool)
- func (inv *Inventory) FirstFunc(comparable func(stack item.Stack) bool) (int, bool)
- func (inv *Inventory) Handle(h Handler)
- func (inv *Inventory) Handler() Handler
- func (inv *Inventory) Item(slot int) (item.Stack, error)
- func (inv *Inventory) Items() []item.Stack
- func (inv *Inventory) RemoveItem(it item.Stack) error
- func (inv *Inventory) RemoveItemFunc(n int, comparable func(stack item.Stack) bool) error
- func (inv *Inventory) SetItem(slot int, item item.Stack) error
- func (inv *Inventory) Size() int
- func (inv *Inventory) Slots() []item.Stack
- func (inv *Inventory) String() string
- func (inv *Inventory) Swap(slotA, slotB int) error
- type NopHandler
Constants ¶
This section is empty.
Variables ¶
var ErrSlotOutOfRange = errors.New("slot is out of range: must be in range 0 <= slot < inventory.Size()")
ErrSlotOutOfRange is returned by any methods on inventory when a slot is passed which is not within the range of valid values for the inventory.
Functions ¶
This section is empty.
Types ¶
type Armour ¶
type Armour struct {
// contains filtered or unexported fields
}
Armour represents an inventory for armour. It has 4 slots, one for a helmet, chestplate, leggings and boots respectively. NewArmour() must be used to create a valid armour inventory. Armour inventories, like normal Inventories, are safe for concurrent usage.
func NewArmour ¶
NewArmour returns an armour inventory that is ready to be used. The zero value of an inventory.Armour is not valid for usage. The function passed is called when a slot is changed. It may be nil to not call anything.
func (*Armour) Chestplate ¶
Chestplate returns the item stack set as chestplate in the inventory.
func (*Armour) Clear ¶
func (a *Armour) Clear()
Clear clears the armour inventory, removing all items currently present.
func (*Armour) Handle ¶ added in v0.5.0
Handle assigns a Handler to an Armour inventory so that its methods are called for the respective events. Nil may be passed to set the default NopHandler. Handle is the equivalent of calling (*Armour).Inventory().Handle.
func (*Armour) Items ¶ added in v0.1.0
Items returns a slice of all non-empty armour items equipped.
func (*Armour) Set ¶ added in v0.5.0
Set sets all individual pieces of armour in one go. It is equivalent to calling SetHelmet, SetChestplate, SetLeggings and SetBoots sequentially.
func (*Armour) SetChestplate ¶
SetChestplate sets the item stack passed as the chestplate in the inventory.
func (*Armour) SetLeggings ¶
SetLeggings sets the item stack passed as the leggings in the inventory.
type Handler ¶ added in v0.3.0
type Handler interface {
// HandleTake handles an item.Stack being taken from a slot in the inventory. This item might be the whole stack or
// part of the stack currently present in that slot.
HandleTake(ctx *event.Context, slot int, it item.Stack)
// HandlePlace handles an item.Stack being placed in a slot of the inventory. It might either be added to an empty
// slot or a slot that contains an item of the same type.
HandlePlace(ctx *event.Context, slot int, it item.Stack)
// HandleDrop handles the dropping of an item.Stack in a slot out of the inventory.
HandleDrop(ctx *event.Context, slot int, it item.Stack)
}
Handler is a type that may be used to handle actions performed on an inventory by a player.
type Inventory ¶
type Inventory struct {
// contains filtered or unexported fields
}
Inventory represents an inventory containing items. These inventories may be carried by entities or may be held by blocks such as chests. The size of an inventory may be specified upon construction, but cannot be changed after. The zero value of an inventory is invalid. Use New() to obtain a new inventory. Inventory is safe for concurrent usage: Its values are protected by a mutex.
func New ¶
New creates a new inventory with the size passed. The inventory size cannot be changed after it has been constructed. A function may be passed which is called every time a slot is changed. The function may also be nil, if nothing needs to be done.
func (*Inventory) AddItem ¶
AddItem attempts to add an item to the inventory. It does so in a couple of steps: It first iterates over the inventory to make sure no existing stacks of the same type exist. If these stacks do exist, the item added is first added on top of those stacks to make sure they are fully filled. If no existing stacks with leftover space are left, empty slots will be filled up with the remainder of the item added. If the item could not be fully added to the inventory, an error is returned along with the count that was added to the inventory.
func (*Inventory) Clear ¶
func (inv *Inventory) Clear()
Clear clears the entire inventory. All items are removed, except for items in locked slots.
func (*Inventory) Close ¶
Close closes the inventory, freeing the function called for every slot change. It also clears any items that may currently be in the inventory. The returned error is always nil.
func (*Inventory) ContainsItem ¶ added in v0.6.0
ContainsItem checks if the Inventory contains an item.Stack. It will visit all slots in the Inventory until it finds at enough items. If enough were found, true is returned.
func (*Inventory) ContainsItemFunc ¶ added in v0.6.0
ContainsItemFunc checks if the Inventory contains at least n items. It will visit all slots in the Inventory until it finds n items on which the comparable function returns true. ContainsItemFunc returns true if this is the case.
func (*Inventory) Empty ¶
Empty checks if the inventory is fully empty: It iterates over the inventory and makes sure every stack in it is empty.
func (*Inventory) First ¶
First returns the first slot with an item if found. Second return value describes whether the item was found.
func (*Inventory) FirstEmpty ¶
FirstEmpty returns the first empty slot if found. Second return value describes whether an empty slot was found.
func (*Inventory) FirstFunc ¶ added in v0.6.0
FirstFunc finds the first slot with an item.Stack that results in the comparable function passed returning true. The function returns false if no such item was found.
func (*Inventory) Handle ¶ added in v0.3.0
Handle assigns a Handler to an Inventory so that its methods are called for the respective events. Nil may be passed to set the default NopHandler.
func (*Inventory) Handler ¶ added in v0.3.0
Handler returns the Handler currently assigned to the Inventory. This is the NopHandler by default.
func (*Inventory) Item ¶
Item attempts to obtain an item from a specific slot in the inventory. If an item was present in that slot, the item is returned and the error is nil. If no item was present in the slot, a Stack with air as its item and a count of 0 is returned. Stack.Empty() may be called to check if this is the case. Item only returns an error if the slot passed is out of range. (0 <= slot < inventory.Size())
func (*Inventory) Items ¶ added in v0.1.0
Items returns a list of all contents of the inventory. This method excludes air items, so the method only ever returns item stacks which actually represent an item.
func (*Inventory) RemoveItem ¶
RemoveItem attempts to remove an item from the inventory. It will visit all slots in the inventory and empties them until it.Count() items have been removed from the inventory. If less than it.Count() items were removed from the inventory, an error is returned.
func (*Inventory) RemoveItemFunc ¶ added in v0.6.0
RemoveItemFunc removes up to n items from the Inventory. It will visit all slots in the inventory and empties them until n items have been removed from the inventory, assuming the comparable function returns true for the slots visited. No items will be deducted from slots if the comparable function returns false. If less than n items were removed, an error is returned.
func (*Inventory) SetItem ¶
SetItem sets a stack of items to a specific slot in the inventory. If an item is already present in the slot, that item will be overwritten. SetItem will return an error if the slot passed is out of range. (0 <= slot < inventory.Size())
func (*Inventory) Size ¶
Size returns the size of the inventory. It is always the same value as that passed in the call to New() and is always at least 1.
func (*Inventory) Slots ¶ added in v0.4.0
Slots returns the all slots in the inventory as a slice. The index in the slice is the slot of the inventory that a specific item.Stack is in. Note that this item.Stack might be empty.
type NopHandler ¶ added in v0.3.0
type NopHandler struct{}
NopHandler is an implementation of Handler that does not run any code in any of its methods. It is the default Handler of an Inventory.
Source Files