Unknown Item: Difference between revisions

From Minetest
>Wuzzy
(Update behavior info)
>Wuzzy
(Update behavior info)
 

Latest revision as of 04:44, 20 February 2023


Unknown Item
Unknown Item.png
An item in Minetest
Item Type Internally-used item
Renewable N/A
Durability N/A
Stackable Yes (99)
Itemstring N/A

An Unknown Item is a pseudo-item in Minetest to represent an item of which the item definition is unknown. These items must never appear in the game, it's always an error when you encounter it.

Behaviour

Most types of world interactions are not possible. Dropping an unknown item is not possible. You can still store and move this item in inventories.

If you try to place, use or drop an unknown item, an error message will be shown to the server. This message is not visible if you are connected to a server as a normal player. The error message reveals the item's itemstring.

Internally, an unknown item still knows the “real” item it represents and the associated data. To fix problems with unknown item, first check the troubleshooting section. You can destroy unknown items with the pulverize server command.

Troubleshooting

A common reason for this item to appear is when you have previously activated a mod which added some new item, stored some of these items in an inventory, then later deactivated said mod. Now all items from this mod will appear as an unknown items. In this case, you can solve this simply by enabling the missing mod again. If you forgot to which mod this item belonged, rightclick with the item in hand to see its itemstring. The part before the colum is the mod name.

Another source of this item is a bug in mods or games or just general developer clumsiness. Developers of a game may have made a mistake or removed items intentionally without any replacement. Complain to the game authors if this happens, as this is generally considered poor development practice. If unknown items occour without you using any mods, this is almost certainly a bug.

Technical background

Technically, an unknown item still kinda acts like a normal item, and most item query and manipulation functions will still work. If you query the itemstring of an unknown item with e.g. itemstack:get_name(), you get the itemstring which the unknown item represents. To find out in Lua whether an item stack is unknown, call itemstack:is_known().

See also