ImagineMoreFun

ImagineMoreFun

A quality-of-life mod for the ImagineFun Minecraft server. It adds a ride tracker with goal HUDs, a daily ride planner, pin-collection tooling, visual and audio tweaks, and a themed Space Mountain overlay — all to make long sessions on ImagineFun smoother.

Every feature only activates while you are connected to an *.imaginefun.net server. On any other server, or in single-player, the mod stays dormant.

Current release: ImagineMoreFun 3.4.0 for Minecraft 26.2

Replaces Not Riding Alert, Pim!, and SkinCache

ImagineMoreFun merges all three mods into one. Remove their standalone jars before installing
ImagineMoreFun; Fabric will reject an installation containing both versions. Existing Not Riding
Alert settings are imported automatically on first launch, while PIM compatibility files and the
existing skin cache remain in their original locations.

Installation

1. Install Minecraft 26.2 with Fabric Loader 0.19.3 or newer.
2. Add Fabric API and Cloth Config using the compatible versions listed below.
3. Download imaginemorefun-3.4.0.jar and place it in the instance's mods folder.
4. Remove any standalone Not Riding Alert, Pim!, or SkinCache jars, then fully restart Minecraft.

Requirements

• Minecraft 26.2
• Java 25 or newer
• Fabric Loader 0.19.3 or newer
• Fabric API 0.157.0+26.2 or newer
• Cloth Config 26.2.155 or newer

Optional integrations

• ImagineFunUtils 0.0.9 or newer — recommended for automatic server-backed ride-count synchronization; a manual /ridestats lookup remains authoritative.
• Mod Menu — exposes ImagineMoreFun's configuration screen through the standard mod list.
• SmoothCoasters 26.2-v1 or newer — enables the live coaster-camera tilt integration.
• MonkeyCraft — enables MonkeyCraft-aware autograb and waiting-state helpers.

Features

Ride tracking & planning

• Not-riding alert — an optional sound when you are not on a ride, with a minimum-ride-time filter.
• Ride tracker — an on-screen list of rides and your progress toward a goal (1K / 5K / 10K), with multiple layouts, sort rules, closest-ride highlighting, per-ride max-goal overrides, and customizable colors. Show it always, only while riding, only while not riding, or never.
• Ride plan — a chained "do this, then that" daily plan across the top of the screen, with live progress and automatic extension as you finish steps. The server's Daily Objectives are folded in automatically.
• Daily ride report — a per-day summary screen, with popup or chat reminders.
• Session stats — today's ride count, ride time, rides-per-hour, and streak.
• Advance-notice chime — a sound a few seconds before selected rides end, configured through an exceptions-only ride editor.

Convenience

• Autograbbing aids — outlines for autograb regions, automatic cursor release, optional window-minimize, PC hibernation while riding, and a MonkeyCraft-visible waiting overlay.
• Setup wizard — a guided first-run walkthrough.
• Config profiles — named saved settings you can switch between instantly.

Visuals

• ImagineFun application icon — uses the ImagineFun logo in the macOS Dock or Windows taskbar
  while connected, then restores the normal Minecraft icon on disconnect.
• Screen tweaks — dim-while-riding, fullbright, modernized closed captions, and toggles to hide the scoreboard, chat, health bar, name tags, hotbar, XP level, and love-potion messages.
• Firework viewing — alerts, time-of-day changes, and blindness are suppressed inside the firework area.
• Space Mountain enhancements — a client-side overlay for Space Mountain / Hyperspace Mountain rides: a cleaned-up dome, an animated launch-tunnel screen effect, the coaster track, a projected starfield, and hidden show props. On by default; a master toggle reverts to vanilla visuals.

Pin collecting

• Pin-book tooling — value and fair-market-value lookup, a trade helper, and pending-pin tracking, with export and reset.
• Pin screen — a combined UI with click-to-copy, click-to-trade, and click-to-reset.
• Overlays — a rarity / alpha table on container screens, and color analysis for pin packs.
• Pin hoarder — auto-confirms pin-trade dialogs.
• Trader warping and scoreboard pin highlights.

Audio & extras

• OpenAudioMC integration — connect and disconnect the server's web-audio sessions in-game, with optional auto-connect, an audio-boost reminder, and clearer runtime-install guidance when the audio helper cannot start.
• Status-bar indicator — a ride countdown in the macOS menu bar or a Windows taskbar-adjacent overlay.
• Skin caching — caches player skins locally to cut down on repeated downloads.

Commands

• /imf — open the profile manager
• /imf setup — (re-)run the first-run walkthrough
• /imf profile <name> — switch to a saved settings profile
• /ridereport [date] — open the daily ride report
• /oa connect | disconnect | reconnect | volume — OpenAudioMC controls
• /pim — open the pin UI (collection tracking, valuation, trading, and clipboard export)

Building from source

./gradlew build

The built mod jar lands in build/libs/.

Native helper binaries are generated during the release workflow. GitHub Actions builds the macOS Swift helpers and Windows .NET helpers, assembles them into src/main/resources/native/, verifies the final jar contains them, and publishes tagged releases. Local ./gradlew build is fine for Java-side development, but a release jar must come from the tagged GitHub Actions build or from ./build-and-deploy.sh, which rebuilds native helpers before packaging.

Coding agents should begin with AGENTS.md and the
docs/README.md documentation map. Historical progress files are intentionally
separated from current behavior contracts there.

License

ImagineMoreFun is released under the MIT License. The bundled audio assets keep their own licenses (CC BY 3.0 and the Mixkit license) — see Audio credits below.

Audio credits

The Space Mountain ride overlay ships two looping sound assets:

• rail_friction.ogg — trimmed and re-encoded from "train_wheels_ringing_speed.wav" by uair01 on Freesound, licensed under CC BY 3.0.
• wind.ogg — trimmed and re-encoded from "Wind cold interior" on Mixkit, used under the Mixkit Sound Effects Free License.