BetterMouseCursor
Custom cursor framework that also fixes the controller cursor flicker. Built-in clean arrow or your own PNG, with live-configurable size and hotspot.
By Coruscnium
| Last updated | 5 hours ago |
| Total downloads | 3 |
| Total rating | 1 |
| Categories | Mods Tools Client-Side Cosmetic |
| Dependency string | Coruscnium-BetterMouseCursor-1.1.0 |
| Dependants | 0 other packages depend on this package |
This mod requires the following mods to function
BepInEx-BepInExPack_Mycopunk
BepInEx pack for Mycopunk. Preconfigured and ready to use.
Preferred version: 5.4.2403
Sparroh-ModSettingsMenu
In-game mod config editor plus click-and-drag HUD reposition mode for compatible mods.
Preferred version: 1.2.0README
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
- Drop a PNG into
BepInEx/config/BetterMouseCursor/(created on first launch). Square images with transparency look best (e.g. 64×64 or 256×256). - Set
CursorFileto the filename — press F10 in-game (ModSettingsMenu) or edit the.cfgin a text editor. Absolute paths work too. - It applies instantly. Set
CursorFileback 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:
| Setting | Default | Description |
|---|---|---|
CursorFile |
(empty) | PNG filename in BepInEx/config/BetterMouseCursor/, or an absolute path. Empty = built-in arrow |
CursorSize |
32 |
Cursor size on screen, in pixels (8–512) |
HotspotX |
0 |
Click point X in source-image pixels from the image's top-left (−2048 to 2048 — values outside the image are fine for irregular art). For a centered crosshair in a 256px image, use 128 |
HotspotY |
0 |
Click point Y, same convention. Scales with CursorSize automatically |
Installation
- Install BepInExPack_Mycopunk
- Install ModSettingsMenu for the in-game F10 config editor
- Place
BetterMouseCursor.dllinBepInEx/plugins/(or install via r2modman) - 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.
