ModsFinder

GuidedMod

by HadesScience

GuidedMod lets a modpack creator guide players through mode selection at startup, with optional mods that players switch on or off before the game loads.

NeoForgeClient-side onlyMIT LicenseOpen source1.21.1

What it does

On startup GuidedMod can show a menu where players pick a mode and toggle optional mods with sliders. Creators set which mods are optional and what each choice enables, and once a choice is saved the menu can be hidden so later launches skip straight to the game.

Missing mods are handled without crashing the menu: a disabled mod that is not installed appears in gray with the word Missing. Hovering over a mod entry shows the exact JAR filename, which helps players and support staff match entries to files. The mod is client-side only, so servers need nothing installed and players alone run it. Builds exist only for NeoForge 1.21.1, with 2.0.0 as the latest file released on 2026-07-09, and the code is released under the MIT License as open source.

Key features

  1. Mode selection screen

    Players choose a mode from a card selector, with hover highlights, outer glows and click sounds.

  2. Optional mods toggles

    Standard buttons are replaced with slider switches that show linked ON and OFF states for each optional mod.

  3. Missing mod detection

    Disabled mods that are not present are drawn in gray and labeled Missing instead of stopping the menu.

  4. One-time startup lock

    Once a choice is configured, the menu entry can be hidden so later startups bypass the selection screens.

  5. Defensive mod matching

    Version brackets and prefixes are stripped before matching, and keywords shorter than three characters are rejected to avoid mass-renaming bugs.

Compatibility

Latest build for each game version and loader.

1.21.12.0.0
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Use cases

Modpack choice screens

A pack with alternate game modes can let players pick one at first launch and then switch mods on or off without editing files.

Optional content in a pack

Creators can offer extra content as individual sliders, so players opt in to each optional mod separately.

Who it’s for: Modpack creators who want a startup menu for mode selection and optional mods. Players of packs that use the menu will see the sliders and selection cards at launch. The mod does not change gameplay or world content.

Questions

Which loader and game version does GuidedMod support?

GuidedMod is published only for NeoForge, with files for 1.21.1. The latest file is 2.0.0, released on 2026-07-09.

Does GuidedMod need to be installed on the server?

No. Players add it to their own game, and a server needs no copy.

Can the selection screen be skipped after a choice is saved?

Yes. Once configured, the one-time interception lock can hide the menu entry so later startups bypass the selection screens.

In the catalog

GuidedMod is one of 3,545 Optimization mods on ModsFinder, and one of 1,250 Optimization mods for NeoForge. 32,366 mods support Minecraft 1.21.1.

Similar mods

What the author says

GuidedMod intercepts players on the first game startup, prompting them to choose between "Vanilla Mode" and "Overhaul Mode". The mod physically controls mod loading states by renaming.jar files (appending or removing the.disabled suffix). [optional] # Optional mods controlled individually by sliders # Example: #…
HadesScience, on the Modrinth page

Official listing

Owner
HadesScience
Published
2026-06-30
Updated on Modrinth
2026-07-09
Facts verified
2026-10-15

Tags