1
0
cuberite-2a/src/Item.h

239 lines
6.5 KiB
C
Raw Normal View History

// Item.h
// Declares the cItem class representing an item (in the inventory sense)
#pragma once
#include "Defines.h"
#include "Enchantments.h"
#include "WorldStorage/FireworksSerializer.h"
#include "Color.h"
// fwd:
class cItemHandler;
class cItemGrid;
class cColor;
namespace Json
{
class Value;
}
// tolua_begin
class cItem
{
public:
2014-02-11 05:30:11 -05:00
/** Creates an empty item */
cItem(void);
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Creates an item of the specified type, by default 1 piece with no damage and no enchantments */
cItem(
short a_ItemType,
char a_ItemCount = 1,
short a_ItemDamage = 0,
const AString & a_Enchantments = "",
const AString & a_CustomName = "",
const AStringVector & a_LoreTable = {}
);
2016-02-05 16:45:45 -05:00
// The constructor is disabled in code, because the compiler generates it anyway,
// but it needs to stay because ToLua needs to generate the binding for it
2017-08-28 09:36:23 -04:00
#ifdef TOLUA_EXPOSITION
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Creates an exact copy of the item */
2017-08-28 09:36:23 -04:00
cItem(const cItem & a_CopyFrom);
2016-02-05 16:45:45 -05:00
#endif
2016-02-05 16:45:45 -05:00
/** Empties the item and frees up any dynamic storage used by the internals. */
void Empty(void);
2016-02-05 16:45:45 -05:00
/** Empties the item and frees up any dynamic storage used by the internals.
TODO: What is the usage difference? Merge with Empty()? */
void Clear(void);
2016-02-05 16:45:45 -05:00
/** Returns true if the item represents an empty stack - either the type is invalid, or count is zero. */
bool IsEmpty(void) const
{
return ((m_ItemType <= 0) || (m_ItemCount <= 0));
}
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/* Returns true if this itemstack can stack with the specified stack (types match, enchantments etc.)
ItemCounts are ignored. */
bool IsEqual(const cItem & a_Item) const
{
return (
IsSameType(a_Item) &&
(m_ItemDamage == a_Item.m_ItemDamage) &&
(m_Enchantments == a_Item.m_Enchantments) &&
(m_CustomName == a_Item.m_CustomName) &&
(m_LoreTable == a_Item.m_LoreTable) &&
m_FireworkItem.IsEqualTo(a_Item.m_FireworkItem)
);
}
2016-02-05 16:45:45 -05:00
bool IsSameType(const cItem & a_Item) const
{
return (m_ItemType == a_Item.m_ItemType) || (IsEmpty() && a_Item.IsEmpty());
}
bool IsBothNameAndLoreEmpty(void) const
{
return (m_CustomName.empty() && m_LoreTable.empty());
}
bool IsCustomNameEmpty(void) const { return (m_CustomName.empty()); }
bool IsLoreEmpty(void) const { return (m_LoreTable.empty()); }
2014-02-11 05:30:11 -05:00
/** Returns a copy of this item with m_ItemCount set to 1. Useful to preserve enchantments etc. on stacked items */
cItem CopyOne(void) const;
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Adds the specified count to this object and returns the reference to self (useful for chaining) */
cItem & AddCount(char a_AmountToAdd);
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Returns the maximum damage value that this item can have; zero if damage is not applied */
short GetMaxDamage(void) const;
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Damages a weapon / tool. Returns true when damage reaches max value and the item should be destroyed */
bool DamageItem(short a_Amount = 1);
inline bool IsDamageable(void) const { return (GetMaxDamage() > 0); }
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Returns true if the item is stacked up to its maximum stacking. */
bool IsFullStack(void) const;
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Returns the maximum amount of stacked items of this type. */
2013-11-10 12:41:26 -05:00
char GetMaxStackSize(void) const;
// tolua_end
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Returns the cItemHandler responsible for this item type */
cItemHandler * GetHandler(void) const;
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Saves the item data into JSON representation */
void GetJson(Json::Value & a_OutValue) const;
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Loads the item data from JSON representation */
void FromJson(const Json::Value & a_Value);
2016-02-05 16:45:45 -05:00
2014-08-30 09:06:43 -04:00
/** Returns true if the specified item type is enchantable.
If FromBook is true, the function is used in the anvil inventory with book enchantments.
So it checks the "only book enchantments" too. Example: You can only enchant a hoe with a book. */
static bool IsEnchantable(short a_ItemType, bool a_FromBook = false); // tolua_export
2014-04-17 07:15:35 -04:00
/** Returns the enchantability of the item. When the item hasn't a enchantability, it will returns 0 */
int GetEnchantability(); // tolua_export
2014-04-17 07:15:35 -04:00
/** Randomly enchants the item using the specified number of XP levels.
Returns true if the item was enchanted, false if not (not enchantable / too many enchantments already). */
bool EnchantByXPLevels(int a_NumXPLevels); // tolua_export
2014-04-17 07:15:35 -04:00
/** Adds this specific enchantment to this item, returning the cost.
FromBook specifies whether the enchantment should be treated as coming
from a book. If true, then the cost returned uses the book values, if
false it uses the normal item multipliers. */
int AddEnchantment(int a_EnchantmentID, unsigned int a_Level, bool a_FromBook); // tolua_export
/** Adds the enchantments on a_Other to this item, returning the
XP cost of the transfer. */
int AddEnchantmentsFromItem(const cItem & a_Other); // tolua_export
/** Returns whether or not this item is allowed to have the given enchantment. Note: Does not check whether the enchantment is exclusive with the current enchantments on the item. */
bool CanHaveEnchantment(int a_EnchantmentID);
// tolua_begin
2016-02-05 16:45:45 -05:00
short m_ItemType;
char m_ItemCount;
short m_ItemDamage;
cEnchantments m_Enchantments;
AString m_CustomName;
// tolua_end
AStringVector m_LoreTable; // Exported in ManualBindings.cpp
// tolua_begin
2014-05-07 14:43:37 -04:00
int m_RepairCost;
2014-05-07 06:45:20 -04:00
cFireworkItem m_FireworkItem;
cColor m_ItemColor;
};
// tolua_end
/** This class bridges a vector of cItem for safe access via Lua. It checks boundaries for all accesses
Note that this class is zero-indexed!
*/
class cItems // tolua_export
: public std::vector<cItem>
{ // tolua_export
public:
cItems(const cItems &) = default;
cItems(cItems &&) = default;
cItems & operator = (const cItems &) = default;
cItems & operator = (cItems &&) = default;
/** Constructs a new instance containing the specified item. */
cItems(cItem && a_InitialItem);
// tolua_begin
2016-02-05 16:45:45 -05:00
2014-02-11 05:30:11 -05:00
/** Need a Lua-accessible constructor */
cItems(void) {}
2016-02-05 16:45:45 -05:00
cItem * Get (int a_Idx);
void Set (int a_Idx, const cItem & a_Item);
void Add (const cItem & a_Item) {push_back(a_Item); }
void Delete(int a_Idx);
void Clear (void) {clear(); }
2014-05-12 14:38:52 -04:00
size_t Size (void) const { return size(); }
2014-01-06 16:22:33 -05:00
void Set (int a_Idx, short a_ItemType, char a_ItemCount, short a_ItemDamage);
bool Contains(const cItem & a_Item);
bool ContainsType(const cItem & a_Item);
2014-01-06 16:22:33 -05:00
void Add (short a_ItemType, char a_ItemCount, short a_ItemDamage)
{
push_back(cItem(a_ItemType, a_ItemCount, a_ItemDamage));
}
2016-02-05 16:45:45 -05:00
/** Adds a copy of all items in a_ItemGrid. */
void AddItemGrid(const cItemGrid & a_ItemGrid);
// tolua_end
} ; // tolua_export
2014-02-11 05:30:11 -05:00
/** Used to store loot probability tables */
class cLootProbab
{
public:
cItem m_Item;
int m_MinAmount;
int m_MaxAmount;
int m_Weight;
} ;