Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/VazkiiMods/Quark/llms.txt

Use this file to discover all available pages before exploring further.

Quark’s Management category groups every feature that touches how you organise, move, and interact with items. From a single-click sort button to a multi-row hotbar selector, these modules are designed to remove friction from everyday inventory work without altering game balance.

​
Inventory Sorting

A small sort button appears in every inventory and container screen. Clicking it rearranges items into a logical order: food together, tools together, blocks together, and so on. A satisfying click sound plays when sorting via keybind (configurable).
1

Open an inventory or chest

Open your player inventory, a chest, a barrel, or any other supported container.
2

Click the sort button

A small sort icon appears near the player inventory section and, when inside a chest-type container, near the container inventory as well. Click the appropriate button to sort that side.
3

Result

Items are grouped by type and sorted within each group. Stacks of the same item are automatically merged before sorting.
You can also sort with a keybind rather than clicking the button. Assign Sort Player Inventory and Sort Container in Controls → Quark Inventory. The keybind plays the click sound if the Satisfying Click option is on.
Configuration options
OptionDefaultDescription
Enable Player InventorytrueSort button appears on the standalone player inventory screen
Enable Player Inventory in CheststrueSort button appears on the player half while a chest is open
Enable CheststrueSort button appears on the container half of chest-type screens
Satisfying ClicktruePlays a UI click sound when sorting via keybind
Locked slots Menus can implement ISortingLockedSlots (from the Quark API) to mark specific slots as exempt from sorting. For example, a modded crafting station can protect its output slot so items are never shuffled there. Modder API — ICustomSorting Items can implement org.violetmoon.quark.api.ICustomSorting to control exactly how they are compared during a sort: 
public interface ICustomSorting {
    // Returns a Comparator used to order items within the same category
    Comparator<ItemStack> getItemComparator();

    // Items share a category bucket before being compared
    // Prefix with your mod ID to avoid collisions
    String getSortingCategory();
}
See the API Interfaces reference for the full contract.

​
Easy Transferring

Easy Transferring adds Insert and Extract buttons to any container screen, making it trivial to move an entire inventory between your player and a chest in one click.
  • Insert — moves matching items from your player inventory into the open container.
  • Extract — moves all items from the container into your player inventory.
  • Shift + Insert / Extract — performs a filtered transfer, moving only items that already exist on the destination side (useful for topping up a chest without filling it with unrelated things).
A Shift Lock button can be toggled to keep Shift active permanently so every transfer automatically uses the filtered mode. The lock state is shown visually on the button.
The Insert keybind is unbound by default. Assign it under Controls → Quark Inventory to transfer without taking your hands off the keyboard.
Modder API — ITransferManager Block entities that want to receive Easy Transferring buttons can implement org.violetmoon.quark.api.ITransferManager or provide it as a NeoForge capability: 
public interface ITransferManager {
    boolean acceptsTransfer(Player player);

    // Override to supply a custom IItemHandler for the transfer
    default IItemHandler getTransferItemHandler(Supplier<IItemHandler> defaultSupplier) {
        return defaultSupplier.get();
    }
}
See API Interfaces for full details.

​
Automatic Tool Restock

When a tool in your hand breaks, Quark automatically pulls a replacement from your inventory and places it in the same hotbar slot — so you never have to stop mid-activity to swap tools manually. How replacement is chosen (in priority order)
  1. Enchantment match — looks for a tool of the same type that shares the same important enchantments (Silk Touch, Fortune, Infinity, Luck of the Sea, Looting by default). Configurable.
  2. Exact item match — finds a copy of the exact same item.
  3. Loose match — finds any tool in the same class (axe, pickaxe, shovel, hoe, sword, shears, fishing rod, bow, or crossbow). Enabled by default; disable with Enable Loose Matching.
If the Backpack module is enabled and you are wearing a Backpack, the restock search also crawls the backpack’s inventory. Configuration
OptionDefaultDescription
Important EnchantmentsSilk Touch, Fortune, etc.Enchantments that earn priority in replacement searches
Enable Loose MatchingtrueReplace with any tool of the same class, not just the identical item
Enable Enchant MatchingtruePrefer replacements that share important enchantments
Allow Pulling from HotbarfalseAllow one hotbar slot to be restocked from another hotbar slot
Unstackables OnlyfalseOnly auto-restock items that don’t stack (tools, not torches)
Ignored Itemsquark:trowel, some Botania rodsItems that should never trigger a restock
This module has antiOverlap = "inventorytweaks", so it automatically disables itself when Inventory Tweaks (or a compatible alternative) is installed to avoid conflicts.

​
Quick Armor Swapping

Quick Armor Swapping lets you swap your entire equipped armor set with a set on an Armor Stand by sneaking and right-clicking the stand. Every slot (head, chest, legs, feet) is exchanged simultaneously.
  • If the Armor Stand is holding a piece in a slot where your matching slot is empty, that piece is moved to you instead.
  • Items with Curse of Binding are never swapped off the player; they are skipped.
  • The off-hand slot is also swapped by default (configurable via Swap Off Hand).
  • Works only in Survival/Adventure mode — spectators and creative players are excluded.

​
Hotbar Changer

The Hotbar Changer lets you switch your active hotbar row among three saved hotbar profiles without opening your inventory. Press the Change Hotbar key (default Z) to reveal a semi-transparent overlay showing all three rows of your inventory (rows 2, 3, and 4). While the overlay is open, press a number key 1, 2, or 3 to swap that inventory row into your active hotbar.
  • The switch is animated with a configurable slide-in animation (default 7 ticks).
  • The overlay shifts the XP bar and other HUD elements upward so they don’t overlap.
  • Closing the overlay or pressing another action key dismisses the menu.
  • Spectator mode automatically closes the overlay if it was left open.
The default key Z can conflict with other mods. Reassign it under Controls → Quark Misc if needed.

​
Item Sharing

Item Sharing lets players broadcast a held item to the chat so other players can see exactly what it is — including a miniature item icon rendered inline in the chat message. How to share an item Hold Shift and press your Chat key while hovering over an item slot in any container screen. The item is shared to public chat with its full name and a small inline sprite.
  • Hovering over a shared item name in chat shows the full item tooltip.
  • The server enforces a cooldown (default 100 ticks / 5 seconds) between shares per player to prevent spam.
  • The client also enforces its own cooldown to avoid accidental double-sends.
  • Set Render Items in Chat to false to show plain text item links without the inline sprite.
Sharing works from any container screen — chests, crafting tables, your player inventory — as long as you aren’t focused in a text box.

​
Expanded Item Interactions

Expanded Item Interactions adds several quality-of-life right-click shortcuts directly in inventory screens. Armor right-click equip Right-click an armor piece (or Elytra) in any inventory slot while your cursor is empty to instantly equip it. If you were already wearing armor in that slot it is swapped out. Curse of Binding prevents items from being removed this way. A yellow tooltip hint confirms the action is available. Shulker Box interactions
  • Right-click a Shulker Box with an item — inserts the held item stack into the shulker box if there is room. A tooltip indicates the insertion or a merge (when one shulker is dragged onto another of the same type).
  • Right-click a Shulker Box with an empty cursor — opens the shulker box as a mini-inventory directly in the slot without placing the box. Only works from your player inventory while no other container is open.
  • Drag one Shulker Box onto another — merges items from the dragged box into the target box wherever there is available space.
Lava Bucket trash Right-click a Lava Bucket slot with a held item to destroy the held item (simulating throwing it into lava). This does not work on fire-resistant items or on shulker boxes, and respects slot restrictions. A red “Trash Item” tooltip warns you before committing. Bundle scroll Hover over a Bundle in any inventory and scroll the mouse wheel to rotate the items inside it, cycling which item is displayed and will be extracted first. Works with all bundles in any container screen.

Build docs developers (and LLMs) love

Get started for freeTalk to us