QuickLoadout

🎒 QuickLoadout

Save up to 4 hotbar layouts and get them back with a single key.

Building, fighting, farming, exploring: each needs a different hotbar. Set it up once, save it, and from then on QuickLoadout pulls the right items out of your inventory and puts every one of them back in its slot. If something is missing, it tells you exactly what.

✨ Features

• 💾 4 loadouts: save the current hotbar with L + 1 / 2 / 3 / 4
• ⚡ One key recall: L + F1 / F2 / F3 / F4 rebuilds the saved hotbar from your inventory (main inventory, other hotbar slots and offhand)
• 📦 No fixed amounts: saved 28 bread and ate 2? The 26 you have go back in the slot, no complaints
• 🧹 Empty slots stay empty: slots that were empty when you saved are cleared into your inventory
• 📝 Clear missing list: items you don't have at all are shown above the hotbar with their real name, e.g. » ʟᴏᴀᴅᴏᴜᴛ 1 ʀᴇᴄᴀʟʟᴇᴅ, ᴍɪꜱꜱɪɴɢ: ᴅɪᴀᴍᴀɴᴛᴇ, ɢᴏʟᴅᴇɴ ᴀᴘᴘʟᴇ. Renamed items show their custom name
• 🎨 Clean messages: small caps text. Saving writes one line in chat, switching loadouts never spams the chat: it only uses the line above the hotbar
• 🔍 Smart matching: a worn sword is still your sword, and server items like guns with changing ammo or lore are still found by their name
• 🌐 Works on any server: it only uses normal inventory clicks, the same a player makes by hand. Nothing to install on the server
• ⚙️ QuickLoadout Settings button in the Options screen, with all the keys of the mod. They are also in Controls → Key Binds → Hotbar Settings
• 🇬🇧 English and 🇮🇹 Italian: messages follow your game language

🎮 How to use

1. Arrange your hotbar the way you like it
2. Hold L and press 1: Hotbar saved to loadout 1
3. Play, mess up your inventory, put things away
4. Hold L and press F1: everything goes back to its place

⌨️ About the keys

Vanilla already uses some of these keys, so QuickLoadout takes care not to break them:

• F1 (hide HUD) and F3 (debug screen) keep working. The F keys only recall a loadout while you hold the modifier (L). When they do, the press never reaches vanilla, so the HUD doesn't disappear and the debug screen doesn't open
• Tapping L still opens Advancements. L is only used as a modifier: if you release it without pressing a loadout key, the game gets the L press as usual
• 1-4 still select the hotbar slots, unless L is held
• If you prefer F1-F4 alone, set Recall: Modifier key (hold) to Not bound (press Esc while changing it). F1-F4 will then always recall loadouts and no longer hide the HUD or open the debug screen
• Shift, Ctrl and Alt work fine as modifiers too and are never held back

🔍 How items are matched

The amount never matters: whatever stack you have goes in the slot. For each slot QuickLoadout looks for the closest item it can find:

1. Identical item
2. Same item, ignoring what changes with use: durability, anvil repair cost, shulker box / bundle contents, a loaded crossbow's arrow
3. Same item with the same name, even if lore, enchantments or server data (ammo, serial numbers...) changed
4. A custom-named server item with the same name, even if its base item changed

A diamond renamed "diamante" never replaces a plain Diamond. When there are several candidates, the main inventory is preferred over other hotbar slots, then the biggest stack.

📌 Good to know

• Loadouts are saved in config/quickloadout.json and shared by all worlds and servers
• Slots that were empty when you saved are moved into your inventory. Items are never dropped: if the inventory is full they stay where they are
• Recall only works with no screen open (not while typing in chat or with the inventory open)
• Client-side only. Works in singleplayer and on any server (vanilla, Paper, Spigot...)

📋 Requirements

• Minecraft 1.21.8 - 1.21.11 (one jar for all)
• Fabric Loader and Fabric API