- Python 99.5%
- PowerShell 0.5%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
|
|
||
| .github | ||
| docs | ||
| mod | ||
| runtime/spikes | ||
| specs | ||
| tests | ||
| tools | ||
| .gitattributes | ||
| .gitignore | ||
| AGENTS.md | ||
| CHANGES.md | ||
| CLAUDE.md | ||
| COMPATIBILITY.md | ||
| CONTRIBUTING.md | ||
| LICENSE | ||
| pytest.ini | ||
| README.md | ||
| versions.json | ||
Overseer's Toolkit 🏘️
Your settlement deserves better than dirt and fireworks.
Overseer's Toolkit is a No Man's Sky mod that gives settlement overseers the stuff a real town needs: stone paths, curbs, street lamps that run without power, and proper signs. Everything builds straight from the settlement's own build menu.
Quick start
- Grab OverseersToolkit-AllInOne from Nexus or the GitHub releases for the full set (core, Defense, Settler Stories and Fair Ledger), or pick just the modules you want. Settlement Decor and Fair Ledger Rebalance are separate downloads either way.
- Install with Vortex, or extract the zips into
No Man's Sky\GAMEDATA\MODS. Details are in Installing and updating. - Become your settlement's overseer and look under Decoration > SETTLEMENT in the build menu.
Removing a module later can delete what you built with it, so read Removing modules before you take anything out.
Modules
The mod comes in six modules, each with its own version. Every one works on its own, and none of them depends on another.
AllInOne holds core, Defense, Settler Stories and Fair Ledger. Settlement Decor and Fair Ledger Rebalance are separate optional downloads because they change the game's own content broadly: Decor makes 489 vanilla parts buildable in settlements, and Rebalance changes vanilla upkeep (and conflicts with economy overhauls).
| Module | What you get | In AllInOne? |
|---|---|---|
| 🧱 OverseersToolkit | A new Decoration > SETTLEMENT section with paths, curbs, a lamp and 24 signs. See Core | Yes |
| 🛡️ OverseersToolkit-Defense | A rare "Fortify the perimeter?" judgement and the decorative Tower Pillar. See Defense | Yes |
| 📜 OverseersToolkit-SettlerStories | 6 new settlement decisions and 3 short stories. See Settler Stories | Yes |
| 💰 OverseersToolkit-FairLedger | Pay off settlement debt at the overseer's terminal, plus clearer upkeep and debt text. See Fair Ledger | Yes |
| 🌿 OverseersToolkit-SettlementDecor | 489 vanilla decoration parts buildable in settlements. See Settlement Decor | No, separate download |
| ⚖️ OverseersToolkit-FairLedger-Rebalance | Break-even upkeep for the town's working buildings at class C. See Fair Ledger Rebalance | No, separate download |
Every module's text is in every language the game offers, built from the game's own words. Native speakers haven't checked the translations, so if something reads wrong in your language, corrections are welcome as an issue.
Core
Core adds a new Decoration > SETTLEMENT section: Path Tile, Path Triangle, Curb, Path Lamp, and 24 signs from the game (Illuminated Sign, Standing Sign, Station Billboard, holo displays, Gek / Korvax / Vy'keen emblems, number decals 0 to 9). They unlock as your settlement levels up:
| Settlement class | Unlocks |
|---|---|
| B | Path Tile, Path Triangle, Curb, Path Lamp |
| A | All 24 signs |
| S | Tower Pillar (Defense module) |
In creative mode, everything is available from the start.
Good to know:
- The class unlocks haven't been tested in a survival or normal game yet. They load fine and should™ work. If a part doesn't unlock when your settlement levels up, please open an issue.
- Path tiles flatten the ground under them, so your streets stay flat.
- The Path Lamp lights up with no power hookup. 💡
- There's no path-drawing tool yet, so paths go down one piece at a time, like any other part.
- These parts are deleted if the game saves without core. See Removing modules.
Defense
Defense adds a rare "Fortify the perimeter?" judgement that grants the Perimeter Watch perk (lower Sentinel alert level) for some debt, plus the decorative Tower Pillar, which unlocks at class S.
Good to know:
- The fortify judgement is rare on purpose: about once every 18 hours of judgements (about 30 with Settler Stories installed). Judgements are drawn independently, so it doesn't come in bursts.
- It can turn up again after you already have Perimeter Watch. Just turn it down (it costs a little happiness).
- The Tower Pillar is deleted if the game saves without Defense. See Removing modules.
Settler Stories
Settler Stories adds new decisions to the ones your settlement already asks you to make:
- Six one-off decisions: a night market, salvage from a crashed freighter, a fevered traveller, a buried signal booster, a festival and a wage dispute.
- Three short stories: a stranger at the gate with pirates on their trail, a vault of ancient seeds, and a survey team overdue from the ridge. Each one plays out over two or three decisions, and there are three new settlement features to earn.
- Every outcome is shown before you choose, and most are good or mixed. About half the options reward you (units, nanites, quicksilver, items, alien words, standing) and half reward the settlement (happiness, productivity, new features).
- They mix in with the game's own decisions.
Good to know:
- Each next story step comes straight after your choice, so answer it at the terminal before you walk away.
- Story steps don't send an alert. Check the overseer's terminal for the next decision.
- Finish any story before you remove this module. See the Settler Stories warning under Removing modules.
Fair Ledger
Fair Ledger lets you pay down a settlement's debt instead of waiting it out. The overseer's Administration Terminal gets two new options:
- "Pay 100,000 debt" for 200,000 units
- "Pay 1,000,000 debt" for 2,000,000 units
Each one clears exactly the debt it names, in that town. Those prices are for the Standard Purchases setting (2 units per debt). On Free it's free, on Discounted it's a third of that, and on Expensive it's 3.32 units per debt.
It also makes the debt text clearer: "Maintenance Cost" becomes "Upkeep", and the two debt tips now explain how debt goes down, where to pay it, and that overpaying is lost.
Good to know:
- Paying more than the remaining debt wastes the extra. The game says "Settlement reserves increased", but reserves aren't actually stored anywhere.
- The 1,000,000 payment only shows "Settlement debt reduced: 100,000 units", but the debt really does drop by the full 1,000,000.
- The terminal shows six options at most and the game already uses four. If another mod adds a terminal option too, one of Fair Ledger's gets pushed off.
- Side effect: the debt cut from a good expedition debrief becomes a flat 100,000, instead of anywhere from 50,000 to 100,000.
- Fair Ledger adds no parts, so removing it doesn't delete anything, and debt you already paid stays paid.
Settlement Decor
Settlement Decor makes 489 vanilla decoration parts buildable in settlements: exterior decor, lights, construction props, plants, statues, wall decals and posters. With it installed, the other decoration tabs in the settlement build menu fill up too.
Good to know:
- It's a separate download because it changes the game's own content broadly.
- Those decoration parts can also be placed outside a base.
- It only unlocks the game's own parts, so anything you build with it stays if you remove the module.
Fair Ledger Rebalance
Rebalance makes the town's working buildings break even at class C: the starport, infrastructure, trade center, small industrial, administrative building, storage facility, farm, factory and Autophage RoboArm each cost exactly as much upkeep as they produce. Upgrades are still how you turn a profit. Residences, the bar and the fish pond keep their usual upkeep.
Good to know:
- It takes effect on your existing buildings right away, and removing it puts the game's own upkeep back right away too.
- It conflicts with economy overhauls that change what buildings contribute, such as BetterSettlements.
Using it
- Become your settlement's overseer.
- Stand inside the settlement and open the build menu.
- The new parts are under Decoration > SETTLEMENT. With Settlement Decor installed, the other decoration tabs fill up too.
Installing and updating
With Vortex: install AllInOne for the full set, or pick the separate modules you want. Use one or the other, not both. Settlement Decor and Rebalance are separate either way.
Switching to AllInOne? Remove the separate core, Defense, Settler Stories and Fair Ledger downloads first. If both stay installed, Vortex reports a file conflict and its load order decides which version loads. Switching keeps your builds, because the folders and part IDs are the same.
By hand:
- Grab the zips you want from Nexus or the releases.
- Extract each one into
No Man's Sky\GAMEDATA\MODS. Each zip already contains its own module folder, and the AllInOne zip contains the four module folders. - Launch the game.
Updates: you only get an update for the modules you installed.
Removing modules
Warning
Removing a module deletes what you built with it. The moment the game saves without a module installed, every part that module added disappears from your save for good, and it can't be recovered from that save. Autosaves count too. That means the paths, curbs, lamps and signs from core, and the Tower Pillar from Defense. Settlement Decor only unlocks the game's own parts, so those stay, and Fair Ledger and Rebalance don't add any parts at all.
Warning
Finish any story before you remove Settler Stories. If you remove it while a story step is waiting at a settlement, that settlement's terminal shows a broken decision you can't answer, and you may have to close the game. To fix it, reinstall Settler Stories, answer the waiting decision, then remove it again.
- Back up your saves first. They live in
%APPDATA%\HelloGames\NMS\. - Replace anything you want to keep with the game's own parts. Settlement Decor parts are the game's own, so they're safe.
- Removing Settler Stories? Answer any story step still waiting at your settlements first. Its settlement features hide while it's gone and come back if you reinstall it.
- Remove the module in Vortex, or delete its folder from
GAMEDATA\MODS.
Fair Ledger adds no parts, so there's nothing to lose when you remove it. Removing Rebalance puts the game's own upkeep back.
Parts missing after an uninstall or a game update? Quit without saving, reinstall the module (or wait for an update if a game patch broke it), then load again. Your parts are still in the save until the game saves without them.
Compatibility
- Built and tested on No Man's Sky 7.06 (COSMOS).
- The mod ships small EXML patches and adds new
OT_parts instead of editing vanilla ones wherever it can. COMPATIBILITY.md lists every vanilla entry and field each module touches, plus the vanilla text each module replaces (Fair Ledger's four strings). It's generated from the patches, so it's always current. - Fair Ledger Rebalance conflicts with economy overhauls that change what buildings contribute, such as BetterSettlements.
- The overseer's terminal shows six options at most and the game uses four. Another mod that adds a terminal option pushes one of Fair Ledger's off.
- Want to build base-only parts (walls, landing pads, tech) right next to your settlement? Pair it with gBase Boundries.
- Multiplayer: every part reuses a vanilla model, so visitors without the mod should still see what you built.
Known limits
- After a game update, check that your paths and signs are still there before you save. If they're gone, the update may have stopped the mod from loading: quit without saving and check the issues or the Nexus page. See Removing modules for getting your parts back.
Reporting bugs and ideas 🐛
Please use the issue tracker. Include your game version, which modules you have installed, and your other mods if you can. Screenshots of your towns are always welcome.
Roadmap
- Path tool. Click points along a route and have the kit tiles laid for you, turned and snapped to the ground, using NMS.py.
Contributing 🛠️
Working on the mod itself? Setup, generators, testing and packaging are in CONTRIBUTING.md.
Credits
- MBINCompiler and hgpaktool for reading the game's data
- NMS.py for the runtime experiments
- Hello Games for No Man's Sky