README.md

   1 # Test Tools readme
   2
   3 Test 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
   5 Here's the list of tools:
   6
   7 ## Remover
   8 Removes nodes and non-player entities that you punch.
   9
  10 ## Node Setter
  11 Replace a node with another one.
  12
  13 First, punch a node you want to remember.
  14 Then rightclick any other node to replace it with the node you remembered.
  15
  16 If you rightclick while pointing nothing, you can manually enter the node and param2.
  17
  18 ## Param2 Tool
  19 Change 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
  26 Note: Use the debug screen (F5) to see the param2 of the pointed node.
  27
  28 ## Falling Node Tool
  29 Turns nodes into falling nodes.
  30
  31 Usage:
  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
  37 Changes the entity rotation (with `set_rotation`).
  38
  39 Usage:
  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
  45 Each usage rotates the entity by 22.5°.
  46
  47 ## Entity Spawner
  48 Spawns entities.
  49
  50 Usage:
  51
  52 * Punch to select entity or spawn one directly
  53 * Place to place selected entity
  54
  55 ## Object Property Editor
  56 Edits properties of objects.
  57
  58 Usage:
  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
  63 To edit a property, select it in the list, enter a new value (in Lua syntax)
  64 and hit “Submit”.
  65
  66 ## Object Attacher
  67 Allows you to attach an object to another one.
  68
  69 Basic 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
  75 Configuration:
  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
  81 Hint: To detach all objects nearby you (including on yourself), use the
  82 `/detach` server command.
  83
  84 ## Object Mover
  85 Move an object by a given distance.
  86
  87 Usage:
  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
  94 Change visual size of entities
  95
  96 Usage:
  97
  98 * Punch entity to increase visual size
  99 * Sneak+punch entity to decrease visual size