🌀 Morphing Bracelet Reborn (MBR) v1.4.93

📘 Update Notes & Changelog

Apologies to anyone who downloaded the last version, it had several regressions from an old backup and some new issues that were overlooked, with the help of Ex2esx hopefully these should be resolved in version 1.4.93

🆕 What's New & Fixed

🎨 Simpler UI Restore

Reverted to a much simpler UI for better stability, readability, and cross-platform reliability.
Fallback to Default Minecraft Font to avoid custom font rendering issues and improve compatibility on mobile, console, and lower-end devices.

🧱 Restored Original Textures

Restored the original texture files for the following assets:

textures/items/wind_charge.png
textures/blocks/stone.png
textures/entity/morph/blocks/stone.png
textures/entity/morph/block_atlases/stone.png

The Wind Charge item now uses the original item texture again instead of the projectile-style streak texture.

🐛 Script Error Fix

Fixed the scripting/render error:

Error: unhandled request for unknown variable 'context.owning_entity'

This should reduce log spam and prevent affected render paths from breaking on supported clients.

📱 Mobile-Safe Transition FX Budget

Added a safer transition FX budget designed to reduce particle overload on mobile, console, Realms, and lower-performance devices.

Added a per-player particle spawn-call budget per tick.
Added a global particle spawn-call budget per tick.
Reduced the safe scale of transition FX.
Capped particle variable counts.
Reduced maximum ring, helix, and column point counts.

Transition effects should now be lighter, safer, and less likely to cause performance spikes while still preserving the intended morphing visual style.

🧹 Stability & Compatibility

Simplified UI presentation to reduce edge-case failures.
Restored vanilla-style texture consistency for stone and wind charge assets.
Improved mobile safety by limiting excessive transition particle calls.
Improved compatibility by falling back to the default Minecraft font.

🛠️ Crafting Recipes

All mod features are fully integrated into survival gameplay. Use a Crafting Table and Furnace to acquire the required items:

1. Soul Glass

Smelt Soul Sand in a standard Furnace.

Input: 1x Soul Sand
Output: 1x Soul Glass

[ Furnace ]
Soul Sand ➔ Smelt ➔ Soul Glass

2. Soul Glass Bottle

Crafted in a Crafting Table using a standard "V" pattern:

Ingredients: 3x Soul Glass

[ Crafting Table ]
S . S
. S .
(. = Nothing, S = Soul Glass) Also available on the recipe book

3. Morphing Bracelet

Crafted in a Crafting Table:

Ingredients: 4x Soul Soil + 1x Soul Glass

[ Crafting Table ]
S . S
S G S
(. = Nothing, S = Soul Soil, G = Soul Glass) Also available on the recipe book

🔋 Durability & Recharging

Durability Loss: When playing in survival mode, morphing into any mob or block consumes durability.
Depletion / Shattering: If the bracelet is allowed to deplete entirely (durability.damage >= max), it will shatter, play a depletion sound effect (respawn_anchor.deplete), and be lost from your inventory.
Recharging: To repair your damaged bracelet, hold it in your main hand while standing on Soul Sand or Soul Soil. You will see soul particles rise up, hear a charging sound, and the bracelet will slowly recharge over time (1 durability point restored per second).

🧪 Soul Bottling System

You can capture, store, and share transformations using the Soul Glass Bottle system:

Sucking Souls (Storing): While transformed into any mob or block, hold a Soul Glass Bottle and use/right-click it.
- The bottle sucks the morph out of you, turning into a Soul in a Bottle loaded with your morph metadata (showing the morph's name in its tooltip).
- You will immediately revert to your default player form.
Unleashing Souls (Consuming): Hold and drink/consume a Soul in a Bottle to immediately transform into the stored mob or block form.
- Once consumed, it returns an empty Soul Glass Bottle to your inventory (triggers a brief cooldown).
- This is an excellent way to pass morphs to friends who do not yet own a Morphing Bracelet!

⚔️ Special Mob Abilities & Weapons

When transformed into certain mobs, you automatically receive custom, locked ability weapons/items. These items are locked to your inventory (ItemLockMode.inventory) and are kept on death (keepOnDeath: true). They are cleaned up automatically when you unmorph or reset. Durability on these items is infinitely auto-repaired to 0.

Morph Form	Active Ability Item / Weapon	Action / Effect
Skeleton / Stray / Bogged	🏹 Bow + Arrow (Locked Slot 8)	Fires arrows (Stray fires slow arrows; Bogged fires poison arrows)
Enderman	🔮 Teleporter	Use to teleport forward with teleport particles/sound effects
Piglin / Zombified Piglin	🗡️ Golden Sword	Melee attacks
Wither Skeleton	🗡️ Stone Sword	Melee attacks
Snow Golem / Sheared variant	❄️ Infinite Snowball	Spams infinite snowballs
Blaze	🔥 Small Fireball	Launches shooting fireballs
Vindicator	🪓 Iron Axe	Melee attacks
Piglin Brute	🪓 Golden Axe	Melee attacks
Llamas (All Variants)	💦 Llama Spit	Spits at enemies
Wither	💀 Wither & Blue Wither Skull	Launches explosive skulls
Pillager	🏹 Crossbow	Fires crossbow bolts
Vex	🗡️ Iron Sword	Melee attacks
Ghast	💥 Fireball	Shoots massive explosive fireballs
Evoker	🦷 Evoker Fangs	Summons lines of biting fangs along the ground
Elder Guardian	👁️ Guardian Curse	Inflicts Mining Fatigue on nearby players
Warden	🔊 Sonic Boom	Charges (1.7s) and releases a massive sonic boom with knockback
Ender Dragon	🐉 Dragon Fireball	Shoots lingering dragon breath fireballs
Breeze	🌀 Wind Charge	Launches native wind charges
Squids (All Variants)	🦑 Ink Blast	Blinds nearby enemies with ink particles
Guardian	📡 Guardian Beam	Shoots a lock-on guardian laser beam
Silverfish	🪨 Infest Block	Infects and hides inside stone blocks
Shulker	🔮 Teleporter + Shulker Bullet	Teleport around, or launch levitating shulker bullets

📦 Enderman Block-Carrying

When morphed as an Enderman, if you hold a supported block (e.g. Dirt, Grass, Stone, Sand, TNT, Oak Log, Glass, Cobblestone, Gravel, Obsidian, Bookshelf, Melon, Pumpkin), your model will physically carry the block in its arms.

🧱 Block Disguise Lock & Rotation

Transforming into blocks allows you to settle and lock yourself to the world grid:

Jump + Crouch: Toggles block lock. When locked, you become stationary and look exactly like a real block placed in the world.
Jump (While Locked): Rotates your settled block clockwise.
Block Disguise Workshop: Open the bracelet's blocks tab to access manual rotation tools:
- Rotate Clockwise / Counter-Clockwise.
- Face My View Direction.
- Release Lock.
Vanilla Interaction: Active interactable blocks (like Bells, Torches, Campfires, Lanterns, Crafting Tables, Smelters, Droppers, and Jukeboxes) can be used/interacted with by other players while you are locked.

🚀 How to Install & Setup

📥 First-Time Installation

Download the latest v1.4.75_MBR_GiantCameraFOVPass.mcaddon file.
Open the file. Minecraft will launch and automatically import the pack.
Create a New World (or edit an existing one).
Navigate to Behavior Packs in the world settings and Activate 1.4.75 - MBR.
Navigate to Resource Packs and confirm that 1.4.75 - MBR is also activated.
Start your world and enjoy morphing!

Note: Both the Behavior Pack and Resource Pack must be active at the same time for the mod to function. The UI files are pre-merged, so no separate UI stack pack is needed!

🔄 Updating From an Older Version

To prevent missing textures, broken menus, invisible morphs, or cached file issues, we highly recommend a clean install when updating.

Go to Settings ➔ Storage.
Under Behavior Packs and Resource Packs, delete any old copies of:
- 🛑 Morphing Bracelet Reborn
- 🛑 Morphing Bracelet UI Stack
- 🛑 Any old beta/test versions.
Once clean, import the new .mcaddon file.

⚙️ Required World Settings

Make sure to enable the following toggles when creating or editing your world:

Beta APIs: 🟢 ON
Education Edition: 🟢 ON (Optional - Required only if you want native Mayfly flight assist for flying morphs)
Allow any additional experimental toggles if prompted by the game.

Warning: This add-on relies heavily on scripting, custom items, custom entities, and custom rendering. It will not function correctly if Beta APIs are turned off.

🔍 Troubleshooting & Recovery

❌ The menu does not open

Confirm Beta APIs is enabled in your world settings.
Verify both the Behavior Pack and Resource Pack are active.
Ensure you deleted all older versions of Morphing Bracelet Reborn and UI Stack from Settings ➔ Storage before importing.

❌ Morphs are invisible or have checkerboard textures

Make sure the Resource Pack is enabled on your world/server.
Accept the resource pack download prompt when joining multiplayer.
Clear old cached versions from your game storage.

❌ I am stuck or my camera is broken

Use the Hard Reset button in the main menu dashboard to safely return to your human form and clear any stale states.
Alternatively, run these recovery chat commands:
- /scriptevent morph:recover - Safely teleports the player out of block locks and restores normal physics.
- /scriptevent morph:state - Displays your current morph diagnostic values.

✨ Brought to you by the MBR - Morphing Bracelet Reborn Team ✨