About PlanetsLib
From Factorio Mod PortalCode and graphics to help modders creating planets, moons and other systems. This is a community project.
PlanetsLib
Code and graphics to help modders creating planets, moons and other systems. This library is a community project. Anyone is welcome to open a pull request on Github. For feature requests, please open an issue. For general discussion, use Discord.
Since other mods make use of the 'orbit structure' this mod provides to the solar system, it is recommended to add PlanetsLib compatibility to your planet mod either by defining your planet prototype using PlanetsLib (as in the first image in the mod portal gallery), or by calling PlanetsLib:update in data-updates.lua (second image in the gallery). Besides improving compatibility with PlanetsLib consumers, this means if another mod updates the position of your planet's orbital parent without moving your planet, your planet will be moved too.
We aim to never make any breaking API changes such that the library is safe to use. We sometimes deprecate APIs by removing them from the documentation, but they stay functional.
Documentation
Contributors
thesixthroc, MeteorSwarm, Midnighttigger, Tserup, notnotmelon, Frontrider, Zwvei, allisonlastname, Hoochie63, SirPuck, Osmo, Thremtopod, Kryzeth.
Highlights
From source dataGame versions
Built for Factorio 2.1.
Footprint
Rated a light load on a server.
License
Published under MIT.
PlanetsLib on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Factorio servers. We download it from Factorio Mod Portal, place it, and restart the server.
- Server side
- Required on the server
- Server load
- light
- Smallest plan we suggest
- Factorio — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 2.3.6, released 2026-10-25
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 2.3.6 | 2026-10-25 | 2.1 | n/a |
| 2.3.5 | 2026-10-25 | 2.1 | n/a |
| 2.3.4 | 2026-10-24 | 2.1 | n/a |
| 2.3.3 | 2026-10-23 | 2.1 | n/a |
| 2.3.2 | 2026-10-22 | 2.1 | n/a |
| 2.3.1 | 2026-10-22 | 2.1 | n/a |
Dependencies
- Optional: [reserved]
- Optional: quality (factorio_portal, not in our catalogue)
- Optional: recycler (factorio_portal, not in our catalogue)
- Optional: PlanetsLib: Tiers
- Optional: Cosmic Social Distancing
- Incompatible with: Midnighttigger's Library
Declared by the newest build that lists any. Required ones are installed with it on one-click installs.
Run PlanetsLib on a Factorio server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogWorld generation
Changes or adds to how new terrain, biomes and structures are created.
Runs on your server
From source side supportFactorio Mod Portal lists PlanetsLib as required on the server. Check its Factorio Mod Portal page to see whether players need it too.
Compatibility
- Game
- Factorio
- Runs on
- Serverrequired on the server
- Game versions
- 2.1
Verified at the source
- ✓Factorio Mod PortalOfficial listing, checked 2026-10-26Open ↗
- ✓Authorthesixthroc, as published on Factorio Mod Portal
- ✓LicenseMITFree
