]> git.jsancho.org Git - lugaru.git/blobdiff - DEVTOOLS.txt
Sorted all source files in folders
[lugaru.git] / DEVTOOLS.txt
index d765ab6d2c425d16e03f2c98f71087f066cbef20..4ed8008380fbeda4223b46854b010444f48c63de 100644 (file)
@@ -4,12 +4,21 @@ Lugaru Developer Tools
 Activation
 ----------
 
-- Pass --devtools option to the binary for these to work
-- Or add the following to your config.txt:
+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
 ------------
 
@@ -36,15 +45,15 @@ 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
-~~~~~~~~~~
+
+Map editor:
 
 alt+m = toggle editor mode
 m = place object
 p = place enemy
-shift-p = place waypoint
+shift+p = place waypoint
 delete = delete most recently made object
-shift-delete = delete most recently made player
+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
@@ -54,83 +63,174 @@ control+p = make/connect pathfind waypoint
 period/comma = select pathfind waypoints
 shift+comma = delete pathfind waypoint
 
+
 Console commands
 ----------------
 
-f is floating point, i is integer, b is boolean, str is string.
-
-Map mapname where mapname is the name of a map in the maps folder
-Save mapname where mapname is an unused filename
-Cellar door, rambo, kungfu, white, brown, black = change skins
-
-Tintr f = red clothes color from 0 to 1
-Tintg f = green clothes color from 0 to 1
-Tintb f = blue clothes color from 0 to 1
-Tint f f f = r,g,b clothes colors from 0 to 1
-Noclothes = remove all clothes
-Clothes str = add clothes str.png
-
-Included clothes include:
-Shirt
-LongSleeve
-EarWrap
-FootWrap
-Pants
-FancyPants
-Scar
-Headband
-LeatherWristLeft
-LeatherWristRight
-LeatherArmor
-LeatherPants
-
-Skybox = toggle skybox (i.e. turn off to get fog)
-Sky Tint f f f =  r,g,b colors from 0 to 1 for the sky
-Sky Light f f f =  r,g,b colors from 0 to 1 for the lighting
-
-Speed f = set player speed
-Strength f = set player power
-Power f = set player power
-Protection f f f = set high,medium,low resistance to blunt attacks
-Armor f f f = set high,medium,low resistance to sharp attacks
-
-slomo f = set the slomo speed
-slofreq i = set the slomo sound frequency
-
-tutorial b = toggle tutorial mode on/off
-hostile b = toggle hostility
-
-type active/sitting/sitting wall/sleeping/dead1/dead2/dead3/dead4 = set initial state
-path keepwalking/pause = determine whether enemies walk through the next pathpoint or pause briefly
-
-mapkilleveryone = set the map objective to kill everyone
-mapgosomewhere = set the map objective to go somewhere
-mapkillsomeone = set the map objective to kill a specific enemy
-mapkillmost = set the map objective to kill everyone but one
-
-hs f i str = set the size, type, and text for a hotspot
-(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 = delete last hotspot
-
-dialogue str = load the dialogue str.txt and enter directing mode (fly around, press numpad 1-10 to change their head target, press 1-10 for who is saying each line and to go to next line)
-
-ddialogue = delete last dialogue
-
-play i = play dialogue #i
-
-immobile = make immobile; this can increase fps
-mobile = make mobile
-
-proportion f f f f = set head, body, arm and leg proportion (1 is default)
-
-viewdistance x= set the far clipping plane (1 is default)
-fadestart x= set what fraction of the viewdistance an object must pass to begin fading (1 is default)
-
-funnybunny = set player to rabbit
-wolfieisgod = set player to wolf
+Mapping
+~~~~~~~
 
-quit = quit
+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.