3 Copyright (C) 2010-2011 celeron55, Perttu Ahola <celeron55@gmail.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 2 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
15 You should have received a copy of the GNU General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #ifndef INVENTORY_HEADER
21 #define INVENTORY_HEADER
26 #include "common_irrlicht.h"
28 #include "mapnode.h" // For content_t
30 #define QUANTITY_ITEM_MAX_COUNT 99
32 class ServerActiveObject;
33 class ServerEnvironment;
40 InventoryItem(IGameDef *gamedef, u16 count);
41 virtual ~InventoryItem();
43 static InventoryItem* deSerialize(std::istream &is, IGameDef *gamedef);
45 virtual const char* getName() const = 0;
46 // Shall write the name and the parameters
47 virtual void serialize(std::ostream &os) const = 0;
48 // Shall make an exact clone of the item
49 virtual InventoryItem* clone() = 0;
50 // Return the name of the image for this item
51 virtual std::string getImageBasename() const { return ""; }
53 // Shall return an image of the item (or NULL)
54 virtual video::ITexture * getImage(ITextureSource *tsrc) const
56 // Shall return an image of the item without embellishments (or NULL)
57 virtual video::ITexture * getImageRaw(ITextureSource *tsrc) const
58 { return getImage(tsrc); }
60 // Shall return a text to show in the GUI
61 virtual std::string getText() { return ""; }
62 // Returns the string used for inventory
63 virtual std::string getItemString();
64 // Creates an object from the item, to be placed in the world.
65 virtual ServerActiveObject* createSAO(ServerEnvironment *env, u16 id, v3f pos);
66 // Gets amount of items that dropping one SAO will decrement
67 virtual u16 getDropCount() const { return getCount(); }
73 // Shall return true if the item can be add()ed to the other
74 virtual bool addableTo(const InventoryItem *other) const
83 void setCount(u16 count)
87 // This should return something else for stackable items
88 virtual u16 freeSpace() const
94 assert(m_count + count <= QUANTITY_ITEM_MAX_COUNT);
97 void remove(u16 count)
99 assert(m_count >= count);
107 // Whether it can be cooked
108 virtual bool isCookable() const {return false;}
109 // Result of cooking (can randomize)
110 virtual InventoryItem *createCookResult() const {return NULL;}
112 virtual float getCookTime() const {return 3.0;}
113 // Whether it can be burned (<0 = cannot be burned)
114 virtual float getBurnTime() const {return -1;}
116 // Eat, press, activate, whatever.
117 // Called when item is right-clicked when lying on ground.
118 // If returns true, item shall be deleted.
119 virtual bool use(ServerEnvironment *env,
120 ServerActiveObject *user){return false;}
127 class MaterialItem : public InventoryItem
130 MaterialItem(IGameDef *gamedef, std::string nodename, u16 count);
131 // Legacy constructor
132 MaterialItem(IGameDef *gamedef, content_t content, u16 count);
134 Implementation interface
136 virtual const char* getName() const
138 return "MaterialItem";
140 virtual void serialize(std::ostream &os) const
142 std::string nodename = m_nodename;
144 nodename = "unknown_block";
153 /*os<<"MaterialItem2";
155 os<<(unsigned int)m_content;
159 virtual InventoryItem* clone()
161 return new MaterialItem(m_gamedef, m_nodename, m_count);
164 video::ITexture * getImage(ITextureSource *tsrc) const;
166 std::string getText()
168 std::ostringstream os;
173 virtual bool addableTo(const InventoryItem *other) const
175 if(std::string(other->getName()) != "MaterialItem")
177 MaterialItem *m = (MaterialItem*)other;
178 if(m->m_nodename != m_nodename)
182 u16 freeSpace() const
184 if(m_count > QUANTITY_ITEM_MAX_COUNT)
186 return QUANTITY_ITEM_MAX_COUNT - m_count;
191 bool isCookable() const;
192 InventoryItem *createCookResult() const;
193 float getCookTime() const;
194 float getBurnTime() const;
196 Special properties (not part of virtual interface)
198 std::string getNodeName() const
199 { return m_nodename; }
200 content_t getMaterial() const;
202 std::string m_nodename;
206 An item that is used as a mid-product when crafting.
210 class CraftItem : public InventoryItem
213 CraftItem(IGameDef *gamedef, std::string subname, u16 count):
214 InventoryItem(gamedef, count)
219 Implementation interface
221 virtual const char* getName() const
225 virtual void serialize(std::ostream &os) const
233 virtual InventoryItem* clone()
235 return new CraftItem(m_gamedef, m_subname, m_count);
238 video::ITexture * getImage(ITextureSource *tsrc) const;
240 std::string getText()
242 std::ostringstream os;
247 ServerActiveObject* createSAO(ServerEnvironment *env, u16 id, v3f pos);
248 u16 getDropCount() const;
250 virtual bool addableTo(const InventoryItem *other) const
252 if(std::string(other->getName()) != "CraftItem")
254 CraftItem *m = (CraftItem*)other;
255 if(m->m_subname != m_subname)
259 u16 freeSpace() const
261 if(m_count > QUANTITY_ITEM_MAX_COUNT)
263 return QUANTITY_ITEM_MAX_COUNT - m_count;
270 bool isCookable() const;
271 InventoryItem *createCookResult() const;
272 float getCookTime() const;
273 float getBurnTime() const;
275 bool use(ServerEnvironment *env, ServerActiveObject *user);
280 std::string getSubName()
285 std::string m_subname;
288 class ToolItem : public InventoryItem
291 ToolItem(IGameDef *gamedef, std::string toolname, u16 wear):
292 InventoryItem(gamedef, 1)
294 m_toolname = toolname;
298 Implementation interface
300 virtual const char* getName() const
304 virtual void serialize(std::ostream &os) const
312 virtual InventoryItem* clone()
314 return new ToolItem(m_gamedef, m_toolname, m_wear);
317 std::string getImageBasename() const;
319 video::ITexture * getImage(ITextureSource *tsrc) const;
320 video::ITexture * getImageRaw(ITextureSource *tsrc) const;
323 std::string getText()
327 /*std::ostringstream os;
331 for(i=0; i<(65535-m_wear)/d; i++)
337 /*std::ostringstream os;
346 std::string getToolName()
354 // Returns true if weared out
355 bool addWear(u16 add)
357 if(m_wear >= 65535 - add)
369 std::string m_toolname;
376 InventoryList(std::string name, u32 size);
379 void serialize(std::ostream &os) const;
380 void deSerialize(std::istream &is, IGameDef *gamedef);
382 InventoryList(const InventoryList &other);
383 InventoryList & operator = (const InventoryList &other);
385 const std::string &getName() const;
391 /*bool getDirty(){ return m_dirty; }
392 void setDirty(bool dirty=true){ m_dirty = dirty; }*/
394 // Get pointer to item
395 const InventoryItem * getItem(u32 i) const;
396 InventoryItem * getItem(u32 i);
397 // Returns old item (or NULL). Parameter can be NULL.
398 InventoryItem * changeItem(u32 i, InventoryItem *newitem);
400 void deleteItem(u32 i);
402 // Adds an item to a suitable place. Returns leftover item.
403 // If all went into the list, returns NULL.
404 InventoryItem * addItem(InventoryItem *newitem);
406 // If possible, adds item to given slot.
407 // If cannot be added at all, returns the item back.
408 // If can be added partly, decremented item is returned back.
409 // If can be added fully, NULL is returned.
410 InventoryItem * addItem(u32 i, InventoryItem *newitem);
412 // Checks whether the item could be added to the given slot
413 bool itemFits(const u32 i, const InventoryItem *newitem);
415 // Checks whether there is room for a given item
416 bool roomForItem(const InventoryItem *item);
418 // Checks whether there is room for a given item aftr it has been cooked
419 bool roomForCookedItem(const InventoryItem *item);
421 // Takes some items from a slot.
422 // If there are not enough, takes as many as it can.
423 // Returns NULL if couldn't take any.
424 InventoryItem * takeItem(u32 i, u32 count);
426 // Decrements amount of every material item
427 void decrementMaterials(u16 count);
429 void print(std::ostream &o);
432 core::array<InventoryItem*> m_items;
446 Inventory(const Inventory &other);
447 Inventory & operator = (const Inventory &other);
449 void serialize(std::ostream &os) const;
450 void deSerialize(std::istream &is, IGameDef *gamedef);
452 InventoryList * addList(const std::string &name, u32 size);
453 InventoryList * getList(const std::string &name);
454 const InventoryList * getList(const std::string &name) const;
455 bool deleteList(const std::string &name);
456 // A shorthand for adding items.
457 // Returns NULL if the item was fully added, leftover otherwise.
458 InventoryItem * addItem(const std::string &listname, InventoryItem *newitem)
460 InventoryList *list = getList(listname);
463 return list->addItem(newitem);
468 const s32 getListIndex(const std::string &name) const;
470 core::array<InventoryList*> m_lists;
475 struct InventoryContext
477 Player *current_player;
484 struct InventoryAction;
486 class InventoryManager
490 virtual ~InventoryManager(){}
493 Get a pointer to an inventory specified by id.
498 virtual Inventory* getInventory(InventoryContext *c, std::string id)
500 // Used on the server by InventoryAction::apply and other stuff
501 virtual void inventoryModified(InventoryContext *c, std::string id)
503 // Used on the client
504 virtual void inventoryAction(InventoryAction *a)
508 #define IACTION_MOVE 0
510 struct InventoryAction
512 static InventoryAction * deSerialize(std::istream &is);
514 virtual u16 getType() const = 0;
515 virtual void serialize(std::ostream &os) const = 0;
516 virtual void apply(InventoryContext *c, InventoryManager *mgr) = 0;
519 struct IMoveAction : public InventoryAction
521 // count=0 means "everything"
523 std::string from_inv;
524 std::string from_list;
537 IMoveAction(std::istream &is);
544 void serialize(std::ostream &os) const
556 void apply(InventoryContext *c, InventoryManager *mgr);
560 Craft checking system
574 enum ItemSpecType type;
575 // Only other one of these is used
583 ItemSpec(enum ItemSpecType a_type, std::string a_name):
589 ItemSpec(enum ItemSpecType a_type, u16 a_num):
596 bool checkItem(const InventoryItem *item) const;
600 items: a pointer to an array of 9 pointers to items
601 specs: a pointer to an array of 9 ItemSpecs
603 bool checkItemCombination(const InventoryItem * const*items, const ItemSpec *specs);