X-Git-Url: https://git.jsancho.org/?a=blobdiff_plain;f=Docs%2FDEVTOOLS.txt;fp=Docs%2FDEVTOOLS.txt;h=4ed8008380fbeda4223b46854b010444f48c63de;hb=e2829dbf48a6964e16eb6ba73d1354a37dc05506;hp=0000000000000000000000000000000000000000;hpb=4c3e64bc1763c8dc59320d23e613863308aa9e26;p=lugaru.git diff --git a/Docs/DEVTOOLS.txt b/Docs/DEVTOOLS.txt new file mode 100644 index 0000000..4ed8008 --- /dev/null +++ b/Docs/DEVTOOLS.txt @@ -0,0 +1,236 @@ +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.