BetterMouseCursor

A custom cursor framework for Mycopunk that also fixes the controller cursor flicker.

Replaces the game's cursor with a clean, uniform cursor for both mouse and controller — the built-in arrow by default, or any PNG you provide. Size and click-point (hotspot) are fully configurable and hot-reload in-game.

The Flicker Fix

Vanilla Mycopunk flickers the cursor when you move it with a controller stick. The game's cursor is custom art, but under the hood it's rendered as an OS hardware cursor — and driving it with a stick means warping that hardware cursor every single frame. Re-drawing a hardware cursor mid-warp, every frame, is something the OS never guarantees will look smooth; the result is flicker that no game-logic fix can touch (the game's internal state is perfectly clean while it happens — verified frame by frame).

This mod draws the cursor in-engine instead (the hardware cursor is hidden entirely), so it renders in the same frame as the rest of the UI and cannot flicker. Cursor movement, clicking, and menu navigation are untouched — the game's own pointer logic still runs.

Bonus smoothness fixes for controller:

• Sub-pixel movement is accumulated across frames instead of being truncated by the OS every frame — slow, precise stick movement no longer stutters or loses speed
• The drawn cursor tracks the pointer with zero frame lag
• Warp-generated mouse events no longer flap the detected input device mid-stick

Custom Cursors

1. Drop a PNG into BepInEx/config/BetterMouseCursor/ (created on first launch). Square images with transparency look best (e.g. 64×64 or 256×256).
2. Set CursorFile to the filename — press F10 in-game (ModSettingsMenu) or edit the .cfg in a text editor. Absolute paths work too.
3. It applies instantly. Set CursorFile back to empty for the built-in arrow.

Invalid or missing files log a warning and fall back to the built-in arrow — your cursor never breaks.

Configuration

BepInEx/config/coruscnium.bettermousecursor.cfg — all settings apply live:

Installation

1. Install BepInExPack_Mycopunk
2. Install ModSettingsMenu for the in-game F10 config editor
3. Place BetterMouseCursor.dll in BepInEx/plugins/ (or install via r2modman)
4. Launch the game

Client-side only — safe in multiplayer lobbies.

Credits

• Built-in arrow: Vimix Cursors by vinceliuice, licensed under GPL v3
• Sparroh — ModSettingsMenu, which powers the in-game config UI

License

This mod (and the bundled cursor art) is licensed under GPL v3 — see LICENSE.

Changelog

1.1.0

• CursorSize range expanded to 8–512 px (custom high-resolution PNGs render pixel-crisp at large sizes; the built-in 64px arrow will look soft past ~128)
• HotspotX/HotspotY range expanded to ±2048 source-image pixels — the click point can sit far outside the image for irregular cursor art

1.0.0

• Initial release
• Fixes the vanilla controller cursor flicker (the game's cursor is rendered as an OS hardware cursor and warped every frame the stick is deflected; the cursor is now drawn in-engine instead, which cannot flicker)
• Uniform cursor for mouse and controller — same art, same size, same hotspot
• Built-in clean arrow cursor, or drop your own PNG into BepInEx/config/BetterMouseCursor/ and set CursorFile
• Configurable cursor size (8–128 px)
• Pixel-accurate hotspot configuration (source-image pixels, scales with cursor size)
• Smoother controller cursor: sub-pixel movement accumulation and zero-lag rendering
• Prevents warp-generated mouse events from flapping the detected input device
• Live hot-reload: edit via ModSettingsMenu (F10) or the .cfg directly — changes apply instantly, no restart