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