GuidedMod

GuidedMod

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

by
1.6K Downloads
neoforgemanagementoptimization
Configure a Compatible Minecraft Server

Screenshots

Confirmation screen
Mode selection
Mods switch

About this Mod

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

Available Versions

GuidedMod 2.0.0release
MC 1.21.1neoforge
July 9, 2026
GuidedMod 1.0.0release
MC 1.21.1neoforge
June 30, 2026

How to Install GuidedMod on Your Client

1

Install the Mod Loader Locally

Install neoforge for your local Minecraft version.

2

Download the Matching File

Choose the GuidedMod file for neoforge and Minecraft 1.21.1.

3

Install Mod

Place the .jar file in your local .minecraft/mods folder and restart Minecraft. No server-side installation is required.

Compatibility

Mod Loaders

neoforge

Minecraft Versions

1.21.1

Server-side

βœ— Unsupported

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

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 Minecraft mods folder. Your server can remain unchanged unless the mod 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. Put the .jar file in your local .minecraft/mods folder and remove older duplicates. Because this mod is client-side, adding server RAM will not fix it.

Minecraft Server for Your Group

GuidedMod stays on your client. Host a compatible world for your group.

Recommended RAM
4 GBfrom €5.2/mo
Minimum 3 GB | per 8 players
Create Server Now
Client Compatibility Guide
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Unsupported

Supported Versions

1.21.1