sm64ex-coop/docs/lua/lua.md

75 lines
2.9 KiB
Markdown
Raw Normal View History

2022-01-30 07:47:22 +01:00
# Lua Reference
The Lua scripting API is in early development.
Expect many more things to be supported in the future.
<br />
## How to install Lua mods
2022-09-13 05:04:37 +02:00
Lua scripts you make can be placed either the `mods` folder in the base directory, or in `<SAVE FILE LOCATION>/mods`
Save file locations:
- Windows: `%appdata%/sm64ex-coop`
- Linux: `~/.local/share/sm64ex-coop`
- MacOS: `~/Library/Application Support/sm64ex-coop`
2022-01-30 07:47:22 +01:00
<br />
## Tips
- When developing Lua mods, run the game from a console. Lua errors and logs will appear there.
- You can use the `print()` command when debugging. Your logs will show up in the console.
2022-03-17 06:55:16 +01:00
- You can create a folder within the mods folder containing multiple lua scripts as long as one script is called `main.lua`. Dynos actors can be placed inside this mod folder under `<your mod folder>/actors/`.
<br />
2022-02-02 03:52:26 +01:00
## Sections
- [Globals](globals.md)
2022-01-30 07:47:22 +01:00
- [Constants](constants.md)
- [Functions](functions.md)
- [Structs](structs.md)
2022-09-13 05:01:45 +02:00
### Guides
- [Hooks](guides/hooks.md)
- [gMarioStates](guides/mario-state.md)
- [Setting up Visual Studio Code](vs-code-setup.md)
2022-01-30 07:47:22 +01:00
## Important notes on player indices
Something important to realize is that the `localIndex` for each player is different (unfortunately).
So the order of `gMarioStates[]`, `gNetworkPlayers[]`, and `gPlayerSyncTable[]` is different for each player.
Luckily `gPlayerSyncTable[]` will automatically translate the player indices, so setting `gPlayerSyncTable[0].example = 1` will set it for the correct player for everyone.
The `globalIndex` of each player is consistent among everyone connected. So if you absolutely need to sort things in order you will have to grab it from `gNetworkPlayers[<LOCAL INDEX HERE>].globalIndex`.
All of this is a holdover from when there were only two players. It was a reasonable idea back then.
<br />
## Example Lua mods (small)
2022-05-08 09:26:55 +02:00
- [Low Gravity](examples/low-gravity.lua)
2022-01-30 07:47:22 +01:00
- [Faster Swimming](../../mods/faster-swimming.lua)
- [Mario Run](examples/Mario-Run.lua)
2022-02-16 07:15:49 +01:00
- [HUD Rendering](examples/hud.lua)
2022-02-26 09:03:21 +01:00
- [Object Spawning](examples/spawn-stuff.lua)
2022-03-05 08:14:01 +01:00
- [Custom Ball Behavior](examples/behavior-ball.lua)
- [Replace Goomba Behavior](examples/behavior-replace-goomba.lua)
- [Add to Goomba Behavior](examples/behavior-add-to-goomba.lua)
- [Behavior with Surface Collisions](examples/behavior-surface-collisions.lua)
2022-03-31 06:36:47 +02:00
- [Custom Surface Collisions](examples/big-paddle)
2022-03-17 06:55:16 +01:00
- [Custom Box Model](examples/custom-box-model)
2022-03-18 05:41:46 +01:00
- [Custom Player Model](examples/koopa-player-model)
- [Moonjump](examples/moonjump.lua)
- [Instant Clip](examples/instant-clip.lua)
- [Water Height Changer](examples/water-level.lua)
2022-04-16 07:01:19 +02:00
- [Custom Level](examples/custom-level)
2022-05-07 07:06:35 +02:00
- [Custom HUD Texture](examples/custom-hud-texture)
2022-05-08 09:26:55 +02:00
- [Custom Audio Test](examples/audio-test)
## Example Lua mods (large)
- [Extended Moveset](../../mods/extended-moveset.lua)
- [Character Movesets](../../mods/character-movesets.lua)
- [Hide and Seek Gamemode](../../mods/hide-and-seek.lua)
- [Football (soccer) Gamemode](../../mods/football.lua)