How to do things with our modding tools. Each page answers one "how do I ...?" question with the exact steps. Every folder
also has a reference.md that lists what the tool has.
This wiki is for modders and agents working with our tools. The players' wiki is a different thing: wiki.cereus.games.
Changed a tool? Update its page in the same change. The rule and the page format are in MAINTAINING.md.
py -3.12 -I -B S:/eclipse-build/docs/wiki/check.py lists pages that have fallen behind their sources.
It is also a site with search: tools.cereus.games. These Markdown pages are its source
(site/build.py builds it, site/publish.py publishes it; see MAINTAINING.md).
Each page says at the top how far it can be trusted: checked (every step read against the code), partial (the page says
which parts are not checked) or stub (placeholder).
I want to ...
Edit maps in Smithbox (all pages)
| I want to ... | Page |
|---|---|
| Place an asset or enemy in a map | smithbox/place-an-object.md |
| Place an Elden Ring asset in a Nightreign map | smithbox/place-er-asset.md |
| Move, rotate and drop objects onto the ground | smithbox/move-rotate-snap.md |
| Switch between a POI's variations | smithbox/poi-variations.md |
| Edit a cliff's far objects (block maps) | smithbox/block-maps-and-far-objects.md |
| Edit a whole area directly (being built) | smithbox/area-editing.md |
| Understand what the viewport draws and hide storm effects | smithbox/rendering.md |
| Set up a project, add the Eclipse mod as a layer, move a project | smithbox/project-setup.md |
| Generate a navmesh for a camp | smithbox/generate-navmesh.md |
| Port an Elden Ring map into Nightreign | smithbox/port-er-map.md |
| Edit an HKS or AI Lua script | smithbox/script-editor.md |
| Send a bug report from Smithbox | smithbox/send-bug-report.md |
| Drive Smithbox from an agent | smithbox/mcp-bridge.md |
| Build Smithbox from source | smithbox/build-smithbox.md |
Build a stage (all pages)
| I want to ... | Page |
|---|---|
| Make a stage | build/start-a-stage.md |
| Run a heavy step without freezing the machine | build/run-heavy-jobs.md |
Skip a step whose inputs did not change, or make .dcx files comparable |
build/cache-and-dcx.md |
| Get a shared tool | build/use-shared-tools.md |
| Freeze files into the store or get them back | build/store-and-rescue.md |
| Build and check a release from stages | build/check-and-build-a-release.md |
Seeds (all pages)
| I want to ... | Page |
|---|---|
| Generate a Limveld seed | seeds/generate-a-seed.md |
| Put a seed in the mod | seeds/put-a-seed-in-the-mod.md |
Port content (all pages)
| I want to ... | Page |
|---|---|
| Port a Dark Souls 2 character | ports/port-a-ds2-character.md |
| Port a Dark Souls 3 or Elden Ring character | ports/port-a-ds3-or-er-character.md |
| Port a DS3 weapon art or ER skill | ports/port-a-weapon-skill.md |
| Add DS3 sounds | ports/add-ds3-sounds.md |
| Edit map files from the command line | ports/map-tools.md |
| Change params with a rowlist | ports/edit-params-and-rowlists.md |
| Add or check a skin | ports/skins.md |
Look at characters in DSAS (all pages)
| I want to ... | Page |
|---|---|
| Take batch screenshots of a character | dsas/render-a-character.md |
| Browse ported characters by hand | dsas/browse-ports-interactively.md |
Debug the game (all pages)
| I want to ... | Page |
|---|---|
| Build and install the debug DLL | debug-dll/build-and-install.md |
| Turn on a debug log | debug-dll/turn-on-a-debug-log.md |
Reference pages
Smithbox map editor · Smithbox MCP bridge · eb commands · seed tools · port tools · DSAS job fields · debug DLL config
Rules that apply everywhere
- Never launch Nightreign from a script or an agent. Stan starts the game himself.
- A running Smithbox is someone's live workspace. Never close it or discard its edits. See smithbox/mcp-bridge.md.
- Secrets (webhooks, signing keys, tokens) never go into a page, a log or git.
- Use the game's own names in anything players or the team will read.