BetterModel | Lightweight BB model engine for Bukkit | Custom hit-box | Folia supported -----
Generic BlockBench model parser & animation-ready entity engine — fully open-sourceBetterModel 1.11.2
Add
Add
- Improved reload performance
- Reload indicator bar
- Kotlin 2.2.10
- player's left/right item bone tag (pli, pri) -> entity's left/right item bone tag (li, ri)
- ModelRenderer#create(Location, Player) -> ModelRenderer#create(Location, OfflinePlayer)
- MythicMobs mechanics
- Keyframe generation
- Interpolation duration
- Hiding player's armor when disguised
BetterModel 1.11.1
Notice
Now API repository is moved.
Release
Snapshot
Add
Notice
Now API repository is moved.
Release
Code (Kotlin):
repositories
{
mavenCentral ( )
}
dependencies {
compileOnly ( "io.github.toxicity188:bettermodel:VERSION" )
}
mavenCentral ( )
}
dependencies {
compileOnly ( "io.github.toxicity188:bettermodel:VERSION" )
}
Code (Kotlin):
repositories
{
maven ( "https://maven.pkg.github.com/toxicity188/BetterModel" )
}
dependencies {
compileOnly ( "io.github.toxicity188:bettermodel:VERSION-SNAPSHOT" )
}
maven ( "https://maven.pkg.github.com/toxicity188/BetterModel" )
}
dependencies {
compileOnly ( "io.github.toxicity188:bettermodel:VERSION-SNAPSHOT" )
}
- support shadow bone to sync ModelEngine's usage
- math animation interpolation
- ModelRenderer#create(Entity, GameProfile, boolean)
- player nametag
BetterModel 1.11.0
Add
![[IMG]](//proxy.spigotmc.org/61c65a06bc9702081d549212973c9ea4693b119d/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f33396537323635322d643438342d343861362d383564302d343765313864333832323735)
Add
- API for per-player animation
- rewrite animation packet packer
- 'remapmodel' MythicMobs mechanic
- custom nametag
- molang support
- exception with some bone
BetterModel 1.11.0
Add
Add
- API for per-player animation
- rewrite animation packet packer
- 'remapmodel' MythicMobs mechanic
- custom nametag
- molang support
- exception with some bone
BetterModel 1.10.3
Add
Add
- initial molang support
- expose id and uuid of item-display
- equipment in the left hand
- animation signal
- packet bundler
BetterModel 1.10.2
Fix
Fix
- optimize animation interpolation and keyframe
- an attribute packet about hitbox
- Folia compatibility
- death animation
BetterModel 1.10.1
Notice
Now support about 1.20.4 is dropped.
Add
Notice
Now support about 1.20.4 is dropped.
Add
- passengers API in EntityTrackerRegistry
- entity body and head rotation
- MythicMobs mechanics
- hitbox rendering
- inventory handling
BetterModel 1.10.0
Add
Add
- new entity rotation API
- 'bodyrotation' MythicMobs mechanic
- handle equipment change of player
- entity invisibility
- traffic optimization
- animation accuracy
- parallel animation packet bundling
BetterModel 1.9.3
Add
Add
- 1.21.8 server support
- New API for updating tracker (Tracker#update)
- entity yaw/pitch sync
- data packet synchronization
- improved animation accuracy
BetterModel 1.9.2
Notice
It may be simple but huge update for optimization and animation quality.
Fix
Notice
It may be simple but huge update for optimization and animation quality.
Fix
- registry creation when spawning
- model spawn issue with teleport
- entity tracker registry optimization
- large traffic optimization
- implements more accurate animation
BetterModel 1.9.1
Notice
This is a hotfix about version 1.9.0.
Add
Notice
This is a hotfix about version 1.9.0.
Add
- API Tracker#billboard
- item model usage in 1.21.2-1.21.3
- unnecessary condition check
- entity data serialization
- hide option resetting
- equipment hiding
- entity spawning issue when quit and rejoin
BetterModel 1.9.0
Add
Fix
Add
- API BetterModelConfig
- API EntityHideOption
- new pack API and more detailed resource pack generation
Code (YAML):
pack:
generate-modern-model : true
generate-legacy-model : true
generate-modern-model : true
generate-legacy-model : true
- minor packet optimization
- entity despawn handling
- animation script
- equipment packet
BetterModel 1.8.1
Notice
This is a simple hotfix for optimization and compatibility.
Fix
Notice
This is a simple hotfix for optimization and compatibility.
Fix
- huge packet traffic optimization
- optimize packet handler with my external plugin (BetterHealthBar, BetterDamage)
- compatibility with Folia
- 'lockmodel' mechanic
BetterModel 1.8.0
Add
Add
- Minecraft 1.21.7 server support
- Write more Javadocs
- Thread lifecycle based on viewed player
- Entity id tracking
- More accurate spawn handling
- Refactor and optimize some API
- Head rotation delay
- 'smooth interpolation' with low keyframe animation
- Unnecessary tick thread task allocation
- Animation with only a single keyframe.
- MythicMobs mechanic
- Packet handling issue with 1.20.4
BetterModel 1.7.0
Notice
Notice
- This update has HUGE API change and refactor, You should check all of your system related to BetterModel.
- 1.21.6 server support
- HUGE API refactor, change and update.
- entity model data serialization
- bezier, step interpolation
- optimize bone item build
- tint for player animation
- offline-mode skin loading
- support multiple models per one entity
- minor optimization
- prevent sending an empty packet
- new player animation example (roll)
BetterModel 1.6.1
Fix
Fix
- Optimized vector calculation
- Head rotation tag (h, hi)
- Hitbox size and position
- Entity scale attribute
- Player animation model size
- Animation frame quality
- Simplify resource pack generation
- MythicMobs 5.9.0 compatibility (bindhitbox)
- Skin event API
BetterModel 1.6.0
Feat
![[IMG]](//proxy.spigotmc.org/d05e0e11e9d2ce3e55e99b8ad667f8208c4edd51/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f32346131653463612d613264612d343831652d626138362d313463346363313866633363)
Feat
- Tracker#hide and Tracker#show API
- TrackerModifier#hideOption
- Now player animation is compatible with Shaderspack (requires 1.21.4 or upper client and server)
- Fix hit-box collision and interaction with 1.21.5
- Tinted item cache
BetterModel 1.5.5
Notice
Notice
- Support about 1.20.2 is dropped.
- tracker view filter
- legacy version support of player animation
- improved animation key frame
- hit-box despawn
- call PlayerInteractAtEntityEvent of base entity
- optimize resource pack
- improved command
- improved resource pack speed, size, and logging
- legacy version test
- HMCCosmetics backpack support (bone tag: hmc_bp)
- Default model for test and learn (demon_knight.bbmodel)
BetterModel 1.5.4
Notice
this is a hotfix of 1.5.3.
Fix
Notice
this is a hotfix of 1.5.3.
Fix
- optimize packet listener and packet data update
- checking entity dead
- fix, clean and optimize animation logic
BetterModel 1.5.3
Fix
Full change log
Fix
- Bukkit hitbox event
- update checker
- optimize packet listener
- multi tag support
- new player limb tag and API
Code (Text):
head (ph)
right arm (pra)
right forearm (prfa)
left arm (pla)
left forearm (plfa)
hip (phip)
waist (pw)
chest (pc)
right leg (prl)
right foreleg (prfl)
left leg (pll)
left foreleg (plfl)
left item (pli)
right item (pri)
right arm (pra)
right forearm (prfa)
left arm (pla)
left forearm (plfa)
hip (phip)
waist (pw)
chest (pc)
right leg (prl)
right foreleg (prfl)
left leg (pll)
left foreleg (plfl)
left item (pli)
right item (pri)
BetterModel 1.5.2
Add
Add
- 'bindhitbox' mechanic
- 'mountmodel' mechanic
- 'dismountmodel' mechanic
- 'dismountallmodel' mechanic
- use interaction entity
- 'override' property in animation
- 'loop mode' property in animation
- 'smooth' interpolation
- make hitbox listener entity to bukkit entity.
- optimize animation update
BetterModel 1.5.1
Notice
Notice
- This version is a hotfix of BetterModel 1.5.
- config 'version-check'
- Spigot support
- loading issue with legacy server
- incorrect world handling
- The default pack builder is now 'zip'
BetterModel 1.5
Add
Add
- 'glow' and 'enchant' mechanic
- update checker
- more API
- entity scale sync
- entity shadow
- some compatibility issues with MythicMobs
- some platform support
BetterModel 1.4.3
Add
Add
- 1.21.5 client, server support
- Support Purpur AFK
- World position API
- More optimization
- More smooth animation
- Fake player like Citizens
- Hit box
- Animated texture
- World change
BetterModel 1.4.2
Fix
![[IMG]](//proxy.spigotmc.org/0a2ddcf80eec9dd2e542d44c13707bb4f819698f/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f39623764353936612d646231612d343163372d383639332d353633343266306330303435)
![[IMG]](//proxy.spigotmc.org/865eabb60e8f75d7ab2001cbee3d4615732d9e46/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f31323861333530382d623861302d343135342d623539652d653134383761383830346166)
Fix
- Fix interpolation
- Fix tick frame
- Fix entity scale attribute
- Fix hitbox logic to match Minecraft vanilla
- Implement more accurate movement and animation
- Hide player head in first person camera
- Add 'module' config
- Support 'smooth' interpolation
- Add 'damage-effect(de)' parameter in model mechanic(boolean)
BetterModel 1.4.1
Fix
Fix
- Improve sight trace
- Improve command
- Improve walk speed calculation
- Force resources name to lower case
- Fix Minecraft <=1.21.3 resource
- Fix entity remove/hide
- Add animation script
- Add .mcmeta animation
- Add 'follow-mob-invisibility' option
BetterModel 1.4
Add
![[IMG]](//proxy.spigotmc.org/4c60338e14f6bab22e631e64404bba204d0b1ae3/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f61636564613534382d316233662d346564392d383966662d333965633638636662656664)
![[IMG]](//proxy.spigotmc.org/822ea8c363e843de60573760729dc3d251555e24/68747470733a2f2f6769746875622e636f6d2f757365722d6174746163686d656e74732f6173736574732f61373066353034392d373762302d346634372d623265662d376262643638393665623131)
Add
- Add texture path validator
- Add @ModelPart targeter (MythicMobs)
- Add changepart mechanic (MythicMobs)
- Add debug config
- Free cube rotation (>=1.21.4)
- Kotlin 2.1.10
- Sync invisibility and glowing to tracker entity
BetterModel 1.3.3
Fix
Fix
- Fix texture rendering issue.
- Fix hitbox removing.
- Adds help command description.
BetterModel 1.3.2
Fix
Fix
- Fix scale calculation
- Fix player limb
- Expand sight degree
- Add 'disable-generating-legacy-models' config
- Add more API
- Fix channel handling.
- Fix spawn position.
- Code refactoring
- Citizens support (/npc model) (experimental)
- Bug fix
- Add configuration
Code (YAML):
namespace
: bettermodel
pack-type : folder #folder, zip
build-folder-location : BetterModel/build
pack-type : folder #folder, zip
build-folder-location : BetterModel/build
- Bug fix
- Support 1.19.4~1.21.4
- 4~5x faster reload
Resource Information
Author:
----------
Total Downloads:
2,763
First Release:
Dec 28, 2024
Last Update:
Aug 19, 2025
Category:
---------------
All-Time Rating:
19 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings