]> git.jsancho.org Git - lugaru.git/blob - Docs/DEVTOOLS.txt
Fixed bindings or documentation to make sure both are consistent with each other
[lugaru.git] / 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 (map mapname, save mapname, quit)
31 tab = minimap
32
33 super+z = restart level
34 shift+k = win level
35
36 alt+h = give 2000 health
37 alt+j = toggle snow/grass/desert
38 alt+c = toggle cameramode
39 alt+b = slow motion (with motion blur that might work)
40 alt+n = ragdoll
41 alt+x = change weapon of nearby player (main player if ctrl is pressed)
42 alt+f = spontaneously combust
43 alt+o = change enemy's skin (main player if ctrl is pressed)
44 alt+shift+o = change enemy's type (rabbit/wolf) (main player if ctrl is pressed)
45 alt+i = explode nearby head
46 alt+shift+i = explode nearby enemy
47
48
49 Map editor:
50
51 alt+m = toggle editor mode
52 o = place object
53 p = place enemy
54 shift+p = place waypoint
55 delete = delete closest object
56 shift+delete = delete closest player
57 up/down = change size of next object
58 control+up/down = change tilt of next object
59 left/right = change rotation of next object
60 shift+left/right = change type of next object
61
62 control+p = make/connect pathfind waypoint
63 period/comma = select pathfind waypoints
64 shift+comma = delete pathfind waypoint
65
66
67 Console commands
68 ----------------
69
70 Mapping
71 ~~~~~~~
72
73 map (string) - loads the specified map.
74     The string corresponds to the filename of a map in the Maps folder, located
75     in Lugaru's Data folder.
76 save (string) - saves the state of the current map.
77     The string corresponds to the filename that the map will be saved under in
78     the Maps folder, located in Lugaru's Data folder. Caution: this command
79     will overwrite other maps with the same name without prompting you.
80
81 Character attributes
82 ~~~~~~~~~~~~~~~~~~~~
83
84 wolfieisgod - sets the player to a wolf. You gain all of the speed, strength,
85     durability, and attacks of a wolf.
86 funnybunny - sets the player to a rabbit.
87 size (float) - changes the overall size of your character.
88     The value is based on 1, that is, 1.5 is 50% larger.
89 proportion (float) (float) (float) (float) - changes the proportions of your
90     character. The four floating point values correspond to the proportions of
91     the character's head, body, arm and leg respectively. Each value is based
92     on 1, that is, 1.5 is 50% larger.
93 speed (float) - sets your running speed.
94     Each value is based on 1, that is, 1.5 is 50% faster.
95 strength (float) - sets your attack strength.
96     Each value is based on 1; that is, 1.5 is 50% stronger.
97 power (float) - sets the amount of health you have.
98     Each value is based on 1; that is, 1.5 is 50% healthier.
99 protection (float) (float) (float) - sets your armor strength in terms of blunt
100     resistance. Each floating point corresponds to the strength of your high,
101     medium, or low resistance, respectively. Each value is based on 1; that is,
102     1.5 is 50% more durable.
103 armor (float) (float) (float) - sets your armor strength in terms of sharp
104     attacks. Each floating point corresponds to the strength of your high,
105     medium, or low resistance, respectively. Each value is based on 1; that is,
106     1.5 is 50% more durable.
107 immobile - makes character immobile.
108     May gain some FPS in dialogue levels.
109 mobile - cancels 'immobile'.
110 allimmobile - does as name suggests.
111     May be used when you are done with a dialogue level.
112 armorreset, protectionreset - reset the value of the armor and protection
113     settings for your character.
114 armornear, protectionnear, proportionnear, sizenear - apply the changes to the
115     character nearest to you instead of you.
116 cellophane - makes everyone invisible, except for the shadows.
117
118 Character appearance
119 ~~~~~~~~~~~~~~~~~~~~
120
121 cellar door, rambo, kungfu, white, brown, black - changes your skin to the
122     respective outfit. Note: this command is a little glitchy sometimes. You
123     may have to enter it multiple times before it changes.
124 tintr (float) - sets the redness of your clothes.
125     This only affects the color of future clothes, so you must set it in
126     advance. It must be a value from 0 to 1.
127 tintg (float) - sets the greenness of your clothes.
128     This only affects the color of future clothes, so you must set it in
129     advance. It must be a value from 0 to 1.
130 tintb (float) - sets the blueness of your clothes.
131     This only affects the color of future clothes, so you must set it in
132     advance. It must be a value from 0 to 1.
133 tint (float) (float) (float) - sets the color of your clothes.
134     This only affects the color of future clothes, so you must set it in
135     advance. Each floating point corresponds to red, green, and blue,
136     respectively. Each value must be a number from 0 to 1.
137 noclothes - removes all of your clothes.
138 noclothesnear - same, applied to the character nearest to you.
139 clothes (string) - adds clothes to your character.
140     The string can be one of the following (case sensitive):
141         Shirt
142         LongSleeve
143         EarWrap
144         FootWrap
145         Pants
146         FancyPants
147         Scar
148         HeadBand
149         LeatherWristLeft
150         LeatherWristRight
151         LeatherArmor
152         LeatherPants
153     Actually, these names come from the files in your Data/Lugaru/Textures
154     folder of type ".png". You may add any png file in that folder and use it
155     with the clothes command. See Decal Editing to create such files.
156 clothesnear - does the same for the character nearest to you.
157
158 Skybox
159 ~~~~~~
160
161 skybox - toggles skybox on and off.
162 sky tint (float) (float) (float) - sets the color tint of the sky.
163     Each floating point value corresponds to a red, green, or blue value,
164     respectively, between 0 and 1.
165 sky light (float) (float) (float) - sets the color of the lighting of the sky.
166     Each floating point value corresponds to a red, green, or blue value,
167     respectively, between 0 and 1.
168
169 Miscellaneous map
170 ~~~~~~~~~~~~~~~~~
171
172 tutorial (boolean) - toggles tutorial mode on/off for the current map.
173 hostile (boolean) - toggles whether or not characters on the map are hostile.
174 type (string) - sets the initial state of the next character.
175     The possible values are listed below:
176         active
177         sitting
178         sitting wall
179         sleeping
180         dead1
181         dead2
182         dead3
183         dead4
184 path keepwalking/pause - determines whether enemies walk through the next
185     pathpoint or pause briefly.
186
187 Map objectives
188 ~~~~~~~~~~~~~~
189
190 mapkilleveryone - makes objective of the map to kill everyone.
191 mapgosomewhere - makes objective of the map to go somewhere.
192 mapkillsomeone - makes objective of the map to kill a specific enemy.
193 mapkillmost - makes objective of the map to kill everyone but one.
194
195 Hotspots
196 ~~~~~~~~
197
198 hs (size) (type) (string) - creates a hotspot underneath you.
199     The three arguments correspond to the size, type, and text of the hotspot,
200     respectively. See below for the explanations of each type integer:
201         type 0 = static, display text
202         type 1-10 = attached to player 1-10, display text
203         type 11-20 = attached to player 1-10, must kill to win
204         type -1 = win if approached
205 dhs - deletes the last hotspot.
206     An example is "hs 15.0 0 sdf". Note that hotspots are very buggy (TODO:
207     review once bugs are fixed), especially those not of type 0. Quitting and
208     restarting Lugaru, then creating a hotspot in a simple map first, can help.
209     You may have to fiddle around with this. Some strings may be randomly
210     rejected, but if you know how to hex-edit, you can change them directly in
211     the map file (make sure to change the byte before the string to the number
212     of its characters).
213
214 Graphics
215 ~~~~~~~~
216
217 viewdistance (float) - sets the far clipping plane.
218     In other words, it controls how far you can see before the fog obscures it.
219     Its value is based on 1, that is, 1.5 is 50% farther.
220 fadestart (float) - sets what fraction of the viewdistance an object must pass
221     to begin fading. In other words, it controls how far an object has to be
222     before it starts becoming transparent. Its value is based on 1, that is,
223     1.5 is 50% farther.
224
225 Miscellaneous
226 ~~~~~~~~~~~~~
227
228 quit - quits Lugaru.
229 slomo (float) - toggles slow motion on or off.
230     If it's turning on, the game speed is controlled by the floating point
231     value. The value is based on 1, that is, 0.5 is 50% slower than normal game
232     speed.
233 slofreq (integer) - sets the slow motion sound frequency.
234
235 The following commands have unknown effects: metal, sizemin, fixrotation,
236 fixtype.