铸造引擎

铸造引擎

一个将Minecraft转变为开发就绪游戏引擎的NeoForge Minecraft模组。

游戏机制

FoundryEngine

一个以 NeoForge Minecraft 模组形式构建的游戏内开发平台和脚本引擎。

CurseForge Modrinth GitHub Wiki Java 25 NeoForge


概述

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、方块点击、玩家交互、战斗和自定义引擎生命周期事件。
  • 阶段进度:将物品、方块、生物、配方和维度锁定在可解锁的进度阶段之后。
  • 实例化维度:生成临时维度副本,用于自定义游戏会话、地牢或小游戏,而不会影响基础世界存档。
  • 屏幕着色器:应用后处理效果,包括暗角、深度模糊、颜色渐变和自定义天空盒。

入门指南

面向玩家和服务器主机

  1. 在 Minecraft 26.1.2 或 26.2 上安装 NeoForge
  2. 将 FoundryEngine 及其必需依赖项放入你的 mods/ 目录。
  3. 将下载的内容包放入 /FoundryEngine/bundles/ 文件夹。
  4. 启动游戏或服务器。

面向创作者和整合包作者

  1. 查看 FoundryEngine Wiki,获取指南、构建器教程和 API 文档。
  2. 使用配置的快捷键或菜单打开游戏内编辑器。
  3. 在 /FoundryEngine/bundles/ 目录中创建一个新包,或从 ExampleBundle 模板开始。
  4. 在 Groovy 脚本中编写你的注册和玩法逻辑。
  5. 运行 /engine reload 实时测试脚本和资源变更。(注册表变更需要重启游戏。)

要求与兼容性

  • 模组加载器:NeoForge
  • Java 版本:Java 25
  • 支持的版本:Minecraft 26.1.2 和 Minecraft 26.2
  • 环境:客户端、专用服务器和单人游戏

链接


致谢