**DBetterModel 3.4.0: Adds interop between BetterModel and Denizen!** [![](https://img.shields.io/badge/SpigotMC-ED8106?style=for-the-badge&logo=SpigotMC&logoColor=white)](https://www.spigotmc.org/resources/dbettermodel.127341/) [![](https://img.shields.io/badge/Modrinth-00AF5C?style=for-the-badge&logo=Modrinth&logoColor=white)](https://modrinth.com/plugin/dbettermodel) [![](https://img.shields.io/badge/Hangar-185DEB?style=for-the-badge&logo=Hangar&logoColor=white)](https://hangar.papermc.io/meigoc/DBetterModel) [![CodeFactor](https://www.codefactor.io/repository/github/meigoc/DBetterModel/badge?style=flat-square)](https://www.codefactor.io/repository/github/meigoc/DBetterModel) [![GitHub Issues or Pull Requests](https://img.shields.io/github/issues/meigoc/DBetterModel?style=flat-square&logo=github)](https://github.com/meigoc/DBetterModel/issues)

# Supported: Supports BetterModel v1.10.2, Minecraft 1.21.4, Denizen 1.3.1 (7144) | BetterModel Version | Latest Supported DBetterModel Version | |----------------------|-------------------------------| | 1.10.2 | [3.4.0](https://github.com/meigoc/DBetterModel/releases/tag/v3.4.0) | | 1.10.0-1.10.1 | [3.3.0](https://github.com/meigoc/DBetterModel/releases/tag/v3.3.0) | | 1.9.0-1.9.3 | [2.1.0](https://github.com/meigoc/DBetterModel/releases/tag/v2.1.0) | | 1.8.0-1.8.1 | [2.0.1](https://github.com/meigoc/DBetterModel/releases/tag/v2.0.1) | | 1.5.5 | [1.1.0](https://github.com/Ignaacioo/DBetterModel/releases/tag/v1.1.0) | | 1.5.1 | [1.0.0](https://github.com/Ignaacioo/DBetterModel/releases/tag/v1.0.0) | # Docs (3.4.0) ----- ## Commands ### BMModel Adds or removes a model from an entity. This is necessary for entities that can have multiple models. - **Syntax**: `bmmodel entity: model: (remove)` - **Examples**: - To add a model: `bmmodel entity: model:my_model` - To remove a model: `bmmodel entity: model:my_model remove` ### BMState Plays or stops a layered animation state on a specific model on an entity, optionally limited to specific bones. This command supports multiple concurrent animations by allowing you to apply animations to specific parts of the model. - **Syntax**: `bmstate entity: model: state: (bones:) (loop:) (speed:<#.#>) (lerp_frames:<#>) (remove)` - **Arguments**: - `bones:`: An optional list of bone names to which this animation should be applied. If not provided, the animation applies to the entire model. - `loop`: Sets the playback mode. It can be: - `once` (plays one time), - `loop` (repeats indefinitely), - `hold` (plays once and freezes on the final frame). - `remove`: A flag to stop the specified animation. - **Examples**: - To play a looping 'walk' animation on specific leg bones: `bmstate entity: model:robot state:walk bones:left_leg|right_leg loop:loop` - To play a one-shot 'shoot' animation on the arm without stopping other animations: `bmstate entity: model:robot state:shoot bones:right_arm` ### BMBillboard Applies a billboard effect to a specific bone of a model, making it always face the player. - **Syntax**: `bmboard entity: model: bone: type:` - **Types (`type`)**: - `fixed`: Disables the billboard effect. - `vertical`: The bone rotates on the Y-axis only. - `horizontal`: The bone rotates on the X and Z axes. - `center`: The bone rotates on all axes to face the player. - **Example**: - To make a 'head' bone always face the player: `bmboard entity: model:my_mob bone:head type:center` ### BMLimb Plays a player-specific animation. These animations are sourced from models in the `players` folder. To stop a looping or held animation, you can play another animation over it. - **Syntax**: `bmlimb target: model: animation: (loop:) (hide:)` - **Modes (`loop`)**: - `once`: Plays the animation a single time (default). - `loop`: Repeats the animation indefinitely. - `hold`: Plays the animation once and freezes on the final frame. - **Examples**: - To make a player perform a 'roll' animation: `bmlimb target: model:steve animation:roll` - To start a repeating 'dance' animation: `bmlimb target: model:player_gestures animation:dance loop:loop` - To make a player strike a pose and hold it: `bmlimb target: model:player_poses animation:heroic_pose loop:hold` ### BMPart Applies a player's skin part (e.g., head, cape, body) to a specific bone of a model. * **Syntax**: `bmpart entity: model: bone: part: from:` * **Arguments**: * `entity:`: Target entity to apply the skin part to. * `model:`: Name of the BetterModel model attached to the entity. * `bone:`: Bone name within the model to map the skin part onto. * `part:`: One of the `PlayerLimb` values (e.g., `head`, `body`, `left_arm`, `cape`). * `from:`: The player whose skin will be used. * **Description**: * Dynamically maps the specified bone to a part of the player's skin. Uses BetterModel's skin manager and bone item mapper to handle fetching, caching, and rendering. * **Example**: * Apply Player's head to the statue's head bone: `bmpart entity:<[statue_entity]> model:statue_model bone:head part:head from:` ## Events ### bm starts reload - **Event**: `bm starts reload` - **Triggers**: This event triggers when BetterModel starts reloading its configuration and models. ### bm finishes reload - **Event**: `bm finishes reload` - **Triggers**: This event triggers when BetterModel finishes reloading its configuration and models. - **Context**: - ``: Returns whether the reload was a 'Success', 'Failure', or 'OnReload'. ## Objects and Tags ### BMEntityTag Represents an entity that has one or more BetterModel models attached to it. - **Prefix**: `bmentity` - **Format**: The identity format is the UUID of the base entity (e.g., `bmentity@dfc67056-b15d-45dd-b239-482d92e482e5`). - **Tags**: - ``: Returns the `BMEntityTag` of the entity, if it has any BetterModel models. It returns null if the entity has no models. - ``: Returns the base Bukkit entity as an `EntityTag`. - `)]>`: Returns the `BMModelTag` for the specified model name on the entity. If no name is provided, it returns the first model loaded on the entity. ### BMModelTag Represents a specific model instance attached to an entity. - **Prefix**: `bmmodel` - **Format**: The identity format is `,` (e.g., `bmmodel@dfc67056-b15d-45dd-b239-482d92e482e5,dummy`). - **Tags**: - ``: Returns the name of the model. - ``: Returns the parent `BMEntityTag` of this model. - ``: Returns a `MapTag` of all bones in the model, with the bone name as the key and the `BMBoneTag` as the value. - `]>`: Returns the `BMBoneTag` for the bone with the specified name from the model. ### BMBoneTag Represents a single bone within a specific model instance on an entity. * **Prefix**: `bmbone` * **Format**: `,,` (e.g., `bmbone@dfc67056-b15d-45dd-b239-482d92e482e5,dummy,head`) * **Tags**: * ``: Returns the bone's name (`ElementTag`). * ``: Returns the bone's world position (`LocationTag`). * ``: Returns whether the bone is visible (`ElementTag(Boolean)`). * ``: Returns the parent model (`BMModelTag`). * **Mechanisms**: * `tint:` Applies an RGB color tint to the bone's item. () * `scale:` Sets the scale vector of the bone. * `visible:` or `ListTag` Sets visibility for all or specific players. * `item:` Sets the item displayed by the bone. * `offset:` Sets the local offset of the bone's item. * `rotate:` Applies an additional rotation to the bone. * `view_range:` Sets the render distance for the bone in blocks.

meigoc

DBetterModel

denizen-reflect

FastBenchmark