A tool to capture a Noita world as a huge image
Go to file
2022-08-08 23:05:58 +02:00
.github/workflows Fix release not including submodules 2022-07-31 20:59:16 +02:00
.vscode Draw entities and their component's bounding boxes 2022-08-08 23:05:58 +02:00
bin Draw entities and their component's bounding boxes 2022-08-08 23:05:58 +02:00
data Reduce more animations for a cleaner image 2022-07-18 22:53:34 +02:00
files Change JSON number formatting to be more conform 2022-08-08 22:07:00 +02:00
images Prepare for 2.0 release 2022-07-30 19:10:48 +02:00
scripts/dist Update distribution script 2022-07-28 10:06:05 +02:00
.gitignore Improve user experience 2022-07-28 01:48:49 +02:00
.gitmodules Add LuaNXML library 2022-07-23 22:36:14 +02:00
AREAS.md Fix coordinate systems & Prepare for entity output 2022-07-17 14:39:18 +02:00
compatibility.xml Fix some stuff 2020-10-18 21:18:43 +02:00
go.mod Draw entities and their component's bounding boxes 2022-08-08 23:05:58 +02:00
go.sum Draw entities and their component's bounding boxes 2022-08-08 23:05:58 +02:00
init.lua Fix compatibility stuff 2022-07-30 00:32:11 +02:00
LICENSE Update tooling & Fix small things 2022-07-16 17:29:26 +02:00
mod.xml Fix some stuff 2020-10-18 21:18:43 +02:00
README.md Fix release not including submodules 2022-07-31 20:59:16 +02:00
settings.lua Test to disable mod detection 2022-08-08 02:54:48 +02:00

Noita map capture addon Build Status

A mod for Noita that can capture images of the world and stitch them into one large image. It works with the regular Noita and the dev build.

missing image

A resulting image with nearly 3.8 gigapixels can be seen here (Warning: Spoilers).

System requirements

  • Windows Vista, ..., 10, 11. (64 bit OS for stitching)
  • A few GB of free drive space.
  • 4 or more GB of RAM for gigapixel images. (But it works with less as long as the software doesn't run out of virtual memory)

Installation

  1. Have Noita installed.
  2. Download the latest release of the mod from this link (The noita-mapcap-windows-amd64.zip, not the source code)
  3. Unpack it into your mods folder, so that you get the following file structure .../Noita/mods/noita-mapcap/mod.xml. You can open the mods folder by clicking Open mod folder from within the Noita mod menu.
  4. Refresh the mod list.
  5. Enable the MapCapture mod.

Usage

You can use the mod with either the regular Noita version, or the dev build noita_dev.exe that is located in the game installation directory. Using noita_dev.exe has the advantage that you can freeze pixel and rigid body simulations. Also, it uses a different location for its savegames, which means you don't have to worry about any save you may have left unfinished on the regular build.

Every setting you want or need to change can be found inside the mod settings tab of the game options. By default the mod settings will be set to useful values. An explanation for every setting can be found in the Mod settings section.

Once you have changed the mod settings to your liking you can start or resume a game with the mod enabled. You may see message boxes that suggest actions. This can happen if the mod detects game settings that do not align with what you have set in the mod settings. All you need to do is follow the given instructions, like:

Auto setup requester example

Hint Most of the changes this mod does to Noita are non permanent and will be gone after a restart or a new game, except:

  • Window, internal and virtual resolutions, if requested.
  • Screen shake intensity, which will always be disabled.

You can always right click Record button to reset the above mentioned settings back to Noita's default.

After all issue have been resolved you are free to start capturing.

To the top left of the window are 3 buttons:

  • Record button/Stop button Starts/Stops the capturing process based on your mod settings. You can always restart a capture, and it will resume where it was stopped.

  • Output directory button Reveals the output directory in your file browser. This will contain raw screenshots that later can be stitched.

  • Stitch button Reveals the directory of the stitch tool in your file browser.

To stitch the final result, click Stitch button to open the directory of the stitching tool. Start stitch.exe and proceed with the default values. After a few minutes the file output.png will be created.

Mod settings

Hint Use right mouse button to reset any mod setting to their default.

  • Mode: Defines what the mod captures, and how it captures it:

    • Live: The mod will capture as you play along. The end result is a map with the path of your run.

    • Area: Captures a defined rectangle of the world. You can either use predefined areas, or enter custom coordinates.

    • Spiral: Will capture the world in a spiral. The center starting point of the spiral can either be your current viewport, the world center or some custom coordinates.

Advanced mod settings

  • World seed: If non empty, this will set the next new game to this seed.

  • Grid size: The amount of world pixels the viewport will move between the screenshots.

  • Pixel scale: The resulting pixel size of the screenshots. If greater than 0, all screenshots will be rescaled to have the given pixel size.

  • Use custom resolution: If enabled, the mod will change the game resolutions to the given values.

  • Capture interval: Interval between screen captures, when in live mode.

  • Min. capture distance: The distance in world pixels the viewport has to move to allow another screenshot. Only used in live mode.

  • Max. capture distance: The distance in world pixels the viewport has to move to force another screenshot. Only used in live mode.

  • Capture entities: If enabled, the mod will capture all entities, their children, parameters and components and write them into output/entities.json.

    Warning This can slow down capturing a bit, it may also make Noita more unstable.

  • Disable parallax background: Will replace the world background with black pixels.

  • Disable UI: Will disable inventory UI. But the UI can still appear if triggered by mouse wheel or something similar.

  • Disable pixel and entity physics: Will disable/stop pixel and rigid body simulation. Only works in dev build.

  • Disable post FX: Disables most postprocessing effects like:

    • Dithering
    • Refraction
    • Lighting
    • Fog of war
    • Glow
    • Gamma correction
  • Disable shaders, GUI and AI: Also disables all postprocessing, any in game UI and will freeze all mobs. Only works in dev build.

  • Disable entity logic: Will modify all encountered entities:

    • Disables AI
    • Disables falling
    • Disables hovering and rotation animations
    • Reduces explosions

    Warning This can slow down capturing a bit, it may also make Noita more unstable.

Example settings

Use this for capturing while you are playing the game. The sliders are at their default values:

Live capture example settings

Use this to capture the base layout with the least amount of glitches and artifacts. The sliders are at their default values:

Area capture example settings

Troubleshooting

Noita crashes a lot

There is not a lot you can do about it:

  • You can try to increase the usable address space of your .../Noita/noita_dev.exe or .../Noita/noita.exe with Large Address Aware or a similar tool. This will help with any crashes that are related to out of memory exceptions.

  • You can disable the replay recorder.

More information/details about this can be found here.

I get "ASSERT FAILED!" messages

These can't really be prevented. All you can do is to click Ignore always.

Alternatively you can run the same capture in the regular Noita (non dev build), which has these messages disabled. With the exception that you can't disable the pixel and rigid body simulations it works as good as in the dev build.

The mod messed up my game

Custom resolution settings are retained even if you restart Noita or start a new game. In the worst case they will cause the game world to not render correctly, or they will make your game only use a fraction of the window.

To reset any permanent settings that may have been set by the mod:

  1. Enable the mod.
  2. Start a new game.
  3. Right click Record button and follow instructions.

Alternatively, you can reset all game settings by deleting:

  • "%appdata%\..\LocalLow\Nolla_Games_Noita\save_shared\config.xml" for the regular Noita.
  • "...\Noita\save_shared\config.xml" for the dev build.

Additional information

The resulting stitched images are quite big. You can read this comment that addresses how you can view, convert or even self-host your images.

Acknowledgements

This mod uses the LuaNXML library by Zatherz.

Thanks to Daniel Niccoli for figuring out how to change some in game options by manipulating process memory.

License

MIT