Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/LPGhatguy/luanoid
Alternative to Roblox Humanoids written entirely in Lua
https://github.com/LPGhatguy/luanoid
Last synced: 3 months ago
JSON representation
Alternative to Roblox Humanoids written entirely in Lua
- Host: GitHub
- URL: https://github.com/LPGhatguy/luanoid
- Owner: LPGhatguy
- License: other
- Archived: true
- Created: 2018-03-26T18:29:18.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-05-09T22:31:08.000Z (over 6 years ago)
- Last Synced: 2024-07-31T20:39:46.717Z (6 months ago)
- Language: Lua
- Homepage:
- Size: 155 KB
- Stars: 64
- Watchers: 13
- Forks: 22
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE-CC0
Awesome Lists containing this project
- awesome-roblox - Luanoid
README
# Luanoid
New character controller intended as a replacement for Humanoid for developers who want more flexibility or control over their characters.## Usage
The latest source is available in the `src` directory. The rig and test playground is available in `luanoid-test-place.rbxlx`, but the version of the controller in the place may not be up-to-date at all times.To work on Luanoid, use [Rojo](https://github.com/LPGhatguy/rojo) to sync the project into the test place continually.
## Goals
* Keep state machine and controls entirely in Lua
* More predictable physics
* Don't get flung into the ceiling
* Rational slope behavior
* Smoothly handle stairs
* Sane control forces and limits
* Newton's third law reaction forces
* Correct friction forces
* Suitable for NPCs
* Pathfinding supportWe do expect to need some engine changes to to properly handle of the more nuanced physics behaviors like friction correctly. Lua heartbeat steps at 60 Hz but the Roblox physics engine internally steps at 240 Hz; Lua only gets to intervene once every 4 physics frames. We're using our experimentation here to inspire the design and development of more flexible and configurable types to support this.
## Non-Goals
* Support for Humanoid-specific APIs or concepts like `Tool`## Known Limitations
This project is meant to be an alternative to Humanoids, so it doesn't use Humanoids. That currently has some drawbacks that might make this controller unsuitable for your game in its current state.* Incompatible with avatar clothing and accessories
* Incompatible with camera control scripts that are dependent on HumanoidsClothing and accessories is something we are hoping to support without Humanoids in the future.
## Contributing
Pull requests are welcome!
If you encounter any issues that would prevent you from using this in a game, please open an issue. That alone is a useful contribution.
## License
Luanoid is dual-licensed under the CC0 and MIT licenses. See [LICENSE-CC0](LICENSE-CC0) and [LICENSE-MIT](LICENSE-MIT) for details.