Modrinth · NeoForge · Client mod

GuidedMod

GuidedMod is a client-side mod. Install it on your computer; the server does not need it.

A mod for modpack creators to guide players through mode selection and physically toggle mods on/off.

Downloads
5.0K
Author
HadesScience
Loader
NeoForge
Minecraft
1.21.1
Updated
–

Screenshots

What GuidedMod looks like

Images: GuidedMod on Modrinth, published by the project team.

Setup

Install GuidedMod on your client

Client-side mods only run on your computer. More server RAM does not change their performance.

  1. 01

    Install the loader locally

    Install NeoForge for your Minecraft version in your launcher.

  2. 02

    Download the file

    Download the GuidedMod file for your loader and your exact Minecraft version, for example 1.21.1.

  3. 03

    Add it to the mods folder

    Put the .jar file in your local .minecraft/mods folder and remove older duplicates.

  4. 04

    Launch

    Launch Minecraft with the loader profile. Nothing needs to change on the server.

On the server
Not needed
On the client
Required
Loader
NeoForge
Minecraft
1.21.1
License
MIT License

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

GuidedMod · Modrinth
Original description by the project author

GuidedMod

A customizable Minecraft client-side guide mod

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).

Features

  • 3D Rotating Panorama: Beautiful Trial Chamber panorama background with clean rendering.
  • Dual Cards Selector: Offers card selectors with hover highlights, outer glows, and custom click sounds.
  • Optional Mods Screen: Upgrades standard buttons to sleek iOS/Material-style slider switches linked to ON/OFF states.
  • Missing Mod Detection: Automatically renders disabled missing mods as gray and displays Missing.
  • Hover Tooltips: Shows the exact JAR filename being controlled when hovering over the mod item.
  • Anti-Accidental-Click: Cancel button on the left (selected by default) and red warning text on the right.
  • One-Time Interception Lock: Hide menu entry and bypass subsequent startup screens once configured.
  • Defensive Matching: Strips common version brackets and version prefixes before doing a prefix starts-with check. Rejects keywords < 3 characters to prevent mass-renaming bugs.

Configuration

Generates configuration files in config/:

1. config/guidedmod-mods.txt
# Mods controlled by primary modes (Vanilla/Overhaul)
# Example:
# appleskin

[optional]
# Optional mods controlled individually by sliders
# Example:
# justenoughitems

FAQ

GuidedMod questions

Question not listed? Ask our team.

Does GuidedMod need to be installed on the Minecraft server?

No. Modrinth marks GuidedMod as unsupported on the server side. Install it only in your local mods folder. Your server can stay unchanged unless the project page lists an additional dependency.

Which version and loader does GuidedMod require?

Use a file for NeoForge and your exact Minecraft version. Supported versions include 1.21.1. Files for different loaders are not interchangeable.

GuidedMod is not working – what should I check?

First check the Minecraft version, loader version and required dependencies. Because the mod is client-side, more server RAM will not fix it.

Looking for mods for your own server?

The catalog lists mods that run on Minecraft servers.

Browse all mods