Config Workshop
一款安全、可搜索的 Minecraft Forge 原生配置编辑器。
Config Workshop 将透过 Minecraft Forge 注册的配置规范转换为清晰的游戏内编辑界面。从单一仪表板浏览配置,深入搜索各项设置,查看各模组声明的规则,并保存有效更改,无需手动编辑 TOML 文件。
Alpha 版本须知: 此版本支持已加载的 CLIENT 和 COMMON ForgeConfigSpec 文件。SERVER(服务器端)配置可见但被有意锁定,直到提供安全且经操作员授权的服务器同步功能为止。
功能特性
- 统一的可搜索配置仪表板,适用于已安装的受支持的 Forge 模组
- Forge Mods 屏幕中的自动 Config 按钮集成
- 尊重自定义界面: 如果模组已提供自己的配置界面,Config Workshop 会将其控制权交还
- 深度搜索:可通过设置名称、完整路径、注释、类型和当前值进行搜索
- 丰富的元数据:包括默认值、声明的范围、注释和重启要求
- 严格验证:通过拥有模组声明的类型和规则进行验证
- 安全保存:每次写入前都会生成一个同级
.configworkshop.bak 备份文件
- 失败回滚:如果保存不成功,不会静默地保留内存中已更改的值
- 支持 布尔值、数字、字符串、枚举和标量列表
- 无运行时模组依赖
- 不进行任意配置目录扫描
为什么使用 Config Workshop?
Config Workshop 有意专注于标准的 Forge 配置系统。模组无需采用替代的配置库,编辑器也不会猜测未知文件。
它基于注册的 ForgeConfigSpec 元数据工作,因此类型、验证规则、默认值、注释和重启标志都保持可见且具有意义。
这种方法使体验更具可预测性:
- 无效输入会在保存前被拒绝。
- 现有的自定义配置界面得以保留。
- 不受支持的自定义
IConfigSpec 实现会被干净地忽略。
- 备份和保存失败会明确显示,而非被隐藏。
支持版本
| Minecraft |
Forge |
Java |
状态 |
| 26.2 |
65.1.0 |
25 |
Alpha |
| 1.21.11 |
61.1.0 |
21 |
Alpha |
请安装与你的 确切 Minecraft 版本匹配的 JAR 文件。请勿在 1.21.11 上使用 26.2 的文件,也不要在 26.2 上使用 1.21.11 的文件。
安装方法
- 安装匹配的 Minecraft Forge 版本。
- 下载与你 Minecraft 版本对应的 Config Workshop JAR 文件。
- 将 JAR 文件放入实例的
mods 文件夹中。
- 启动 Minecraft 并打开 Mods → Config Workshop → Config。
无需额外的模组库。
客户端与服务端使用
Config Workshop 目前是 客户端模组。专用服务器无需安装它。
远程服务器配置编辑功能未包含在此 Alpha 版本中,因此服务器拥有的配置文件显示为锁定状态。
当前 Alpha 版本限制
- 尚未实现远程
SERVER 配置编辑。
- 未使用
ForgeConfigSpec 的自定义配置规范无法编辑。
- 标量列表使用逗号分隔编辑器。
- 界面目前仅提供英文翻译。
- 广泛的现实世界兼容性和 GUI 测试仍在进行中。
请在报告错误时提供你的 Minecraft 版本、Forge 版本、受影响的模组、复现步骤以及相关的 latest.log 日志。
许可证与致谢
Config Workshop 是独立开发并以 MIT 许可证 发布的。其源代码和视觉标识均为原创。
本项目参考了 Forge Config Screens、Configured 的公开行为与文档,以及公开的 Minecraft Forge 配置 API。
不包含任何上游艺术作品、品牌标识、模组 ID 或捆绑的模组类。
Config Workshop 是一个非官方的社区项目。它与 Mojang、Microsoft、Minecraft Forge、Forge Config Screens、Configured、OneConfig、CurseForge 或 Modrinth 均无隶属关系或背书。
Config Workshop
A safe, searchable, Forge-native configuration editor for Minecraft.
Config Workshop turns configuration specifications registered through Minecraft Forge into clear in-game editing screens. Browse configs from one dashboard, search deeply across their settings, inspect the rules declared by each mod, and save valid changes without manually editing TOML files.
Alpha notice: This release supports loaded CLIENT and COMMON ForgeConfigSpec files. SERVER configs are visible but intentionally locked until secure, operator-authorized server synchronization is available.
Features
- One searchable config dashboard for supported installed Forge mods
- Automatic Config button integration in Forge's Mods screen
- Respect for custom screens: if a mod already provides its own config screen, Config Workshop leaves it in control
- Deep search by setting name, full path, comment, type, and current value
- Helpful metadata including defaults, declared ranges, comments, and restart requirements
- Strict validation through the type and rules declared by the owning mod
- Safe saving with a sibling
.configworkshop.bak backup before every write
- Failure rollback so an unsuccessful save does not silently leave the in-memory value changed
- Support for booleans, numbers, strings, enums, and scalar lists
- No runtime mod dependencies
- No arbitrary config-directory scanning
Why use Config Workshop?
Config Workshop is intentionally focused on the standard Forge configuration system. Mods do not need to adopt a replacement config library, and the editor does not guess at unknown files.
It works from registered ForgeConfigSpec metadata so types, validation rules, defaults, comments, and restart flags remain visible and meaningful.
This approach keeps the experience predictable:
- Invalid input is rejected before saving.
- Existing custom config screens are preserved.
- Unsupported custom
IConfigSpec implementations are ignored cleanly.
- Backups and save failures remain visible instead of being hidden.
Supported editions
| Minecraft |
Forge |
Java |
Status |
| 26.2 |
65.1.0 |
25 |
Alpha |
| 1.21.11 |
61.1.0 |
21 |
Alpha |
Install the JAR matching your exact Minecraft version. Do not use the 26.2 file on 1.21.11, or the 1.21.11 file on 26.2.
Installation
- Install the matching Minecraft Forge version.
- Download the Config Workshop JAR for your Minecraft version.
- Place the JAR in the instance's
mods folder.
- Start Minecraft and open Mods → Config Workshop → Config.
No additional mod library is required.
Client and server use
Config Workshop is currently a client-side mod. Dedicated servers do not need to install it.
Remote server configuration editing is not included in this alpha, so server-owned configuration files are displayed as locked.
Current alpha limitations
- Remote
SERVER config editing is not implemented.
- Custom configuration specifications that do not use
ForgeConfigSpec are not edited.
- Scalar lists use a comma-separated editor.
- The interface currently includes English translations only.
- Broad real-world compatibility and GUI testing is still in progress.
Please report bugs with your Minecraft version, Forge version, affected mod, steps to reproduce, and the relevant latest.log.
License and attribution
Config Workshop is independently implemented and released under the MIT License. Its source code and visual identity are original.
The project was informed by the public behavior and documentation of Forge Config Screens, Configured, and the public Minecraft Forge configuration APIs.
No upstream artwork, branding, mod IDs, or bundled mod classes are included.
Config Workshop is an unofficial community project. It is not affiliated with or endorsed by Mojang, Microsoft, Minecraft Forge, Forge Config Screens, Configured, OneConfig, CurseForge, or Modrinth.
评论 0
登录后参与评分
还没有评论,来抢沙发吧