FoundryEngine
一个作为 NeoForge Minecraft 模组构建的内置开发平台与脚本引擎。
简介
FoundryEngine 是一个 NeoForge 模组,允许创作者使用 Groovy 脚本和内置编辑器构建自定义游戏玩法系统、物品、过场动画和对话。通过模块化包(bundles)和热重载功能,你可以在不重启游戏的情况下直接在 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:直接从脚本注册物品、方块、方块实体、配方、音效、粒子效果和标签。
- 事件总线:挂钩游戏刻、方块点击、玩家交互、战斗以及自定义引擎生命周期事件。
- 阶段进度:将物品、方块、生物、配方和维度锁定在可解锁的进度阶段之后。
- 实例化维度:为自定义游戏会话、地牢或小游戏生成临时维度副本,而不影响基础世界存档。
- 屏幕着色器:应用后处理效果,包括暗角、景深模糊、颜色淡入淡出和自定义天空盒。
快速开始
对于玩家和服务器主机
- 在 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 Repository
- 入门模板:Example Bundle Repository
- 问题反馈:GitHub Issues
致谢
- LuckyMcDev:创作者兼首席开发者
- Auseawesome:功能设计与标志艺术
- G_cat:Alpha 测试
- 基于 NeoForge、Apache Groovy、ImGuiMc 和 Stonecutter 构建。
FoundryEngine
An in-game development platform and scripting engine built as a NeoForge Minecraft mod.
Summary
FoundryEngine is a NeoForge mod that lets creators build custom gameplay systems, items, cutscenes, and dialogues using Groovy scripts and an in-game editor. With modular bundles and live reloading, you can develop and test content directly inside Minecraft without restarting the game.
What is FoundryEngine?
FoundryEngine provides an in-game development environment for Minecraft. It lets mapmakers, server owners, and modpack creators build standalone games, custom mechanics, and interactive story systems without compiling separate mod JARs.
Content is authored in Groovy scripts and organized into self-contained bundles. With the integrated Dear ImGui editor suite and runtime reloading (/engine reload), script edits and asset updates apply immediately while the game is running.
Note: Registry changes (such as registering new items, blocks, or sounds) require a game restart and cannot be hot reloaded at this time.
Key Features
Bundles and Scripting
- Self-contained packages: Group scripts, models, textures, and sounds into isolated folders inside
.minecraft/FoundryEngine/bundles/ - Live reloading: Test script logic and asset changes live with
/engine reload. (Registry changes require a game restart and cannot be hot reloaded yet.) - Clear structure: Organize your code across dedicated
common,server, andcliententrypoints.
In-Game ImGui Editor
- Script and JSON editor: Edit Groovy scripts directly inside Minecraft with syntax highlighting and diagnostic checks.
- Dialogue editor: Build branching conversations with player options, custom requirements, and script triggers.
- Visual cutscene timeline: Position cameras along splines with keyframes, focal points, and easing transitions.
- Spatial area tools: Place 3D bounding boxes in the world to configure trigger zones visually.
- Development utilities: Inspect textures, browse files, test recipes, monitor console logs, and commit changes to Git.
Gameplay Subsystems
- Builder APIs: Register items, blocks, block entities, recipes, sounds, particles, and tags directly from scripts.
- Event bus: Hook into game ticks, block clicks, player interactions, combat, and custom engine lifecycle events.
- Stage progression: Lock items, blocks, mobs, recipes, and dimensions behind unlockable progression stages.
- Instanced dimensions: Spawn temporary dimension copies for custom game sessions, dungeons, or minigames without touching base world saves.
- Screen shaders: Apply post-processing effects including vignette, depth blur, color fades, and custom skyboxes.
Getting Started
For Players and Server Hosts
- Install NeoForge on Minecraft 26.1.2 or 26.2
- Place
FoundryEngineand its required dependencies into yourmods/directory. - Put downloaded content packages into the
/FoundryEngine/bundles/folder. - Start the game or server.
For Creators and Pack Authors
- Check the FoundryEngine Wiki for guides, builder tutorials, and API documentation.
- Open the in-game editor using the configured shortcut or menu.
- Create a new bundle in your
/FoundryEngine/bundles/directory or start from the ExampleBundle template. - Write your registration and gameplay logic in Groovy scripts.
- Run
/engine reloadto test script and asset changes in real time. (Registry changes require a game restart.)
Requirements and Compatibility
- Mod loader: NeoForge
- Java version: Java 25
- Supported versions: Minecraft 26.1.2 and Minecraft 26.2
- Environment: Client, Dedicated Server, and Singleplayer
Links
- Documentation Wiki: luckymcdev.github.io/FoundryEngine
- Source code: GitHub Repository
- Starter template: Example Bundle Repository
- Issues: GitHub Issues
Credits
- LuckyMcDev: Creator and lead developer
- Auseawesome: Feature design and logo artwork
- G_cat: Alpha testing
- Built using NeoForge, Apache Groovy, ImGuiMc, and Stonecutter.
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
下载 Foundry Engine
0.2.2
- 修复脚本引擎错误:该错误导致运行时在不应重新加载时进行了重新加载。
- 移除编写不佳且非必需的代码。
0.2.1
修复
- 修复了日志中的 ASCII Logo。
0.2.0
破坏性变更
- 包结构现以功能优先(
feature.dist)而非分发优先(dist.feature) - 复数形式的包名已改为单数形式
- FoundryEngine 已拆分为按功能划分的独立模组;请相应更新依赖项
- 迁移指南:在导入文件、Mixin 配置文件和脚本中查找并替换旧的包路径
新增内容
- 为部分功能添加了额外的模组。
修复问题
- 修复了创意模式物品栏中因重复物品导致的崩溃问题
- 提高了部分数据包的限制值
其他更改
- 将 NeoForge 更新至最新版本
0.1.11
- 添加 FileIO 和 JsonIO
- 在主菜单中添加“重载脚本”按钮
- 添加用于禁用类加载器限制的配置文件选项
- 对脚本引擎进行大规模重写
- 重构 Gradle 工作流以使用 IntelliJ 插件
- 为支持 26.3 做准备
0.1.10
- 添加了菜单系统
- Storage Source 在路径为空时不再发出警告
- Bundle 脚本现在可以在服务端正确编译
- DialogueTree 中的 addNode 方法返回节点本身
- 修复了文档中的属性引用问题
- 更新包以适配文档中我的首个 Bundle 指南
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧