📗 Notice

Due to Mojang’s new version numbering system (e.g., 1.21.x → 26.x), the next BetterModel feature release will begin at 2.0.0 to avoid confusion with Minecraft versions.
This also marks the completion of the BetterModel 1.x series, as its core APIs and features have now reached a stable, finalized state.

Several technical questions are expected to emerge in the near future, and they may influence the evolution of BetterModel 2.0.0:

• Will Mojang upgrade Minecraft’s Java requirement to version 25?
• Will Spigot platform compatibility be phased out based on future policy decisions by the Paper team?
• How will NMS be organized under Mojang’s new version numbering system?

🔥 Feat

• Minecraft 1.21.11 support
• new profile API to handle uncompleted profile

// ModelProfile#of
// Can be offline player, uuid
BetterModel.model("model").ifPresent(model -> model.create(location, ModelProfile.of(player)));

• CommandAPI is no longer used. Now cloud is used to implement commands.
• parallel json build
• optimized IK
• optimized texture load
• BonePredicate builder

//Or chain
BonePredicate.name("hitbox")
    .or(BonePredicate.tag(BoneTags.HITBOX))
    .or(b -> b.getGroup().getMountController().canMount())
    .notSet();

//Apply with children
BonePredicate.tag(BoneTags.HEAD_WITH_CHILDREN).withChildren();

• added 'loop_type' to '/bm limb' command
• added 'scaling' to 'bm disguise' command

⚡ Refactor

• ModelChildren -> ModelOutliner
• BaseEntity
• Float3 and Float4
• ModelBlueprint

🔧 Fix

• Tracker#hide on init
• resource pack load error
• Citizens trait
• UV issue regarding right forearm

🧹 Chores

• fix(deps): update dependency io.lumine:mythic-dist to v5.11.1
• fix(deps): update dependency com.gradleup.shadow:com.gradleup.shadow.gradle.plugin to v9.3.0

Full change log

🔥 Feat

• more accurate ik rig
• support client skin customisation for player limb (cape)

🔧 Fix

• RenderedBone#worldPosition ('ModelPart' MythicMobs targeter)
• 'camera' element type
• 'bm test' command in Spigot platform
• step interpolation
• bezier interpolation

Full change log

🔥 Feat

IK rig (experimental)

Now BetterModel supports IK rig. (locator, null object)

Rotation in global space

Now animator option 'rotation in global space' is available.

Other features

• 'brightness' script
• namespace in MythicMobs script (bm)

🔧 Fix

• default leather armor color
• animation placeholder
• exception handling in missing textures
• stability with SkinsRestorer

Full change log

⚡ BetterModel 1.14.0

📗 Notice

This update introduces significant API changes to the entity adapter.
Please verify the compatibility of all plugins that depend on BetterModel.

🔥 Feat

Armor in player model (experimental)

The player model now supports vanilla armor.
Armor textures can be customized in the BetterModel/armors directory.

Global texture (global_)

Any texture prefixed with global_ is recognized as a global texture.
These textures have no namespace and can be shared between multiple models, avoiding duplicate texture creation.

Other features

• remove image process
• 'loop_mode' argument in /npc animate

🔧 Fix

• move duration
• parsing bone tag
• NoSuchElementException in ModelAnimation

🧹 Chores

• deps: update dependency com.github.ben-manes.caffeine:caffeine to v3.2.3
• deps: update dependency io.github.toxicity188:dynamicuv to v1.1.0
• deps: update gradle to v9.2.0

Full change log

BetterModel 1.13.4

Feat

• cape support in player limb (bone tag 'cape_')
• 'enable-strict-loading' config
• Kotlin 2.2.21

Fix

• UV size
• 'shadow' bone tag
• exception in animation script
• position convert in BlockBench 5.0
• 'false' texture loading error
• filter dummy data in model file
• animation sync of each model part

Full change log

BetterModel 1.13.3

Notice

This is a version for avoid confusion with BlockBench 5

Feat

• initial BlockBench 5 support
• remove blueprint reference from renderer for gc
• reuse IO buffer

Fix

• Tracker#show
• animation replacement (MythicMobs mechanic 'defaultstate')

Full change log

BetterModel 1.13.2

Notice

• This is a hotfix of 1.13.1

Feat

• support obfuscation in player limb

Fix

• properly supporting minecraft 1.21.10
• plugin loading issue with some legacy Paper version
• some model's loading issue
• invalid hitbox bounding box

Full change log

BetterModel 1.13.1

Feat

• official 1.21.10 support
• use paper-plugin.yml in Paper platform
• make CommandAPI as runtime
• 'pairmodel' mechanics (experimental)
• 'use-obfuscation' config option

Fix

• ignore group name's case
• add minimum keyframe time

Full change log

BetterModel 1.13.0

Add

• 1.21.9 support
• component logging

Change

• optimize state handler

Fix

• animation script
• 'hold on last' animation type
• model resolution
• step interpolation
• exception handling on tick

Full change log

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