Docs/DEVTOOLS.txt

   1 Lugaru Developer Tools
   2 ======================
   3
   4 Activation
   5 ----------
   6
   7 There are two ways to activate developer tools:
   8
   9 - Temporary: Pass the --devtools or -d option to the executable
  10 - Persistent: Add the following to your config.txt file:
  11
  12     Devtools:
  13     1
  14
  15 The config.txt file can be found in the following locations:
  16
  17 - On Linux: ~/.config/lugaru/config.txt
  18 - On Mac: ~/Library/Application Support/Lugaru/config.txt
  19 - On Windows: C:/Users/yourusername/AppData/Roaming/Lugaru/config.txt
  20
  21
  22 Key bindings
  23 ------------
  24
  25 Note: dev keys must be pressed as if on a QWERTY keyboard.
  26
  27 General
  28 ~~~~~~~
  29
  30 ~ = console (see "Console commands" section)
  31 alt+m = toggle editor mode (see "Map editor" section)
  32
  33 alt+k = restart challenge
  34 shift+k = skip challenge
  35
  36 alt+h = give 200000 health and reset damage
  37 alt+j = toggle snow/grass/desert environment
  38 alt+c = toggle camera mode
  39 alt+v = toggle freeze
  40 alt+b = toggle slow motion
  41 alt+n = ragdoll
  42 alt+x = change weapon of nearby player [mod: ctrl]
  43 alt+u = change yaw (rotation around Z axis) [mod: ctrl]
  44 alt+f = put nearby player on fire [mod: ctrl]
  45 alt+t = change player skin [mod: ctrl]
  46 alt+shift+t = change player type (rabbit/wolf) [mod: ctrl]
  47 alt+i = explode nearby head
  48 alt+shift+i = explode nearby player
  49
  50 * Where noted, the ctrl modifier applies the change to the main player,
  51   otherwise to the nearest player.
  52
  53 Map editor (alt+m)
  54 ~~~~~~~~~~~~~~~~~~
  55
  56 o = place object
  57 p = place player
  58 delete = delete closest object
  59 shift+delete = delete closest player
  60
  61 shift+left/right = change type of next object
  62 up/down = change size of next object
  63 left/right = change yaw (rotation around Z axis) of next object
  64 ctrl+up/down = change pitch (tilt) of next object
  65 shift+ctrl+up/down = change map radius
  66
  67 shift+p = place waypoint
  68 ctrl+p = make/connect pathfind waypoint
  69 comma/period = select prev/next pathfind waypoints
  70 shift+comma = delete pathfind waypoint
  71
  72
  73 Console commands
  74 ----------------
  75
  76 Mapping
  77 ~~~~~~~
  78
  79 map (string) - loads the specified map.
  80     The string corresponds to the filename of a map in the Maps folder, located
  81     in Lugaru's Data folder.
  82 save (string) - saves the state of the current map.
  83     The string corresponds to the filename that the map will be saved under in
  84     the Maps folder, located in Lugaru's Data folder. Caution: this command
  85     will overwrite other maps with the same name without prompting you.
  86
  87 Character attributes
  88 ~~~~~~~~~~~~~~~~~~~~
  89
  90 wolfie - sets the player to a wolf. You gain all of the speed, strength,
  91     durability, and attacks of a wolf.
  92 funnybunny - sets the player to a rabbit.
  93 size (float) - changes the overall size of your character.
  94     The value is based on 1, that is, 1.5 is 50% larger.
  95 proportion (float) (float) (float) (float) - changes the proportions of your
  96     character. The four floating point values correspond to the proportions of
  97     the character's head, body, arm and leg respectively. Each value is based
  98     on 1, that is, 1.5 is 50% larger.
  99 speed (float) - sets your running speed.
 100     Each value is based on 1, that is, 1.5 is 50% faster.
 101 strength (float) - sets your attack strength.
 102     Each value is based on 1; that is, 1.5 is 50% stronger.
 103 power (float) - sets the amount of health you have.
 104     Each value is based on 1; that is, 1.5 is 50% healthier.
 105 protection (float) (float) (float) - sets your armor strength in terms of blunt
 106     resistance. Each floating point corresponds to the strength of your high,
 107     medium, or low resistance, respectively. Each value is based on 1; that is,
 108     1.5 is 50% more durable.
 109 armor (float) (float) (float) - sets your armor strength in terms of sharp
 110     attacks. Each floating point corresponds to the strength of your high,
 111     medium, or low resistance, respectively. Each value is based on 1; that is,
 112     1.5 is 50% more durable.
 113 immobile - makes character immobile.
 114     May gain some FPS in dialogue levels.
 115 mobile - cancels 'immobile'.
 116 allimmobile - does as name suggests.
 117     May be used when you are done with a dialogue level.
 118 armorreset, protectionreset - reset the value of the armor and protection
 119     settings for your character.
 120 armornear, protectionnear, proportionnear, sizenear - apply the changes to the
 121     character nearest to you instead of you.
 122 cellophane - makes everyone invisible, except for the shadows.
 123
 124 Character appearance
 125 ~~~~~~~~~~~~~~~~~~~~
 126
 127 lizardwolf, darko - changes your skin to the respective easter egg texture.
 128     Normal skins are available via the ctrl+alt+t hotkey.
 129 tintr (float) - sets the redness of your clothes.
 130     This only affects the color of future clothes, so you must set it in
 131     advance. It must be a value from 0 to 1.
 132 tintg (float) - sets the greenness of your clothes.
 133     This only affects the color of future clothes, so you must set it in
 134     advance. It must be a value from 0 to 1.
 135 tintb (float) - sets the blueness of your clothes.
 136     This only affects the color of future clothes, so you must set it in
 137     advance. It must be a value from 0 to 1.
 138 tint (float) (float) (float) - sets the color of your clothes.
 139     This only affects the color of future clothes, so you must set it in
 140     advance. Each floating point corresponds to red, green, and blue,
 141     respectively. Each value must be a number from 0 to 1.
 142 noclothes - removes all of your clothes.
 143 noclothesnear - same, applied to the character nearest to you.
 144 clothes (string) - adds clothes to your character.
 145     The string can be one of the following (case sensitive):
 146         Shirt
 147         LongSleeve
 148         EarWrap
 149         FootWrap
 150         Pants
 151         FancyPants
 152         Scar
 153         HeadBand
 154         LeatherWristLeft
 155         LeatherWristRight
 156         LeatherArmor
 157         LeatherPants
 158     Actually, these names come from the files in your Data/Lugaru/Textures
 159     folder of type ".png". You may add any png file in that folder and use it
 160     with the clothes command. See Decal Editing to create such files.
 161 clothesnear - does the same for the character nearest to you.
 162 clotheslist - lists the clothes of the main player (and their tint).
 163 clotheslistnear - does the same for the character nearest to you.
 164
 165 Skybox
 166 ~~~~~~
 167
 168 skybox - toggles skybox on and off.
 169 skytint (float) (float) (float) - sets the color tint of the sky.
 170     Each floating point value corresponds to a red, green, or blue value,
 171     respectively, between 0 and 1.
 172 skylight (float) (float) (float) - sets the color of the lighting of the sky.
 173     Each floating point value corresponds to a red, green, or blue value,
 174     respectively, between 0 and 1.
 175
 176 Miscellaneous map
 177 ~~~~~~~~~~~~~~~~~
 178
 179 tutorial (boolean) - toggles tutorial mode on/off for the current map.
 180 hostile (boolean) - toggles whether or not characters on the map are hostile.
 181 type (string) - sets the initial state of the next character.
 182     The possible values are listed below:
 183         active
 184         sitting
 185         sitting wall
 186         sleeping
 187         dead1
 188         dead2
 189         dead3
 190         dead4
 191 path keepwalking/pause - determines whether enemies walk through the next
 192     pathpoint or pause briefly.
 193
 194 Map objectives
 195 ~~~~~~~~~~~~~~
 196
 197 mapkilleveryone - makes objective of the map to kill everyone.
 198 mapgosomewhere - makes objective of the map to go somewhere.
 199 mapkillsomeone - makes objective of the map to kill a specific enemy.
 200 mapkillmost - makes objective of the map to kill everyone but one.
 201
 202 Hotspots
 203 ~~~~~~~~
 204
 205 hs (size) (type) (string) - creates a hotspot underneath you.
 206     The three arguments correspond to the size, type, and text of the hotspot,
 207     respectively. See below for the explanations of each type integer:
 208         type 0 = static, display text
 209         type 1-10 = attached to player 1-10, display text
 210         type 11-20 = attached to player 1-10, must kill to win
 211         type -1 = win if approached
 212 dhs - deletes the last hotspot.
 213     An example is "hs 15.0 0 sdf". Note that hotspots are very buggy (TODO:
 214     review once bugs are fixed), especially those not of type 0. Quitting and
 215     restarting Lugaru, then creating a hotspot in a simple map first, can help.
 216     You may have to fiddle around with this. Some strings may be randomly
 217     rejected, but if you know how to hex-edit, you can change them directly in
 218     the map file (make sure to change the byte before the string to the number
 219     of its characters).
 220
 221 Dialogs
 222 ~~~~~~~
 223
 224 dialog (int) (string) - loads the "string.txt" dialog with type "int" and enter
 225     directing mode: Fly around, press numpad 1-10 to change the players' head
 226     target, press 1-10 to define who is saying the current line and move on to
 227     the next line. The type argument can be one of:
 228         0-9 = player index, activates when "attacking" them
 229         10+ = "special", activates automatically when in range; player ID is
 230               the module of the type (e.g. type 18 would be special, player 8)
 231         40-49 = some other thing, someone really needs to cleanup this logic :)
 232 fixdialog (int) (string) - replaces the dialog of given index by the one
 233     described in the "string.txt" file.
 234 ddialog (int) - deletes given dialog (if no argument or -1, deletes the last
 235     dialog). Does not work when actually playing a dialog.
 236 fixtype (int) (int) - fixes the type (2nd arg) of the given dialog (1st arg).
 237 play (int) - plays given dialog.
 238 fixrotation - when playing a dialog, sets the in-dialog yaw of the current
 239     participant to its out-of-dialog yaw value.
 240
 241 Graphics
 242 ~~~~~~~~
 243
 244 viewdistance (float) - sets the far clipping plane.
 245     In other words, it controls how far you can see before the fog obscures it.
 246     Its value is based on 1, that is, 1.5 is 50% farther.
 247 fadestart (float) - sets what fraction of the viewdistance an object must pass
 248     to begin fading. In other words, it controls how far an object has to be
 249     before it starts becoming transparent. Its value is based on 1, that is,
 250     1.5 is 50% farther.
 251
 252 Miscellaneous
 253 ~~~~~~~~~~~~~
 254
 255 quit - quits Lugaru.
 256 slomo (float) - toggles slow motion on or off.
 257     If it's turning on, the game speed is controlled by the floating point
 258     value. The value is based on 1, that is, 0.5 is 50% slower than normal game
 259     speed.
 260 slofreq (integer) - sets the slow motion sound frequency.
 261
 262 The following commands have unknown effects: metal, sizemin, fixrotation,
 263 fixtype.