README.md
1# Test Tools readme
2
3Test Tools is a mod for developers that adds a bunch of tools to directly manipulate nodes and entities. This is great for quickly testing out stuff.
4
5Here's the list of tools:
6
7## Remover
8Removes nodes and non-player entities that you punch.
9
10## Node Setter
11Replace a node with another one.
12
13First, punch a node you want to remember.
14Then rightclick any other node to replace it with the node you remembered.
15
16If you rightclick while pointing nothing, you can manually enter the node and param2.
17
18## Param2 Tool
19Change the value param2 of nodes.
20
21* Punch: Add 1 to param2
22* Sneak+Punch: Add 8 to param2
23* Place: Subtract 1 from param2
24* Sneak+Place: Subtract 8 from param2
25
26Note: Use the debug screen (F5) to see the param2 of the pointed node.
27
28## Falling Node Tool
29Turns nodes into falling nodes.
30
31Usage:
32
33* Punch node: Make it fall
34* Place: Try to teleport up to 2 units upwards, then make it fall
35
36## Entity Rotator
37Changes the entity rotation (with `set_rotation`).
38
39Usage:
40
41* Punch entity: Rotate yaw
42* Punch entity while holding down “Sneak” key: Rotate pitch
43* Punch entity while holding down “Special” key (aka “Aux”): Rotate roll
44
45Each usage rotates the entity by 22.5°.
46
47## Entity Spawner
48Spawns entities.
49
50Usage:
51
52* Punch to select entity or spawn one directly
53* Place to place selected entity
54
55## Object Property Editor
56Edits properties of objects.
57
58Usage:
59
60* Punch object to open a formspec that allows you to view and edit properties
61* Punch air to edit properties of your own player object
62
63To edit a property, select it in the list, enter a new value (in Lua syntax)
64and hit “Submit”.
65
66## Object Attacher
67Allows you to attach an object to another one.
68
69Basic usage:
70* First select the parent object, then the child object that should be attached
71* Selecting an object is done by punching it
72* Sneak+punch to detach selected object
73* If you punch air, you select yourself
74
75Configuration:
76* Place: Increase attachment Y position
77* Sneak+place: decrease attachment Y position
78* Aux+place: Increase attachment X rotation
79* Aux+Sneak+Rightclick: Decrease attachment X rotation
80
81Hint: To detach all objects nearby you (including on yourself), use the
82`/detach` server command.
83
84## Object Mover
85Move an object by a given distance.
86
87Usage:
88* Punch object into the direction you want to move it
89* Sneak+punch: Move object towards you
90* Place: Increase move distance
91* Sneak+place: Decrease move distance
92
93## Entity Visual Scaler
94Change visual size of entities
95
96Usage:
97
98* Punch entity to increase visual size
99* Sneak+punch entity to decrease visual size
100