BetterModel | Modern BlockBench model engine | Folia supported icon

BetterModel | Modern BlockBench model engine | Folia supported -----

Generic BlockBench model parser & animation-ready entity engine — fully open-source




BetterModel 1.12.1
Notice
This is a simple bug fix version for preparing 1.21.9 update.

Add
  • More comfortable help command (/bm)
  • API update related to 1.21.9
Fix
  • Citizens trait
  • NPE in animation script
  • Boot issue with some version like 1.21.3
Full change log
----------, Today at 10:55 AM

BetterModel 1.12.0
Add
  • billboard MythicMobs mechanic
  • 5 of animation script
  • TrackerUpdateAction#composite
  • ModelEngine blueprints migration
changepart
partvis
enchant
remap
tint

Change
  • Kotlin 2.2.20
Fix
  • SkinsRestorer compatibility
  • mount hitbox cache
  • hitbox exception
  • minor keyframe optimization
Full change log
----------, Sep 12, 2025

BetterModel 1.11.4
Add
  • refresh plugin jar
  • use caffeine
  • add hide argument in /bm play (#134)
  • lerp-frame-time 5 -> 3
  • zip hash
  • Auto-merge with Nexo
Fix
  • animation interpolation
  • plugin lifecycle
Full change log
----------, Sep 4, 2025

BetterModel 1.11.3
Notice
  • It will be helpful to check 'template texture' docs to ignore resource pack generation.
  • There are some deprecated API in ModelManager and PlayerManager.
Add
  • allow textures in BetterModel/players with template texture
  • add player/monster nametag (ptag_, mtag_)
  • ModelRenderer API
  • more BetterModel API
  • improved reload speed
Code (Text):
BetterModel.modelOrNull("name"); //Gets nullable model renderer
BetterModel.model("name"); //Gets optional model renderer
Fix
  • avoid classloader conflict of Adventure in Paper
  • tracker remove refreshment
  • minor optimized memory cost
  • animation script
Full change log
----------, Aug 30, 2025

BetterModel 1.11.2
Add
  • Improved reload performance
  • Reload indicator bar
Change
  • 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)
Fix
  • MythicMobs mechanics
  • Keyframe generation
  • Interpolation duration
  • Hiding player's armor when disguised
Full change log
----------, Aug 19, 2025

BetterModel 1.11.1
Notice
Now API repository is moved.

Release
Code (Kotlin):
repositories {
   mavenCentral ( )
}

dependencies {
   compileOnly ( "io.github.toxicity188:bettermodel:VERSION" )
}
Snapshot
Code (Kotlin):
repositories {
   maven ( "https://maven.pkg.github.com/toxicity188/BetterModel" )
}

dependencies {
   compileOnly ( "io.github.toxicity188:bettermodel:VERSION-SNAPSHOT" )
}
Add
Fix
  • math animation interpolation
  • ModelRenderer#create(Entity, GameProfile, boolean)
  • player nametag
Full change log
----------, Aug 12, 2025

BetterModel 1.11.0
Add
Fix
Full change log

[​IMG]
----------, Aug 6, 2025

BetterModel 1.11.0
Add
Fix
Full change log
[​IMG]
----------, Aug 6, 2025

BetterModel 1.10.3
Add
  • initial molang support
  • expose id and uuid of item-display
Fix
  • equipment in the left hand
  • animation signal
  • packet bundler
Full change log
----------, Aug 3, 2025

BetterModel 1.10.2
Fix
  • optimize animation interpolation and keyframe
  • an attribute packet about hitbox
  • Folia compatibility
  • death animation
Full change log
----------, Jul 30, 2025

BetterModel 1.10.1
Notice
Now support about 1.20.4 is dropped.

Add
  • passengers API in EntityTrackerRegistry
Fix
  • entity body and head rotation
  • MythicMobs mechanics
  • hitbox rendering
  • inventory handling
Full change log
----------, Jul 24, 2025

BetterModel 1.10.0
Add
  • new entity rotation API
  • 'bodyrotation' MythicMobs mechanic
Fix
  • handle equipment change of player
  • entity invisibility
  • traffic optimization
  • animation accuracy
  • parallel animation packet bundling
Full change log
----------, Jul 20, 2025

BetterModel 1.9.3
Add
  • 1.21.8 server support
  • New API for updating tracker (Tracker#update)
Fix
  • entity yaw/pitch sync
  • data packet synchronization
  • improved animation accuracy
Full change log
----------, Jul 18, 2025

BetterModel 1.9.2
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
Full change log
----------, Jul 16, 2025

BetterModel 1.9.1
Notice
This is a hotfix about version 1.9.0.

Add
  • API Tracker#billboard
Fix
  • 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
----------, Jul 13, 2025

BetterModel 1.9.0
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
Fix
  • minor packet optimization
  • entity despawn handling
  • animation script
  • equipment packet
Full change log
----------, Jul 11, 2025

BetterModel 1.8.1
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
----------, Jul 5, 2025

BetterModel 1.8.0
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
Fix
  • '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
Full change log
----------, Jul 2, 2025

BetterModel 1.7.0
Notice
  • This update has HUGE API change and refactor, You should check all of your system related to BetterModel.
Add
  • 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)
Full change log
----------, Jun 23, 2025

BetterModel 1.6.1
Fix
  • Optimized vector calculation
  • Head rotation tag (h, hi)
  • Hitbox size and position
  • Entity scale attribute
  • Player animation model size
  • Animation frame quality
Change
  • Simplify resource pack generation
  • MythicMobs 5.9.0 compatibility (bindhitbox)
Add
  • Skin event API
Full change log
----------, Jun 1, 2025

BetterModel 1.6.0
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
  • Fix hit-box collision and interaction with 1.21.5
  • Tinted item cache
Full change log

[​IMG]
----------, May 18, 2025

BetterModel 1.5.5
Notice
  • Support about 1.20.2 is dropped.
Fix
  • 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
Add
  • HMCCosmetics backpack support (bone tag: hmc_bp)
  • Default model for test and learn (demon_knight.bbmodel)
Full change log
----------, May 12, 2025

BetterModel 1.5.4
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
Full change log
----------, May 7, 2025

BetterModel 1.5.3
Fix
  • Bukkit hitbox event
  • update checker
  • optimize packet listener
Add
  • 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)
Full change log
----------, May 5, 2025

BetterModel 1.5.2
Add
  • 'bindhitbox' mechanic
  • 'mountmodel' mechanic
  • 'dismountmodel' mechanic
  • 'dismountallmodel' mechanic
  • use interaction entity
  • 'override' property in animation
  • 'loop mode' property in animation
  • 'smooth' interpolation
Fix
  • make hitbox listener entity to bukkit entity.
  • optimize animation update
Full change log
----------, Apr 27, 2025

BetterModel 1.5.1
Notice
  • This version is a hotfix of BetterModel 1.5.
Add
  • config 'version-check'
Fix
  • Spigot support
  • loading issue with legacy server
  • incorrect world handling
Change
  • The default pack builder is now 'zip'
Full change log
----------, Apr 19, 2025

BetterModel 1.5
Add
  • 'glow' and 'enchant' mechanic
  • update checker
  • more API
Fix
  • entity scale sync
  • entity shadow
  • some compatibility issues with MythicMobs
  • some platform support
Full change log
----------, Apr 17, 2025

BetterModel 1.4.3
Add
  • 1.21.5 client, server support
  • Support Purpur AFK
  • World position API
  • More optimization
Fix
  • More smooth animation
  • Fake player like Citizens
  • Hit box
  • Animated texture
  • World change
Full change log
----------, Apr 7, 2025

BetterModel 1.4.2
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
  • Add 'module' config
  • Support 'smooth' interpolation
  • Add 'damage-effect(de)' parameter in model mechanic(boolean)
[​IMG]
[​IMG]
----------, Mar 17, 2025

BetterModel 1.4.1
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
  • Add animation script
  • Add .mcmeta animation
  • Add 'follow-mob-invisibility' option
----------, Feb 7, 2025

BetterModel 1.4
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
[​IMG]
[​IMG]
----------, Jan 31, 2025

BetterModel 1.3.3
Fix
  • Fix texture rendering issue.
  • Fix hitbox removing.
  • Adds help command description.
----------, Jan 20, 2025

BetterModel 1.3.2
Fix
  • Fix scale calculation
  • Fix player limb
  • Expand sight degree
Add
  • Add 'disable-generating-legacy-models' config
  • Add more API
----------, Jan 9, 2025

  • Fix channel handling.
  • Fix spawn position.
----------, Jan 3, 2025

  • 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
----------, Dec 29, 2024

  • Bug fix
  • Support 1.19.4~1.21.4
  • 4~5x faster reload
----------, Dec 28, 2024

Resource Information
Author:
----------
Total Downloads: 2,907
First Release: Dec 28, 2024
Last Update: Today at 10:55 AM
Category: ---------------
All-Time Rating:
19 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings