Mod Deck

ModDeck is a client-side mod and library that brings the settings of supported mods into one place. Browse settings by mod, switch between categories, and search for specific options through a consistent interface. Changes are applied only when you press Save, and ModDeck asks for confirmation before discarding unsaved changes.

For Players

• Access supported mods from one settings hub
• Search for mods and individual settings
• Navigate categories with tabs
• Save changes manually
• Confirm before discarding unsaved changes
• Reset individual options or an entire mod
• Apply presets provided by supported mods
• Choose between automatic, light, and dark themes
• View mod icons in the list and settings screen

Supported Options

• On/off switches
• Integer and decimal sliders
• Text fields
• Selectors and enum options
• Colors
• Key bindings
• Editable and reorderable lists
• Subcategories
• Description rows
• Action buttons
• Input validation and error messages

For Mod Developers

• Define configuration screens through a declarative Java API
• Register options, categories, display conditions, enabled conditions, validation, presets, and themes
• Generate configuration screens with annotation-based AutoConfig
• Use the built-in JSON storage or provide custom storage
• Open a specific mod’s settings from Mod Menu, a key binding, a command, or another screen

ModDeck

ModDeck is a client-side mod and library that centrally manages settings for supported installed mods.
With a unified, modern UI, you can intuitively check, toggle, and search through settings for each mod.

Key Features

1. Comfortable Search and Management

You can perform incremental searches across not only mod names but also detailed setting item names. With tabbed category displays, you can access your desired settings without getting lost, even for mods with a large number of items.

2. Reliable Save and Reset Functions

Setting changes are not applied until you click Save. A confirmation dialog also appears if you try to close the screen without saving, preventing unintended setting changes. It also features a reset function to restore default values either per item or per mod.

3. Theme Switching and Excellent Visibility

In addition to automatic switching based on system settings, you can manually select light or dark themes. Icons for each mod are displayed on lists and setting screens, offering exceptional visibility.

Main Features for Players

• Integrates settings screens for supported mods into one
• Incremental search for mod names and setting items
• Easy category navigation via tabs
• Prevention of misoperation through manual saving (with a warning dialog for unsaved changes)
• Setting resets per item or per mod
• One-click application of presets provided by mods
• Theme switching (Auto / Light / Dark)
• Supports opening the screen from Mod Menu, keybinds, and commands

Included Setting Components

ModDeck comes standard with a wide variety of UI parts necessary for mod settings.

• On/off switches
• Sliders (supporting integers and decimals)
• Text input fields
• Dropdown and Enum selection lists
• Color pickers
• Keybind settings
• Sortable and editable list formats
• Expansion and collapse of subcategories
• Real-time input validation and error display

Features for Developers

You can easily incorporate a sophisticated settings screen into your own mod.

• Intuitive API: Declaratively write settings screens and hierarchical structures simply using the Java API
• AutoConfig Support: Automatically generate settings screens just by adding annotations
• Flexible Control: Supports conditional display and enabling of items, validation, and the definition of custom themes and presets
• Storage Flexibility: In addition to standard built-in JSON storage, it supports saving to custom storage
• Seamless Integration: Easily implement processes to open your mod's settings screen directly from external screens or custom keybinds