Difference between revisions of "Groups/Shared groups"

From Minetest Developer Wiki
Jump to navigation Jump to search
(Created page with "This a list of groups which are shared across multiple mods and games. They can be said to be more or less said as a de facto standard. == Creative Mode == * <code>not_in_cre...")
 
 
(14 intermediate revisions by one other user not shown)
Line 1: Line 1:
This a list of groups which are shared across multiple mods and games. They can be said to be more or less said as a de facto standard.
+
{{LuaTips}}
 +
This a list of groups which are shared across multiple mods and games, or groups which have been accepted by the community to have a standard meaning.
  
== Creative Mode ==
+
== List of shared groups ==
* <code>not_in_creative_inventory=1</code>: This item must not appear in the creative inventory (i.e. a special inventory in Creative Mode allowing players to access most items)
+
=== GUI-related ===
 +
* <code>not_in_creative_inventory=1</code>: This item must not appear in the [https://wiki.minetest.net/index.php?title=Creative_inventory creative inventory]
 +
* <code>not_in_craft_guide=1</code>: Crafting recipes which have this item as a result will not be shown in a [http://wiki.minetest.net/Crafting_guide crafting guide]. The item may still be shown as an ingredient.
  
== [http://wiki.minetest.net/Crafting_guide Crafting guide] mods ==
+
=== Colors ===
* <code>not_in_craft_guide=1</code>: Crafting recipes which have this item as a result will not be shown in the crafting guide. The item may still be shown as an ingredient. Used by the following mods: <code>craft_guide</code>, <code>zcg</code>, <code>unified_inventory</code>
+
For dyes, the color groups used in Minetest Game have been widely accepted. If you add a dye, you should add the appropriate groups. The groups have names like <code>basecolor_white</code>, <code>excolor_sky_blue</code> and <code>unicolor_dark_green</code>.
 +
 
 +
See [https://github.com/minetest/minetest_game/blob/master/game_api.txt game_api.txt], section “Dyes” for a detailed description and see the [https://github.com/minetest/minetest_game/tree/master/mods/dye/init.lua dye] mod for an example implementation.
 +
 
 +
=== Object classification ===
 +
These groups are used to classify something. The rating is assumed to be 1. These groups mean that the item in question ''is'' something. E.g. the group “<code>tree=1</code>” means the item ''is a'' tree trunk.
 +
 
 +
==== Basic nodes ====
 +
* <code>tree</code>: Tree trunk
 +
* <code>leaves</code>: Leaves, (pine) needles, and the like
 +
* <code>sand</code>: Sand
 +
* <code>sandstone</code>: Sandstone
 +
* <code>stone</code>: Stone or stone-like materials
 +
* <code>water</code>: Water (source or flowing)
 +
* <code>lava</code>: Lava (source or flowing)
 +
 
 +
==== Additional nodes ====
 +
* <code>wood</code>: Block of wooden planks
 +
* <code>wool</code>: Block of wool
 +
* <code>sapling</code>: Sapling
 +
* <code>flower</code>: Flower
 +
 
 +
=== Items and tools ===
 +
* <code>pickaxe</code>: Pickaxe
 +
* <code>shovel</code>: Shovel
 +
* <code>axe</code>: Axe
 +
* <code>sword</code>: Sword
 +
* <code>hoe</code>: Hoe (farming tool)
 +
 
 +
=== Damage groups ===
 +
* <code>fleshy</code>: ''De facto'' considered the “default” damage group for players and mobs when a game has no sophisticated damage system and everything is considered to be in the same “damage class”. Otherwise, intended for living things like animals and the player. This could imply some blood effects when hitting.
 +
[[Category:Misc]]

Latest revision as of 19:46, 25 January 2023

Mbox information.png This page contains community-written advice, tips, tricks or recommendations about modding. Your mileage may vary.

This a list of groups which are shared across multiple mods and games, or groups which have been accepted by the community to have a standard meaning.

List of shared groups

GUI-related

  • not_in_creative_inventory=1: This item must not appear in the creative inventory
  • not_in_craft_guide=1: Crafting recipes which have this item as a result will not be shown in a crafting guide. The item may still be shown as an ingredient.

Colors

For dyes, the color groups used in Minetest Game have been widely accepted. If you add a dye, you should add the appropriate groups. The groups have names like basecolor_white, excolor_sky_blue and unicolor_dark_green.

See game_api.txt, section “Dyes” for a detailed description and see the dye mod for an example implementation.

Object classification

These groups are used to classify something. The rating is assumed to be 1. These groups mean that the item in question is something. E.g. the group “tree=1” means the item is a tree trunk.

Basic nodes

  • tree: Tree trunk
  • leaves: Leaves, (pine) needles, and the like
  • sand: Sand
  • sandstone: Sandstone
  • stone: Stone or stone-like materials
  • water: Water (source or flowing)
  • lava: Lava (source or flowing)

Additional nodes

  • wood: Block of wooden planks
  • wool: Block of wool
  • sapling: Sapling
  • flower: Flower

Items and tools

  • pickaxe: Pickaxe
  • shovel: Shovel
  • axe: Axe
  • sword: Sword
  • hoe: Hoe (farming tool)

Damage groups

  • fleshy: De facto considered the “default” damage group for players and mobs when a game has no sophisticated damage system and everything is considered to be in the same “damage class”. Otherwise, intended for living things like animals and the player. This could imply some blood effects when hitting.