Lugaru Developer Tools
======================

Activation
----------

There are two ways to activate developer tools:

- Temporary: Pass the --devtools or -d option to the executable
- Persistent: Add the following to your config.txt file:

    Devtools:
    1

The config.txt file can be found in the following locations:

- On Linux: ~/.config/lugaru/config.txt
- On Mac: ~/Library/Application Support/Lugaru/config.txt
- On Windows: C:/Users/yourusername/AppData/Roaming/Lugaru/config.txt


Key bindings
------------

Note: dev keys must be pressed as if on a QWERTY keyboard.

General
~~~~~~~

~ = console (map mapname, save mapname, quit)
tab = minimap

super+z = restart level
shift+k = win level

alt+h = give 2000 health
alt+j = toggle snow/grass/desert
alt+c = toggle cameramode
alt+b = slow motion (with motion blur that might work)
alt+n = ragdoll
alt+x = change weapon of nearby player (main player if ctrl is pressed)
alt+f = spontaneously combust
alt+o = change enemy's skin (main player if ctrl is pressed)
alt+shift+o = change enemy's type (rabbit/wolf) (main player if ctrl is pressed)
alt+i = explode nearby head
alt+shift+i = explode nearby enemy


Map editor:

alt+m = toggle editor mode
m = place object
p = place enemy
shift+p = place waypoint
delete = delete most recently made object
shift+delete = delete most recently made player
up/down = change size of next object
control+up/down = change tilt of next object
left/right = change rotation of next object
shift+left/right = change type of next object

control+p = make/connect pathfind waypoint
period/comma = select pathfind waypoints
shift+comma = delete pathfind waypoint


Console commands
----------------

Mapping
~~~~~~~

map (string) - loads the specified map.
    The string corresponds to the filename of a map in the Maps folder, located
    in Lugaru's Data folder.
save (string) - saves the state of the current map.
    The string corresponds to the filename that the map will be saved under in
    the Maps folder, located in Lugaru's Data folder. Caution: this command
    will overwrite other maps with the same name without prompting you.

Character attributes
~~~~~~~~~~~~~~~~~~~~

wolfieisgod - sets the player to a wolf. You gain all of the speed, strength,
    durability, and attacks of a wolf.
funnybunny - sets the player to a rabbit.
size (float) - changes the overall size of your character.
    The value is based on 1, that is, 1.5 is 50% larger.
proportion (float) (float) (float) (float) - changes the proportions of your
    character. The four floating point values correspond to the proportions of
    the character's head, body, arm and leg respectively. Each value is based
    on 1, that is, 1.5 is 50% larger.
speed (float) - sets your running speed.
    Each value is based on 1, that is, 1.5 is 50% faster.
strength (float) - sets your attack strength.
    Each value is based on 1; that is, 1.5 is 50% stronger.
power (float) - sets the amount of health you have.
    Each value is based on 1; that is, 1.5 is 50% healthier.
protection (float) (float) (float) - sets your armor strength in terms of blunt
    resistance. Each floating point corresponds to the strength of your high,
    medium, or low resistance, respectively. Each value is based on 1; that is,
    1.5 is 50% more durable.
armor (float) (float) (float) - sets your armor strength in terms of sharp
    attacks. Each floating point corresponds to the strength of your high,
    medium, or low resistance, respectively. Each value is based on 1; that is,
    1.5 is 50% more durable.
immobile - makes character immobile.
    May gain some FPS in dialogue levels.
mobile - cancels 'immobile'.
allimmobile - does as name suggests.
    May be used when you are done with a dialogue level.
armorreset, protectionreset - reset the value of the armor and protection
    settings for your character.
armornear, protectionnear, proportionnear, sizenear - apply the changes to the
    character nearest to you instead of you.
cellophane - makes everyone invisible, except for the shadows.

Character appearance
~~~~~~~~~~~~~~~~~~~~

cellar door, rambo, kungfu, white, brown, black - changes your skin to the
    respective outfit. Note: this command is a little glitchy sometimes. You
    may have to enter it multiple times before it changes.
tintr (float) - sets the redness of your clothes.
    This only affects the color of future clothes, so you must set it in
    advance. It must be a value from 0 to 1.
tintg (float) - sets the greenness of your clothes.
    This only affects the color of future clothes, so you must set it in
    advance. It must be a value from 0 to 1.
tintb (float) - sets the blueness of your clothes.
    This only affects the color of future clothes, so you must set it in
    advance. It must be a value from 0 to 1.
tint (float) (float) (float) - sets the color of your clothes.
    This only affects the color of future clothes, so you must set it in
    advance. Each floating point corresponds to red, green, and blue,
    respectively. Each value must be a number from 0 to 1.
noclothes - removes all of your clothes.
noclothesnear - same, applied to the character nearest to you.
clothes (string) - adds clothes to your character.
    The string can be one of the following (case sensitive):
        Shirt
        LongSleeve
        EarWrap
        FootWrap
        Pants
        FancyPants
        Scar
        HeadBand
        LeatherWristLeft
        LeatherWristRight
        LeatherArmor
        LeatherPants
    Actually, these names come from the files in your Data/Lugaru/Textures
    folder of type ".png". You may add any png file in that folder and use it
    with the clothes command. See Decal Editing to create such files.
clothesnear - does the same for the character nearest to you.

Skybox
~~~~~~

skybox - toggles skybox on and off.
sky tint (float) (float) (float) - sets the color tint of the sky.
    Each floating point value corresponds to a red, green, or blue value,
    respectively, between 0 and 1.
sky light (float) (float) (float) - sets the color of the lighting of the sky.
    Each floating point value corresponds to a red, green, or blue value,
    respectively, between 0 and 1.

Miscellaneous map
~~~~~~~~~~~~~~~~~

tutorial (boolean) - toggles tutorial mode on/off for the current map.
hostile (boolean) - toggles whether or not characters on the map are hostile.
type (string) - sets the initial state of the next character.
    The possible values are listed below:
        active
        sitting
        sitting wall
        sleeping
        dead1
        dead2
        dead3
        dead4
path keepwalking/pause - determines whether enemies walk through the next
    pathpoint or pause briefly.

Map objectives
~~~~~~~~~~~~~~

mapkilleveryone - makes objective of the map to kill everyone.
mapgosomewhere - makes objective of the map to go somewhere.
mapkillsomeone - makes objective of the map to kill a specific enemy.
mapkillmost - makes objective of the map to kill everyone but one.

Hotspots
~~~~~~~~

hs (size) (type) (string) - creates a hotspot underneath you.
    The three arguments correspond to the size, type, and text of the hotspot,
    respectively. See below for the explanations of each type integer:
        type 0 = static, display text
        type 1-10 = attached to player 1-10, display text
        type 11-20 = attached to player 1-10, must kill to win
        type -1 = win if approached
dhs - deletes the last hotspot.
    An example is "hs 15.0 0 sdf". Note that hotspots are very buggy (TODO:
    review once bugs are fixed), especially those not of type 0. Quitting and
    restarting Lugaru, then creating a hotspot in a simple map first, can help.
    You may have to fiddle around with this. Some strings may be randomly
    rejected, but if you know how to hex-edit, you can change them directly in
    the map file (make sure to change the byte before the string to the number
    of its characters).

Graphics
~~~~~~~~

viewdistance (float) - sets the far clipping plane.
    In other words, it controls how far you can see before the fog obscures it.
    Its value is based on 1, that is, 1.5 is 50% farther.
fadestart (float) - sets what fraction of the viewdistance an object must pass
    to begin fading. In other words, it controls how far an object has to be
    before it starts becoming transparent. Its value is based on 1, that is,
    1.5 is 50% farther.

Miscellaneous
~~~~~~~~~~~~~

quit - quits Lugaru.
slomo (float) - toggles slow motion on or off.
    If it's turning on, the game speed is controlled by the floating point
    value. The value is based on 1, that is, 0.5 is 50% slower than normal game
    speed.
slofreq (integer) - sets the slow motion sound frequency.

The following commands have unknown effects: metal, sizemin, fixrotation,
fixtype.