Tidy Mods

📌 about

Tidy Mods is a replacement for the default mod list screen. Built for players and modpack developers alike, it offers a streamlined way to browse, organize, and manage installed mods.

🛠️ features

• category organization: Mods are grouped into categories like Technology, Magic, Utility, and more. Categories can be customized, and mods can be reassigned through config.
• category icons: Assign texture-based icons to categories for quick visual identification, or display each mod's own icon.
• smart search: Find mods instantly by name, @ID, #category, !author or $license with inline autocomplete suggestions.
• filtering: Show only configurable mods or hide specific mods from the list entirely.
• quick actions: Open mod configs, websites, and issue trackers directly from each entry.
• configurable display: Control what appears in list entries and tooltips, including version, authors, description, and license.
• translatable: Override mod descriptions and category names via resource packs.
• live updates: All settings apply instantly without restarting the game.
• developer API: Mod developers can declare their category directly in the mod file.
• wide compatibility: Over 1000 mods are pre-categorized out of the box! Compatible with ATM10, FTB StoneBlock 4, BMC5, Craftoria and more...

🤝 contributions

Help expand compatibility by categorizing mods that aren't covered yet:

• submit a pull request — Add missing mods to BuiltInCategories.java.
• notify mod authors — Let them know they can easily assign a category to their mod for native support.

Every contribution helps keep the mod list organized for everyone.

🔗 developer API

Add modCategory to your neoforge.mods.toml block:

[[mods]]
modId = "tidybinds"
displayName = "Tidy Binds"
modCategory = "utility"

This allows your mod to appear in the correct category without requiring users to configure anything. Replace utility with one of the available categories:

Category	Name	Description
agriculture	Agriculture & Cuisine	Mods with a focus on growing, breeding, cooking, and consuming.
building	Building & Decoration	Mods that add blocks with no function other than aesthetics (furniture, roofs, windows).
equipment	Equipment & Combat	Mods focused on what the player wears or wields. This includes weapons, armor, and tools.
functional	Functional & Mechanics	Mods that add things with specific uses, mechanics or a variety of content across multiple categories without a single defining theme (vanilla+ mods).
library	Libraries, APIs & Integrations	Mods for other mods.
magic	Magic & Arcane	Mods involve mana, spells, rituals, altars, or nature-based progression systems that do not rely on standard electricity.
misc	Miscellaneous	Mods that do not fit into any of the listed categories.
mobs	Mobs & Entities	Mods that add or improve living things as their main feature.
storage	Storage & Logistics	Mods that increase inventory space or provide static places to put items.
system	System, Performance & Fixes	Mods that optimize the game code or fix bugs.
technology	Technology & Automation	Mods involve processing resources, generating power (RF/FE), moving fluids/items via pipes, automating tasks, or just redstone.
utility	Utilities, UI & QoL	Mods that change how you play the game, usually via the interface, controls, or information, without adding physical blocks/items.
worldgen	World Generation & Dimensions	Mods that change the terrain, add new biomes and structures to explore, or add entirely new dimensions.

📝 credits

Icon from Fluent UI System Icons by Microsoft (MIT).
Inspired by Catalogue by MrCrayfish (MIT).

Found a bug? Open an issue on GitHub.