Factorio Standard Library Project
The Factorio Standard Library is a project to bring Factorio modders high-quality, commonly-required utilities and tools that developers have been often copying around, remixing, and rewriting poor quality copies of. Factorio mods often re-implement basic tools like logging, math calculations, and position or area manipulation. These common operations can be a subtle source of errors and their regular occurance has encouraged the creation of the Factorio Stdlib, as a toolbox and set of utilities for modders. Factorio Standard Library APIs are all unit-tested, documented, and high quality, and written to be simple and straightforward for the earliest beginners and seasoned developers alike.
- Install the Factorio Standard Library mod from the mod portal latest release
- In your
info.jsonaddstdlibas a dependency. - In your
control.luaor other lua modules, you can import the stdlib modules you need.
See the wiki for an introduction and usage/examples.
See the github pages for the latest generated documentation of the Factorio-stdlib
The codebase is tested with busted. Test specifications are located under spec/
Contributions are welcome! Please follow general lua coding standards and include ldoc-compatible comments.
