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 an image into BepInEx/config/BetterMouseCursor/ (created on first launch). PNG and JPG are supported; square images with transparency look best (e.g. 64×64 or 256×256).
2. Press F10 in-game (ModSettingsMenu) and pick it from the CursorFile dropdown — every image in that folder is listed, with the file extension hidden, so sad.png shows up as sad. Default is the built-in arrow.
3. It applies instantly.

The list is live: add or delete images while the game is running and the dropdown updates on the spot, no restart. Overwriting the image you're using reloads it immediately too — handy while you're drawing one.

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

Per-Cursor Settings

CursorSize, HotspotX and HotspotY apply to the cursor you currently have selected. Each cursor remembers its own, so a 256px crosshair and a 32px arrow can live side by side and you can swap between them freely — no re-dialling the hotspot every time.

• A newly added image starts at the defaults (32 px, hotspot 0,0)
• Deleting an image deletes its saved settings too
• Everything lives in BepInEx/config/BetterMouseCursor/PerCursorSettings.ini, next to the images, so settings travel with a shared cursor set. Delete a section from that file to reset that one cursor

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.