2013-07-29 07:13:03 -04:00
|
|
|
|
|
|
|
#pragma once
|
|
|
|
|
|
|
|
#include "../Defines.h"
|
|
|
|
#include "../Item.h"
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
// fwd:
|
2021-05-05 09:25:10 -04:00
|
|
|
class cChunk;
|
2013-07-29 07:13:03 -04:00
|
|
|
class cWorld;
|
|
|
|
class cPlayer;
|
2017-08-07 03:08:27 -04:00
|
|
|
class cBlockPluginInterface;
|
2013-07-29 07:13:03 -04:00
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
class cItemHandler
|
|
|
|
{
|
|
|
|
public:
|
2014-07-23 10:32:09 -04:00
|
|
|
|
2018-01-05 06:28:06 -05:00
|
|
|
/** Actions that may cause durability of an item may be lost, where the
|
|
|
|
magnitude of the loss depends on the specific item used to perform the
|
|
|
|
action */
|
2014-07-23 10:32:09 -04:00
|
|
|
enum eDurabilityLostAction
|
|
|
|
{
|
|
|
|
dlaAttackEntity,
|
2018-01-05 06:28:06 -05:00
|
|
|
dlaBreakBlock,
|
|
|
|
dlaBreakBlockInstant,
|
2014-07-23 10:32:09 -04:00
|
|
|
};
|
|
|
|
|
2013-07-29 07:13:03 -04:00
|
|
|
cItemHandler(int a_ItemType);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Force virtual destructor */
|
2014-03-07 13:26:07 -05:00
|
|
|
virtual ~cItemHandler() {}
|
2014-12-24 01:20:17 -05:00
|
|
|
|
|
|
|
/** Called when the player tries to place the item (right mouse button, IsPlaceable() == true).
|
2020-04-21 16:19:22 -04:00
|
|
|
a_ClickedBlockPos is the (neighbor) block that has been clicked to place this item.
|
|
|
|
a_ClickedBlockFace is the face of the neighbor that has been clicked to place this item.
|
|
|
|
a_CursorPos is the position of the player's cursor within a_ClickedBlockFace.
|
2015-06-21 13:49:22 -04:00
|
|
|
The default handler uses GetBlocksToPlace() and places the returned blocks.
|
|
|
|
Override if the item needs advanced processing, such as spawning a mob based on the blocks being placed.
|
2021-05-05 09:25:10 -04:00
|
|
|
If the block placement is refused inside this call, it will automatically revert the client-side changes. */
|
|
|
|
void OnPlayerPlace(cPlayer & a_Player, const cItem & a_HeldItem, Vector3i a_ClickedBlockPosition, eBlockFace a_ClickedBlockFace, Vector3i a_CursorPosition);
|
2014-12-24 01:20:17 -05:00
|
|
|
|
2015-04-14 04:49:01 -04:00
|
|
|
/** Called when the player tries to use the item (right mouse button).
|
2020-04-21 16:19:22 -04:00
|
|
|
Descendants can return false to abort the usage (default behavior). */
|
2015-04-14 04:49:01 -04:00
|
|
|
virtual bool OnItemUse(
|
2020-04-21 16:19:22 -04:00
|
|
|
cWorld * a_World,
|
|
|
|
cPlayer * a_Player,
|
|
|
|
cBlockPluginInterface & a_PluginInterface,
|
|
|
|
const cItem & a_HeldItem,
|
|
|
|
const Vector3i a_ClickedBlockPos,
|
|
|
|
eBlockFace a_ClickedBlockFace
|
2015-04-14 04:49:01 -04:00
|
|
|
);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2020-04-21 16:19:22 -04:00
|
|
|
/** Called when the client sends the SHOOT status in the lclk packet (releasing the bow). */
|
|
|
|
virtual void OnItemShoot(cPlayer *, const Vector3i a_BlockPos, eBlockFace a_BlockFace)
|
2013-12-22 08:46:55 -05:00
|
|
|
{
|
2020-04-21 16:19:22 -04:00
|
|
|
UNUSED(a_BlockPos);
|
2013-12-22 08:46:55 -05:00
|
|
|
UNUSED(a_BlockFace);
|
|
|
|
}
|
2014-02-17 09:27:12 -05:00
|
|
|
|
2015-06-30 10:50:15 -04:00
|
|
|
/** Called every tick while the item is on the player's inventory (used by maps, for example) - For now, called only for equipped items */
|
2014-02-17 09:27:12 -05:00
|
|
|
virtual void OnUpdate(cWorld * a_World, cPlayer * a_Player, const cItem & a_Item)
|
|
|
|
{
|
|
|
|
UNUSED(a_World);
|
|
|
|
UNUSED(a_Player);
|
|
|
|
UNUSED(a_Item);
|
|
|
|
}
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2019-10-16 04:06:34 -04:00
|
|
|
/** Called while the player digs a block using this item */
|
2020-04-21 16:19:22 -04:00
|
|
|
virtual bool OnDiggingBlock(
|
|
|
|
cWorld * a_World, cPlayer * a_Player, const cItem & a_HeldItem,
|
|
|
|
const Vector3i a_ClickedBlockPos,
|
|
|
|
eBlockFace a_ClickedBlockFace
|
|
|
|
);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2020-04-21 16:19:22 -04:00
|
|
|
/** Called when a player attacks an entity with this item in hand. */
|
2014-07-23 10:32:09 -04:00
|
|
|
virtual void OnEntityAttack(cPlayer * a_Attacker, cEntity * a_AttackedEntity);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Called after the player has eaten this item. */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual void OnFoodEaten(cWorld *a_World, cPlayer *a_Player, cItem *a_Item);
|
2014-07-23 10:32:09 -04:00
|
|
|
|
2018-01-05 06:28:06 -05:00
|
|
|
/** Get the durability lost which the item will get, when a specified action
|
|
|
|
was performed. This is only relevant for uses where the damage taken may
|
|
|
|
depend on the item used. */
|
2014-07-26 07:26:14 -04:00
|
|
|
virtual short GetDurabilityLossByAction(eDurabilityLostAction a_Action);
|
2014-07-23 10:32:09 -04:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Returns the maximum stack size for a given item */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual char GetMaxStackSize(void);
|
|
|
|
|
|
|
|
struct FoodInfo
|
|
|
|
{
|
2014-04-18 15:09:44 -04:00
|
|
|
int FoodLevel;
|
2014-07-31 17:04:00 -04:00
|
|
|
double Saturation;
|
2013-07-29 07:13:03 -04:00
|
|
|
|
2014-08-29 08:44:01 -04:00
|
|
|
FoodInfo(int a_FoodLevel, double a_Saturation) :
|
2014-04-18 16:47:59 -04:00
|
|
|
FoodLevel(a_FoodLevel),
|
2014-07-31 17:04:00 -04:00
|
|
|
Saturation(a_Saturation)
|
2013-07-29 07:13:03 -04:00
|
|
|
{
|
|
|
|
}
|
|
|
|
} ;
|
|
|
|
|
2014-07-31 17:04:00 -04:00
|
|
|
/** Returns the FoodInfo for this item. (FoodRecovery and Saturation) */
|
2017-07-30 13:53:21 -04:00
|
|
|
virtual FoodInfo GetFoodInfo(const cItem * a_Item);
|
2014-07-31 17:04:00 -04:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Lets the player eat a selected item. Returns true if the player ate the item */
|
2014-07-31 17:04:00 -04:00
|
|
|
virtual bool EatItem(cPlayer * a_Player, cItem * a_Item);
|
2013-07-29 07:13:03 -04:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Indicates if this item is a tool */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual bool IsTool(void);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Indicates if this item is food */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual bool IsFood(void);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-06-07 16:45:00 -04:00
|
|
|
/** Indicates if this item is drinkable */
|
2014-06-08 20:06:15 -04:00
|
|
|
virtual bool IsDrinkable(short a_ItemDamage);
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2014-04-24 14:41:25 -04:00
|
|
|
/** Blocks simply get placed */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual bool IsPlaceable(void);
|
|
|
|
|
2014-04-30 18:47:57 -04:00
|
|
|
/** Can the anvil repair this item, when a_Item is the second input? */
|
2014-05-06 13:38:09 -04:00
|
|
|
virtual bool CanRepairWithRawMaterial(short a_ItemType);
|
2014-04-30 18:47:57 -04:00
|
|
|
|
2014-12-24 01:20:17 -05:00
|
|
|
/** Returns whether this tool / item can harvest a specific block (e.g. iron pickaxe can harvest diamond ore, but wooden one can't).
|
|
|
|
Defaults to false unless overridden. */
|
2013-07-29 07:13:03 -04:00
|
|
|
virtual bool CanHarvestBlock(BLOCKTYPE a_BlockType);
|
|
|
|
|
2016-11-06 13:30:19 -05:00
|
|
|
/** Returns the strength to break a specific block.
|
|
|
|
Defaults to 1 unless overriden. */
|
|
|
|
virtual float GetBlockBreakingStrength(BLOCKTYPE a_Block);
|
|
|
|
|
2013-07-29 07:13:03 -04:00
|
|
|
static cItemHandler * GetItemHandler(int a_ItemType);
|
|
|
|
static cItemHandler * GetItemHandler(const cItem & a_Item) { return GetItemHandler(a_Item.m_ItemType); }
|
|
|
|
|
|
|
|
static void Deinit();
|
2016-02-05 16:45:45 -05:00
|
|
|
|
2013-07-29 07:13:03 -04:00
|
|
|
protected:
|
2021-05-05 09:25:10 -04:00
|
|
|
|
2013-07-29 07:13:03 -04:00
|
|
|
int m_ItemType;
|
2014-07-17 16:15:34 -04:00
|
|
|
static cItemHandler * CreateItemHandler(int m_ItemType);
|
2013-07-29 07:13:03 -04:00
|
|
|
|
2021-05-05 09:25:10 -04:00
|
|
|
/** Performs the actual placement of this placeable item.
|
|
|
|
The descendant handler should call a_Player.PlaceBlock(s) supplying correct values for the newly placed block.
|
|
|
|
The default handler uses the stored block type and meta copied from the lowest 4 bits of the player's equipped item's damage value.
|
|
|
|
Handlers return what a_Player.PlaceBlock(s) returns, indicating whether the placement was successful. */
|
|
|
|
virtual bool CommitPlacement(cPlayer & a_Player, const cItem & a_HeldItem, Vector3i a_PlacePosition, eBlockFace a_ClickedBlockFace, Vector3i a_CursorPosition);
|
|
|
|
|
2013-08-30 08:24:03 -04:00
|
|
|
static cItemHandler * m_ItemHandler[E_ITEM_LAST + 1];
|
2014-07-17 16:15:34 -04:00
|
|
|
static bool m_HandlerInitialized; // used to detect if the itemhandlers are initialized
|
2013-07-29 07:13:03 -04:00
|
|
|
};
|
|
|
|
|
2014-07-17 16:15:34 -04:00
|
|
|
// Short function
|
2013-07-29 07:13:03 -04:00
|
|
|
inline cItemHandler *ItemHandler(int a_ItemType) { return cItemHandler::GetItemHandler(a_ItemType); }
|