repository·master·Indexed 41 days ago
https://github.com/jannisx11/blockbench-pluginsA central repository for hosting and developing extensions for the Blockbench 3D modeling tool. Includes documentation for various plugins such as GeckoLib Animation Utils, Baked Ambient Occlusion, Bone View, Easy Model Entities, and Farsight.
The Hytale plugin extends Blockbench with specific capabilities for Hytale assets:
stretch value of the attached cube.The Animated Platforms plugin provides tools for creating moving platforms within Blockbench. Key capabilities include:
Important Note: Custom texture rotation is a visual-only effect; the actual movement direction of the platform remains consistent regardless of how the texture is rotated.
PAL Bend Player Tools is a Blockbench plugin designed to create player animation projects and convert between different animation formats, specifically targeting PlayerAnimationLibrary, Emotecraft, and DragonCore.
player_model.geo.json helper-bend projects with a default player_model.geo.png texture. It also supports creating DragonCore-compatible projects using either standard PAL bone names or specific DragonCore group names (e.g., Body_Lower, Body, Left_Arm_Lower, Right_Hand).animations JSON or Emotecraft emote JSON.animations JSON or Emotecraft emote JSON.*_bend.rotation.x), it exports in the original scalar PAL format.PlayerAnimationLibraryMoreRotation.bend, Emotecraft exports are limited to the single X-axis bend value supported by the emote JSON format.The Structure to Model plugin provides several automated processing features during the import of .nbt files:
The mod automatically triggers specific animations based on the entity's state. To ensure your model animates correctly, name your Blockbench animation clips using the following reserved names:
| Clip Name | Trigger Condition |
|---|---|
idle | Standing still |
walk | Moving on the ground |
swim | Moving in water |
fly | Flying |
attack | Attacking |
sit | Sitting |
Other Clips:
hurt and death clips are loaded but are not automatically triggered by the mod./easy_model_entities animation command or via other mods. If no matching clip is found for a state, the model renders without animation.The plugin uses TypeScript with types provided by blockbench-types. Because these types are hand-written, they may be incomplete or incorrect. TypeScript errors will be logged to the terminal but will not prevent the plugin from building.
blockbench-types (Recommended)If a type is genuinely missing or wrong, submit a PR to the blockbench-types repository. You can test these changes locally using npm link:
blockbench-types and use the same Node version as the plugin.npm link inside blockbench-types.npm link blockbench-types inside the plugin's src folder.
Note: You must re-run npm link blockbench-types after every npm install.as to cast to a target type. For insufficient overlap, use as unknown as <Target Type>.let easingBar: HTMLElement = document.createElement('div');(kf: GeckolibKeyframe) => { } // Forces kf to be GeckolibKeyframe instead of KeyframeIf all else fails, use // @ts-ignore above the line to suppress all type checking for that specific line.
// Example of type assertion
const myVar = someValue as unknown as TargetType;
// Example of type annotation
let easingBar: HTMLElement = document.createElement('div');When the Also Update Animation Names option is enabled, the plugin ensures that renaming groups does not break existing animations.
It checks project animations and updates matching animator names if they are tied to:
The model group rename and the animation-name update are committed in a single undo step, so Ctrl+Z will revert both simultaneously.
The plugin uses TypeScript with types provided by the blockbench-types package. Because these types are hand-written, you may encounter errors even if your code is correct.
blockbench-types. You can test local type changes using npm link (link blockbench-types locally, then run npm link blockbench-types in the plugin's src folder).as <Target Type> or as unknown as <Target Type>.(kf: GeckolibKeyframe) => { }.// @ts-ignore above the line to suppress all type checking for that specific line.When an animation is exported using the Java Block Sequence button in the Animate tab, the plugin processes each frame through the following six stages:
The plugin includes two visual/navigation tweaks: