Free Minecraft Models

FreeMinecraftModels 2.7.1:

• [Fix] Item Lua scripts now remain active for the full lifetime of the holding player
• [Tweak] Updated the bundled MagmaCore library

Note: this update adds full support for bedrock clients that connect via geyser or floodgate for proxied servers! ResourcePackManager is mandatory to make this work. This should now cover every possible case of bedrock clients connecting to serverss being able to see models.

FreeMinecraftModels 2.7.0:

• [New] sendCustomModelsToBedrockClientsV2 now defaults Bedrock custom-model display to true
• [New] /fmm debug bedrock [on|off] toggles runtime Bedrock display diagnostics
• [New] preventPropPlacementInProtectedRegions blocks prop placement in WorldGuard and GriefPrevention regions unless the player has freeminecraftmodels.bypassregionprotection
• [Fix] Projectile hits now connect with modeled entity hitboxes reliably, including fast arrows, tridents, and rotated models
• [Fix] Projectile hits on dynamic models now damage the underlying entity as projectile hits instead of melee/raw damage
• [Fix] Player disguises now hide and restore armor and held items for other viewers, including players who join or change worlds mid-disguise
• [Fix] MagmaCore Bedrock detection now recognizes Floodgate/Geyser players through plugin, UUID, and username fallbacks so Bedrock viewers stay on the custom-model packet path
• [Fix] MagmaCore NMS packet handling now avoids Bedrock bundle and entity-position desync issues on newer servers
• [Tweak] Prop Lua tables are cached per prop with lazy current_location updates
• [Tweak] Location protection now uses MagmaCore's shared location registry so WorldGuard, GriefPrevention, EliteMobs dungeons, and other registered providers can block protected prop placement
• [Tweak] Setup menu now uses MagmaCore's shared SetupMenuBuilder, Nightbreak setup icons, and setup-done handling

FreeMinecraftModels 2.6.0: [New] Geyser/Floodgate support! Geyser/Floodgate clients can now see custom models. Requires ResourcePackManager for the conversions. [New] Craftenmine's Weapons Item Pack — new free scripted item-model pack available now via Nightbreak (and /fmm setup) [New] Craftenmine Tools Item Pack — new premium scripted item-model pack available now via Nightbreak (and /fmm setup) [New] Player disguise system — /fmm disguise [player] and /fmm undisguise [player] disguise yourself (or another player) as any loaded model; mirrors player movement, head rotation, and arm-swing animations [New] /fmm disguiselist admin command to see all active disguises [New] DisguiseAPI public class for third-party plugins (disguise / undisguise / isDisguised / getDisguiseModelID / getDisguisedPlayers) [New] FmmReloadedEvent API — fires after FMM finishes initializing (startup and /fmm reload) so plugins shading FMM can re-attach their custom models [Fix] Custom models on MC 26.1+ no longer fail to bake with "Cannot compute translucency out of bounds" errors (UV coordinates that went past texture bounds are now clamped) [Fix] Custom models on MC 26.1+ no longer spam "Missing block model" warnings for empty/anchor-only bones [Fix] Disguise invisibility now persists through milk buckets, /effect clear, and third-party effect strippers [Fix] /fmm disguise with no model arg now self-disguises correctly instead of erroring [Fix] freeminecraftmodels.* wildcard now properly grants the new disguise permissions [Tweak] Various MagmaCore library improvements (MC 26 Spigot compatibility, Bedrock position sync, classloader isolation for shaded copies, etc.) [Tweak] plugin.yml api-version updated from 1.18 to 1.21.4 [Tweak] Added .gitignore for Maven build artifacts and IDE files

FreeMinecraftModels 2.5.2:

• [Fix] Click hit detection on rotated entities — OrientedBoundingBox.update() was setting inverseRotationDirty=true after rotating but never actually transposing the rotation into inverseRotation, so rayIntersection / containsPoint silently used the stale identity inverse. Hit-detection on any entity not at yaw=0 was broken. The inverse is now computed inline (transpose of a pure rotation matrix) so clicks register correctly at every yaw.
• [Fix] LEFT_CLICK_AIR / RIGHT_CLICK_AIR no longer silently dropped — Bukkit reports air clicks with useInteractedBlock=DENY (there's no block to "use") and ignoreCancelled=true was treating that as "cancelled", skipping every air click and breaking hit detection on any entity without a block behind it. The handler now suppresses only when both useBlock and useItem are DENY (the real "another plugin cancelled this" signal).
• [Fix] OBB-edge left-clicks on dynamic entities now actually attack the underlying LivingEntity — previously the InteractionComponent default left-click path had no handler when no callback was registered, so OBB-edge clicks fell through silently and the entity stayed un-attackable outside its resized vanilla bbox. The default now forwards the swing to the underlying entity as a vanilla attack, with applyDamage gating to bypass OBBHitDetection's own EntityDamageByEntityEvent cancel for the dispatched hit.
• [Tweak] Per-player left-click cooldown (100ms) mirrors the existing right-click cooldown, so the same click can't double-fire from both the packet interaction entity path and the OBB raytrace path.

FreeMinecraftModels 2.5.0:

• [New] Furniture shop — optional Vault-backed /fmm shop opens a paginated GUI of craftable models that players can purchase with in-game currency, gated by the freeminecraftmodels.shop permission. Disabled by default; auto-disables if Vault or an economy provider is missing.
• [New] shop_config.yml config file with a master toggle, default price, menu title, price/click-to-buy lore formats, and configurable purchase/insufficient-funds/disabled/not-for-sale/inventory-full messages.
• [New] Per-recipe shopEnabled and shopPrice fields on PropRecipeConfig so individual recipes can opt out of the shop or set their own price (default falls back to ShopConfig.defaultPrice or 100).
• [New] ModeledEntity.setTintColor(Color) / getTintColor() API for a persistent per-entity dye tint applied through the leather-armor channel; the damage-flash animation now fades back to this color instead of undyed white.
• [New] ModeledEntity.setViewDistanceOverride(int) / getEffectiveViewDistance() API for per-entity view-distance caps — used by both SkeletonWatchers and PropBlockComponent.setPropBlocks so individual models can be made visible further than the plugin-wide DefaultConfig.maxModelViewDistance.
• [New] LocationAPI for third-party plugins to register dungeon detectors and region-protection providers via plain Predicate (no shaded types crossing classloaders), feeding the Lua em.location.is_in_dungeon and em.location.is_protected checks.
• [New] /fmm location diagnostic command reporting the count of registered dungeon locators and protection providers and what each predicate returns for the player's current location.
• [New] Lua entity-table enrichment — every entity table now exposes is_modeled, is_prop, and a nested model sub-table (model_id, play_animation, stop_animations, remove, is_dynamic) when the entity is an FMM model.
• [New] EliteMobs Lua bridge — when EliteMobs is installed, entity tables are enriched with is_elite, is_custom_boss, is_significant_boss, and an elite sub-table exposing level, name, health, max health, health/damage multipliers, and a remove() method.
• [New] Premade pickupable and double-storage prop scripts now query em.location.is_protected and em.location.is_in_dungeon and cancel the interaction in protected zones or dungeons, including a new on_right_click handler on the pickupable script that blocks mount fallback in those areas.
• [New] Soft-depend declarations for WorldGuard, WorldEdit, GriefPrevention, and Vault in plugin.yml so FMM loads after those protection/economy plugins when present.
• [New] Per-player local cooldown store on ScriptableItem — overrides getLocalCooldownStore to back cooldowns.set_local / check_local with a static map keyed by player UUID + itemId + script file, surviving item re-equip.
• [New] Per-player global cooldown store on ScriptableItem and per-prop global cooldown store on ScriptableProp for Lua scripting, with cleanup on player quit and prop destroy.
• [Fix] Fixed inverted Bedrock-client check in Bone.displayTo that prevented custom models from rendering for Bedrock players when sendCustomModelsToBedrockClients was enabled — the negation was the wrong way around so models were hidden exactly when they should have been shown.
• [Fix] Fixed item local cooldowns being wiped on every hotbar swap — ScriptableItem's ScriptInstance is destroyed on unequip, so the in-instance default map died with it; cooldowns are now persisted in a static map and cleared on player quit.
• [Fix] Fixed NullPointerException when playAnimation was called on a model that has no animations — AnimationComponent now null-guards animationManager and emits a single deduplicated warning per entity+animation pair instead of crashing or spamming the log.
• [Fix] Fixed bbmodels with freefloating cubes (cubes declared at the top of the outliner without a containing group) rendering as the missing-texture purple/black cube — BoneBlueprint.appendFreefloatingCubes now ingests bare-UUID outliner entries onto the auto-generated root bone, and ModelsFolder writes the matching item-model JSON instead of skipping the root.
• [Fix] Fixed prop right-click placement immediately triggering the right-click script or mount fallback — props now ignore click callbacks for 500 ms after spawn so the placement click can't double as an interaction.
• [Fix] Fixed prop right-click scripts being unable to suppress mount fallback — PropScriptManager.onPropRightClick now returns whether the script cancelled the event, and PropEntity only falls through to MountPointManager.tryMount when no script handled it.
• [Fix] Fixed persistent props leaking stale ModeledEntity references in loadedModeledEntitiesWithUnderlyingEntities when chunks unloaded — the underlying-entity mapping is now always cleared on remove, while the actual underlying despawn still only fires for non-persistent props.
• [Fix] Fixed double propEntities.put and double chunkHash assignment in PropEntity spawn that registered the wrong UUID — only the armorstand UUID is now stored.
• [Fix] Fixed OBBHitDetection.onPlayerInteract running for already-cancelled interaction events (e.g. cancelled by protection plugins) — the listener is now ignoreCancelled = true.
• [Fix] Fixed an async-vs-main-thread race in HitboxComponent.updatePacketInteractionEntityPosition where removePacketInteractionEntity could null packetInteractionEntity between the null check and the teleport — the field is now snapshotted into a local before use.
• [Fix] Fixed resendFakeBlocks running its scheduled re-show after the prop had been removed — the delayed task now bails out if isRemoved() is true.
• [Tweak] Bumped project version to 2.5.0 and added EliteMobs 10.2.0 and VaultAPI 1.7 as provided dependencies (with the JitPack repository for VaultAPI).
• [Tweak] Extracted EliteMobs custom-boss spawning out of the reflective block in LuaPropTable.spawn_boss into a dedicated EliteMobsBossSpawner class with direct API imports, isolated so EliteMobs classes only load when the call is actually made.
• [Tweak] Updated MagmaCore dependency to 2.2.0-SNAPSHOT.

FreeMinecraftModels 2.4.0:

• [New] Updated for Minecraft 26.1.
• [New] Lua scripting for props — scripts can react to left-click, right-click, projectile hits, zone enter/leave, spawn, destroy, and tick events.
• [New] Lua scripting for custom items — 22 hooks including equip, unequip, left/right/shift-click, damage dealt/received, block break/place, and more.
• [New] Custom item system — define items with material, name, lore, enchantments, and Lua scripts via YML config alongside model files. A single model can be both a prop and a custom item.
• [New] Bow and crossbow draw state support — provide models with _idle, _draw_start, _draw_half, _draw_full (and _charged for crossbows) suffixes and FMM auto-generates the correct conditional resource pack JSON with pulling animations.
• [New] Item durability Lua API — get_durability, use_durability, use_durability_percentage for scripted item wear.
• [New] Persistent prop inventory and book Lua endpoints for interactive furniture.
• [New] Pickupable prop script and mount_ bone mount points for rideable models.
• [New] /fmm admin command — browse content packs, models, and custom items with click-to-get.
• [New] /fmm craftable player menu — browse and view crafting recipes for custom items with 3D model previews.
• [New] /fmm giveitem admin command for giving custom items.
• [New] Display model support — sibling .json files processed during resource pack generation for custom item visuals.
• [New] ScriptedItemAPI for external plugin integration (used by EliteMobs).
• [New] Premade invulnerable.lua prop script — replaces old PropsConfig onlyRemovableByOPs behavior.
• [New] Lua entity bridge — scripts can check is_elite, is_custom_boss, is_significant_boss, health_multiplier, and damage_multiplier on targeted entities.
• [New] Lua API: player boss bars, action bars, and titles with tick-based auto-dismiss.
• [New] Lua API: raycast, spawn_firework, get_target_entity, get_eye_location, get_look_direction.
• [New] Lua API: send_block_change and reset_block with optional auto-reset timer.
• [New] Lua API: get_highest_block_y for terrain queries.
• [New] Lua API: player:sleep() and player:wake_up() endpoints.
• [New] Lua API: event context with cancel support for intercepting interactions.
• [New] Lua API: zone enter/leave tracking for spatial scripting.
• [New] Lua scripting engine and zone system integrated from MagmaCore 2.0.
• [New] EasyMinecraftGoals now bundled inside MagmaCore — no longer a separate dependency.
• [Fix] Props now place at center of hit block face instead of block corner.
• [Fix] Custom 3D models now render correctly in menu UIs.
• [Fix] Skull textures pre-cached at startup to avoid Steve head fallbacks in menus.
• [Fix] Left-click on props now uses FMM's own callback instead of Bukkit events (armor stands are invulnerable, so the event never fired).
• [Fix] Animation rotation now applied after base bone rotation so animations respect bone tilt.
• [Fix] Content package import routing for scripts and content_packages folders.
• [Fix] Fixed Nightbreak token "Invalid token format" errors caused by whitespace in copy-pasted tokens.
• [Fix] Fixed compatibility with Minecraft 26.1 — replaced removed SnakeYAML Base64Coder with java.util.Base64.
• [Tweak] Removed old PropsConfig system — fully replaced by Lua scripting.
• [Tweak] All item creation centralized through ModelItemFactory.

FreeMinecraftModels 2.3.18:

• [New] Modified EasyMinecraftGoals dependency to add the ability to make FMM display nametags with hex codes for advanced color control

FreeMinecraftModels 2.3.17:

• [New] Started implementing IK compatibility from blockbench
• [New] Added syncMovement property to DynamicEntity allowing models to be positioned independently from their underlying entity
• [New] Added packet-based Interaction entity support for click detection on prop models, providing more reliable interaction handling
• [Fix] Fixed UV mapping to use per-texture resolution instead of global resolution, fixing texture display issues on models with multiple textures of different sizes
• [Fix] Fixed duplicate texture name handling - textures with the same name now receive a numeric suffix to prevent file conflicts
• [Fix] Fixed NullPointerException when non-model files (e.g., PNG images) are placed in the models folder
• [Fix] Fixed viewer cleanup order in SkeletonWatchers to properly clean up state even when player goes offline
• [Tweak] Updated EasyMinecraftGoals dependency to 1.19.23

FreeMinecraftModels 2.3.16:

• [Critical fix] Fixes for papermc 1.21.11

FreeMinecraftModels 2.3.15:

• [New] Updated FreeMinecraftModels for Minecraft 1.21.11
• [New] Cube rotations now support arbitrary angles between -45 and 45 degrees on Minecraft 1.21.6+
• [Fix] Fixed UV mapping not correctly using the resolution property from bbmodel files, which could cause textures to appear incorrectly on models with non-16x16 resolution settings
• [Fix] Fixed OBB hitboxes not updating position for models without a configured hitbox blueprint
• [Fix] Fixed memory leaks and potential issues on plugin reload by properly clearing static data on shutdown
• [Tweak] Updated EasyMinecraftGoals dependency to 1.19.18

FreeMinecraftModels 2.3.14:

• [New] Animation scale keyframes now support per-axis scaling (X, Y, Z) instead of uniform scaling
• [New] Added automatic attack animation support for Evokers when summoning fangs
• [New] Added getBoneLocation() method to the Bone API
• [Fix] Fixed potential thread safety issues with entity visibility changes for Bedrock clients
• [Tweak] Updated EasyMinecraftGoals dependency to 1.19.17

FreeMinecraftModels 2.3.13:

• [Fix] Fixed error spam related to hiding models

FreeMinecraftModels 2.3.12:

• [New] Custom models can now correctly apply a damage tint for Minecraft versions 1.21.4-1.21.10
• [New] Conversions now correctly account for the inflate property
• [Fix] Fixed several problems with the fmmodel file format
• [Fix] Fixed errors related to animations
• [Tweak] Improved warning logging

FreeMinecraftModels 2.3.11:

• [New] Updated to support Block Bench 5!
• [Fix] Fixed animations being very jittery
• [Fix] Fixed issue where animated textures would not work when in the fmmodel format

FreeMinecraftModels 2.3.10:

• [New] Free Minecraft Models can now send functionally unlimited amounts of entities to players without causing problems (other than killing player FPS)
• [New] Tweaked the base model entity to be able to be moved independently of having an underlying entity, making true fake entities possible
• [New] Various tweaks and optimizations for MegaCraft Survivors have led to successfully loading up to 10,000 entities at 20 TPS (but only 14 FPS client side when viewing those entities at the same time, nothing I can do about that)
• [Fix] Fixed bug where mobs that would teleport would do so twice, resulting in pretty bad flickering
• [Fix] Fixed a number of warnings and bugs

FreeMinecraftModels 2.3.9:

• [New] Updated to Minecraft 1.21.9 and 1.21.10
• [Fix] Changed left click detection, should no longer incorrectly trigger when right clicking

FreeMinecraftModels 2.3.8:

• [New] Added the ability to instantly discover props when inserted into the world with the correct metadata (works with WorldEdit and the new BetterStructures structure generation)
• [Critical Fix] Fixed problems for Minecraft versions 1.21.0, 1.21.1, 1.21.2, 1.21.3
• [Fix] Fixed a number of concurrency errors

FreeMinecraftModels 2.3.7:

• [Fix] Critical fix, making the plugin appropriately async again