--- @class ItemDefinition local ItemDefinition = { description = "", -- Can contain new lines. "\n" has to be used as new line character. -- See also: `get_description` in [`ItemStack`] short_description = "", -- Must not contain new lines. -- Defaults to nil. -- Use an [`ItemStack`] to get the short description, e.g.: -- ItemStack(itemname):get_short_description() groups = {}, -- key = name, value = rating; rating = . -- If rating not applicable, use 1. -- e.g. {wool = 1, fluffy = 3} -- {soil = 2, outerspace = 1, crumbly = 1} -- {bendy = 2, snappy = 1}, -- {hard = 1, metal = 1, spikes = 1} inventory_image = "", -- Texture shown in the inventory GUI -- Defaults to a 3D rendering of the node if left empty. inventory_overlay = "", -- An overlay texture which is not affected by colorization wield_image = "", -- Texture shown when item is held in hand -- Defaults to a 3D rendering of the node if left empty. wield_overlay = "", -- Like inventory_overlay but only used in the same situation as wield_image wield_scale = {x = 1, y = 1, z = 1}, -- Scale for the item when held in hand palette = "", -- An image file containing the palette of a node. -- You can set the currently used color as the "palette_index" field of -- the item stack metadata. -- The palette is always stretched to fit indices between 0 and 255, to -- ensure compatibility with "colorfacedir" (and similar) nodes. color = "#ffffffff", -- Color the item is colorized with. The palette overrides this. stack_max = 99, -- Maximum amount of items that can be in a single stack. -- The default can be changed by the setting `default_stack_max` range = 4.0, -- Range of node and object pointing that is possible with this item held liquids_pointable = false, -- If true, item can point to all liquid nodes (`liquidtype ~= "none"`), -- even those for which `pointable = false` light_source = 0, -- When used for nodes: Defines amount of light emitted by node. -- Otherwise: Defines texture glow when viewed as a dropped item -- To set the maximum (14), use the value 'minetest.LIGHT_MAX'. -- A value outside the range 0 to minetest.LIGHT_MAX causes undefined -- behavior. -- See "Tool Capabilities" section for an example including explanation tool_capabilities = { full_punch_interval = 1.0, max_drop_level = 0, groupcaps = { -- For example: choppy = {times = {2.50, 1.40, 1.00}, uses = 20, maxlevel = 2}, }, damage_groups = {groupname = damage}, -- Damage values must be between -32768 and 32767 (2^15) punch_attack_uses = nil, -- Amount of uses this tool has for attacking players and entities -- by punching them (0 = infinite uses). -- For compatibility, this is automatically set from the first -- suitable groupcap using the formula "uses * 3^(maxlevel - 1)". -- It is recommend to set this explicitly instead of relying on the -- fallback behavior. }, node_placement_prediction = nil, -- If nil and item is node, prediction is made automatically. -- If nil and item is not a node, no prediction is made. -- If "" and item is anything, no prediction is made. -- Otherwise should be name of node which the client immediately places -- on ground when the player places the item. Server will always update -- with actual result shortly. node_dig_prediction = "air", -- if "", no prediction is made. -- if "air", node is removed. -- Otherwise should be name of node which the client immediately places -- upon digging. Server will always update with actual result shortly. sound = { -- Definition of item sounds to be played at various events. -- All fields in this table are optional. --- @type SimpleSoundSpec breaks = nil, -- When tool breaks due to wear. Ignored for non-tools --- @type SimpleSoundSpec eat = nil, -- When item is eaten with `minetest.do_item_eat` --- @type SimpleSoundSpec punch_use = nil, -- When item is used with the 'punch/mine' key pointing at a node or entity --- @type SimpleSoundSpec punch_use_air = nil, -- When item is used with the 'punch/mine' key pointing at nothing (air) }, --- When the 'place' key was pressed with the item in hand --- and a node was pointed at. --- Shall place item and return the leftover itemstack --- or nil to not modify the inventory. --- The placer may be any ObjectRef or nil. --- default: minetest.item_place --- @type fun(itemstack:ItemStack, placer:Player|ObjectRef|nil, pointed_thing:pointed_thing) on_place = minetest.item_place, --- Same as on_place but called when not pointing at a node. --- Function must return either nil if inventory shall not be modified, --- or an itemstack to replace the original itemstack. --- The user may be any ObjectRef or nil. --- default: nil --- @type fun(itemstack:ItemStack, user:Player|ObjectRef|nil, pointed_thing:pointed_thing) on_secondary_use = nil, --- Shall drop item and return the leftover itemstack. --- The dropper may be any ObjectRef or nil. --- default: minetest.item_drop --- @type fun(itemstack:ItemStack, dropper:Player|ObjectRef|nil, pos:Position) on_drop = minetest.item_drop, --- Called when a dropped item is punched by a player. --- Shall pick-up the item and return the leftover itemstack or nil to not --- modify the dropped item. --- Parameters: --- * `itemstack`: The `ItemStack` to be picked up. --- * `picker`: Any `ObjectRef` or `nil`. --- * `pointed_thing` (optional): The dropped item (a `"__builtin:item"` --- luaentity) as `type="object"` `pointed_thing`. --- * `time_from_last_punch, ...` (optional): Other parameters from --- `luaentity:on_punch`. --- default: `minetest.item_pickup` --- @type fun(itemstack:ItemStack, picker:Player|ObjectRef|nil, pointed_thing:pointed_thing, time_from_last_punch, ...) on_pickup = minetest.item_pickup, --- default: nil --- When user pressed the 'punch/mine' key with the item in hand. --- Function must return either nil if inventory shall not be modified, --- or an itemstack to replace the original itemstack. --- e.g. itemstack:take_item(); return itemstack --- Otherwise, the function is free to do what it wants. --- The user may be any ObjectRef or nil. --- The default functions handle regular use cases. --- @type fun(itemstack:ItemStack, user:Player|ObjectRef|nil, pointed_thing:pointed_thing) on_use = nil, --- default: nil --- If defined, should return an itemstack and will be called instead of --- wearing out the item (if tool). If returns nil, does nothing. --- If after_use doesn't exist, it is the same as: --- function(itemstack, user, node, digparams) --- itemstack:add_wear(digparams.wear) --- return itemstack --- end --- The user may be any ObjectRef or nil. --- @type fun(itemstack:ItemStack, user:Player|ObjectRef|nil, node, digparams) after_use = nil, --- Add your own custom fields. By convention, all custom field names --- should start with `_` to avoid naming collisions with future engine --- usage. _custom_field = "< whatever >", }