No Man's Sky mod to make settlements a bit less underwhelming.
  • Python 99.5%
  • PowerShell 0.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
Ethan Hann 82e7008806
Merge pull request #32 from ethan-hann/readme-1.2.0
Update and reorganize the README for 1.2.0
2026-10-17 22:27:38 -05:00
.github Modify bug report template for mod issues 2026-10-17 14:56:20 -05:00
docs Apply the README review: links, roadmap, and the contributing workflow 2026-10-17 22:22:20 -05:00
mod Keep only the Fair Ledger text overrides that add something 2026-10-17 19:46:22 -05:00
runtime/spikes Add the runtime spike sketches and the M6 go/no-go 2026-10-06 22:06:44 -05:00
specs Keep only the Fair Ledger text overrides that add something 2026-10-17 19:46:22 -05:00
tests List overridden vanilla text in COMPATIBILITY.md and flag shared text keys in scans 2026-10-17 21:14:20 -05:00
tools List overridden vanilla text in COMPATIBILITY.md and flag shared text keys in scans 2026-10-17 21:14:20 -05:00
.gitattributes Make release zips independent of working-copy line endings 2026-10-17 17:18:04 -05:00
.gitignore Add nexus_screenshots to .gitignore 2026-10-07 22:58:51 -05:00
AGENTS.md Apply the README review: links, roadmap, and the contributing workflow 2026-10-17 22:22:20 -05:00
CHANGES.md Record the Vortex bundle check and fix the switching advice 2026-10-17 21:05:15 -05:00
CLAUDE.md Add an agent guide and warn players about removing modules 2026-10-12 19:48:10 -05:00
COMPATIBILITY.md List overridden vanilla text in COMPATIBILITY.md and flag shared text keys in scans 2026-10-17 21:14:20 -05:00
CONTRIBUTING.md Apply the README review: links, roadmap, and the contributing workflow 2026-10-17 22:22:20 -05:00
LICENSE Initial commit 2026-10-06 18:37:42 -05:00
pytest.ini Pin tools and fix .gitignore 2026-10-06 19:13:05 -05:00
README.md Apply the README review: links, roadmap, and the contributing workflow 2026-10-17 22:22:20 -05:00
versions.json Version each module separately, with an all-in-one bundle 2026-10-17 20:17:24 -05:00

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.

No Man's Sky 7.06 (COSMOS) License: MIT Issues

Quick start

  1. 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.
  2. Install with Vortex, or extract the zips into No Man's Sky\GAMEDATA\MODS. Details are in Installing and updating.
  3. 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

  1. Become your settlement's overseer.
  2. Stand inside the settlement and open the build menu.
  3. 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:

  1. Grab the zips you want from Nexus or the releases.
  2. 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.
  3. 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.

  1. Back up your saves first. They live in %APPDATA%\HelloGames\NMS\.
  2. Replace anything you want to keep with the game's own parts. Settlement Decor parts are the game's own, so they're safe.
  3. 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.
  4. 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

License

MIT