Ashlar checks / tooling (push) Successful in 5s
New [Game] mantling setting, on by default, with mantle max height (1.1 times the actor's height above its feet) and mantle duration (0.4 s). When the player jumps or falls into a wall while moving towards it (within 60 degrees), the movement solver casts the player's collision shape up, across the edge and down. If it finds a surface flat enough to stand on, above the feet and within reach, with headroom and room on top, the player moves up, across and onto it along that checked path. Movement and jump input are ignored meanwhile, and the climb ends any fall without fall damage. No animation is needed. A script move or teleport, noclip or paralysis cancels a climb. Lua: self.controls.mantle (true by default) vetoes climbs while false, and the actor's scripts get an AshlarMantle event with the ledge height when one starts. The engine logs "Ashlar mantle:" lines at verbose level. Player only; with the setting off nothing changes. The geometry rules (reach, headroom, room on top, slope, too high, too low) and the climb path are in mwphysics/mantle.cpp, apart from the physics calls, with unit tests. The new mantle scenario uses a CC0 box mesh written for it: the player climbs an 80 unit ledge, doesn't climb it with the Lua veto, and doesn't climb a 240 unit wall. Closes #28 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Files in this directory describe OpenMW API for Lua Development Tools (LDT).
*.doclua files are taken (with some modifications) from LDT distribution and are distributed under MIT license.
Openmw-specific docs (openmw/*.lua) are under GPLv3 license.
To get a Lua IDE with integrated OpenMW documentation and code autocompletion do the following:
- Install and run LDT.
- Press
File/New/Lua Projectin menu. - Specify project name (for example the title of your omwaddon)
- Set
Targeted Execution EnvironmenttoNo Execution Environment, andTarget Grammartolua-5.1. - Press
Next, choose theLibrariestab, and clickAdd External Source Folder. Then specify there the path to this directory. - Press
Finish.