Skip to content

AtlasEngineCa/WorldSeedEntityEngine

Repository files navigation

Contributors Forks Stargazers Issues APACHE-2.0 License


Logo

WSEE

WorldSeed Entity Engine


Report Bug · Request Feature

About The Project

This is a library that allows users to add bedrock models from blockbench in to Vanilla Minecraft!

WSEE lets you create multipart entities, using display entities. The framework provided allows users to easily create multipart entities, define animations, and write AI that fully utilises the entity's animations.

Currently WSEE only supports Minestom

Getting Started

A full, runnable example server can be found here

Adding as a dependency

Add the following to your build.gradle.kts file:

repositories {
    maven("https://reposilite.worldseed.online/public")
}

Add the library as a dependency

dependencies {
    implementation("net.worldseed.multipart:WorldSeedEntityEngine:<version>")
}

The lastest version number can be found here

VM Arguments

Add the following VM arguments to your run configuration

--add-opens java.base/java.lang=ALL-UNNAMED

This is required for the molang compiler library.

Restrictions

Some restrictions are imposed by Minecraft

  • Bones must be less than 64 blocks in size

Learn what this project is, how it works and how you can use it on your server

FAQ

Q: Why are my bones positioned incorrectly in minecraft?
A: Entities used for bones will be placed at the pivot point of the bone in blockbench. To fix this, move the pivot point closer to the bone

Q: Why is my model not working?
A: Make sure you have the type set to Bedrock Model in blockbench

Q: Why am I getting the exception InaccessibleObjectException
A: Make sure you have the VM arguments set up correctly, as described in the Getting Started section

Q: Why are ModelDamageEvent and ModelInteractEvent not triggering?
A: You need to create hitboxes for the model Hitboxes

Comparisons

Feature Minestom Support Paper Support Math Animations Cube Rotation Hurt Colour Accurate Hitboxes
WSEE ✔️ ✔️ ✔️ any ✔️ Texture Swapping ✔️
Model Engine ️❌ ✔️ ❌ 22.5 multiple ❌ Leather Armour
hephaestus-engine ✔️ ✔️ ❌ 22.5 multiple ❌ Leather Armour

(back to top)