Initial 0.2 release candidate
[minetest_treasurer.git] / GROUPS_AND_PRECIOUSNESS
blob58b652db53ea07601fd7588ba1d772f0be7b6858
2 If you wish to register treasures to Treasurer, it is recommended to assign the treasurer to a Treasurer group.
3 Treasurer also requires you to assign each
5 It is not possible to assign a treasure to multiple groups. If you think a treasurer fits to two groups, create
6 two seperate treasure definitions instead. But try to keep it as an exception.
8 Think of treasurer groups as drawers for treasurers to put into.
10 This file contains some guidelines for Treasurer groups and there are even guidelines for preciousness levels.
11 Keep in mind these are only guidelines
13 Treasurer suggests to use the following standard Treasurer groups:
15 crafting_component:
16         generic group for components in crafting recipes. If it is primarily a component for food, use raw_food instead.
17         preciousness is based roughly on the preciousness of items it can create
19 fuel:
20         fuel for furnaces
21         preciousness is based on burning time 
23 food:
24         can be eaten and restores health
25         preciousness should equal the number of hearts restored, but not higher than 7.
27 raw_food:
28         food which is not fully processed and is not (quite) ready to be eaten.
30 melee_weapon:
31         primarily used to damage close foes, i.e. a sword
32         preciousness is based on attack speed and damage
34 ranged_weapon:
35         primarily used to damage far away foes, 
36         preciousness is based on attack speed, damage and range
38 tool:
39         a tool for other uses.
40         preciousness is hard to determine; at least is should base on the number of uses.
41         
43 minetool:
44         a tool to destroy blocks. Includes pickaxes, axes, shovels, …
45         preciousness is based on power, number of uses and speed
47 deco:
48         primarily just a decorational thing to place
49         preciousness is based on beauty, highly subjective
51 light:
52         is a light source
53         preciousness is based on the brightness. For the maximum brightness, preciousness should be 3.
55 building_block:
56         A block for buildings. Includes stairs, slabs, fences and similar things.
57         Excludes all natural blocks.
58         preciousness should be rougly based on the “cost” to craft the block.
60 seed:
61         seeds and saplings
62         preciousness is based on the “usefulness” of what can grow from the seed.
64 transport_vehicle
65         a vehicle to transport players and stuff, i.e. a cart or a boat
66         preciousness is hard to determine, maybe speed?
68 transport_structure
69         a fixed structure which is neccessary for a transport vehicle to operate, i.e. rails
70         preciousness is hard to dertermine …
72 ladder
73         a ladder
75 default:
76         This is the group your treasure get assigned to if you don’t specify a group.
79 Do you miss a group? Feel free to invent your own!
82 Note that Treasurer groups differ from the groups as defined by the Minetest API. These groups are handled differently.