Skip to content

Modern lightweight Minecraft model implementation for Bukkit, Folia

License

Notifications You must be signed in to change notification settings

toxicity188/BetterModel

Repository files navigation

0

Welcome to BetterModel!

SpigotMC | GitHub | Modrinth | Hangar

Maven Central Version GitHub Release Discord GitHub Issues or Pull Requests bStats Servers

Modern lightweight Minecraft model implementation for Bukkit, Folia

This plugin implements server-side model by using packet-based item display.

  • Importing .bbmodel
  • Resource pack auto-generation
  • Multiple hit-box

Why I created BetterModel even though ModelEngine already exists?

The main reason I created it is:

  • To reduce traffic - MEG uses too many packet, making significant network issue.
  • To provide faster update - MEG's update is too slow.
  • To provide more flexible API - MEG is a closed-source plugin and API is very limited.

Summary

1
This plugin, of course, implements generic block bench model with animation.
2
This plugin can track entity's movement and head rotation.

Network optimization

3
This plugin can optimize network by sight-trace. It won't send packets when the player's not looking.

Multiple hit-box

4
5
This plugin provides multiple hit-box both client and server. (tracking animation rotation)

MythicMobs support (experimental)

6
7
Like MEG, This plugin implements simple MythicMobs support.

model
state
defaultstate
partvisibility

Version

  • Spigot, Paper or a fork (e.g. Folia)
  • Java 21
  • Minecraft 1.19.4-1.21.4

Dependency

No

Command

/bettermodel reload - Reloads this plugin.
/bettermodel spawn - Summons this model to husk.
/bettermodel limb <true/false> - Shows/Hides player limb.
/bettermodel play - Plays player animation.

Permission

bettermodel - Accesses to command.

Build

./gradlew build

API

We are using maven central.

repositories {
    mavenCentral()
}

dependencies {
    compileOnly("io.github.toxicity188:BetterModel:VERSION")
}