ModernConfig
一款适用于 Minecraft 模组的美观、现代化配置库
? 概览
ModernConfig 是一款专为 Minecraft Fabric 模组打造的精致配置库,让设置管理变得轻松自如。不再需要繁琐的配置命令——ModernConfig 拥有动画效果、现代风格,并且极易在你的模组中集成。
✨ 特性
? 配置选项
- ? 开关: 布尔值切换 - 开或关
- ? 文本字段: 字符串输入
- ?️ 滑块: 数值输入,支持自定义范围和精度
- ? 列表: 动态字符串列表,支持添加/删除功能
- ? 颜色选择器: HSV 色彩选择,支持十六进制输入
- ? 下拉菜单: 选择菜单
- ? 分类: 带有嵌套配置的有组织部分
? 易于开发
- 简单 API: 易于使用的构建器(Builder)
- 配置更新监听器: 注册监听器以在配置更改时触发
? 其他特性
- 全局配置界面: 一处访问所有模组的配置
- 内置按键绑定: 按右 Shift 打开配置(可自定义)
- 性能优化: 不消耗帧率的动画
? 截图
主界面
带有动画和现代设计的主界面
配置选项
丰富的输入类型:开关、滑块、文本字段等
颜色选择器
带有实时预览的 HSV 颜色选择器
? 安装
对于玩家
-
下载并安装 Fabric
- 获取 Fabric Loader
- 安装 Fabric API
-
下载 ModernConfig
- 从 Modrinth 下载
-
安装模组
- 将
.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 流程
- Fork 仓库
- 进行修改
- 进行测试
- 提交 Pull Request
? 致谢
开发团队
- QWERTZ - 首席开发者 - @QWERTZexe
? 支持
- Discord: 加入我们的服务器
? Star 历史记录
你是这个资源的作者?登录后可认领此资源。
相似资源
Woot Revived
pharuxtan
一个用于收集生物掉落物的多区块模组。
生物科技
349
玉Jade ?
Snownee
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
实用前置
339
KubeJS
Lat
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
前置实用
239
物品管理器Just Enough Items (JEI)
mezz
查看物品与配方
前置实用
239
Xaero的小地图
thexaero
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
冒险交通
238
Applied Energistics 2
shartte
AE2:一款流行的自动化与存储模组
存储科技
217
评论 0
登录后参与评分
还没有评论,来抢沙发吧