MIMESIS - MarkerMod

🛟 Need help or found a bug? Get support at support.doodesch.de.

Turn paintballs into permanent dungeon markers. Puddles and the footprints you leave normally vanish almost instantly - MarkerMod makes them persist so you can mark rooms, paths and dead ends, with optional color cycling and infinite paintballs.

Features

• Keep footprints - the paint footprints you leave after walking through a puddle persist instead of fading away (on by default).
• Keep puddles - the spawned paint puddles themselves also stay instead of drying up (off by default).
• Configurable lifetime - a single setting controls how long persistent paint stays visible, in seconds (default 86400 = 24 hours, minimum 1 second).
• Paintball color cycling - while holding a paintball, right-click to cycle its color through Red, Yellow, Green, Blue, Orange, Purple, White, Black and back to default. The color applies to both the held item and the next throw (on by default).
• Infinite paintballs - paintballs are not consumed when thrown, so you never run out of markers (off by default).

Requirements

Installation

• Recommended: install through a Thunderstore mod manager (r2modman / Gale). MimicAPI is pulled in automatically as a dependency.
• Manual: download MarkerMod.dll, make sure MimicAPI.dll is also installed, and drop both into MIMESIS/Mods/. Launch the game once to generate the config file at UserData/MelonPreferences.cfg.

Configuration

Stored in UserData/MelonPreferences.cfg under the MarkerMod category.

Usage

1. Hold a paintball and throw it to create a puddle.
2. Walk through wet paint to leave footprints.
3. With keepFootprints / keepPuddles enabled, the marks persist for the configured lifetime so you can navigate complex dungeons.
4. Right-click while holding a paintball to cycle its color (Red, Yellow, Green, Blue, Orange, Purple, White, Black, then back to default); the chosen color applies to the next throw.
5. With infinitePaintballs enabled, paintballs are never consumed when thrown.

Compatibility

Built for Mimesis 0.3.0 / MelonLoader 0.7.3. Requires MimicAPI.

Credits / License

Author: DooDesch. Released under the MIT License (Copyright (c) 2025 DooDesch). Source: github.com/DooDesch/Mimesis-MarkerMod.

Changelog

All notable changes to MarkerMod are documented in this file. The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.5.1] - 2026-06-22

Fixed

• The mod's Harmony patches were applied twice (MelonLoader auto-applies them, and the mod also called PatchAll() itself), so every patch ran twice. The mod now disables the auto-apply and patches exactly once, after its settings are loaded - so the patches run a single time and the configurable options (including the experimental long-throw option) apply reliably.

[1.5.0] - 2026-06-20

Fixed

• Thrown paintballs no longer damage the thrower. After the Mimesis 0.3.0 update a thrown paintball would detonate right next to the player instead of flying, hit them and deal damage. Paintballs now fly properly to where you aim and can never damage their own thrower. (Nexus: "The player takes damage when throwing into the distance".)
• The selected paintball colour matches the paint on the ground again. The 0.3.0 update removed the game's decal-colour pipeline, so the floor splat stayed its default colour; the mod now colours the floor decal directly to match the ball. (Nexus: "The colors don't match".)
• The "Infinite Paintballs" setting works again. The 0.3.0 update moved how thrown paintballs are consumed, which made the toggle have no effect; it is now wired to the new consumption path (with the previous durability path kept as a fallback). (Nexus: "infinite Paintballs".)

Added

• New "Prevent Paintball Self Damage" setting (default on): keeps your own thrown paintballs from hitting and damaging you, and lets them fly past you instead of detonating at your feet.
• New experimental "Allow Long Paintball Throws" setting (default off): reduces the navmesh clamp that can make a throw stop short at an invisible wall. Server-authoritative (host only); verify in-game before relying on it.

[1.4.2] - 2026-06-17

Changed

• Started maintaining a full changelog that is now published on GitHub, Thunderstore and Nexus. No gameplay changes compared to 1.4.1.

[1.4.1] - 2026-06-16

Changed

• Updated the MimicAPI dependency to 0.3.0 to match the current game build.
• Refreshed the README for the June 2026 standard (accurate configuration, dependencies and badges).

[1.4.0] - 2026-06-15

Fixed

• Compatibility with the Mimesis 0.3.0 game update and MelonLoader 0.7.3 (updated the MimicAPI reference for the new game build).

Changed

• Refreshed the README and project documentation with new badges and title format.

[1.3.1] - 2025-11-16

Added

• Paintball colour-change feature: paintballs cycle through colours, with the chosen colour applied to both the splatter material and the floor decals for consistent markers.

Changed

• Reworked colour handling into dedicated material and decal colour services for more reliable colouring.

[1.3.0] - 2025-11-15

Added

• MimicAPI integration. Paintball and decal persistence internals are now accessed through MimicAPI's reflection helpers for better compatibility across game updates.

Changed

• Improved decal persistence performance and compatibility.
• Tidied up the configuration namespace and preference descriptions.

[1.2.0] - 2025-11-15

Fixed

• Release packaging and Thunderstore upload fixes, including correct README (UTF-8) handling and the post-build copy step now only running on Windows.

[1.1.0] - 2025-11-15

Added

• Initial release. Makes paintballs work as practical markers in dungeons: paintballs create puddles and leave footprints that no longer vanish too quickly, so you can mark your way through the maps.
• Configurable marker lifetime plus toggles for keeping footprints and puddles.
• Optional infinite paintballs.
• Automated build-and-release pipeline and Thunderstore packaging.