InventorySystem.h

浏览该文件的文档.

#pragma once
 
// 库存操作静态入口 + 可插拔接纳 / 容量 / 堆叠 / 变更钩子。
//
// C++ 侧通过 register* 扩展；脚本侧通过 Bag 上的策略名字符串选用已注册规则。
 
#include "inventory/ItemTypes.h"
 
#include <functional>
#include <string>
#include <unordered_map>
#include <vector>
 
namespace eve::inventory {
 
class Bag;
class EquipmentSet;
 
class InventorySystem {
public:
    using AcceptFn =
        std::function<bool(const Bag &bag, const ItemDefinition &def, int quantity, std::string *reason)>;
    using CapacityFn =
        std::function<bool(const Bag &bag, const ItemDefinition &def, int quantity, std::string *reason)>;
    using StackFn =
        std::function<bool(const ItemStack &a, const ItemStack &b, const ItemDefinition &def)>;
    using ChangeHook = std::function<void(const InventoryChangeEvent &ev)>;
 
    static void registerAcceptRule(const std::string &name, AcceptFn fn);
    static void unregisterAcceptRule(const std::string &name);
    static bool hasAcceptRule(const std::string &name);
 
    static void registerCapacityPolicy(const std::string &name, CapacityFn fn);
    static void unregisterCapacityPolicy(const std::string &name);
    static bool hasCapacityPolicy(const std::string &name);
 
    static void registerStackRule(const std::string &name, StackFn fn);
    static void unregisterStackRule(const std::string &name);
    static bool hasStackRule(const std::string &name);
 
    static void registerChangeHook(const std::string &name, ChangeHook fn);
    static void unregisterChangeHook(const std::string &name);
    static bool hasChangeHook(const std::string &name);
 
    static void ensureBuiltins();
 
    static bool canAdd(Bag *bag, const std::string &itemId, int quantity, std::string *reason = nullptr);
    static int addItem(Bag *bag, const std::string &itemId, int quantity);
    static int removeItem(Bag *bag, const std::string &itemId, int quantity);
    static int removeAt(Bag *bag, int slot, int quantity);
    static bool swapSlots(Bag *bag, int slotA, int slotB);
    static bool moveSlot(Bag *bag, int fromSlot, int toSlot);
    static bool splitStack(Bag *bag, int slot, int quantity, int toSlot);
    static int transfer(Bag *from, Bag *to, const std::string &itemId, int quantity);
    static int transferSlot(Bag *from, int fromSlot, Bag *to, int quantity);
 
    static int countItem(const Bag *bag, const std::string &itemId);
    static int findItem(const Bag *bag, const std::string &itemId);
    static int findItemByTag(const Bag *bag, const std::string &tag);
    static float usedWeight(const Bag *bag);
    static float usedVolume(const Bag *bag);
    static int usedSlotCount(const Bag *bag);
    static void clearBag(Bag *bag);
 
    static bool equipFromBag(EquipmentSet *eq, const std::string &equipSlot, Bag *bag, int bagSlot);
    static bool unequipToBag(EquipmentSet *eq, const std::string &equipSlot, Bag *bag);
 
    static void pushEvent(InventoryChangeEvent ev);
    static void pollEvents(std::vector<InventoryChangeEvent> &out);
    static void clearEvents();
    static const std::vector<InventoryChangeEvent> &events();
 
    static int nextInstanceId();
 
private:
    static bool canStackTogether(const Bag &bag, const ItemStack &a, const ItemStack &b,
                                 const ItemDefinition &def);
    static bool checkAccept(const Bag &bag, const ItemDefinition &def, int quantity,
                            std::string *reason);
    static bool checkCapacity(const Bag &bag, const ItemDefinition &def, int quantity,
                              std::string *reason);
    static int freeSpaceInSlot(const Bag &bag, int slot, const ItemDefinition &def);
    static void emit(InventoryChangeEvent ev);
 
    static std::unordered_map<std::string, AcceptFn> &acceptRules();
    static std::unordered_map<std::string, CapacityFn> &capacityPolicies();
    static std::unordered_map<std::string, StackFn> &stackRules();
    static std::unordered_map<std::string, ChangeHook> &changeHooks();
    static std::vector<InventoryChangeEvent> &eventQueue();
    static int &instanceCounter();
    static bool &builtinsReady();
};
 
}  // namespace eve::inventory