Skip to content

Repository files navigation

Logo

Hollow Engine

Commits Stars Contributors Downloads Discord CodeFactor


Introduction

HollowEngine is a content creation engine for Minecraft. It combines Kotlin scripting, a visual programming, and tools for building NPCs, events, gameplay systems, and interactive experiences.

What It Provides

  • In-game IDE with syntax highlighting and code analysis
  • Kotlin Scripting with full access to the game's classes without having to re-enter the game
  • A custom language for writing dialogues in the style of Ink / Yarn Spinner
  • Advanced model system (.gltf, .obj, .fbx, .geo.json)
  • Advanced UI framework that includes a Compose-like DSL, a CSS-like styling system, 3D transformations, masks, and effects
  • NPC tooling with models, textures, animations, and interactions
  • Scene and camera tooling for cinematic workflows
  • Embedded asset, resource pack, and datapack loading

Current Platform Support

  • Minecraft 1.21.1
  • Fabric
  • NeoForge
  • Kotlin 2.4.0

Project Layout

  • runtime/: main engine, UI, gameplay integration, tests
  • bridge/: shared compatibility layer (bootstrap <---> bridge <---> runtime)
  • bootstrap/: shared bootstrap code and resources
  • bootstrap-fabric/: Fabric bootstrap implementation
  • bootstrap-neoforge/: NeoForge bootstrap implementation
  • addons/compiler/: scripting compiler addon

Quick Start

  1. Install the HollowEngine jar into your mods/ folder. One jar covers both Fabric and NeoForge.
  2. If you use the compiler, install HollowEngineCompiler-*.jar as well. Addons work from mods/ like any other mod, or from hollowengine/addons/ if you prefer to keep them apart.
  3. Start Minecraft.
  4. Open the in-game editor and begin creating content.

Build From Source

Use the Gradle wrapper from the repository root:

  • .\gradlew.bat buildAndCollect - build enabled bootstrap platforms and collect outputs into merged/
  • .\gradlew.bat test - run JVM tests
  • .\gradlew.bat buildAddons - build and collect every addon, including the compiler

Links

License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

Other

About

Engine for development story-based maps & modpacks

Topics

Resources

Stars

108 stars

Watchers

3 watching

Forks

Releases

Packages

Used by

Contributors

Languages