
Flexible Arms
Library mod allowing adjusting arm positions in item JSON models. Inspired by the great Blåhaj mod.
Screenshots

About this Mod
Flexible Arms
A Quilt mod (potentially Fabric & NeoForge too but I don't have time to do a multi-platform setup and I'm too lazy to handle this as well) allowing adjusting arm positions in item JSON models.
Does not require Quilt Standard Libraries.
This mod is inspired by the great Blåhaj mod.
Getting Started
It's pretty simple! You just need to add a few lines into your existing JSON model files.
{
// ...
"arm_properties": {
"held_mainhand": {
"right_arm": { // Adjust the right arm
"pitch": -0.95, // Any float value is valid
"yaw": -0.39, // Here too
"roll": 0.0,
"follow_sight": false // Optional - Whether this arm will move according to the holder's sight (Think bows and crossbows)
},
"left_arm": { // Left arm too
"pitch": -0.90,
"yaw": 0.39,
"roll": 0.0,
"follow_sight": false
}
},
"held_offhand": { // Also off hand
"right_arm": { // Adjust the right arm
"pitch": -0.95, // Any float value is valid
"yaw": -0.39, // Here too
"roll": 0.0,
"follow_sight": false // Optional - Whether this arm will move according to the holder's sight (Think bows and crossbows)
},
"left_arm": { // Left arm too
"pitch": -0.90,
"yaw": 0.39,
"roll": 0.0,
"follow_sight": false
}
}
// If any field above (except for "follow_sight") is presented,
// the game will not try to adjust the model with vanilla mechanics.
// You'd better configure both pitch and yaw for each arm at the same time.
}
}
JSON does not support comments, you'll need to remove the comments before you put them into a real JSON file!
Available Versions
How to Install Flexible Arms on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set quilt Loader
In the panel under "Egg", select the quilt loader and matching Minecraft version (1.20.1).
Install Mod
Open the mod browser in the dashboard and search for "Flexible Arms". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.20.1, 1.20
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Flexible Arms server crashes on startup – what to do?
Most common cause: wrong quilt version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.20.1). You can switch loaders with one click in the panel.
Is Flexible Arms compatible with quilt?
Flexible Arms officially supports quilt for Minecraft 1.20.1, 1.20. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Flexible Arms – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Flexible Arms consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Flexible Arms with just one click on your server.