MAutoModGenerator - 轻松修补其他模组文件（界面、语言等更多内容！）

MAutoModGenerator - Hytale 自动模组生成器

一个为 Hytale 服务器设计的自动模组生成插件，可从配置的源目录自动构建模组 JAR 文件。

概述

MAutoModGenerator 是一款插件，通过从配置的源目录收集文件，并创建包含 manifest.json 的完整模组包，自动生成 Hytale 模组 JAR 文件。这在将自定义内容、资源或配置打包成可分发的模组文件时非常有用。

主要用途：资源模组修补

MAutoModGenerator 的主要用途是简化资源模组的创建，特别是用于修补其他模组。

由于 Hytale 按特定顺序加载模组，MAutoModGenerator 生成的模组始终最后加载。这使得它非常适合创建覆盖或扩展其他模组文件的修补模组：

• 语言文件：替换或添加现有模组的翻译
  • 修复其他模组中的翻译错误
  • 为尚未翻译的模组添加新语言翻译
  • 自定义文本和消息以匹配您服务器的风格
• 图片与纹理：覆盖纹理、图标和 UI 元素
  • 使用自定义版本替换纹理
  • 更新 UI 元素以匹配服务器主题
  • 修复视觉错误或不一致性
• 界面文件：修改 UI 组件和布局
  • 自定义界面元素
  • 调整布局和样式
  • 添加或修改 UI 组件

工作原理：只需将要覆盖的文件放置在 files 目录中，并使用与原始模组相同的路径结构。当生成的模组被加载时，它将替换原始模组中的文件。

示例：若要修补位于 Server/Languages/pt-BR/somemod.lang 的另一模组的语言文件，只需将您的自定义文件放置在 MAutoModGenerator 的 files/Server/Languages/pt-BR/somemod.lang 目录中。

功能

• 自动构建模组：在插件初始化时自动构建模组 JAR 文件
• 可配置源目录：支持多个源目录用于收集文件
• 自动生成清单：基于配置自动生成 manifest.json
• 基于命令的重建：使用 /mautomodgenerator rebuild 命令按需重建模组
• 默认源目录：自动包含来自 config/com.machina/mautomodgenerator/files 目录的文件

安装

1. 将 MAutoModGenerator 插件 JAR 文件放置在 Hytale 服务器的 mods 或 builtin 目录中
2. 确保 lib/ 目录中存在 HytaleServer.jar 文件
3. 重启服务器或重新加载插件
4. 插件将在首次加载时自动构建模组

配置

所有设置均通过插件数据目录中的 config.json5 文件管理。

清单配置

{
    "manifest": {
        "group": "com.machina",
        "name": "mautomodgenerator-pack",
        "version": "1.0.0",
        "author": "Machina",
        "description": "自动生成模组的模组"
    }
}

配置选项：

• manifest.group：模组组标识符（必须与文件兼容：^[a-zA-Z0-9_.-]+$）
• manifest.name：模组名称（必须与文件兼容：^[a-zA-Z0-9_.-]+$）
• manifest.version：模组版本（例如 "1.0.0"）
• manifest.author：作者名称
• manifest.description：模组描述

源目录配置

{
    "src": {
        "directories": [
            "/path/to/custom/files",
            "/another/path/to/files"
        ]
    }
}

配置选项：

• src.directories：要收集文件的目录列表（可选）
  • 插件默认自动包含 config/com.machina/mautomodgenerator/files
  • 可在此列表中指定其他目录
  • 这些目录中的所有文件都将包含在生成的模组 JAR 中

使用

自动构建

在以下情况下，模组会自动构建：

• 插件首次加载时
• 服务器启动且插件启用时

生成的模组 JAR 文件将以 {group}-{name}.zip 格式创建在服务器根目录中。

示例：com.machina-mautomodgenerator-pack.zip

手动重建

您可以随时使用以下命令手动重建模组：

/mautomodgenerator rebuild

或使用别名：

/mamg rebuild

权限：需要 mautomodgenerator.command.rebuild.permission

工作原理

1. 文件收集：插件扫描所有配置的源目录（包括默认的 config/com.machina/mautomodgenerator/files）
2. 清单生成：根据您的配置创建 manifest.json 文件
3. JAR 创建：将所有收集的文件与清单一起打包成 JAR 文件
4. 输出：生成的模组 JAR 保存在服务器根目录中

文件结构

生成的模组 JAR 将具有以下结构：

mod.zip
├── manifest.json
├── (来自源目录的文件)
└── ...

示例用例

• 🩹 模组修补（主要用途）：创建修补模组以覆盖其他模组的文件
  • 语言补丁：修复翻译、添加新语言或自定义文本
  • 纹理补丁：替换图像、图标和视觉资源
  • UI 补丁：修改界面元素和布局
• 资源包：将自定义纹理、模型或声音打包成可分发的模组
• 配置模组：捆绑服务器配置或自定义游戏规则
• 内容包：创建包含自定义内容的模组，便于分发
• 开发工作流：在开发过程中自动打包模组

注意事项

• 生成的模组 JAR 文件创建在服务器根目录中
• JAR 中的文件路径相对于源目录
• 插件会验证组和名称是否与文件兼容（仅限字母数字、点、下划线、连字符）
• 源目录中的所有文件（包括子目录）都会被递归包含

社区

💬 加入我们的 Discord 社区！

获取帮助、分享想法并与其他开发者交流：

• 🆘 支持：获取设置和故障排除的帮助
• 💡 建议：分享您的想法和反馈
• 🤝 社区：与其他 Hytale 开发者联系

👉 加入 Discord 服务器

---

由 Machina Studios 开发 - 专业 Hytale 服务器解决方案