author | Wuzzy |
Wed, 02 May 2018 22:53:00 +0100 | |
changeset 1344 | 250cb1218787 |
parent 1330 | d92ed3272533 |
child 1352 | e504c2e2246d |
permissions | -rw-r--r-- |
1329
bd781e19a52d
Split Lua libraries into several sub-pages
Wuzzy <almikes@aol.com>
parents:
1234
diff
changeset
|
1 |
#summary Overview of libraries for writing Lua scripts in Hedgewars |
84
6fa418422e57
Created wiki page through web user interface.
henrik.rostedt@gmail.com
parents:
diff
changeset
|
2 |
|
742 | 3 |
= Lua libraries documentation = |
4 |
||
5 |
== Introduction == |
|
1329
bd781e19a52d
Split Lua libraries into several sub-pages
Wuzzy <almikes@aol.com>
parents:
1234
diff
changeset
|
6 |
Libraries in scripts in Hedgewars are Lua files that are used by many scripts to add a common function, as an example the `Locale` library that allows scripts to translate text. The variables in these files are not exposed to the script using it but all the functions can be called. |
84
6fa418422e57
Created wiki page through web user interface.
henrik.rostedt@gmail.com
parents:
diff
changeset
|
7 |
|
6fa418422e57
Created wiki page through web user interface.
henrik.rostedt@gmail.com
parents:
diff
changeset
|
8 |
To use a library you only need to add one row at the top of the script: |
501
04b4b463bf33
Add HedgewarsScriptLoad, warn about the old and rusty loadfile function.
almikes@aol.com
parents:
500
diff
changeset
|
9 |
<code language="lua">HedgewarsScriptLoad("Scripts/<Library Name>.lua")</code> |
04b4b463bf33
Add HedgewarsScriptLoad, warn about the old and rusty loadfile function.
almikes@aol.com
parents:
500
diff
changeset
|
10 |
Where `<Library Name>` is replaced by the name. |
84
6fa418422e57
Created wiki page through web user interface.
henrik.rostedt@gmail.com
parents:
diff
changeset
|
11 |
|
1329
bd781e19a52d
Split Lua libraries into several sub-pages
Wuzzy <almikes@aol.com>
parents:
1234
diff
changeset
|
12 |
*Note*: In ancient scripts, you might find this line instead: |
501
04b4b463bf33
Add HedgewarsScriptLoad, warn about the old and rusty loadfile function.
almikes@aol.com
parents:
500
diff
changeset
|
13 |
<code language="lua">loadfile(GetDataPath() .. "Scripts/<Library Name>.lua")()</code> |
1329
bd781e19a52d
Split Lua libraries into several sub-pages
Wuzzy <almikes@aol.com>
parents:
1234
diff
changeset
|
14 |
This does not work with new Hedgewars versions anymore and causes the script to break. Use `HedgewarsScriptLoad` instead. |
85
9f1d2d3db844
Edited wiki page LuaLibraries through web user interface.
henrik.rostedt@gmail.com
parents:
84
diff
changeset
|
15 |
|
1329
bd781e19a52d
Split Lua libraries into several sub-pages
Wuzzy <almikes@aol.com>
parents:
1234
diff
changeset
|
16 |
== List of Lua libraries == |
246
7b1a6c46c3b5
Edited wiki page LuaLibraries through web user interface.
szabibibi@gmail.com
parents:
103
diff
changeset
|
17 |
|
1330 | 18 |
* [LuaLibraryLocale Locale] |
19 |
* [LuaLibraryUtils Utils] |
|
20 |
* [LuaLibraryTracker Tracker] |
|
21 |
* [LuaLibraryAnimate Animate] |
|
22 |
* [LuaLibraryParams Params] |
|
23 |
* [LuaLibraryTargetPractice TargetPractice] |
|
24 |
* [LuaLibrarySpeedShoppa SpeedShoppa] |
|
25 |
* [LuaLibrarySimpleMission SimpleMission] |