author | Wuzzy |
Tue, 17 Apr 2018 00:47:50 +0100 | |
changeset 1299 | c0cade1e3676 |
parent 1272 | 4f93f837c427 |
child 1300 | dff2be85c8d2 |
permissions | -rw-r--r-- |
67
eecbb1c261bb
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
66
diff
changeset
|
1 |
#summary API for writing Lua scripts in Hedgewars. |
284
365362b51148
This is cool stuff, let's put it on the project frontpage (adding "featured" tag)
sheepyluva@gmail.com
parents:
244
diff
changeset
|
2 |
#labels Featured |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
3 |
|
741 | 4 |
= Core Lua API documentation = |
5 |
||
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
6 |
== Introduction == |
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
7 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
8 |
Version 0.9.13 of Hedgewars introduced the ability to use Lua scripts to modify Hedgewars behaviour for different maps without having to recompile the whole game. The till then used triggers (only appeared in training maps) were removed. |
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
9 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
10 |
Lua is an easy to learn scripting language that’s implemented using open source libraries. If you’d like to learn more about Lua, have a look at [http://www.lua.org Lua's official homepage]. Even though its easy to learn syntax this wiki page won't explain all basics of using Lua, e.g. declaring variables or using control structures. There are tons of step-by-step tutorials and documentation available on the internet. Just throw “Lua” into your favourite search engine and give it a try. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
11 |
|
519 | 12 |
=== About this wiki page === |
1240 | 13 |
This page might become outdated. For a list of undocumented functions, see [http://hw.ercatec.net/docs/lua_wiki_check.php]. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
14 |
|
519 | 15 |
<wiki:toc max_depth="4" /> |
16 |
||
859 | 17 |
== Overview == |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
18 |
=== How Hedgewars handles Lua scripts === |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
19 |
As of Version 0.9.20, Hedgewars supports Lua scripts for two similar tasks: Define tutorial missions, campaign missions or provide special map behaviour for precreated maps. It is also used for multiplayer scripts to create new game styles. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
20 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
21 |
=== Tutorial missions === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
22 |
Tutorial missions are located within text files inside `share/hedgewars/Data/Missions/Training`. The game will list all files with the lua extension inside this directory in the Training selection screen. You’ll find some premade example scripts within this directory that contain several comments on the script lines and what they do. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
23 |
|
567 | 24 |
See [Missions] for details. |
25 |
||
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
26 |
=== Special maps === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
27 |
In addition to tutorial missions predrawn maps (maps not created using the random map creator) may contain a single lua script file named `map.lua`. If it’s there, it will be used once the map is played. This way it’s possible to play maps alone or over the internet using custom goals. Mission maps can be found in singleplayer mode under the “training” button and in multiplayer mode, it is selectable as a map type. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
28 |
|
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
29 |
See also [PresetMaps] for more information about such maps. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
30 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
31 |
=== How Lua scripts are used === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
32 |
Several parts of script files are executed multiple times. In general, the whole script file is read while loading the map. Declarations as well as function calls outside functions are executed at once. Later on the game will call special predefined function names at special occassions such as the creation of new game objects (called “gears”). |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
33 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
34 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
35 |
=== Important things to know === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
36 |
It is possible to play missions in multiplayer. However this requires all participating players to have the exact same version of the map files, including the `map.lua` script file. If this isn’t the case the game will probably desync and “kick” at least the one player using a different version of the map files. To avoid problems when running prepackaged maps, you should never modify any maps provided with the Hedgewars default package. Instead, create a copy of the existing map and modify this one. Feel free to share your work on the forums. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
37 |
|
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
38 |
Another thing to note is the current status of our scripting implementation. Similar to the whole game, this is still work in progress and we can’t guarantee that scripts working in this version will run in future revisions of the game as we might extend, change or rename parts of the scripting engine. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
39 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
40 |
=== Global variables/constants === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
41 |
Global variables are used by the game to interact with the scripts by passing and retrieving their values. While some of the variables are never read by the engine some allow you to modify the engine’s behaviour, e.g. the theme to be used for the current map. |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
42 |
|
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
43 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
44 |
=== Functions called by the game: Event handlers === |
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
45 |
After successfully loading the Lua script the game will call the following functions on different occasions. To be used, they have to use the exact same name as defined below. |
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
46 |
|
478 | 47 |
== Data types == |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
48 |
This section defines some commonly used non-primitive parameter types which are used in multiple functions. This section is a bit incomplete at the moment. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
49 |
|
478 | 50 |
=== Color === |
477
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
51 |
Some functions take a `color` parameter. |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
52 |
|
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
53 |
Colors are stored in RGB or RGBA format and are specified as a three- or four-byte number, respecively. |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
54 |
In 3-byte (RGB) colors, each byte represents a color component. The value 0 means no intensity and 255 is largest intensity of the component. |
477
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
55 |
The first byte is for the red component, the second byte for the green component and the third byte for the blue component. |
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
56 |
Four-byte (RGBA) colors use the first 3 bytes for the color components (like for the 3-byte colors) and the fourth byte is used for opacity, where 255 means maximum opacity and 0 means fully transparent (also called the “alpha channel”). |
477
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
57 |
|
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
58 |
Specifying the color number becomes much easier if you write it in hexadecimal notation. |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
59 |
|
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
60 |
Examples for RGB (3-byte) colors: |
477
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
61 |
<code language="lua"> |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
62 |
c = 0x000000 -- black (R, G, B are all 0) |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
63 |
c = 0xFF0000 -- red |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
64 |
c = 0x00FF00 -- green |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
65 |
c = 0x0000FF -- blue |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
66 |
c = 0xFFFFFF -- white |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
67 |
c = 0x808080 -- gray (50%)</code> |
8c326a00ead3
Add information about the “color” parameter found in some functions.
almikes@aol.com
parents:
476
diff
changeset
|
68 |
|
885 | 69 |
Hint: On [http://www.colorpicker.com/] you find a color-picking tool for getting RGB colors easily. |
70 |
||
312
6c0397400a9b
Add Smaxx' nice lua API introduction from the hedgewars.org wiki
sheepyluva@gmail.com
parents:
295
diff
changeset
|
71 |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
72 |
== Globally available variables and constants == |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
73 |
The following variables are made available by Hedgewars in Lua and can be used to quickly query a value. Lua scripts schould normally *not* write to these variables, only read from them. |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
74 |
|
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
75 |
=== General variables and constants === |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
76 |
Here are some unsorted variables or constants which are available in Lua. You shouldn’t write to most of them. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
77 |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
78 |
|| *Identifier* || *Description* || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
79 |
|| `LAND_WIDTH` || The width of the landscape in pixels || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
80 |
|| `LAND_HEIGHT` || The height of the landscape in pixels || |
1074 | 81 |
|| `LeftX` || X coordinate of the leftmost point of the landscape || |
82 |
|| `RightX` || X coordinate of the rightmost point of the landscape || |
|
83 |
|| `TopY` || Y coordinate of the topmost point of the landscape || |
|
819 | 84 |
|| `CursorX` || The X position of the cursor if the player is choosing a target. Otherwise, this is `-2147483648` || |
85 |
|| `CursorY` || The Y position of the cursor if the player is choosing a target. Otherwise, this is `-2147483648` || |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
86 |
|| `WaterLine` || The y position of the water, used to determine at which position stuff drowns. Use `SetWaterLine` to change. || |
1157 | 87 |
|| `ClansCount` || Number of clans, including defeated ones (a clan is a group of teams with same color) || |
88 |
|| `TeamsCount` || Number of teams, including defeated ones || |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
89 |
|| `TurnTimeLeft` || Number of game ticks (milliseconds) left until the current turn ends. You can change this variable directly. || |
1112 | 90 |
|| `ReadyTimeLeft` || Remaining ready time in millseconds, 0 if turn in progress. Can be set in onNewTurn. In other places, it should only be read, not written. || |
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
91 |
|| `GameTime` || Number of total game ticks || |
1158 | 92 |
|| `TotalRounds` || Number of rounds that have passed. Equals `-1` if game has not started yet or hogs are still being placed. This variable is buggy in 0.9.23 and earlier! || |
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
93 |
|| `CurrentHedgehog` || The hedgehog gear that is currently in play || |
1155 | 94 |
|| `AmmoTypeMax` || Maximum ammo type ID (useful to iterate through all ammo types, starting by 0) || |
125
b0b7654c6de6
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
123
diff
changeset
|
95 |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
96 |
=== !GameFlags === |
557 | 97 |
The !GameFlags are used to store simple boolean settings of the game. |
98 |
You can read/modify them using the [LuaAPI#GameFlags_functions GameFlags-Functions]. |
|
102
86cf695636c6
Added gfResetHealth to Gameflags section along with a note.
RedGrinner@gmail.com
parents:
101
diff
changeset
|
99 |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
100 |
|| *Identifier* || *Description (active state)* || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
101 |
|| `gfOneClanMode` || Used when only one clan is in the game. This game flag is primarily used for training missions. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
102 |
|| `gfMultiWeapon` || TODO (Used in training missions.) || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
103 |
|| `gfForts` || Fort Mode || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
104 |
|| `gfDivideTeams` || The teams will start at opposite sites of the terrain. Two clans maximum. || |
626 | 105 |
|| `gfBorder` || An indestructible border is active around the map. || |
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
106 |
|| `gfBottomBorder` || There is an indestructable border at the bottom of the map. || |
626 | 107 |
|| `gfShoppaBorder` || The terrain edge will be replaced by a decorative black/yellow “danger stripe”. This has no gameplay effect. || |
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
108 |
|| `gfSolidLand` || The terrain is indestructible. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
109 |
|| `gfLowGravity` || The gravity is low. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
110 |
|| `gfLaserSight` || A laser sight is almost always active. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
111 |
|| `gfInvulnerable` || All hedgehogs are invulnerable. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
112 |
|| `gfVampiric` || All hedgehogs become vampires and get 80% of the damage they deal as health. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
113 |
|| `gfKarma` || Attackers share the damage they deal to enemies. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
114 |
|| `gfArtillery` || Hedgehogs can’t walk. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
115 |
|| `gfRandomOrder` || The game is played in random order. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
116 |
|| `gfPlaceHog` || Placement mode: At the beginning of the round, all hedgehogs are placed manually first. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
117 |
|| `gfKing` || King Mode: One hedgehog per team becomes their king, if the king dies, the team loses. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
118 |
|| `gfSharedAmmo` || Teams in the same clan share their ammo. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
119 |
|| `gfDisableGirders` || No girders will be created in random maps || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
120 |
|| `gfDisableLandObjects` || No land objects will be created in random maps || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
121 |
|| `gfAISurvival` || Computer-controlled hedgehogs will be revived after they die. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
122 |
|| `gfInfAttack` || Attacks don’t end the turn. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
123 |
|| `gfResetWeps` || The weapons will be reset to the initial state each turn. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
124 |
|| `gfPerHogAmmo` || Each hedgehog has its own weapon stash. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
125 |
|| `gfDisableWind` || There is no wind. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
126 |
|| `gfMoreWind` || There is always strong wind. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
127 |
|| `gfTagTeam` || Tag Team: Teams in the same clan share their turn time. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
128 |
|| `gfResetHealth` || The health of all living hedgehogs is reset at the end of each turn. || |
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
129 |
|
540 | 130 |
=== Land flags === |
131 |
The land flags denote several types of terrain. Like all flags, they can be combined at will. |
|
132 |
||
133 |
|| *Identifier* || *Meaning* || |
|
134 |
|| `lfIce` || Slippery terrain, hogs will slide on it. || |
|
135 |
|| `lfBouncy` || Bouncy terrain, hogs and some other gears will bounce off when they collide with it. || |
|
136 |
|| `lfIndestructible` || Almost indestructible terrain, most weapons will not destroy it. || |
|
1228 | 137 |
|| `0` || Normal destroyable terrain. Note that this is the case when no other land flag is set. || |
540 | 138 |
|
491
9079444264ae
Update section “Global available constants”: Use tables, fix gameflags section (was outdated, some gameflags were missing).
almikes@aol.com
parents:
478
diff
changeset
|
139 |
=== More constants === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
140 |
More constants are at at [GearTypes Gear Types] , [AmmoTypes Ammo Types], [Sounds], [States], [Sprites], [VisualGearTypes Visual Gear Types]. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
141 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
142 |
== Event handlers == |
890 | 143 |
Lua scripts are supposed to _define_ these functions to do something. The functions are then _called_ by Hedgewars when a certain event has occoured. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
144 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
145 |
=== <tt>onGameInit()</tt> === |
860 | 146 |
This function is called before the game loads its resources. One can read and modify various game variables here. These variables will become globally available after `onGameInit` has been invoked, but changing them has only an effect in `onGameInit`. |
147 |
Most variables are optional, but for missions, `Theme` must be set by the scripter if you want to use a random map, rather than an image map. All other variables do not need to be set by the scripter and have default values. |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
148 |
|
860 | 149 |
List of game variables: |
863 | 150 |
|| *Identifier* || *Default* || *Description* || |
860 | 151 |
|| `Theme` || _depends_ || The theme to be used. When `Map` is set, a default value is used. For missions which don't use an image map, `Theme` *must* be set explicitly || |
152 |
|| `Map` || `""` || The image map being played or `""` if no image map is used || |
|
153 |
|| `Seed` || `0` || Seed of the random number generator || |
|
154 |
|| `MapGen` || `mgRandom` || Type of map generator. One of `mgRandom`, `mgMaze`, `mgPerlin`, `mgDrawn`. || |
|
155 |
|| `TemplateFilter` || `0` || _unknown meaning_ || |
|
156 |
|| `TemplateNumber` || `0` || _unknown meaning_ || |
|
864 | 157 |
|| `MapFeatureSize` || `50` || Used by random maps to determine its “curvyness” or complexity. This value can be set by the user with the slider under the random map preview in the game setup screen. The user-set value ranges from 1 (leftmost position) to 25 (rightmost position). A good starting value is `12`. || |
1251 | 158 |
|| `GameFlags` || `0` || All `GameFlags` combined as a bitmask. Setting `GameFlags` directly is discouraged, use the [LuaAPI#GameFlags_functions] instead || |
860 | 159 |
|| `Ready` || `5000` || Ready timer at the start of the turn (in milliseconds) || |
160 |
|| `Delay` || `100` || Delay between each turn in milliseconds || |
|
161 |
|| `TurnTime` || `45000` || Turn time in milliseconds || |
|
162 |
|| `GetAwayTime` || `100` || Retreat time in percent || |
|
163 |
|| `CaseFreq` || `5` || Probability that a crate drops in a turn. 0: never, >0: probability = `1/CaseFreq` || |
|
164 |
|| `HealthCaseProb` || `35` || Chance that a crate drop is a health crate, in percent (other crates are ammo or utility crates) || |
|
165 |
|| `HealthCaseAmount` || `25` || Amount of health in a health crate || |
|
166 |
|| `DamagePercent` || `100` || Global damage in percent, affects damage and knockback || |
|
167 |
|| `RopePercent` || `100` || Rope length in percent || |
|
168 |
|| `MinesNum` || `4` || Number of mines being placed on a medium-sized map || |
|
169 |
|| `MinesTime` || `3000` || Time for a mine to explode from activated (in milliseconds), `-1000` for random || |
|
170 |
|| `MineDudPercent` || `0` || Chance of mine being a dud, in percent || |
|
1111 | 171 |
|| `AirMinesNum` || `0` || Number of air mines being placed on a medium-sized map || |
860 | 172 |
|| `Explosives` || `2` || Number of barrels being placed on a medium-sized map || |
173 |
|| `SuddenDeathTurns` || `15` || Turns until Sudden Death begins || |
|
862 | 174 |
|| `WaterRise` || `47` || Height of water rise in pixels for each Sudden Death turn || |
861 | 175 |
|| `HealthDecrease` || `5` || Amount of health decreased on each turn in Sudden Death || |
860 | 176 |
|| `Goals` || `""` || Use this to add additional text to the goal text popup shown at the beginning and when using the quit or pause keys. The text is added to the default text which usually explains the game modifiers and does not replace it. Use `|` for line breaks. Also, all text before and including a `:` in a line will be highlighted. See also `ShowMission`. || |
1111 | 177 |
|| `WorldEdge` || `weNone` || Type edges being used at the left and right sides of the terrain (see below). || |
860 | 178 |
|| `ScreenWidth` || _N/A_ || Width of the Hedgewars window or screen || |
890 | 179 |
|| `ScreenHeight` || _N/A_ || Height of the Hedgewars window or screen || |
860 | 180 |
|
862 | 181 |
The proper way to disable Sudden Death is by setting both `WaterRise` and `HealthDecrease` to `0`. |
182 |
||
860 | 183 |
If you want to add teams or hogs manually, you have to do it here. If you want to draw your own map using `AddPoint` and `FlushPoints`, you have to do this within this function as well. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
184 |
|
917 | 185 |
==== `WorldEdge` ==== |
186 |
The value of `WorldEdge` can have the following values: |
|
187 |
||
188 |
|| *Identifier* || *Meaning* || |
|
189 |
|| `weNone` || No world edges || |
|
190 |
|| `weBounce` || Bouncy world edges || |
|
191 |
|| `weWrap` || World wraps around at the edges || |
|
192 |
|| `weSea` || Ocean world edges || |
|
193 |
||
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
194 |
=== <tt>onGameStart()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
195 |
This function is called when the first round starts. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
196 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
197 |
Can be used to show the mission and for more setup, for example initial target spawning. |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
198 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
199 |
=== <tt>onPreviewInit()</tt> === |
461 | 200 |
This function is called when the map preview in the frontend is initialized. This happens when the script is selected or you change a map generator parameter. |
201 |
||
202 |
It is useful for scripts which create their own maps (see `AddPoint` and `FlushPoints`). If you create a map in this function, a preview will be generated from this map and is exposed to the frontend. |
|
203 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
204 |
=== <tt>onParameters()</tt> === |
505 | 205 |
This function is called when the script parameters (as specified in the game scheme) become available. The script parameter string is stored in the global variable `ScriptParam`. |
206 |
||
207 |
Please note that it is normally not safe to call many of the other functions inside this function, this function is called very early in the game, only use this to initialize variables and other internal stuff like that. |
|
208 |
||
209 |
*Tip*: If you use the Params library (`/Scripts/Params.lua`), you can make the task of dissecting the string into useful values a bit easier, but it’s not required. (The Params library is not documented yet, however). |
|
210 |
||
211 |
*Tip*: If you use this callback, make sure to document the interpretation of the parameters so others know how to set the parameters properly. |
|
212 |
||
64
a651a8ab85d5
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
63
diff
changeset
|
213 |
=== <tt>onGameTick()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
214 |
This function is called on every game tick, i.e. 1000 times a second. If you just need to check on something periodically, consider `onGameTick20`. |
346
5f322c85c0e0
toss in onGameTick20 - this page needs more updating tho
kyberneticist@gmail.com
parents:
328
diff
changeset
|
215 |
|
5f322c85c0e0
toss in onGameTick20 - this page needs more updating tho
kyberneticist@gmail.com
parents:
328
diff
changeset
|
216 |
=== <tt>onGameTick20()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
217 |
This function is called every 20 game ticks, which equals 50 times a second. It reduces Lua overhead for simple monitoring that doesn’t need to happen every single tick. |
64
a651a8ab85d5
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
63
diff
changeset
|
218 |
|
181 | 219 |
=== <tt>onNewTurn()</tt> === |
1112 | 220 |
This function calls at the start of every turn. You can set `ReadyTimeLeft` here to change the ready time for this turn. (See also: `Ready`) |
63
24004a9003ec
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
62
diff
changeset
|
221 |
|
1189 | 222 |
=== <tt>onEndTurn()</tt> (0.9.24) === |
223 |
This function calls at the end of every turn. The end of a turn is defined as the point of time after the current hedgehog lost control and all the important gears are either gone or have settled. |
|
224 |
||
225 |
`CurrentHedgehog` holds the gear ID of the hedgehog whose turn just ended. |
|
226 |
||
227 |
This function is called at one of the earliest possible moment after the end of a turn. After this callback, Hedgewars then performs all the other stuff between turns. This includes things like: Applying poison or Sudden Death damage, calculating total hog damage, rising the water in Sudden Death, dropping a crate, checking victory, giving control to the next hog. |
|
228 |
||
229 |
Because this function is called *before* victories are checked, this is useful to set up your victory conditions here. |
|
230 |
||
1269 | 231 |
=== <tt>onSkipTurn()</tt> (0.9.24) === |
232 |
This function calls when a hog skips its turn. |
|
233 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
234 |
=== <tt>onSuddenDeath()</tt> === |
649 | 235 |
This function is called on the start of Sudden Death. |
236 |
||
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
237 |
=== <tt>onGearAdd(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
238 |
This function is called when a new gear is added. Useful in combination with `GetGearType(gearUid)`. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
239 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
240 |
=== <tt>onGearDelete(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
241 |
This function is called when a new gear is deleted. Useful in combination with `GetGearType(gearUid)`. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
242 |
|
916
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
243 |
=== <tt>onVisualGearAdd(vgUid)</tt> (0.9.23) === |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
244 |
This function is called when a new visual gear is added. Useful in combination with `GetVisualGearType(vgUid)`. |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
245 |
|
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
246 |
=== <tt>onVisualGearDelete(vgUid)</tt> (0.9.23) === |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
247 |
This function is called when a new visual gear is deleted. Useful in combination with `GetVisualGearType(vgUid)`. |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
248 |
|
181 | 249 |
=== <tt>onGearDamage(gearUid, damage)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
250 |
This function is called when a gear is damaged. |
55
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
251 |
|
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
252 |
Example: |
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
253 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
254 |
<code language="lua"> function onGearDamage(gear, damage) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
255 |
if (GetGearType(gear) == gtHedgehog) then |
55
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
256 |
-- adds a message saying, e.g. "Hoggy H took 25 points of damage" |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
257 |
AddCaption(GetHogName(gear) .. ' took ' .. damage .. ' points of damage') |
55
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
258 |
end |
ef26ff619aea
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
54
diff
changeset
|
259 |
end</code> |
181 | 260 |
=== <tt>onGearResurrect(gearUid) </tt> === |
942 | 261 |
This function is called when a gear is resurrected due to the hog effect `heResurrectable` being set (see `SetEffect`) and/or being an AI hog when the game modifier “AI Survival” (`gfAISurvival`) is active. It is *not* called when a hog was resurrected by the resurrector tool you can use in the game. |
44
bf53e635a2ac
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
43
diff
changeset
|
262 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
263 |
=== <tt>onAmmoStoreInit()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
264 |
This function is called when the game is initialized to request the available ammo and ammo probabilities. Use `SetAmmo` here. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
265 |
|
203
08cc35ba4d34
Edited wiki page LuaAPI through web user interface.
kyberneticist@gmail.com
parents:
202
diff
changeset
|
266 |
=== <tt>onNewAmmoStore(team/clan index, hog index)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
267 |
This function is identical to `onAmmoStoreInit` in function, but is called once per ammo store. This allows different ammo sets for each clan, team or hedgehog depending on the mode. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
268 |
If `gfSharedAmmo` is set, the parameters passed are the clan index, and `-1`, and the function will be called once for each clan. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
269 |
If `gfPerHogAmmo` is set, the parameters passed are the team index and the hog index in that team, and the function will be called once for each hedgehog. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
270 |
If neither is set, the parameters passed are the team index and `-1`, and the function will be called once for each team. |
202
47363108b6b6
Edited wiki page LuaAPI through web user interface.
kyberneticist@gmail.com
parents:
184
diff
changeset
|
271 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
272 |
These indexes can be used to look up details of the clan/team/hedgehog prior to gear creation. Routines to do these lookups will be created as needed. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
273 |
If you add this hook, the expectation is that you will call SetAmmo appropriately. Any values from `onAmmoStoreInit` are ignored. |
202
47363108b6b6
Edited wiki page LuaAPI through web user interface.
kyberneticist@gmail.com
parents:
184
diff
changeset
|
274 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
275 |
=== <tt>onGearWaterSkip(gear)</tt> === |
502 | 276 |
This function is called when the gear `gear` skips over water. |
277 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
278 |
=== <tt>onScreenResize()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
279 |
This function is called when you resize the screen. Useful place to put a redraw function for any `vgtHealthTags` you're using. |
145
547ac6a1d14e
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
144
diff
changeset
|
280 |
|
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
281 |
=== <tt>onAttack()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
282 |
This function is called when your Hedgehog attacks. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
283 |
|
107 | 284 |
=== <tt>onHJump()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
285 |
This function is called when you press the high jump key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
286 |
|
107 | 287 |
=== <tt>onLJump()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
288 |
This function is called when you press the long jump key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
289 |
|
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
290 |
=== <tt>onPrecise()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
291 |
This function is called when you press the precise key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
292 |
|
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
293 |
=== <tt>onLeft()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
294 |
This function is called when you press the left key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
295 |
|
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
296 |
=== <tt>onRight()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
297 |
This function is called when you press the right key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
298 |
|
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
299 |
=== <tt>onUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
300 |
This function is called when you press the up key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
301 |
|
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
302 |
=== <tt>onDown()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
303 |
This function is called when you press the down key. |
98
54e178bb6986
Added basic (not entirely accurate) entries for the event handlers relating to actions taken by Hedgehogs / user input.
RedGrinner@gmail.com
parents:
95
diff
changeset
|
304 |
|
181 | 305 |
=== <tt>onAttackUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
306 |
This function is called when you release the attack key. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
307 |
|
181 | 308 |
=== <tt>onDownUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
309 |
This function is called when you release the down key. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
310 |
|
535 | 311 |
=== <tt>onHogAttack(ammoType)</tt> === |
312 |
This function is called when you press the attack key. Beginning with 0.9.21, the parameter `ammoType` is provided. It contains the ammo type of the weapon used for the attack. |
|
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
313 |
|
181 | 314 |
=== <tt>onLeftUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
315 |
This function is called when you release the left key. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
316 |
|
181 | 317 |
=== <tt>onPreciseUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
318 |
This function is called when you release the precise key. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
319 |
|
181 | 320 |
=== <tt>onRightUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
321 |
This function is called when you release the right key. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
322 |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
323 |
=== <tt>onSetWeapon(msgParam)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
324 |
It is get called when a weapon is selected or switched. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
325 |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
326 |
`msgParam` tells you which ammo type was selected. |
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
327 |
|
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
328 |
=== <tt>onSlot(msgParam)</tt> === |
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
329 |
This function is called when one of the weapon slot keys has been pressed. |
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
330 |
|
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
331 |
`msgParam` tells the slot number minus 1 (i.e. `0` is for slot number 1, `1` is for slot number 2, etc.). |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
332 |
|
181 | 333 |
=== <tt>onSwitch()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
334 |
This function is called when a hog is switched to another. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
335 |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
336 |
=== <tt>onTaunt(msgParam)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
337 |
This function is called when the player uses an animated emote for example by using the chat commands `/wave`, `/juggle`, etc. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
338 |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
339 |
`msgParam` tells you which animation was played: |
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
340 |
|
623 | 341 |
|| *`msgParam`* || *Animation* || *Associated chat command* || |
342 |
|| 0 || Rolling up || `/rollup` || |
|
343 |
|| 1 || Sad face || `/sad` || |
|
344 |
|| 2 || Waving hand || `/wave` || |
|
345 |
|| 3 || Stupid winner's grin / “Awesome” face || `/hurrah` || |
|
346 |
|| 4 || Peeing || `/ilovelotsoflemonade` || |
|
347 |
|| 5 || Shrug || `/shrug` || |
|
348 |
|| 6 || Juggling || `/juggle` || |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
349 |
|
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
350 |
=== <tt>onTimer(msgParam)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
351 |
This function is called when one of the timer keys is pressed. |
175
2455fbbab5e8
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
174
diff
changeset
|
352 |
|
622
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
353 |
`msgParams` tells the set timer in seconds (i.e. `3` for the 3 seconds timer key). |
d7c2a5db19a4
Add msgParam for onSlot, onTaunt, onTimer and onSetWeapon
Wuzzy
parents:
616
diff
changeset
|
354 |
|
181 | 355 |
=== <tt>onUpUp()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
356 |
This function is called when you release the up key. |
178
dde460404412
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
177
diff
changeset
|
357 |
|
946 | 358 |
=== <tt>onUsedAmmo(ammoType)</tt> (0.9.23) === |
359 |
Called after a weapon has been used completely, with `ammoType` as the used ammo type. |
|
360 |
||
947 | 361 |
For example, it is called right after a bazooka is fired, when both shots of a shotgun have been fired, when extra time is used, or when all 4 shots of a portable portal device have been fired. It is also called when using a multi-shot ammo has been aborted by changing the weapon selection mid-way, because this still uses up the ammo. |
946 | 362 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
363 |
=== <tt>onHogHide(gearUid)</tt> === |
689 | 364 |
This function is called when a hedgehog with the gear ID `gearUid` is hidden (removed from the map). |
179
156e5fba2e2c
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
178
diff
changeset
|
365 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
366 |
=== <tt>onHogRestore(gearUid)</tt> === |
689 | 367 |
This function is called when a hedgehog with the specified gear ID `gearUid` is restored (unhidden). |
173
ef246592a16e
Edited wiki page LuaAPI through web user interface.
azizi.054@gmail.com
parents:
172
diff
changeset
|
368 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
369 |
=== <tt>onSpritePlacement(spriteId, centerX, centerY)</tt> === |
411 | 370 |
This function is called when a [Sprites Sprite] has been placed. |
371 |
||
372 |
`spriteID` is the type of the sprite, you find a list at [Sprites Sprites]. `centerX` and `centerY` are the coordinates of the center of the sprite. |
|
373 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
374 |
=== <tt>onGirderPlacement(frameIdx, centerX, centerY)</tt> === |
402
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
375 |
This function is called when a girder has been placed. |
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
376 |
|
940 | 377 |
`frameIdx` is used for the length and orientation of the girder. The possible values are explained in `PlaceGirder`. `centerX` and `centerY` are the coordinates of the girder’s center. |
402
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
378 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
379 |
=== <tt>onRubberPlacement(frameIdx, centerX, centerY)</tt> === |
402
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
380 |
This function is called when a rubber has been placed. |
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
381 |
|
940 | 382 |
`frameIdx` is used for the rubber orientation. The possible values are explained in `PlaceRubber`. `centerX` and `centerY` are the coordinates of the rubber’s center. |
402
1e7586c110f6
Documented 0.9.21 functions onGirderPlacement and onRubberPlacement.
almikes@aol.com
parents:
401
diff
changeset
|
383 |
|
1223
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
384 |
=== `onSpecialPoint(x, y, flags)` === |
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
385 |
This is used while a special hand-drawn map is loaded. The engine is building these hand-drawn maps by reading points from the map definition. Optionally, some of these points may be “special”. These are not actually drawn on the map, but are used to store additional information for a position on the map. Special points currently need to be added manually in the map, the in-game editor is not able to add those yet (as of 0.9.23). |
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
386 |
Now, when such a special point at the coordinates `x` and `y` with an assigned value of `flags` is added, this function is called. `flags` is a whole number between `0` and `255` inclusive. |
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
387 |
|
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
388 |
This function is used in Racer and !TechRacer to define waypoints. |
868b783afc88
LuaAPI: Add onSpecialPoints. I hope it's more or less correct
Wuzzy
parents:
1221
diff
changeset
|
389 |
|
1225
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
390 |
=== `onAchievementsDeclaration()` === |
1229 | 391 |
This function is called after the stats for the stats screen (after the game) have been generated. You are supposed to call `DeclareAchievement` here. |
1225
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
392 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
393 |
== Functions for creating gears == |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
394 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
395 |
=== <tt>!AddGear(x, y, gearType, state, dx, dy, timer)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
396 |
This creates a new gear at position x,y (measured from top left) of kind `gearType` (see [GearTypes Gear Types]). The initial velocities are `dx` and `dy`. All arguments are numbers. The function returns the `uid` of the gear created. Gears can have multple states at once: `state` is a bitmask, the flag variables can be found in [States]. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
397 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
398 |
Example: |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
399 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
400 |
<code language="lua"> local gear = AddGear(0, 0, gtTarget, 0, 0, 0, 0) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
401 |
FindPlace(gear, true, 0, LAND_WIDTH)</code> |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
402 |
|
1165 | 403 |
=== <tt>!AddVisualGear(x, y, visualGearType, state, critical [, layer])</tt> === |
404 |
This creates a new visual gear at position x,y (measured from top left) of kind `visualGearType` (see [VisualGearTypes Visual Gear Types]). The function returns the `uid` of the visual gear created. Set `critical` to `true` if the visual gear is crucial to game play. Use `false` if it is just an effect, and can be skipped when in fast-forward mode (such as when joining a room). A critical visual gear will always be created, a non-critical one may fail. Most visual gears delete themselves. You can set an optional `layer` to specify which visual gears get drawn on top. |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
405 |
|
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
406 |
Example: |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
407 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
408 |
<code language="lua"> -- adds an non-critical explosion at position 1000,1000. Returns 0 if it was not created. |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
409 |
vgear = AddVisualGear(1000, 1000, vgtExplosion, 0, false) |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
410 |
</code> |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
411 |
|
871
3222b4cfef8a
LuaAPI: Additional parameter for SpawnHealthCrate, SpawnAmmoCrate, SpawnUtilityCrate
Wuzzy
parents:
869
diff
changeset
|
412 |
=== <tt>!SpawnHealthCrate(x, y, [, health])</tt> === |
1235
dae4580eca94
LuaAPI: Discourage negative health for health crates
Wuzzy
parents:
1232
diff
changeset
|
413 |
Spawns a health crate at the specified position. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land). Set `health` for the initial health contained in the health crate. If not set, the default health (`HealthCaseAmount`) is used. Do not use a negative value for `health`. |
417
f4b7962d39cd
Better documentation about the special coordinates x=0, y=0 for the crate spawn functions.
almikes@aol.com
parents:
416
diff
changeset
|
414 |
|
1189 | 415 |
=== <tt>!SpawnSupplyCrate(x, y, ammoType [, amount])</tt> (0.9.24) === |
416 |
Spawns an ammo or utility crate at the specified position with the given ammo type and an optional amount (default: 1). The crate type is chosen automatically based on the ammo type. |
|
417 |
Otherwise, this function behaves like `SpawnAmmoCrate`. |
|
418 |
||
871
3222b4cfef8a
LuaAPI: Additional parameter for SpawnHealthCrate, SpawnAmmoCrate, SpawnUtilityCrate
Wuzzy
parents:
869
diff
changeset
|
419 |
=== <tt>!SpawnAmmoCrate(x, y, ammoType [, amount])</tt> === |
1189 | 420 |
Spawns an ammo crate at the specified position with content of `ammoType` (see [AmmoTypes Ammo Types]). Any `ammoType` is permitted, an ammo crate is spawned even if the ammo is normally defined as an utility. |
421 |
If `ammoType` is set to `amNothing`, a random weapon (out of the available weapons from the weapon scheme) will be selected. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land). The `amount` parameter specifies the amount of ammo contained in the crate. If `amount` is `nil` or `0`, the value set by `SetAmmo` is used, or if `SetAmmo` has not been used, it falls back to the weapon scheme's value. If ´amount` is equal to or greater than `100` or greater, the amount is infinite. |
|
1031
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
422 |
|
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
423 |
Note that in Lua missions, the default number of ammo in crates is 0, so it has to be set to at least 1 with `SetAmmo` first, see the example: |
417
f4b7962d39cd
Better documentation about the special coordinates x=0, y=0 for the crate spawn functions.
almikes@aol.com
parents:
416
diff
changeset
|
424 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
425 |
Example: |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
426 |
|
1033 | 427 |
<code language="lua"> SetAmmo(amGrenade, 0, 0, 0, 1) -- grenade ammo crates now contain 1 grenade each |
428 |
SpawnAmmoCrate(0, 0, amGrenade) -- spawn grenade ammo crate at random position</code> |
|
417
f4b7962d39cd
Better documentation about the special coordinates x=0, y=0 for the crate spawn functions.
almikes@aol.com
parents:
416
diff
changeset
|
429 |
|
871
3222b4cfef8a
LuaAPI: Additional parameter for SpawnHealthCrate, SpawnAmmoCrate, SpawnUtilityCrate
Wuzzy
parents:
869
diff
changeset
|
430 |
=== <tt>!SpawnUtilityCrate(x, y, ammoType [, amount])</tt> === |
881
ab6bd4812ca4
LuaAPI: special amNothing for SpawnAmmoCrate / SpawnUtilityCrate
Wuzzy
parents:
871
diff
changeset
|
431 |
Spawns an utility crate with some ammo at the specified position. The function behaves almost like `SpawnAmmoCrate`, the differences are 1) the crate looks different and 2) if `ammoType` is set to `amNothing`, a random utility out of the set of available utilities from the weapon scheme is chosen as content. |
417
f4b7962d39cd
Better documentation about the special coordinates x=0, y=0 for the crate spawn functions.
almikes@aol.com
parents:
416
diff
changeset
|
432 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
433 |
Example: |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
434 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
435 |
<code language="lua"> SetAmmo(amLaserSight, 0, 0, 0, 1) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
436 |
SpawnUtilityCrate(0, 0, amLaserSight)</code> |
400 | 437 |
|
438 |
=== <tt>!SpawnFakeAmmoCrate(x, y, explode, poison) </tt> === |
|
417
f4b7962d39cd
Better documentation about the special coordinates x=0, y=0 for the crate spawn functions.
almikes@aol.com
parents:
416
diff
changeset
|
439 |
Spawns a crate at the specified coordinates which looks exactly like a real ammo crate but contains not any ammo. It can be use useful for scripted events or to create a trap. If `x` and `y` are set to 0, the crate will spawn on a random position (but always on land). |
400 | 440 |
`explode` and `poison` are booleans. |
441 |
If `explode` is `true`, the crate will explode when collected. |
|
442 |
If `poison` is `true`, the collector will be poisoned. |
|
443 |
||
444 |
Example: |
|
445 |
||
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
446 |
<code language="lua">SpawnFakeAmmoCrate(500, 432, false, false) -- Spawns a fake ammo crate at the coordinates (500, 434) without explosion and poison. |
400 | 447 |
</code> |
448 |
||
449 |
=== <tt>!SpawnFakeHealthCrate(x, y, explode, poison) </tt> === |
|
1241
50cb37fde767
LuaAPI: Simplify SpawnFakeHealthCrate and SpawnFakeUtilityCrate
Wuzzy
parents:
1240
diff
changeset
|
450 |
Same as `SpawnFakeAmmoCrate`, except the crate will look like a health crate. |
400 | 451 |
|
452 |
=== <tt>!SpawnFakeUtilityCrate(x, y, explode, poison) </tt> === |
|
1241
50cb37fde767
LuaAPI: Simplify SpawnFakeHealthCrate and SpawnFakeUtilityCrate
Wuzzy
parents:
1240
diff
changeset
|
453 |
Same as `SpawnFakeAmmoCrate`, except the crate will look like an utility crate. |
400 | 454 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
455 |
=== <tt>!AddHog(hogname, botlevel, health, hat)</tt> === |
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
456 |
Adds a new hedgehog for current team (last created one with the `AddTeam` function), with bot level and specified health, also hat. |
556
e57188e7bc3b
Better explanation of botlevel (AddHog argument).
almikes@aol.com
parents:
555
diff
changeset
|
457 |
`botlevel` ranges from `0` to `5`, where `0` denotes a human player and `1` to `5` denote the skill level of a bot, where `1` is strongest and `5` is the weakest. Note that this is the reverse order of how the bot level is displayed in the game. |
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
458 |
|
1159 | 459 |
*Warning*: This only works in singleplayer mode (e.g. missions). Also, Hedgewars only supports up to 48 hedgehogs in a game. If you add more hedgehogs or call this function in multiplayer mode, Hedgewars might fail. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
460 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
461 |
Example: |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
462 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
463 |
<code language="lua"> local player = AddHog("HH 1", 0, 100, "NoHat") -- botlevel 0 means human player |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
464 |
SetGearPosition(player, 1500, 1000)</code> |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
465 |
== Functions to get gear properties == |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
466 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
467 |
=== <tt>!GetGearType(gearUid)</tt> === |
891 | 468 |
This function returns the [GearTypes gear type] for the specified gear. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
469 |
|
916
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
470 |
=== <tt>!GetVisualGearType(vgUid)</tt> (0.9.23) === |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
471 |
This function returns the [VisualGearTypes visual gear type] for the specified visual gear. |
a01743eb08f1
LuaAPI: onVisualGearAdd, onVisualGearDelete, GetVisualGearType
Wuzzy
parents:
913
diff
changeset
|
472 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
473 |
=== <tt>!GetGearPosition(gearUid)</tt> === |
891 | 474 |
Returns x,y coordinates for the specified gear. Not to be confused with `GetGearPos`. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
475 |
|
1244 | 476 |
=== `GetGearCollisionMask(gearUid)` === |
477 |
Returns the current collision mask of the given gear. See `SetGearCollisionMask` for an explanation of the mask. |
|
478 |
||
181 | 479 |
=== <tt>!GetGearRadius(gearUid)</tt> === |
892 | 480 |
Returns the `Radius` value for the specified gear. For most [GearTypes gear types] for “projectile” gears (like `gtShell` or `gtGrenade`), the radius refers to the gear's collision radius. This is an invisible circle around the center of the gear which is used for the collision checks. For a few gear types, its radius means something different, see [Gear Types] for a full list. |
481 |
||
482 |
To set the `Radius` value, use `SetGearValues`. |
|
148
f343b50d5619
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
147
diff
changeset
|
483 |
|
181 | 484 |
=== <tt>!GetGearVelocity(gearUid)</tt> === |
555 | 485 |
Returns a tuple of dx,dy values for the specified gear. |
486 |
||
487 |
=== <tt>!GetFlightTime(gearUid)</tt> === |
|
488 |
Returns the `FlightTime` of the specified gear. The `FlightTime` is a gear varialbe used to store a general time interval. The precise meaning of the `FlightTime` depends on the gear type. |
|
489 |
||
490 |
For example: The `FlightTime` of a hedgehog (`gtHedgehog`) is the time since they last have stood on solid ground. For most projectile gear types (i.e. `gtShell`), it stores the time after it has been launched. |
|
71
2dcbebb06088
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
70
diff
changeset
|
491 |
|
181 | 492 |
=== <tt>!GetGearElasticity(gearUid) </tt> === |
611 | 493 |
Returns the elasticity of the specified gear. The elasticity normally determines how strong the gear will bounce after collisions, where higher elasticity is for stronger bounces. |
494 |
||
495 |
This is also useful for determining if a hog is on a rope or not. If a hog is attached to a rope, or is busy firing one, the elasticity of the rope will be non-zero. |
|
496 |
||
497 |
=== <tt>!GetGearFriction(gearUid) </tt> === |
|
498 |
Returns the friction of the specified gear. The friction normally determines how well the gear will slide on terrain. Higher values are for increased sliding properties. |
|
74 | 499 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
500 |
=== <tt>!GetHogClan(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
501 |
Returns the clan ID of the specified hedgehog gear. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
502 |
|
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
503 |
=== <tt>!GetHogTeamName(gearUid)</tt> === |
1039 | 504 |
Returns the name of the specified gear’s team. `gearUid` can be a hedgehog or a grave. |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
505 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
506 |
=== <tt>!GetHogName(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
507 |
Returns the name of the specified hedgehog gear. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
508 |
|
140
04d82b673bc4
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
139
diff
changeset
|
509 |
=== <tt>!GetEffect(gearUid, effect)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
510 |
Returns the state of given effect for the given hedgehog gear. |
140
04d82b673bc4
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
139
diff
changeset
|
511 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
512 |
See `SetEffect` for further details. |
373 | 513 |
|
133
b737ccb5b49a
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
132
diff
changeset
|
514 |
=== <tt>!GetHogHat(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
515 |
Returns the hat of the specified hedgehog gear. |
133
b737ccb5b49a
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
132
diff
changeset
|
516 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
517 |
=== <tt>!GetHogFlag(gearUid)</tt> === |
610 | 518 |
Returns the name of the flag of the team of the specified hedgehog gear. |
519 |
||
932 | 520 |
=== <tt>!GetHogFort(gearUid)</tt> (0.9.23) === |
521 |
Returns the name of the fort of the team of the specified hedgehog gear. |
|
522 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
523 |
=== <tt>!GetHogGrave(gearUid)</tt> === |
610 | 524 |
Returns the name of the grave of the team of the specified hedgehog gear. |
525 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
526 |
=== <tt>!GetHogVoicepack(gearUid)</tt> === |
610 | 527 |
Returns the name of the voicepack of the team of the specified hedgehog gear. |
528 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
529 |
=== <tt>!GetAmmoCount(gearUid, ammoType)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
530 |
Returns the ammo count of the specified ammo type for the specified hedgehog gear. |
133
b737ccb5b49a
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
132
diff
changeset
|
531 |
|
913 | 532 |
=== <tt>!IsHogLocal(gearUid)</tt> (0.9.23) === |
1190 | 533 |
Returns `true` if the specified hedgehog gear is controlled by a human player on the computer on which Hedgewars runs on (i.e. not over a computer over the network). Also returns `true` if the hog is a member of any of the local clans. Returns `false` otherwise. Returns `nil` if `gearUid` is invalid. |
534 |
||
535 |
This is perfect to hide certain captions like weapon messages from enemy eyes. |
|
913 | 536 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
537 |
=== <tt>!GetGearTarget(gearUid, x, y) </tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
538 |
Returns the x and y coordinate of target-based weapons/utilities. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
539 |
<b>Note:</b>: This can’t be used in `onGearAdd()` but must be called after gear creation. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
540 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
541 |
=== <tt>GetX(gearUid)</tt> === |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
542 |
Returns x coordinate of the gear. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
543 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
544 |
=== <tt>GetY(gearUid)</tt> === |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
545 |
Returns y coordinate of the gear. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
546 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
547 |
=== <tt>!GetState(gearUid)</tt> === |
415
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
548 |
Returns the state of the gear. The gear state is a bitmask which is built out of the variables as shown in [States]. |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
549 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
550 |
This function is usually used in combination with `band` to extract the truth value of a single flag. It is also used together with `SetState` and `bor` in order to activate a single flag. |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
551 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
552 |
Examples: |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
553 |
<code language="lua"> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
554 |
local state = GetState(gear) |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
555 |
--[[ Stores the full raw bitmask of gear in state. Usually |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
556 |
useless on its own. ]] |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
557 |
</code> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
558 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
559 |
<code language="lua"> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
560 |
isDrowning = band(GetState(CurrentHedgehog),gstDrowning) ~= 0 |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
561 |
--[[ GetState(CurrentHedgehog) returns the state bitmask of |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
562 |
CurrentHedgehog, gstDrowning is a bitmask where only the |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
563 |
“drowning” bit is set. band does a bitwise AND on both, if |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
564 |
it returns a non-zero value, the hedgehog is drowning.]] |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
565 |
</code> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
566 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
567 |
<code language="lua"> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
568 |
SetState(CurrentHedgehog, bor(GetState(CurrentHedgehog), gstInvisible)) |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
569 |
--[[ first the state bitmask of CurrentHedgehog is bitwise ORed with |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
570 |
the gstInvisible flag, thus making the bit responsible for |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
571 |
invisiblity to become 1. Then the new bitmask is applied to |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
572 |
CurrentHedgehog, thus making it invisible.]] |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
573 |
</code> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
574 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
575 |
|
114
e311af715b57
Edited wiki page LuaAPI through web user interface.
henrik.rostedt@gmail.com
parents:
107
diff
changeset
|
576 |
=== <tt>!GetGearMessage(gearUid)</tt> === |
625 | 577 |
Returns the message of the gear. This is a bitmask built out of flags seen in [GearMessages]. |
419 | 578 |
|
579 |
=== <tt>!GetTag(gearUid)</tt> === |
|
580 |
Returns the tag of the specified gear (by `gearUid`). |
|
581 |
||
891 | 582 |
The `Tag` of a gear is just another arbitrary variable to hold the gear's state. The meaning of a tag depends on the gear type. For example, for `gtBall` gears, it specifies the ball color, for `gtAirAttack` gears (airplane) it specifies the direction of the plane, etc. See [GearTypes] for a full list. The returned value will be an integer. |
419 | 583 |
|
584 |
Note that the word “tag” here does _not_ refer to the name and health tags you see above hedgehogs, this is something different. |
|
585 |
||
586 |
<code language="lua"> |
|
587 |
-- This adds a ball (the one from the ballgun) at (123, 456): |
|
588 |
ball = AddGear(123, 456, gtBall, 0, 0, 0, 0) |
|
589 |
-- The tag of a ball defines its color. It will automatically chosen at random when created. |
|
590 |
colorTag = GetTag(ball) |
|
591 |
-- Now colorTag stores the tag of ball (in this case a number denoting its color) |
|
592 |
</code> |
|
593 |
||
421
d584704354ad
Add link to GearTypes for SetTag and GetTag.
almikes@aol.com
parents:
419
diff
changeset
|
594 |
The meaning of tags are described in [GearTypes]. |
419 | 595 |
|
209
26805ae2a319
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
203
diff
changeset
|
596 |
=== <tt>!GetFollowGear()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
597 |
Returns the uid of the gear that is currently being followed. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
598 |
|
181 | 599 |
=== <tt>!GetTimer(gearUid)</tt> === |
891 | 600 |
Returns the timer of the gear. This is for example the time it takes for watermelon, mine, etc. to explode. This is also the time used to specify the blowtorch or RC plane time. See [GearTypes] for a full list. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
601 |
|
181 | 602 |
=== <tt>!GetHealth(gearUid)</tt> === |
891 | 603 |
Returns the health of the gear. Depending on the gear type, the gear's “health” can also refer to other things, see [GearTypes] for a full list. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
604 |
|
181 | 605 |
=== <tt>!GetHogLevel(gearUid)</tt> === |
1243 | 606 |
Returns the bot level ranging from `0` to `5`. `1` is the strongest bot level and `5` is the weakest one (this is the reverse of what players see). `0` is for human player. |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
607 |
|
503 | 608 |
=== <tt>!GetGearPos(gearUid)</tt> === |
891 | 609 |
Get the `Pos` value of the specified gear. `Pos` is just another arbitrary value to hold the state of the gear, such as `Tag` and `Health`, the meaning depends on the gear type. See [GearTypes] for the conrete meaning of a gear's `Pos` value. |
610 |
||
611 |
*Important*: Pos is *not* related to the gear's position, use `GetGearPosition` for that. |
|
503 | 612 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
613 |
=== <tt>!GetGearValues(gearUid)</tt> === |
616 | 614 |
This returns a bunch of values associated with the gear, their meaning is often depending on the gear type and many values might be unused for certain gear types. |
612 | 615 |
|
616 |
This is returned (all variables are integers): |
|
617 |
||
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
618 |
`Angle, Power, WDTimer, Radius, Density, Karma, DirAngle, AdvBounce, ImpactSound, nImpactSounds, Tint, Damage, Boom` |
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
619 |
|
612 | 620 |
A rough description of some of the parameters: |
615 | 621 |
|
622 |
* `Radius`: Effect or collision radius, most of the time |
|
625 | 623 |
* `ImpactSound`: Sound it makes on a collision (see [Sounds]) |
615 | 624 |
* `Tint`: Used by some gear types to determine its colorization. The color is in RGBA format. |
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
625 |
* `Boom`: Used by most gears to determine the damage dealt. |
612 | 626 |
|
627 |
Example: |
|
628 |
<code language="lua"> |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
629 |
-- Get all values in a single line of code: |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
630 |
local Angle, Power, WDTimer, Radius, Density, Karma, DirAngle, AdvBounce, ImpactSound, nImpactSounds, Tint, Damage, Boom = GetGearValues(myGear) |
612 | 631 |
</code> |
632 |
||
181 | 633 |
=== <tt>!GetVisualGearValues(vgUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
634 |
This returns the typically set visual gear values, useful if manipulating things like smoke or bubbles or circles. It returns the following values: |
614 | 635 |
|
636 |
`X, Y, dX, dY, Angle, Frame, FrameTicks, State, Timer, Tint` |
|
637 |
||
615 | 638 |
* `X`, `Y`: typically position |
639 |
* `dX`, `dY`: typically speed |
|
640 |
* `Angle` is usually the rotation angle |
|
641 |
* `Frame` is typically the animation frame |
|
642 |
* `FrameTicks` is usually an animation counter |
|
643 |
* `State` can have a variety of values, but is typically bit packed |
|
644 |
* `Timer` is usually the gear lifetime |
|
645 |
* `Tint` is the RGBA color |
|
614 | 646 |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
647 |
Most visual gears require little to no modification of parameters. |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
648 |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
649 |
Example: |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
650 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
651 |
<code language="lua"> GetVisualGearValues(vgUid) -- return visual gear values |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
652 |
</code> |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
653 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
654 |
== Functions to modify gears == |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
655 |
|
243
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
656 |
=== <tt>!HideHog(gearUid)</tt> === |
1004 | 657 |
Removes a hedgehog from the map. The hidden hedgehog can be restored with `RestoreHog(gearUid)`. Since 0.9.23, returns `true` on success and `false` on failure (if gear does not exist / hog is already hidden). |
243
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
658 |
|
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
659 |
Example: |
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
660 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
661 |
<code language="lua"> gear = AddGear(...) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
662 |
HideHog(gear) -- Hide the newly created gear.</code> |
243
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
663 |
|
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
664 |
=== <tt>!RestoreHog(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
665 |
Restores a previously hidden hedgehog. |
243
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
666 |
|
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
667 |
Example: |
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
668 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
669 |
<code language="lua"> gear = AddGear(...) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
670 |
HideHog(gear) -- Hide the newly created gear. |
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
671 |
RestoreHog(gear) -- Restore the newly hidden gear.</code> |
243
ac34d3763a17
Edited wiki page LuaAPI through web user interface.
szabibibi@gmail.com
parents:
209
diff
changeset
|
672 |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
673 |
=== <tt>!DeleteGear(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
674 |
Deletes a gear. |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
675 |
|
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
676 |
Example: |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
677 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
678 |
<code language="lua"> gear = AddGear(...) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
679 |
DeleteGear(gear) -- Delete the newly created gear.</code> |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
680 |
|
181 | 681 |
=== <tt>!DeleteVisualGear(vgUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
682 |
Deletes a visual gear. Note, most visual gears delete themselves. |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
683 |
|
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
684 |
Example: |
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
685 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
686 |
<code language="lua"> vgear = AddVisualGear(...) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
687 |
DeleteVisualGear(vgear) -- Delete the newly created visual gear.</code> |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
688 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
689 |
=== <tt>!SetGearValues(gearUid, Angle, Power, WDTimer, Radius, Density, Karma, DirAngle, AdvBounce, ImpactSound, ImpactSounds, Tint, Damage, Boom)</tt> === |
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
690 |
Sets various gear value for the specified gear (`gearUid`). The meaining of each value often depends on the gear type. See the documentation on !GetGearValues for a brief description of the gear values. |
612 | 691 |
|
692 |
Set `nil` for each value you do not want to change. |
|
693 |
||
694 |
Example: |
|
695 |
<code language="lua"> |
|
696 |
-- Paints all RC planes into a white color |
|
697 |
function onGearAdd(gear) |
|
698 |
if GetGearType(gear) == gtRCPlane then |
|
699 |
SetGearValues(gear, nil, nil, nil, nil, nil, nil, nil, nil, nil, nil, 0xFFFFFFFF) |
|
700 |
end |
|
701 |
end |
|
702 |
</code> |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
703 |
|
554 | 704 |
=== <tt>!SetVisualGearValues(vgUid, X, Y, dX, dY, Angle, Frame, !FrameTicks, State, Timer, Tint)</tt> === |
1188 | 705 |
This allows manipulation of many of the visual gear values of the visual gear `vgUid`. All visual gear values are numbers. Each visual gear may be using these parameters differently, but the *usual* meaning of these is the following: |
613 | 706 |
|
615 | 707 |
* `X`, `Y`: Position |
1188 | 708 |
* `dX`, `dY`: Speed along the X and Y axis |
709 |
* `Angle`: Current rotation |
|
710 |
* `Frame`: Image frame, if using a sprite sheet |
|
711 |
* `FrameTicks`: ??? |
|
712 |
* `State`: Helper value to save some internal state |
|
713 |
* `Timer`: Time in milliseconds until it expires |
|
615 | 714 |
* `Tint`: RGBA color |
613 | 715 |
|
1188 | 716 |
Some visual gears interpret these values differently, just like normal gears. See [VisualGearTypes] for details. Also, most visual gears are not even using some of these values. |
717 |
||
718 |
Note that most visual gears require little to no modification of their values. |
|
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
719 |
|
613 | 720 |
Example 1: |
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
721 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
722 |
<code language="lua"> -- set a circle to position 1000,1000 pulsing from opacity 20 to 200 (8%-78%), radius of 50, 3px thickness, bright red. |
552 | 723 |
SetVisualGearValues(circleUid, 1000,1000, 20, 200, 0, 0, 100, 50, 3, 0xff0000ff)</code> |
724 |
||
1188 | 725 |
Only the first argument is required. Everything else is optional. Any such argument which is declared as `nil` will not overwrite the corresponding value of the visual gear. |
552 | 726 |
|
613 | 727 |
Example 2: |
552 | 728 |
|
1188 | 729 |
<code language="lua"> -- set a visual gear to position 1000,1000 |
552 | 730 |
SetVisualGearValues(circleUid, 1000, 1000)</code> |
1188 | 731 |
<code language="lua"> -- set the tint of a visual gear to bright red. |
552 | 732 |
SetVisualGearValues(circleUid, nil, nil, nil, nil, nil, nil, nil, nil, nil, 0xff0000ff)</code> |
733 |
||
39
45a576e56425
Updating with visual gear functions and delete gear
kyberneticist
parents:
38
diff
changeset
|
734 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
735 |
=== <tt>!FindPlace(gearUid, fall, left, right[, tryHarder])</tt> === |
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
736 |
Finds a place for the specified gear between x=`left` and x=`right` and places it there. `tryHarder` is optional, setting it to `true`/`false` will determine whether the engine attempts to make additional passes, even attempting to place gears on top of each other. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
737 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
738 |
Example: |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
739 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
740 |
<code language="lua"> gear = AddGear(...) |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
741 |
FindPlace(gear, true, 0, LAND_WIDTH) -- places the gear randomly between 0 and LAND_WIDTH</code> |
1254 | 742 |
=== `HogSay(gearUid, text, manner [,vgState])` === |
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
743 |
Makes the specified gear say, think, or shout some text in a comic-style speech or thought bubble. `gearUid` is _not_ limited to hedgehogs, altough the function name suggests otherwise. |
533 | 744 |
|
745 |
The `manner` parameter specifies the type of the bubble and can have one of these values: |
|
59
233360620ae2
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
58
diff
changeset
|
746 |
|
533 | 747 |
|| *Value of `manner`* || *Looks* || |
748 |
|| `SAY_THINK` || Thought bubble || |
|
749 |
|| `SAY_SAY` || Speech bubble || |
|
750 |
|| `SAY_SHOUT` || Exclamatory bubble (denotes shouting) || |
|
59
233360620ae2
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
58
diff
changeset
|
751 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
752 |
There is a optional 4th parameter `vgState`, it defines wheather the speechbubble is drawn fully opaque or semi-transparent. The value `0` is the default value. |
533 | 753 |
|
754 |
|| *Value of `vgState`* || *Effect* || |
|
755 |
|| `0` || If the specified gear is a hedgehog, and it’s the turn of the hedgehog’s team, the bubble is drawn fully opaque.<br>If the gear is a hedgehog, and it’s another team’s turn, the bubble is drawn translucent.<br>If the gear is not a hedgehog, the bubble is drawn fully opaque. || |
|
756 |
|| `1` || The bubble is drawn translucent. || |
|
757 |
|| `2` || The bubble is drawn fully opaque. || |
|
758 |
||
759 |
Examples: |
|
760 |
||
761 |
<code language="lua">HogSay(CurrentHedgehog, "I wonder what to do …", SAY_THINK) -- thought bubble with text “I wonder what to do …”</code> |
|
762 |
<code language="lua">HogSay(CurrentHedgehog, "I'm hungry.", SAY_SAY) -- speech bubble with text “I’m hungry.”</code> |
|
763 |
<code language="lua">HogSay(CurrentHedgehog, "I smell CAKE!", SAY_SHOUT) -- exclamatory bubble with text “I smell CAKE!”</code> |
|
52
714b56de5ea1
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
51
diff
changeset
|
764 |
=== <tt>!HogTurnLeft(gearUid, boolean)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
765 |
Faces the specified hog left or right. |
52
714b56de5ea1
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
51
diff
changeset
|
766 |
|
714b56de5ea1
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
51
diff
changeset
|
767 |
Example: |
714b56de5ea1
Edited wiki page LuaAPI through web user interface.
RedGrinner
parents:
51
diff
changeset
|
768 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
769 |
<code language="lua"> HogTurnLeft(CurrentHedgehog, true) -- turns CurrentHedgehog left |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
770 |
HogTurnLeft(CurrentHedgehog, false) -- turns CurrentHedgehog right</code> |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
771 |
=== <tt>!SetGearPosition(gearUid, x, y)</tt> === |
891 | 772 |
Places the specified gear exactly at the position (`x`,`y`). Not to be confused with `SetGearPos`. |
71
2dcbebb06088
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
70
diff
changeset
|
773 |
|
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
774 |
=== `SetGearCollisionMask(gearUid, mask)` === |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
775 |
Set the collision mask of the given gear with `gearUid`. |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
776 |
The collision mask defines with which gears and terrain types the gear can collide. |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
777 |
|
1228 | 778 |
`mask` is a number between `0x0000` and `0xFFFF` and used as a bitfield, which means you can combine these flags with `bor`. These are the available flags (excerpt): |
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
779 |
|
1228 | 780 |
|| *Flag* || *Collision with …* || |
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
781 |
|| `0xFF00` || Terrain || |
1228 | 782 |
|| `0x0080` || Current hedgehog and crates || |
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
783 |
|| `0x000F` || Other hedgehogs || |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
784 |
|| `0x0070` || Mines and explosives || |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
785 |
|
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
786 |
Beware, the collision mask is often set by the engine as well. |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
787 |
|
1228 | 788 |
Examples: |
1231 | 789 |
<code language="lua">SetGearCollisionMask(gear, 0xFF7F) |
790 |
-- Ignore collision with current hedgehog</code> |
|
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
791 |
|
1231 | 792 |
<code language="lua">SetGearCollisionMask(gear, 0xFFFF) |
793 |
-- Collide with everything</code> |
|
1228 | 794 |
|
1231 | 795 |
<code language="lua">SetGearCollisionMask(gear, 0x00FF) |
796 |
-- Collide with hedgehogs and objects</code> |
|
1228 | 797 |
|
1231 | 798 |
<code language="lua">SetGearCollisionMask(gear, 0x0000) |
799 |
-- Collide with nothing</code> |
|
1228 | 800 |
|
801 |
There are actual more flags availbable, but they are not as useful for use in Lua. You can find the full range of flags in the engine source code (in Pascal): |
|
1227
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
802 |
https://hg.hedgewars.org/hedgewars/file/default/hedgewars/uConsts.pas#l112 |
edda2e2b973f
LuaAPI: Add SetGearCollisionMask and GetGearCollisionMask
Wuzzy
parents:
1226
diff
changeset
|
803 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
804 |
=== <tt>!SetGearVelocity(gearUid, dx, dy)</tt> === |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
805 |
Gives the specified gear the velocity of `dx`, `dy`. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
806 |
|
555 | 807 |
=== <tt>!SetFlightTime(gearUid, flighttime)</tt> === |
808 |
Sets the `FlightTime` of the given gear to `flighttime`. The meaning of `FlightTime` is explained in the section `GetFlightTime`. |
|
809 |
||
611 | 810 |
=== <tt>!SetGearElasticity(gearUid, Elasticity) </tt> === |
811 |
Sets the elasticity of the specified gear. For most gears, the elasticity determines how strong the gear will bounce after collisions, where higher elasticity is for stronger bounces. Recommended are values between `0` and `9999`. |
|
812 |
||
813 |
=== <tt>!SetGearFriction(gearUid, Friction) </tt> === |
|
814 |
Sets the friction of the specified gear. The friction normally determines how well the gear will slide on terrain. Higher values are for increased sliding properties. `0` is for no sliding whatsoever, where `9999` is for very long slides, greater values are not recommended. |
|
815 |
||
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
816 |
=== <tt>!SetHealth(gearUid, health)</tt> === |
891 | 817 |
Sets the health of the specified gear. The “health” of a gear can refer to many things, depending on the gear type. |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
818 |
|
891 | 819 |
Use cases: |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
820 |
|
891 | 821 |
* Setting the health of a hedgehog (`gtHedgehog`) to 99 |
822 |
* Starting the RC Plane (`gtRCPlane`) with 10 bombs |
|
823 |
* Starting flying saucer (`gtJetpack`) with only 50% fuel |
|
824 |
* Setting all the mines (`gtMine`) to duds |
|
825 |
* And more! |
|
826 |
||
827 |
See [GearTypes] for a full description. |
|
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
828 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
829 |
<code language="lua"> function onGearAdd(gear) |
891 | 830 |
if (GetGearType(gear) == gtHedgehog) then |
831 |
-- Set hedgehog health to 99 |
|
832 |
SetHealth(gear, 99) |
|
833 |
end |
|
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
834 |
if (GetGearType(gear) == gtRCPlaane) then |
891 | 835 |
-- Give the plane 10 bombs |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
836 |
SetHealth(gear, 10) |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
837 |
end |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
838 |
if (GetGearType(gear) == gtJetpack) then |
891 | 839 |
-- Set fuel to 50% only |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
840 |
SetHealth(gear, 1000) |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
841 |
end |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
842 |
if (GetGearType(gear) == gtMine) then |
891 | 843 |
-- Turn mine into dud |
361
315e9db1f458
no need to prevent linking of names in code blocks
sheepyluva@gmail.com
parents:
360
diff
changeset
|
844 |
SetHealth(gear, 0) |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
845 |
end |
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
846 |
end</code> |
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
847 |
|
1189 | 848 |
=== `HealHog(gearUid, healthBoost[, showMessage[, tint]])` (0.9.24) === |
1191 | 849 |
Convenience function to increase the health of hogs with default effects. |
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
850 |
|
1189 | 851 |
Increases the health of the hedgehog gear with the given ID `gearUid` by `healthBoost`, displays some healing particles at the hedgehog and shows the health increae as a message. This is similar to the behavour after taking a health crate, or getting a health boost from vampirism. |
852 |
||
853 |
If `showMessage` is false, no message is shown. With `tint` you can set the RGBA color of the particles (default: `0x00FF00FF`). |
|
99
983ec9ac63c7
Added a non-exhaustive list of examples for further applications of SetHealth()
RedGrinner@gmail.com
parents:
98
diff
changeset
|
854 |
|
1191 | 855 |
This function does not affect the poison state, however (see `SetEffect`). |
856 |
||
373 | 857 |
=== <tt>!SetEffect(gearUid, effect, effectState)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
858 |
Sets the state for one of the effects <tt>heInvulnerable, heResurrectable, hePoisoned, heResurrected, heFrozen</tt> for the specified hedgehog gear. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
859 |
A value of 0 usually means the effect is disabled, values other than that indicate that it is enabled and in some cases specify e.g. the remaining time of that effect. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
860 |
|
824 | 861 |
|| *`effect`* || *Description* || *`effectState`* || |
823 | 862 |
|| `heInvulnerable` || Wether hog is invulnerable || Any non-zero value turns on invulnerability. `0` turns it off. || |
863 |
|| `hePoisoned` || Poison damage, damages hog each turn. || Amount of damage per turn. Use `0` to disable poisoning. || |
|
864 |
|| `heResurrectable` || Whether to resurrect the hog on death || With a non-zero value, the hedgehog will be resurrected and teleported to a random location on death. `0` disables this. || |
|
824 | 865 |
|| `heResurrected` || Whether the hedgehog has been resurrected once. This is only a subtle graphical effect. || With a non-zero value, the hedgehog was resurrected, `0` otherwise. || |
1216 | 866 |
|| `heFrozen` || Freeze level. Frozen hedgehogs skip turn, are heavy and take half damage || The hog is considered frozen if the value is `256` or higher, otherwise not. A number of `256` or higher denotes “how frozen” the hedgehog is, i.e. how long it takes to melt. The freezer sets this to `199999` initially. The value will be reduced by `50000` each round. Being hit by a flame reduces this number by `1000`. The values `0` to `255` are used for the freeze/melt animations. || |
1299 | 867 |
|| `heArtillery` || If enabled, the hedgehog can't walk (since 0.9.24). || `0` = disabled. `1` = permanently enabled. `2` = temporarily enabled (used by sniper rifle between shots) || |
823 | 868 |
|
869 |
Example (sets all bots poisoned with poison damage of 1): |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
870 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
871 |
<code language="lua"> function onGearAdd(gear) |
558 | 872 |
if (GetGearType(gear) == gtHedgehog) and (GetHogLevel(gear) > 0) then |
373 | 873 |
SetEffect(gear, hePoisoned, 1) |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
874 |
end |
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
875 |
end</code> |
181 | 876 |
|
17 | 877 |
=== <tt>CopyPV(gearUid, gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
878 |
This sets the position and velocity of the second gear to the first one. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
879 |
|
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
880 |
=== <tt>!FollowGear(gearUid)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
881 |
Makes the game client follow the specifiec gear. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
882 |
|
139
6bf231a611a7
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
138
diff
changeset
|
883 |
=== <tt>!SetHogName(gearUid, name)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
884 |
Sets the name of the specified hedgehog gear. |
139
6bf231a611a7
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
138
diff
changeset
|
885 |
|
398
1f9f7fb00be3
Added entries for SetHogTeamName, SetWeapon
RedGrinner@gmail.com
parents:
394
diff
changeset
|
886 |
=== <tt>!SetHogTeamName(gearUid, name)</tt> === |
1039 | 887 |
Sets the team name of the specified gear. The gear can be a hedgehog or grave. |
398
1f9f7fb00be3
Added entries for SetHogTeamName, SetWeapon
RedGrinner@gmail.com
parents:
394
diff
changeset
|
888 |
|
139
6bf231a611a7
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
138
diff
changeset
|
889 |
=== <tt>!SetHogHat(gearUid, hat)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
890 |
Sets the hat of the specified hedgehog gear. |
139
6bf231a611a7
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
138
diff
changeset
|
891 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
892 |
=== <tt>!SetGearTarget(gearUid, x, y)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
893 |
Sets the x and y coordinate of target-based weapons/utilities. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
894 |
*Note*: This can’t be used in onGearAdd() but must be called after gear creation. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
895 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
896 |
=== <tt>!SetState(gearUid, state)</tt> === |
415
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
897 |
Sets the state of the specified gear to the specified `state`. This is a bitmask made out of the variables as seen in [States]. |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
898 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
899 |
This function is often used together with `GetState` and the bitmask utility functions `band` and `bnot` in order to manipulate a single flag. |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
900 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
901 |
Examples: |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
902 |
<code language="lua"> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
903 |
SetState(CurrentHedgehog, bor(GetState(CurrentHedgehog), gstInvisible)) |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
904 |
--[[ first the state bitmask of CurrentHedgehog is bitwise ORed with |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
905 |
the gstInvisible flag, thus making the bit responsible for |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
906 |
invisiblity to become 1. Then the new bitmask is applied to |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
907 |
CurrentHedgehog, thus making it invisible. ]] |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
908 |
</code> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
909 |
|
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
910 |
<code language="lua"> |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
911 |
SetState(CurrentHedgehog, band(GetState(CurrentHedgehog), bnot(gstInvisible))) |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
912 |
--[[ The reverse of the above: This function toggles CurrentHedgehog’s |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
913 |
gstInvisible flag off, thus making it visible again. ]] |
70961d4eef05
Fixed misleading descriptions of GetState and SetState (use of bitmasks were not mentioned). Added commented examples.
almikes@aol.com
parents:
414
diff
changeset
|
914 |
</code> |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
915 |
|
114
e311af715b57
Edited wiki page LuaAPI through web user interface.
henrik.rostedt@gmail.com
parents:
107
diff
changeset
|
916 |
=== <tt>!SetGearMessage(gearUid, message)</tt> === |
625 | 917 |
Sets the gear messages of the specified gear. `message` is a bitmask built out of flags seen in [GearMessages]. |
114
e311af715b57
Edited wiki page LuaAPI through web user interface.
henrik.rostedt@gmail.com
parents:
107
diff
changeset
|
918 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
919 |
=== <tt>!SetTag(gearUid, tag)</tt> === |
891 | 920 |
Sets the `Tag` value of the specified gear (by `gearUid`). The `Tag` value of a gear is simply an extra variable to modify misc. things. The meaning of a tag depends on the gear type. For example, for `gtBall` gears, it specifies the ball color, for `gtAirAttack` gears (airplane) it specifies the direction of the plane, etc. See [GearTypes] for a full list. `tag` has to be an integer. |
419 | 921 |
|
922 |
Note that the word “tag” here does _not_ refer to the name and health tags you see above hedgehogs, this is something different. |
|
923 |
||
924 |
<code language="lua"> |
|
925 |
-- This adds a ball (the one from the ballgun) at (123, 456): |
|
926 |
ball = AddGear(123, 456, gtBall, 0, 0, 0, 0) |
|
927 |
-- This sets the tag of the gear. For gtBall, the tag specified the color. “8” is the color white. |
|
928 |
SetTag(ball, 8) -- |
|
929 |
</code> |
|
930 |
||
421
d584704354ad
Add link to GearTypes for SetTag and GetTag.
almikes@aol.com
parents:
419
diff
changeset
|
931 |
The meaning of tags are described in [GearTypes]. |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
932 |
|
181 | 933 |
=== <tt>!SetTimer(gearUid, timer)</tt> === |
891 | 934 |
Sets the timer of the specified gear. Also see `GetTimer`. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
935 |
|
360 | 936 |
=== <tt>!SetHogLevel(gearUid, level)</tt> === |
1243 | 937 |
Sets the bot level from 0 to 5. `1` is the strongest bot level and `5` is the weakest one (this is the reverse of what players see). `0` means human player. |
69
48f6e6c0076d
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
68
diff
changeset
|
938 |
|
1224 | 939 |
=== `SetGearAIHints(gearUid, aiHint)` === |
940 |
Set some behaviour hints for computer-controlled hedgehogs for any given gear with `gearUid`. |
|
941 |
||
942 |
Set `aiHint` to either of: |
|
943 |
||
944 |
* `aihUsualProcessing`: AI hogs treat this gear the usual way. This is the default. |
|
945 |
* `aihDoesntMatter`: AI hogs don't bother attacking this gear intentionally. |
|
946 |
||
947 |
Example: |
|
948 |
||
1231 | 949 |
<code language="lua"> |
1224 | 950 |
SetGearAIHints(uselessHog, aihDoesntMatter) |
1231 | 951 |
-- This makes AI hogs stop caring about attacking uselessHog</code> |
1224 | 952 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
953 |
=== <tt>!SetGearPos(gearUid, value)</tt> === |
891 | 954 |
Sets the `Pos` value (not the position!) of the specified gear to specified value. See `GetGearPos` for more information. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
955 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
956 |
== Gameplay functions == |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
957 |
|
549 | 958 |
=== `GameFlags` functions === |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
959 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
960 |
==== <tt>!ClearGameFlags()</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
961 |
Disables *all* !GameFlags. |
380 | 962 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
963 |
==== <tt>!DisableGameFlags(gameflag, ...)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
964 |
Disables the listed !GameFlags, without changing the status of other !GameFlags. |
380 | 965 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
966 |
==== <tt>!EnableGameFlags(gameflag, ...)</tt> ==== |
1253 | 967 |
Enables the listed !GameFlags, without changing the status of other !GameFlags. In missions, no !GameFlags are set initially. |
380 | 968 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
969 |
==== <tt>!GetGameFlag(gameflag)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
970 |
Returns `true` if the specified gameflag is enabled, otherwise `false`. |
380 | 971 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
972 |
=== Environment === |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
973 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
974 |
==== <tt>!SetGravity(percent)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
975 |
Changes the current gravity of the game in percent (relative to default, integer value). |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
976 |
Setting it to 100 will set gravity to default gravity of hedgewars, 200 will double it, etc. |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
977 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
978 |
==== <tt>!GetGravity()</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
979 |
Returns the current gravity in percent. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
980 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
981 |
==== <tt>!SetWaterLine(waterline)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
982 |
Sets the water level (`WaterLine`) to the specified y-coordinate. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
983 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
984 |
==== <tt>!SetWind(windSpeed)</tt> ==== |
1189 | 985 |
Sets the current wind in the range of -100 to 100 inclusive. Use together with `gfDisableWind` for full control. |
986 |
||
987 |
==== <tt>!GetWind()</tt> (0.9.24) ==== |
|
988 |
Returns current wind, expressed as a floating point number between -100 to 100 inclusive. Note there may be rounding errors. |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
989 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
990 |
==== <tt>!SetMaxBuildDistance(distInPx)</tt> ==== |
790 | 991 |
Sets the maximum building distance for of girders and rubber bands in pixels to `distInPx`. If `distInPx` is `0`, the limit is disabled. If called without arguments, the distance will be reset to the default value. |
608 | 992 |
|
1270 | 993 |
==== `Explode(x, y, radius[, options])` (0.9.24) ==== |
994 |
Cause an explosion or erase land, push or damage gears. |
|
995 |
||
1271 | 996 |
By default, an explosion destroys a circular piece of land and damages and pushes gears in its radius. |
997 |
||
998 |
The explosion occours at coordinates `(x, y)` with the given `radius`. Assuming 100% damage, the explosion damage at the center equals the explosion radius. |
|
1270 | 999 |
|
1272 | 1000 |
The explosion will also have a visual effect (by spawning an explosion visual gear), unless the radius is very small. |
1001 |
||
1270 | 1002 |
`options` is a bitmask which can be used to tweak how the explosion behaves: |
1003 |
||
1004 |
|| *Flag* || *Meaning* || |
|
1005 |
|| `EXPLAutoSound` || Plays an appropriate sound || |
|
1006 |
|| `EXPLNoDamage` || Deal no damage to gears || |
|
1007 |
|| `EXPLDoNotTouchHH` || Do not push hedgehogs || |
|
1008 |
|| `EXPLDoNotTouchAny` || Do not push any gears || |
|
1009 |
|| `EXPLDontDraw` || Do not destroy land || |
|
1010 |
|| `EXPLNoGfx` || Do not show an explosion animation and do not shake the screen || |
|
1011 |
|| `EXPLPoisoned` || Poison all hedgehogs in explosion radius || |
|
1012 |
||
1013 |
`options` is assumed to be `EXPLAutoSound` by default. Set `options` to 0 to disable all flags. |
|
1014 |
||
1015 |
Examples: |
|
1016 |
<code language="lua"> |
|
1017 |
-- Simple explosion at (100, 50) with radius 50 |
|
1018 |
Explode(100, 50, 50) |
|
1019 |
||
1020 |
-- Simlpe explosion without sound |
|
1021 |
Explode(100, 50, 50, 0) |
|
1022 |
||
1271 | 1023 |
-- Fake explosion which only pushes gears but deals no damage to gears and terrain |
1270 | 1024 |
Explode(500, 1000, 50, EXPLAutoSound + EXPLNoDamage + EXPLDontDraw) |
1025 |
||
1271 | 1026 |
-- Erase a circle of land without side effects |
1270 | 1027 |
Explode(500, 100, 100, EXPLNoDamage + EXPLDoNotTouchAny + EXPLNoGfx) |
1028 |
</code> |
|
1029 |
||
1269 | 1030 |
==== `SkipTurn()` (0.9.24) ==== |
1031 |
Forces the current hedgehog to skip its turn. |
|
1032 |
||
1212 | 1033 |
==== `EndTurn([noTaunts])` (0.9.23) ==== |
997 | 1034 |
Ends the current turn. |
1035 |
||
1036 |
Normally, a “Coward” taunt may be played and an announcer message may be shown (depending on the situation). Set the optional `noTaunts` parameter to `true` to force the engine to never play a taunt or show a message. `noTaunts` is `false` by default. |
|
1037 |
||
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1038 |
==== <tt>!EndGame()</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1039 |
Makes the game end. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1040 |
|
912
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1041 |
=== Ammo === |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1042 |
==== <tt>!SetAmmo(ammoType, count, probability, delay, numberInCrate)</tt> ==== |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1043 |
This updates the settings for a specified [AmmoTypes Ammo Type] as of count available for players, spawn probability, availability delay in turns, and the number available in crates. This is supposed to be used in the `onAmmoStoreInit()` event handler. |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1044 |
|
1032 | 1045 |
In Lua missions, for *all* ammo types, the ammo count, probability, delay and number in crates is set to 0 initially. Note: This also includes skip! |
1031
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
1046 |
|
912
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1047 |
Example: |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1048 |
|
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1049 |
<code language="lua"> SetAmmo(amShotgun, 9, 0, 0, 0) -- unlimited amount of shotgun ammo for players |
1031
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
1050 |
SetAmmo(amGrenade, 0, 0, 0, 3) -- crates should contain always three grenade |
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
1051 |
SetAmmo(amSkip, 9, 0, 0, 0) -- enable skip</code> |
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
1052 |
|
637ad254daf9
LuaAPI: Explain the initial ammo setting in missions
Wuzzy
parents:
1030
diff
changeset
|
1053 |
Hint: It is recommended to always enable skip in missions. Only in exceptional circumstances you should choose to not enable skip. |
912
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1054 |
|
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1055 |
==== <tt>!SetAmmoDelay(ammoType, delay)</tt> ==== |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1056 |
Changes the delay of a specified [AmmoTypes Ammo Type]. |
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1057 |
|
918
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1058 |
==== <tt>!SetAmmoTexts(ammoType, name, caption, description)</tt> (0.9.23) ==== |
1006
160112dc2fcf
LuaAPI: Clarify SetAmmoTexts usage: Must not be called before onGameStart was fired
Wuzzy
parents:
1004
diff
changeset
|
1059 |
Allows you to overwrite the displayed name and tooltip descriptions of a given ammo type. This function must only be called either inside the `onGameStart` callback function, or after the engine has called `onGameStart`. |
918
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1060 |
|
919 | 1061 |
* `ammoType`: The ammo type to set the text for |
1062 |
* `name`: Name of the ammo type (e.g. “Grenade” for `amGrenade`), affects both name in ammo menu and in the “ticker” message on the screen top. |
|
1063 |
* `caption`: The second line in the ammo menu (below the title). E.g. “Timed grenade” for `amGrenade`. |
|
1064 |
* `description`: Description text in ammo menu, below the caption. |
|
918
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1065 |
|
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1066 |
`title`, `caption`, `description` can be `nil`, in which case they will be reverted to the engine default value. This function returns `nil`. |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1067 |
|
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1068 |
Example: |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1069 |
<code language="lua"> |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1070 |
-- Overwrites bazooka name and description |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1071 |
SetAmmoTexts(amBazooka, "Spoon Missile", "Crazy weapon", "This crazy weapon looks like a spoon and explodes on impact.|Attack: Hold to launch with more power")</code> |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1072 |
|
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1073 |
==== <tt>!SetAmmoDescriptionAppendix(ammoType, descAppend)</tt> (0.9.23) ==== |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1074 |
Will set a string `descAppend` to be appended below the “core” description (ammo tooltip) of the specified `ammoType`, without changing the ordinary description. |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1075 |
Note that calling this function always sets the complete appended string, you can't use this function to append multiple texts in row. |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1076 |
|
920 | 1077 |
This function is recommended if you have tweaked an existing ammo type only a little and want to keep the original description intact as much as possible. |
918
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1078 |
|
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1079 |
Example: |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1080 |
<code language="lua"> |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1081 |
-- Appends a text to the ammo tooltip of the bazooka but leaves name and main description intact |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1082 |
SetAmmoTexts(amBazooka, "This weapon deals double the damage than usually.")</code> |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1083 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1084 |
==== <tt>!AddAmmo(gearUid, ammoType, ammoCount)</tt> ==== |
1030 | 1085 |
Adds `ammoType` to the specified gear. The amount added is determined by the arguments passed via `SetAmmo()` in the `onAmmoStoreInit()` event handler. `ammoCount` is an optional parameter. If this is set, the ammo will **not** be added, but instead set to `ammoCount`. A value of 0 will remove the weapon, a value of 100 will give infinite ammo. |
912
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1086 |
|
918
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1087 |
==== <tt>!GetAmmoName(ammoType [, ignoreOverwrite ])</tt> (0.9.23) ==== |
87e1d0a11e99
LuaAPI: Add SetAmmoDescriptionAppendix, SetAmmoTexts and update GetAmmoName
Wuzzy
parents:
917
diff
changeset
|
1088 |
Returns the localized name for the specified `ammoType`, taking an ammo name overwritten by `SetAmmoTexts` into account. If `ignoreOverwrite` is `true`, this function will always return the original ammo name of the weapon and ignores names which may have been overwritten by `SetAmmoTexts`. |
912
ea13b02292c5
LuaAPI: Move non-gear related ammo functions to new section
Wuzzy
parents:
911
diff
changeset
|
1089 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1090 |
=== Map === |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1091 |
==== <tt>!MapHasBorder()</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1092 |
Returns `true`/`false` if the map has a border or not. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1093 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1094 |
==== <tt>!TestRectForObstacle(x1, y1, x2, y2, landOnly)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1095 |
Checks the rectangle between the given coordinates for possible collisions. Set `landOnly` to `true` if you don’t want to check for collisions with gears (hedgehogs, etc.). |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1096 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1097 |
==== <tt>!PlaceGirder(x, y, frameIdx)</tt> ==== |
940 | 1098 |
Attempts to place a girder with centre points `x`, `y` and a certain length and orientation, specified by `frameIdx`. The girder can only be placed in open space and must not collide with anything so this function may fail. It will return `true` on successful placement and `false` on failure. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1099 |
|
940 | 1100 |
These are the accepted values for `frameIdx`: |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1101 |
|
940 | 1102 |
|| *`frameIdx`* || *Length* || *Orientation* || |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1103 |
|| 0 || short || horizontal || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1104 |
|| 1 || short || decreasing right || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1105 |
|| 2 || short || vertical || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1106 |
|| 3 || short || increasing right || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1107 |
|| 4 || long || horizontal || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1108 |
|| 5 || long || decreasing right || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1109 |
|| 6 || long || vertical || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1110 |
|| 7 || long || increasing right || |
412 | 1111 |
|
940 | 1112 |
==== <tt>!PlaceRubber(x, y, frameIdx)</tt> (0.9.23) ==== |
1113 |
Attempts to place a rubber with centre points `x`, `y` and a certain orientation, specified by `frameIdx`. The rubber can only be placed in open space and must not collide with anything so this function may fail. It will return `true` on successful placement and `false` on failure. |
|
1114 |
||
1115 |
These are the accepted values for `frameIdx`: |
|
1116 |
||
1117 |
|| *`frameIdx`* || *Orientation* || |
|
1118 |
|| 0 || horizontal || |
|
1119 |
|| 1 || decreasing right || |
|
1120 |
|| 2 || vertical || |
|
1121 |
|| 3 || increasing right || |
|
1122 |
||
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1123 |
==== <tt>!PlaceSprite(x, y, sprite, frameIdx, tint, behind, flipHoriz, flipVert, [, landFlag, ...])</tt> ==== |
869 | 1124 |
Places a [Sprites sprite] at the specified position (`x`, `y`) on the map, it behaves like terrain then. Unlike `PlaceGirder`, this function does not check for collisions, so the sprite can be placed anywhere within map boundaries. The function returns `true` if the placement was successful, `false` otherwise. `frameIdx` is the frame index starting by 0. `frameIdx` is used if the sprite consists of several sub-images. Only a subset of the sprites is currently supported by this function: |
539 | 1125 |
|
1126 |
* `sprAmGirder` |
|
1127 |
* `sprAmRubber` |
|
1128 |
* `sprAMSlot` |
|
1129 |
* `sprAMAmmos` |
|
1130 |
* `sprAMAmmosBW` |
|
1131 |
* `sprAMCorners` |
|
1132 |
* `sprHHTelepMask` |
|
1133 |
* `sprTurnsLeft` |
|
1134 |
* `sprSpeechCorner` |
|
1135 |
* `sprSpeechEdge` |
|
1136 |
* `sprSpeechTail` |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1137 |
* `sprTargetBee` |
539 | 1138 |
* `sprThoughtCorner` |
1139 |
* `sprThoughtEdge` |
|
1140 |
* `sprThoughtTail` |
|
1141 |
* `sprShoutCorner` |
|
1142 |
* `sprShoutEdge` |
|
1143 |
* `sprShoutTail` |
|
1144 |
* `sprBotlevels` |
|
1145 |
* `sprIceTexture` |
|
1146 |
* `sprCustom1` |
|
1147 |
* `sprCustom2` |
|
1148 |
||
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1149 |
`tint` is for an RGBA colouring to apply, this works about the same as `Tint` in gears. `behind` indicates the sprite should not replace existing land. `flipHoriz` and `flipVert` are for mirroring the sprite vertically and horizontally before placing, respectively. |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1150 |
The 9th and later arguments specify land flags (see the constants section) to be used for the newly created terrain. If omited, `lfNormal` is assumed. |
539 | 1151 |
|
1152 |
Example: |
|
1153 |
||
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1154 |
<code language="lua">PlaceSprite(2836, 634, sprAmGirder, 5) |
539 | 1155 |
-- Places the girder sprite as normal terrain at (2836, 634). The `frameIdx` 5 is for the long decreasing right girder.</code> |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1156 |
<code language="lua">PlaceSprite(1411, 625, sprAmRubber, 1, nil, nil, nil, nil, lfBouncy) |
539 | 1157 |
-- Places the rubber band sprite as bouncy terrain at (2836, 634). The `frameIdx` 1 is for the decreasing right rubber band.</code> |
1158 |
||
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1159 |
==== <tt>!EraseSprite(x, y, sprite, frameIdx, eraseOnLFMatch, onlyEraseLF, flipHoriz, flipVert, [, landFlag, ...])</tt> ==== |
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1160 |
Erases a [Sprites sprite] at the specified position (`x`, `y`) on the map. `frameIdx` is the frame index starting by 0. `sprite`, `frameIdx`, `flipHoriz` and `flipVert` behave the same as in `PlaceSprite`. For `sprite`, the same subset of sprites is permitted. |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1161 |
|
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1162 |
Set `eraseOnLFMatch` to `true` to erase all land for a pixel that matches any of the passed in land flags. This is useful if, for example, an `lfBouncy` sprite was placed “behind” land using `PlaceSprite` and you want to remove it without destroying the non-bouncy terrain. |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1163 |
|
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1164 |
Set `onlyEraseLF` to `true` to only remove specific land flags. If for example a sprite consists of `lfIndestructible` and `lfBouncy`, and you call `EraseSprite` with `onlyEraseLF` and `lfIndestructible` set, the sprite will remain bouncy but can be destroyed. You can use this to entirely remove all land flags from a sprite—at this point the sprite will be visual only, painted on the map but with no collision. |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1165 |
|
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1166 |
Examples: |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1167 |
|
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1168 |
<code language="lua">EraseSprite(2836, 634, sprAmGirder, 5) |
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1169 |
-- Removes the girder sprite at (2836, 634). The frameIdx 5 is for the long decreasing right girder.</code> |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1170 |
<code language="lua">EraseSprite(1411, 625, sprAmRubber, 1, true, true, nil, nil, lfIndestructible) |
692
111f39408390
Clean up markup for PlaceSprite and EraseSprite and clarify some stuff
Wuzzy
parents:
691
diff
changeset
|
1171 |
-- Removes indestructibility from a rubber band sprite at (2836, 634). The frameIdx 1 is for the decreasing right rubber band.</code> |
688
d9fc58ac04f2
Update EraseSprite, PlaceSprite and Get/Set GearValues
nemo
parents:
685
diff
changeset
|
1172 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1173 |
==== <tt>!AddPoint(x, y [, width [, erase] ])</tt> ==== |
412 | 1174 |
This function is used to draw your own maps using Lua. The maps drawn with this are of type “hand-drawn”. |
1175 |
||
1176 |
The function takes a `x`,`y` location, a `width` (means start of a new line) and `erase` (if `false`, this function will draw normally, if `true`, this function will erase drawn stuff). |
|
1177 |
||
1178 |
This function must be called within `onGameInit`, where `MapGen` has been set to `mgDrawn`. You also should call `FlushPoints` when you are finished with drawing. |
|
1179 |
||
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1180 |
==== <tt>!FlushPoints()</tt> ==== |
412 | 1181 |
Makes sure that all the points/lines specified using `AddPoint` are actually applied to the map. This function must be called within `onGameInit`. |
1182 |
||
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1183 |
=== Current hedgehog === |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1184 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1185 |
==== <tt>!GetCurAmmoType()</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1186 |
Returns the currently selected [AmmoTypes Ammo Type]. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1187 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1188 |
==== <tt>!SwitchHog(gearUid)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1189 |
This function will switch to the hedgehog with the specifiedd `gearUid`. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1190 |
|
1246 | 1191 |
==== <tt>!SetWeapon(ammoType)</tt> ==== |
1245 | 1192 |
Sets the selected weapon of `CurrentHedgehog` to one of the [AmmoTypes Ammo Type]. |
1193 |
||
1299 | 1194 |
Examples: |
1245 | 1195 |
|
1196 |
<code language="lua"> |
|
1299 | 1197 |
SetWeapon(amBazooka) -- select the bazooka (if hog has one) |
1198 |
</code> |
|
1199 |
<code language="lua"> |
|
1200 |
SetWeapon(amNothing) -- unselects the weapon. |
|
1201 |
</code> |
|
1245 | 1202 |
|
1246 | 1203 |
==== <tt>!SetNextWeapon()</tt> ==== |
1245 | 1204 |
This function makes the current hedgehog switch to the next weapon in list of available weapons. It can be used for example in trainings to pre-select a weapon. |
1205 |
||
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1206 |
==== <tt>!SetInputMask(mask)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1207 |
Masks specified player input. This means that Hedgewars ignores certain player inputs, such as walking or jumping. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1208 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1209 |
Example: |
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
1210 |
<code language="lua"> -- masks the long and high jump commands |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1211 |
SetInputMask(band(0xFFFFFFFF, bnot(gmLJump + gmHJump))) |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1212 |
-- clears input mask, allowing player to take actions |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1213 |
SetInputMask(0xFFFFFFFF) |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1214 |
</code> |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1215 |
*Note*: Using the input mask is an effective way to script uninterrupted cinematics, or create modes such as No Jumping. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1216 |
|
936 | 1217 |
*Note*: This function is used internally in the Animate [LuaLibraries library]. |
1218 |
||
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1219 |
See also [GearMessages]. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1220 |
|
405 | 1221 |
==== <tt>!GetInputMask()</tt> ==== |
1222 |
Returns the current input mask of the player. |
|
1223 |
||
1219
b467502126fd
LuaAPI: Move SetVampiric and SetLaserSight one level down
Wuzzy
parents:
1218
diff
changeset
|
1224 |
==== `SetVampiric(bool)` (0.9.24) ==== |
1189 | 1225 |
Toggles vampirism mode for this turn. Set `bool` to `true` to enable (same effect as if the hedgehog has used Vampirism), `false` to disable. |
1226 |
||
1219
b467502126fd
LuaAPI: Move SetVampiric and SetLaserSight one level down
Wuzzy
parents:
1218
diff
changeset
|
1227 |
==== `SetLaserSight(bool)` (0.9.24) ==== |
1189 | 1228 |
Toggles laser sight for this turn. Set `bool` to `true` to enable (same effect as if the hedgehog has used Laser Sight), `false` to disable. |
1229 |
||
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1230 |
=== Randomness === |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1231 |
==== <tt>!GetRandom(number)</tt> ==== |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1232 |
Returns a randomly generated number in the range of 0 to number - 1. This random number uses the game seed, so is synchronised, and thus safe for multiplayer and saved games. Use `GetRandom` for anything that could impact the engine state. For example, a visual gear could simply use Lua’s `math.random`, but adding a regular gear should use `GetRandom`. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1233 |
|
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1234 |
=== Clans and teams === |
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1235 |
==== <tt>!AddTeam(teamname, color, grave, fort, voicepack, flag)</tt> ==== |
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1236 |
|
476
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1237 |
Adds a new team. Note that this can only be done in `onGameInit`, not at a later time. |
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1238 |
You *must* add at least one hedgehog with `AddHog` after calling this. The engine does not support empty teams. |
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1239 |
|
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1240 |
Arguments: |
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1241 |
|
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1242 |
* `teamname`: The name of the team. |
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1243 |
* `color`: The RGB color of the team as defined in [LuaAPI#Color] |
476
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1244 |
* `grave`: The name of the team’s grave (equals file name without the suffix) |
638 | 1245 |
* `fort`: The name of the team’s fort (equals file name without the suffix and without the letter “L” or “R” before that suffix) |
476
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1246 |
* `voicepack`: The name of the team’s voice pack (equals the directory name) |
638 | 1247 |
* `flag`: Optional argument for the name of the team’s flag (equals file name without the suffix). If set to `nil`, the flag “hedgewars” is used. |
476
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1248 |
|
625 | 1249 |
*Note*: This works only for singleplayer training missions for now and will desync multiplayer games. |
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1250 |
|
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1251 |
Example: |
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1252 |
|
476
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1253 |
<code language="lua">AddTeam("team 1", 0xDD0000, "Simple", "Tank", "Default", "hedgewars") |
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1254 |
--[[ Adds a new team with name “team 1”, red color (hexadecimal notation), the grave “Simple”, |
dd4470df66ad
Restructure information about AddTeam, add info that Hedgewars does not support empty teams.
almikes@aol.com
parents:
461
diff
changeset
|
1255 |
the fort “Tank” the voicepack “Default” and the flag “hedgewars”. ]]</code> |
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1256 |
|
1189 | 1257 |
==== <tt>!GetTeamName(teamIdx)</tt> (0.9.24) ==== |
1258 |
Returns the name of the team with the index `teamIdx`. `teamIdx` is a number between 0 and `TeamsCount-1`. |
|
1259 |
||
1218 | 1260 |
==== <tt>!GetTeamIndex(teamname)</tt> (0.9.24) ==== |
1217 | 1261 |
Returns the team index (number between 0 and `TeamsCount-1`) of the team with the name `teamName`. |
1262 |
||
1263 |
==== <tt>!GetTeamClan(teamname)</tt> (0.9.24) ==== |
|
1264 |
Returns the clan ID of the team with the given `teamName`. |
|
1265 |
||
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1266 |
==== <tt>!DismissTeam(teamname)</tt> ==== |
1217 | 1267 |
Vaporizes all the hogs of the team with the given team name in a puff of smoke. |
1268 |
||
1269 |
This function must not be called while it's the team's turn. |
|
1270 |
||
1240 | 1271 |
==== `SetTeamLabel(teamname[, label])` (0.9.24) ==== |
1217 | 1272 |
Set or remove a label for the team with the given team name. The label is a string and will be displayed next to the team's health bar. |
1273 |
||
1274 |
If `label` is `nil`, the label will be removed. |
|
1275 |
||
1276 |
There's a special case: If the AI Survival game modifier is active, the AI kill counter will be replaced by the custom team label if it has been set. If `label` is set to `nil`, the default AI counter is shown again. |
|
1277 |
||
1278 |
Use this to display a score, power value or another important team attribute. There's no hard length limit, but please try to keep it as short as possible to avoid visual clutter. |
|
413
6d90d6994e95
Add DismissTeam, move AddTeam to new “Clans and teams” section.
almikes@aol.com
parents:
412
diff
changeset
|
1279 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1280 |
==== <tt>!GetClanColor(clan)</tt> ==== |
858
2a562faa73fb
LuaAPI: GetClanColor, SetClanColor: They use RGBA instead of RGB
Wuzzy
parents:
826
diff
changeset
|
1281 |
Returns the RGBA color of the chosen clan by its number. The color data type is described in [LuaAPI#Color]. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1282 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1283 |
==== <tt>!SetClanColor(clan, color)</tt> ==== |
858
2a562faa73fb
LuaAPI: GetClanColor, SetClanColor: They use RGBA instead of RGB
Wuzzy
parents:
826
diff
changeset
|
1284 |
Sets the RGBA color of the chosen clan by its number. The color data type is described in [LuaAPI#Color]. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1285 |
|
577 | 1286 |
=== Campaign management === |
1287 |
==== <tt>!SaveCampaignVar(varname, value)</tt> ==== |
|
1288 |
Stores the value `value` (a string) into the campaign variable `varname` (also a string). Campaign variables allow you to save progress of a team in a certain campaign. Campaign variables are saved on a per-team per-campaign basis. They are written into the team file (see [ConfigurationFiles#TeamName.hwt]). |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1289 |
|
579
9895045e9963
Updated SaveCampaignVar / GetCampaignVar links
almikes@aol.com
parents:
577
diff
changeset
|
1290 |
There are some special campaign variables which are used by Hedgewars to determine which missions to display in the campaign menu. This is described [ConfigurationFiles#%5BCampaign%20%3CCAMPAIGN_NAME%3E%5D here]. |
9895045e9963
Updated SaveCampaignVar / GetCampaignVar links
almikes@aol.com
parents:
577
diff
changeset
|
1291 |
|
577 | 1292 |
==== <tt>!GetCampaignVar(varname)</tt> ==== |
579
9895045e9963
Updated SaveCampaignVar / GetCampaignVar links
almikes@aol.com
parents:
577
diff
changeset
|
1293 |
Returns the value of the campaign variable `varname` as a string. See also `SaveCampaignVar`. |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1294 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1295 |
== Functions affecting the GUI == |
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1296 |
|
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1297 |
=== <tt>!AddCaption(text)</tt> === |
561 | 1298 |
Display an event text in the upper part of the screen. The text will be white and the caption group will be `capgrpMessage`. |
1299 |
||
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1300 |
Example: |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1301 |
<code language="lua"> |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1302 |
AddCaption("Hello, world!") |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1303 |
</code> |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1304 |
|
561 | 1305 |
=== <tt>!AddCaption(text, color, captiongroup)</tt> === |
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1306 |
Display an event text in the upper part of the screen with the specified RGBA [LuaAPI#Color color] and caption group. Although an RBGA color is used, Hedgewars does not actually support transparent or semi-transparent captions, so the fourth byte is ignored. We recommend you to always specify a full opacity (`FF` in hexadecimal) for the caption. |
561 | 1307 |
|
1308 |
|| *`captiongroup`* || *Meaning* || |
|
1309 |
|| `capgrpGameState` || Used for important global game events, like Sudden Death || |
|
1310 |
|| `capgrpAmmoinfo` || Used for new weapon crates and some other events || |
|
1311 |
|| `capgrpVolume` || Used when adjusting volume || |
|
1312 |
|| `capgrpMessage` || Generic message || |
|
1313 |
|| `capgrpMessage2` || Generic message || |
|
1314 |
|| `capgrpAmmostate` || Used to show information about weapon state, i.e. bounce level, timer, remaining shots, etc. || |
|
1315 |
||
583
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1316 |
Example: |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1317 |
<code language="lua"> |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1318 |
AddCaption("Melon bomb rain in 2 rounds!", 0xFF0000FF, capgrpGameState) |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1319 |
-- Green example message. |
0818d57c392f
Clarifications on differences of RGB vs RGBA.
almikes@aol.com
parents:
579
diff
changeset
|
1320 |
</code> |
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1321 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1322 |
=== <tt>!ShowMission(caption, subcaption, text, icon, time)</tt> === |
894 | 1323 |
This function will open the mission panel and set the texts in it. |
1324 |
||
1325 |
Use to tell the player what he/she is supposed to do. If you use this function, a mission panel is shown for the amount of time specified in `time` (in milliseconds). If `time` is set to 0, it will be displayed for a default amount of time. |
|
1326 |
This function replaces the *entire* text of the mission panel. Compare this to the global `Goals` variable, which *adds* to the default text without replacing it. |
|
645 | 1327 |
|
1328 |
`caption` is the text displayed in the first line, `subcaption` is displayed in the second line and `text` is the text displayed in the third and following lines. |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1329 |
|
647 | 1330 |
`text` uses some special characters for formatting: `|` is used for a line break, and everything written before and including a `:` in a line is written in a lighter color. |
645 | 1331 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1332 |
`icon` accepts the following values: |
79 | 1333 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1334 |
|| *`icon`* || *What is shown* || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1335 |
|| _negative number_ || Icon of an ammo type. It is specified as the negative of an ammo type constant (see [AmmoTypes]), i.e. `-amBazooka` for the bazooka icon. || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1336 |
|| `0` || Golden crown || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1337 |
|| `1` || Target || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1338 |
|| `2` || Exclamation mark || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1339 |
|| `3` || Question mark || |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1340 |
|| `4` || Golden star || |
636 | 1341 |
|| `5` || Utility crate || |
1342 |
|| `6` || Health crate || |
|
1343 |
|| `7` || Ammo crate || |
|
1344 |
|| `8` || Barrel || |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1345 |
|| `9` || Dud mine || |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
1346 |
|
645 | 1347 |
Example: |
1348 |
<code language="lua"> |
|
1349 |
ShowMission(loc("Nobody Laugh"), loc("User Challenge"), loc("Eliminate the enemy before the time runs out"), 0, 0) |
|
1350 |
</code> |
|
1351 |
||
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1352 |
=== <tt>!HideMission()</tt> === |
894 | 1353 |
Hides the mission panel if it is currently displayed, otherwise, this function does nothing. |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
1354 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1355 |
=== <tt>!SetZoom(zoomLevel)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1356 |
Sets the zoom level. The value for maximum zoom is currently 1.0 and for minimum 3.0 The default zoom level is 2.0 |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
1357 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1358 |
=== <tt>!GetZoom()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1359 |
Returns the current zoom level. |
147
379d7931ffc7
Edited wiki page LuaAPI through web user interface.
RedGrinner@gmail.com
parents:
146
diff
changeset
|
1360 |
|
775 | 1361 |
=== `SetCinematicMode(enable)` (0.9.23) === |
1362 |
Turns on or off cinematic mode. Cinematic mode can be used for cutscenes etc. |
|
1363 |
If `enable` is set to `true`, cinematic mode is enabled, |
|
1364 |
if it is `false`, cinematic mode is disabled. |
|
1365 |
||
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1366 |
== Sound functions == |
1256 | 1367 |
=== `PlaySound(soundId, [gearUid [, instaVoice]])` === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1368 |
Plays the specified sound. Possible values for `soundId` are listed on the [Sounds] page. |
28
026591d95ac6
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
24
diff
changeset
|
1369 |
|
1258 | 1370 |
To play a voice (see [Taunts] for a list), you must also set `gearUid`. `gearUid` is the hedgehog gear which is used to “talk”. |
1256 | 1371 |
|
1257 | 1372 |
If you play a voice, by default the voice will respect an internal queue and might be played with an delay in order to prevent annoying voice overlapping. Since version 0.9.24, you can disable this behaviour and force Hedgewars to instantly play the voice by also setting `instaVoice` to `true`. Only use `instaVoice` when you really need it. |
1256 | 1373 |
|
1374 |
=== `SetSoundMask(soundId, isMasked)` (0.9.24) === |
|
1375 |
Disables a given sound (including taunts) from being played by the engine. `soundId` is a valid sound ID on [Sounds] or [Taunts]. `isMasked` is a boolean. If `true`, the sound will not be played by the engine anymore. If `false`, playing this sound is allowed again. |
|
70
ff7d4c176303
Edited wiki page LuaAPI through web user interface.
henrik.rostedt
parents:
69
diff
changeset
|
1376 |
|
1256 | 1377 |
Sounds played by the Lua function `PlaySound` will always work, however, and ignore the sound mask. |
1378 |
||
1379 |
Note: Due to the way the voices work internally in Hedgewars, if you want to play a masked voice, you have to set `instaVoice` to `true` when you call `PlaySound`. Otherwise, it won't work. |
|
1380 |
||
1381 |
Example: |
|
1382 |
||
1383 |
<code language="lua">SetSoundMask(sndIncoming, true) |
|
1384 |
-- Disable the “Incoming” sound from being played</code> |
|
77 | 1385 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1386 |
== File system functions == |
410 | 1387 |
=== <tt>!HedgewarsScriptLoad(scriptPath)</tt> === |
407 | 1388 |
Loads a script (i.e. a [LuaLibraries library]) from the specified `scriptPath`. The root directory is here Hedgewars’ data directory. |
1389 |
||
1390 |
Example: |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
1391 |
<code language="lua"> |
407 | 1392 |
HedgewarsScriptLoad("/Scripts/Locale.lua") -- loads locale library |
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
1393 |
</code> |
407 | 1394 |
|
404
37d44392ad2b
Reorganize the section “other functions” into several logical subunits.
almikes@aol.com
parents:
403
diff
changeset
|
1395 |
== Stats functions == |
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1396 |
=== <tt>!SendStat(TStatInfoType, statMessage[, teamName])</tt> === |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1397 |
|
893 | 1398 |
This function allows to change the details of the stats screen seen after the end of a game. |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1399 |
|
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1400 |
`TStatInfoType` is the piece of information you want to manipulate. The result of this functions varies greatly for different `TStatInfoType`s. The parameter `statMessage` is mandatory and is a string used for the statistics, its meaning depends on the `TStatInfoType`. The parameter `teamName` contains the name of a team which is relevant to the chosen stat. This parameter is not always required, this also depends on `TStatInfoType`. |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1401 |
|
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1402 |
This tables explains the different behaviours of this function for different values of `TStatInfoType`: |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1403 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1404 |
|| *`TStatInfoType`* || *Meaning of `statMessage`* || *Team parameter used?* || |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1405 |
|| `siGraphTitle` || Title of the graph. If you use this, the health icon changes into a star. || No || |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1406 |
|| `siGameResult` || Title of the stats screen, used to show the result of the game, i.e. who won the game || No || |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1407 |
|| `siCustomAchievement` || A freeform text for a single “bullet point” in the “bullet point” list in the details section. For each time you call `SendStat` with this `TStatInfoType`, a new “bullet point” gets added to the list. || No || |
685 | 1408 |
|| `siPointType` || Replaces the word “kills” in the ranking list. You have to call this each time before you report the score or kills of a team with `siPlayerKills`. Sadly, grammatical number is currently not respected at all here. || No || |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1409 |
|| `siPlayerKills` || The number of kills for the specified team (converted to a string), as shown in the ranking list. Unless the word “kills” has been replaced by `siPointType`, then that word is used instead. Only integers (converted to string) are possible. || Yes || |
1265 | 1410 |
|| `siClanHealth` || Value of a data point. This sets a single data point on the graph for the specified team. All teams will be converted to clans prior to drawing, there can only be one chart per clan. Subsequent calls will draw the next point along the horizontal axis; the frontend will then simply connect the dots in the final chart. Only whole numbers are supported. There must be at least 2 data points for any given clan, otherwise there won't be much to look at. ;-) You also should have called `SendHealthStatsOff` if to prevent the default health graphs to be drawn. || Yes || |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1411 |
|| `siMaxStepKills` || Most hedgehogs killed in a round. `statText` must be in format “`<kills> <name of killer hedgehog> (<team name of killer>)`”. || No || |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1412 |
|| `siMaxTeamDamage` || Hedgehog with most damage inflicted to his own team. `statText` must be in the format “`<damage> <hedgehog name>`”. || No || |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1413 |
|| `siKilledHHs` || Total number of killed hedgehogs (converted to string). || No || |
1038 | 1414 |
|| `siTeamStats` || Sets the ranking of each team. Use number 0 for default ranking. Format: “`<team name 1>:<rank 1>:<team name 2>:<rank 2>:`” (and so on) || No || |
1265 | 1415 |
|| `siMaxStepDamage` || Most damage in one turn for the “best shot award”. `statText` must be in format “`<damage> <hedgehog name> (<team name>)`”. || No || |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1416 |
|| `siMaxTurnSkips` || Team with most skips. `statText` must be of format “`<number> <teamName>`”. || No || |
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1417 |
|
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1418 |
|
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1419 |
<b>Examples:</b> |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1420 |
|
416
5aa55bbe4b73
Fixed faulty syntax highlighting in code block (was: “<code lang=…” instead of “<code language=…”)
almikes@aol.com
parents:
415
diff
changeset
|
1421 |
<code language="lua"> |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1422 |
-- will automatically change the health icon to a star |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1423 |
SendStat(siGraphTitle,'Custom Graph Title') |
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1424 |
SendStat(siGameResult,'Winner is Team A!') |
418
a7d34a3e5786
Make documentation for SendStat much more readable: Add a table (still not perfect), added some basic parameter descriptions.
almikes@aol.com
parents:
417
diff
changeset
|
1425 |
SendStat(siCustomAchievement,'This is a custom message posted in the Details section!') |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1426 |
-- Changes the word kill to Point, call it just before sending kills/score for each hog |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1427 |
-- in case you want to change the word i.e. print Point or Points |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1428 |
SendStat(siPointType,'Point') |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1429 |
-- if above function call was not used it will print 3 kills for teamName in Ranking section. |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1430 |
-- if it was used it will print 3 Point for teamName in Ranking section. |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1431 |
SendStat(siPlayerKills,'3',teamName) |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1432 |
-- call siClanHealth to send the "value" of a clan that will be used for the graph creation |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1433 |
-- a good idea is to call it always for every hog by using the runOnGears(function) |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1434 |
-- in normal mode "value" represents clan health |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1435 |
SendStat(siClanHealth, "100",teamName) |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1436 |
-- most hedgehogs killed in a round (hedgeHogName is who killed them) |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1437 |
SendStat(siMaxStepKills, "1 hedgeHogName (teamName)") |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1438 |
-- hog with most damage inflicted to his own team |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1439 |
SendStat(siMaxTeamDamage, "100 hedgeHogName") |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1440 |
-- total number of killed hedgehogs |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1441 |
SendStat(siKilledHHs, "1") |
1038 | 1442 |
-- ranking: sets rank of Megateam to 1 and rank of Superteam to 2 |
1443 |
SendStat(siTeamStats, "Megateam:1:Superteam:2:") |
|
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1444 |
-- best shot award |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1445 |
SendStat(siMaxStepDamage, "30 hedgeHogName (teamName)") |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1446 |
-- team with most kills of own hedgehogs |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1447 |
SendStat(siMaxStepDamage, "2 teamName") |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1448 |
-- team with most skips |
347
edc8d322d02d
Edited wiki page LuaAPI, fixing SendStat
pntanasis@gmail.com
parents:
346
diff
changeset
|
1449 |
SendStat(siMaxTurnSkips, "3 teamName") |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1450 |
</code> |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1451 |
|
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1452 |
<b>Important:</b> |
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1453 |
|
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1454 |
* As the game engine send stats to the frontend at the end of the game one should send her stats when the game is going to finish and right before the call of `EndGame()`. (Note: Stats are sent from the engine in `CheckForWin`. If conditions are met (win or draw) then `SendStats(uStats)` is called.) |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1455 |
* Calling just `EndGame()` won’t produce any stats. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1456 |
* If one would like to produce a custom graph see also `SendHealthStatsOff()`. |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1457 |
|
1232
4ac63a5c0184
LuaAPI: Remove most pre-0.9.23 version number mentions as very old
Wuzzy
parents:
1231
diff
changeset
|
1458 |
=== <tt>!SendHealthStatsOff()</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1459 |
Prevents the engine of sending health stats to the frontend. |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1460 |
|
996
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1461 |
If any health stats haven’t been sent before this will cause the health graph to the stats page to be hidden. Use this function in the Lua scripts to produce custom graphs by calling it inside `onGameStart()` and using the `SendStat()` function. |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1462 |
|
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1463 |
=== <tt>!SendAchievementsStatsOff()</tt> (0.9.23) === |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1464 |
Prevents the engine of populating the snarky comments in the “Details” section (internally known as “achievements”) of the stats screen, such as “best shot award”, etc. So you can start with a clean list when the game ends normally. This function needs to be called inside `onGameStart()`. |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1465 |
|
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1466 |
=== <tt>!SendRankingStatsOff()</tt> (0.9.23) === |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1467 |
Prevents the engine of populating the team rankings in the stats screen, so you can start with a clean list when the game ends normally. This function needs to be called inside `onGameStart()`. |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1468 |
|
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1469 |
=== <tt>!SendGameResultOff()</tt> (0.9.23) === |
9d49deef533c
LuaAPI: Add SendRankingStatsOff, SendAchievementsStatsOff, SendGameResultOff
Wuzzy
parents:
993
diff
changeset
|
1470 |
Prevents the engine of setting the game result text at the top of the stats screen, e.g. “Team 1 wins!” when the game ends normally. This function needs to be called inside `onGameStart()`. |
328
fdc71ac8db83
Updated wiki page LuaAPI with the SendStat() and SendHealthStatsOff() functions.
pntanasis@gmail.com
parents:
313
diff
changeset
|
1471 |
|
1040 | 1472 |
=== <tt>!GetTeamStats(teamname)</tt> (0.9.23) === |
1473 |
Returns a table of internal stats of a team. This table has the following fields: |
|
1474 |
||
1211 | 1475 |
* `Kills`: Number of kills |
1476 |
* `Suicides`: Number of suicides (not yet working) |
|
1477 |
* `AIKills`: Number of AI kills |
|
1478 |
* `TeamKills`: Number of hedgehogs killes in own team (excluding current hedghog) |
|
1479 |
* `TurnSkips`: Number of skipped turns |
|
1480 |
* `TeamDamage`: Damage inflicted to own team (excluding current hedgehog) |
|
1040 | 1481 |
|
382 | 1482 |
== Math Functions == |
1483 |
||
383
6679b75048c0
I really have to get used to using preview on google code wiki...
sheepyluva@gmail.com
parents:
382
diff
changeset
|
1484 |
=== <tt>div(dividend, divisor)</tt> === |
515
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1485 |
Performs an integer division and returns the result. |
8e9d86efc07b
Copy-editing of the entire page. Also a few updates to some fairly out-dated information while I’m at it.
almikes@aol.com
parents:
505
diff
changeset
|
1486 |
The result is an integer and has the value of the first parameter (an integer) divided by the second parameter (another integer), rounded towards zero. |
382 | 1487 |
|
401
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1488 |
=== <tt>band(value1, value2)</tt> === |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1489 |
Returns the bitwise logical AND of `value1` and `value2`. |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1490 |
|
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1491 |
=== <tt>bor(value1, value2)</tt> === |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1492 |
Returns the bitwise logical OR of `value1` and `value2`. |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1493 |
|
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1494 |
=== <tt>bnot(value)</tt> === |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1495 |
Returns the bitwise logical NOT of `value`. |
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1496 |
|
aee281298267
Documented the following functions: band, bnot, bor.
almikes@aol.com
parents:
400
diff
changeset
|
1497 |
|
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1498 |
== Debugging Functions == |
820 | 1499 |
=== `WriteLnToConsole(string)` === |
1500 |
Writes `string` to `Logs/game0.log`, found in the user data directory. |
|
1501 |
||
1189 | 1502 |
=== `WriteLnToChat(string)` (0.9.24) === |
1503 |
Writes `string` into the chat. |
|
1504 |
||
820 | 1505 |
=== `DumpPoint(x, y)` (0.9.23) === |
821 | 1506 |
Converts the whole numbers `x` and `y` to strings and writes them to `Logs/game0.log`, one line each. |
12
74ead59b6c64
LuaAPI page + GearTypes,AmmoTypes,Sounds,States listing pages
Tobias Neumann <mail@tobias-neumann.eu>
parents:
diff
changeset
|
1507 |
|
1221 | 1508 |
=== `StartGhostPoints(count)` === |
1509 |
Just prints out “GHOST_POINTS” and the argument on the console. This function might change in later versions. |
|
1510 |
||
1226 | 1511 |
=== `DeclareAchievement(id, teamname, location, value)` === |
1225
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1512 |
Declares an achievement with the identifier `id` achieved by the team `teamname` on the map `location` with an achievement value (e.g. score) of `value`. `value` must be an integer. You are supposed to call this function inside an `onAchievementsDeclaration` callback. |
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1513 |
|
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1514 |
Currently, this actually just triggers a console output, but it might be changed later. The idea is to track multiplayer records. |
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1515 |
|
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1516 |
Example: |
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1517 |
|
1231 | 1518 |
<code language="lua">DeclareAchievement("height reached", teamname, "ClimbHome", -score)</code> |
1225
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1519 |
Records a team's best height in !ClimbHome. |
64b95a681971
LuaAPI: Add onAchievementsDeclaration and DeclareAchievement
Wuzzy
parents:
1224
diff
changeset
|
1520 |
|
394
b2742eb19396
Edited wiki page LuaAPI through web abuser interface.
sheepyluva@gmail.com
parents:
384
diff
changeset
|
1521 |
=== <tt>!ParseCommand(string)</tt> === |
1046 | 1522 |
Makes the game client parse and execute the specified internal game engine command. |
1523 |
||
1524 |
The available commands depend on the current engine protocol version. The *engine protocol can (and will) change* between releases. |
|
1044 | 1525 |
|
1046 | 1526 |
**Important**: If you use `ParseCommand` to overcome a shortcoming in our Lua API (e.g. a missing function), please make sure to [https://issues.hedgewars.org/enter_bug.cgi report the issue]. |
394
b2742eb19396
Edited wiki page LuaAPI through web abuser interface.
sheepyluva@gmail.com
parents:
384
diff
changeset
|
1527 |
|
1046 | 1528 |
With your report we can fix the shortcoming in future releases. We will try to remove the reliance on `ParseCommand` as good as possible. This will allow scripts to use the previously missing feature in a way that won’t break! |
1529 |
||
1530 |
There are many available commands, but only a few of them are useful for scripting. These are commands used in official scripts in 0.9.22: |
|
394
b2742eb19396
Edited wiki page LuaAPI through web abuser interface.
sheepyluva@gmail.com
parents:
384
diff
changeset
|
1531 |
|
1074 | 1532 |
* `"skip"`: Current hedgehog skips its turn |
1533 |
* `"draw <map>"`: Draws a hand-drawn map. `MapGen` must be `mgDrawn` for this to work. `<map>` is a string which must follow the format specified in [DrawnMapFormat] |
|
1044 | 1534 |
|
1057 | 1535 |
Moreover, the control action names as listed in [ConfigurationFiles] (under “Binds”) can be used. Note we will eventually try to remove all `ParseCommand`s in the official scripts. |
1054 | 1536 |
|
1537 |
=== <tt>!EndLuaTest(success)</tt> === |
|
1538 |
This function is used by the Hedgewars developers in testing scripts in order to test the game engine. The testing scripts can be found in the Hedgewars source code under `tests/lua`. This function is useless for anything else. |
|
1539 |
||
1540 |
Calling this function ends an engine test and reports a test result. |
|
1541 |
||
1055
754e0a7bdd44
Explain briefly how engine testing works
Wuzzy <almikes@aol.com>
parents:
1054
diff
changeset
|
1542 |
`success` is either one of `TEST_SUCCESSFUL` to report a successful test or `TEST_FAILED` for a failed test. |
754e0a7bdd44
Explain briefly how engine testing works
Wuzzy <almikes@aol.com>
parents:
1054
diff
changeset
|
1543 |
|
754e0a7bdd44
Explain briefly how engine testing works
Wuzzy <almikes@aol.com>
parents:
1054
diff
changeset
|
1544 |
See [EngineTestCases] to learn more about testing the engine. |