ModernConfig

模组

· 作者 QWERTZexe

ModernConfig 是一个面向现代 Fabric 模组的配置库

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 1.5 · 26.3 · Fabric

一键开服(送7天)

ModernConfig

ModernConfig Logo

一款适用于 Minecraft 模组的美观、现代化配置库

? 概览

ModernConfig 是一款专为 Minecraft Fabric 模组打造的精致配置库,让设置管理变得轻松自如。不再需要繁琐的配置命令——ModernConfig 拥有动画效果、现代风格,并且极易在你的模组中集成。

✨ 特性

? 配置选项

  • ? 开关: 布尔值切换 - 开或关
  • ? 文本字段: 字符串输入
  • ?️ 滑块: 数值输入,支持自定义范围和精度
  • ? 列表: 动态字符串列表,支持添加/删除功能
  • ? 颜色选择器: HSV 色彩选择,支持十六进制输入
  • ? 下拉菜单: 选择菜单
  • ? 分类: 带有嵌套配置的有组织部分

? 易于开发

  • 简单 API: 易于使用的构建器(Builder)
  • 配置更新监听器: 注册监听器以在配置更改时触发

? 其他特性

  • 全局配置界面: 一处访问所有模组的配置
  • 内置按键绑定: 按右 Shift 打开配置(可自定义)
  • 性能优化: 不消耗帧率的动画

? 截图

主界面

Main Config Screen 带有动画和现代设计的主界面

配置选项

Config Options 丰富的输入类型:开关、滑块、文本字段等

颜色选择器

Color Picker 带有实时预览的 HSV 颜色选择器

? 安装

对于玩家

  1. 下载并安装 Fabric

  2. 下载 ModernConfig

  3. 安装模组

    • 将 .jar 文件放入你的 mods 文件夹
    • 使用 Fabric 配置文件启动 Minecraft

对于开发者

将 ModernConfig 添加到你的 build.gradle 中:

repositories {
    maven {
        name = 'QWERTZ-Repo'
        url = 'https://repo.qwertz.app/'
    }
}

dependencies {
    modImplementation 'app.qwertz:modernconfig:1.5'
}

? 使用方法

打开配置界面

  • 游戏中: 按下 Right Shift(你可以更改此按键绑定)

导航

  • 主屏幕: 显示所有使用 ModernConfig 的模组
  • 点击某个模组: 打开该模组的设置
  • 返回按钮: 返回上一个屏幕

? 开发者指南

快速开始

以下是设置配置的简便方法:

public class YourMod implements ClientModInitializer {
    
    @Override
    public void onInitializeClient() {
        ModernConfig config = ConfigBuilder.create("YourMod", "Your Mod Configuration")
            .toggle("enabled", "Enable Mod", true)
            .slider("power", "Power Level", 50, 0, 100, 1)
            .text("username", "Player Name", "Steve")
            .color("theme_color", "Theme Color", 0x4A90E2)
            .list("whitelist", "Player Whitelist", "Player Name")
            .dropdown("difficulty", "Difficulty", Arrays.asList("Easy", "Normal", "Hard"), "Normal")
            .build();
    }
}

使用分类

当你有很多设置时,将它们组织到分类中:

ModernConfig config = ConfigBuilder.create("AdvancedMod", "Advanced Mod Settings")
    .category("general", "General Settings", "Main configuration options", category -> category
        .toggle("enabled", "Enable Mod", true)
        .slider("update_interval", "Update Interval", 20, 1, 100, 1)
        .text("server_url", "Server URL", "https://api.example.com")
    )
    .category("ui", "User Interface", "Customize the user interface", category -> category
        .color("primary_color", "Primary Color", 0x4A90E2)
        .color("secondary_color", "Secondary Color", 0x2ECC71)
        .dropdown("theme", "Theme", Arrays.asList("Dark", "Light", "Auto"), "Dark")
        .slider("ui_scale", "UI Scale", 1.0f, 0.5f, 2.0f, 0.1f)
    )
    .category("advanced", "Advanced Settings", "Advanced configuration options", category -> category
        .toggle("debug_mode", "Debug Mode", false)
        .list("blocked_items", "Blocked Items", "Item ID")
        .list("whitelist", "Whitelisted Servers", "IP")
        .text("api_key", "API Key", "")
    )
    .build();

访问配置值

// 通过分类路径获取配置选项
ConfigOption<?> enabledOption = config.getOption("general", "enabled");
ConfigOption<?> updateOption = config.getOption("general", "update_interval");
ConfigOption<?> whitelistOption = config.getOption("advanced", "whitelist");

```java
// 获取实际的值
boolean isEnabled = (Boolean) enabledOption.getValue();
int updateInterval = (Integer) updateOption.getValue();
List<String> whitelist = (List<String>) whitelistOption.getValue();

? 配置选项

开关(布尔值)

.toggle("toggle_id", "显示名称", defaultValue)
  • 用途:开/关切换
  • 示例:功能标志、启用/禁用选项

文本字段(字符串)

.text("text_id", "显示名称", "默认值")
.text("text_id", "显示名称", "默认值", maxLength)
  • 用途:文本输入框
  • 示例:玩家名称、服务器地址、文件路径、API 密钥

滑块(数值)

.slider("slider_id", "显示名称", defaultValue, minValue, maxValue, step)
  • 用途:带有范围限制的数值输入
  • 示例:百分比、缩放比例、间隔、数量、延迟

颜色选择器(整数)

.color("color_option_id", "显示名称", 0xRRGGBB)
  • 用途:带颜色拾取器的颜色选择
  • 示例:主题颜色、高亮显示、UI 自定义

列表(字符串数组)

.list("list_id", "显示名称", "项目显示名称")
  • 用途:文本条目列表
  • 示例:玩家白名单、屏蔽物品、关键词

下拉菜单(字符串选择)

.dropdown("dropdown_id", "显示名称", Arrays.asList("选项1", "选项2"), "默认值")
  • 用途:从列表中选择一个选项
  • 示例:难度等级、主题、渲染模式、语言选择

分类(组织)

.category("category_id", "分类名称", "描述", category -> category
    // 在此处添加选项
)
  • 用途:组织相关选项
  • 示例:逻辑上分组相关设置

? 贡献指南

Pull Request 流程

  1. Fork 仓库
  2. 进行修改
  3. 进行测试
  4. 提交 Pull Request

? 致谢

开发团队

? 支持

  • Discord: 加入我们的服务器

? Star 历史记录

Star History Chart

用 ❤️ 和许多眼泪 ? 制作而成

⬆ 回到顶部

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源