
铸造引擎
一个将Minecraft转变为开发就绪游戏引擎的NeoForge Minecraft模组。
查看大图FoundryEngine
一个以 NeoForge Minecraft 模组形式构建的游戏内开发平台和脚本引擎。
概述
FoundryEngine 是一个 NeoForge 模组,让创作者能够使用 Groovy 脚本和游戏内编辑器构建自定义游戏系统、物品、过场动画和对话。借助模块化包和实时重载,你可以直接在 Minecraft 内开发和测试内容,而无需重启游戏。
什么是 FoundryEngine?
FoundryEngine 为 Minecraft 提供了一个游戏内开发环境。它让地图制作者、服务器管理员和整合包作者能够构建独立游戏、自定义机制和互动故事系统,而无需编译单独的模组 JAR。
内容使用 Groovy 脚本编写,并组织成自包含的包。借助集成的 Dear ImGui 编辑器套件和运行时重载(/engine reload),脚本修改和资源更新会在游戏运行期间立即生效。
注意:注册表变更(例如注册新物品、方块或声音)需要重启游戏,目前无法热重载。
核心功能
包与脚本
- 自包含包:将脚本、模型、纹理和声音分组到
.minecraft/FoundryEngine/bundles/内的隔离文件夹中 - 实时重载:使用
/engine reload实时测试脚本逻辑和资源变更。(注册表变更需要重启游戏,目前无法热重载。) - 清晰结构:在专用的
common、server和client入口点中组织你的代码。
游戏内 ImGui 编辑器
- 脚本和 JSON 编辑器:直接在 Minecraft 内编辑 Groovy 脚本,支持语法高亮和诊断检查。
- 对话编辑器:构建带有玩家选项、自定义需求和脚本触发器的分支对话。
- 可视化过场动画时间轴:沿样条曲线放置摄像机,支持关键帧、焦点和缓动过渡。
- 空间区域工具:在世界中放置 3D 包围盒,以可视化方式配置触发区域。
- 开发实用工具:检查纹理、浏览文件、测试配方、监控控制台日志,并提交更改到 Git。
玩法子系统
- 构建器 API:直接从脚本注册物品、方块、方块实体、配方、声音、粒子和标签。
- 事件总线:挂钩到游戏 tick、方块点击、玩家交互、战斗和自定义引擎生命周期事件。
- 阶段进度:将物品、方块、生物、配方和维度锁定在可解锁的进度阶段之后。
- 实例化维度:生成临时维度副本,用于自定义游戏会话、地牢或小游戏,而不会影响基础世界存档。
- 屏幕着色器:应用后处理效果,包括暗角、深度模糊、颜色渐变和自定义天空盒。
入门指南
面向玩家和服务器主机
- 在 Minecraft 26.1.2 或 26.2 上安装 NeoForge
- 将
FoundryEngine及其必需依赖项放入你的mods/目录。 - 将下载的内容包放入
/FoundryEngine/bundles/文件夹。 - 启动游戏或服务器。
面向创作者和整合包作者
- 查看 FoundryEngine Wiki,获取指南、构建器教程和 API 文档。
- 使用配置的快捷键或菜单打开游戏内编辑器。
- 在
/FoundryEngine/bundles/目录中创建一个新包,或从 ExampleBundle 模板开始。 - 在 Groovy 脚本中编写你的注册和玩法逻辑。
- 运行
/engine reload实时测试脚本和资源变更。(注册表变更需要重启游戏。)
要求与兼容性
- 模组加载器:NeoForge
- Java 版本:Java 25
- 支持的版本:Minecraft 26.1.2 和 Minecraft 26.2
- 环境:客户端、专用服务器和单人游戏
链接
- 文档 Wiki:luckymcdev.github.io/FoundryEngine
- 源代码:GitHub 仓库
- 入门模板:示例包仓库
- 问题反馈:GitHub Issues
致谢
- LuckyMcDev:创作者和首席开发者
- Auseawesome:功能设计和徽标美术
- G_cat:Alpha 测试
- 使用 NeoForge、Apache Groovy、ImGuiMc 和 Stonecutter 构建。
正在加载版本记录…



正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。