MarkerMod

Use paintballs as markers in dungeons.

Paintballs create puddles and leave footprints when you walk through them. Without this mod, these effects are useless as they disappear too quickly. MarkerMod makes them into practical markers you can use in dungeons.

Features

• Puddles stay permanently (optional)
• Footprints remain visible (optional)
• Configurable lifetime for both effects
• Perfect for navigation in complex dungeons

Installation

1. Install the mod via Thunderstore Mod Manager or manually
2. Launch the game once to generate the configuration file
3. Adjust settings in UserData/MelonPreferences.cfg as needed

Configuration

The mod adds a MarkerMod section to your configuration file:

• keepFootprints: Enable permanent footprints (default: true)
• keepPuddles: Enable permanent puddles (default: false)
• permanentLifetimeSeconds: Lifetime of effects in seconds (default: 86400)
• infinitePaintballs: Paintballs are not consumed when thrown (default: false)

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.