Synced Inventory Mode

​

Overview

• All players share the same 41 inventory slots (main, hotbar, armor, offhand)
• Changes by one player instantly sync to all other players
• Only one “master” inventory exists - preventing duplication exploits
• In Manhunt mode, only Runners share inventory (Hunters are independent)

​

How to Enable

1. Run /chaos to open the Chaos Modes GUI
2. Click on the Chest/Copper Chest icon (“Synced Inventory”)
   • Chest = Disabled
   • Copper Chest = Enabled (dark aqua color)
3. Click the emerald “Confirm” button
4. Start a new run with /start

​

Gameplay Impact

​

Shared Inventory Slots

• 9 hotbar slots (bottom row)
• 27 main inventory slots (3 rows above hotbar)

• 4 armor slots (helmet, chestplate, leggings, boots)
• 1 offhand slot

​

Strategic Opportunities

​

Challenges and Risks

​

Advanced Mechanics

​

Master Inventory System

private static final List<ItemStack> master = new ArrayList<>(41);

1. One player modifies their inventory
2. Their inventory is copied to the master
3. Master is applied to all other players
4. All players see the same items instantly

​

Synchronization Process

1. Detection: System detects inventory slot change via mixin
2. Copy Phase: Changed player’s full inventory copied to master
3. Apply Phase: Master inventory applied to all other participating players
4. Sync Guard: isSyncing flag prevents infinite loops during application

public static void syncFromPlayerToAll(ServerPlayerEntity sourcePlayer) {
    isSyncing = true;
    try {
        copyFromPlayer(sourcePlayer);  // Source → Master
        
        for (ServerPlayerEntity player : server.getPlayerManager().getPlayerList()) {
            if (player != sourcePlayer && shouldParticipate(player)) {
                applyToPlayer(player);  // Master → Others
            }
        }
    } finally {
        isSyncing = false;
    }
}

​

Late Joiners

• New player receives a copy of the current master inventory
• They immediately sync with existing players
• No items are duplicated during the sync

​

Participation Rules

• All players in a standard Soul Link run
• Runners in Manhunt mode

• Hunters in Manhunt mode (they have independent inventories)
• Players not in the run
• Spectators

private static boolean shouldParticipate(ServerPlayerEntity player) {
    if (!Settings.getInstance().isSyncedInventory()) return false;
    if (!runManager.isPlayerInRun(player)) return false;
    
    // Exclude hunters in Manhunt
    if (Settings.getInstance().isManhuntMode() 
            && ManhuntManager.getInstance().isHunter(player)) {
        return false;
    }
    return true;
}

​

Strategy Guide

​

Resource Management

​

Division of Labor

• Focuses on gathering resources
• Wears mining gear (efficiency, fortune)
• Manages pickaxes and shovels

• Handles combat encounters
• Equips combat armor and weapons
• Manages food consumption

• Places blocks and builds structures
• Uses building blocks from shared inventory
• Manages scaffolding and ladders

• Sorts items in inventory
• Crafts needed items
• Manages inventory space

​

Dangerous Situations

​

Combat Implications

​

Shared Equipment

• Changing armor affects everyone’s defense rating
• Swapping to sword removes tools from others
• Using up durability impacts all players
• Death drops affect the entire shared inventory

1. Designate one “fighter” who controls combat gear
2. Others stay in safe locations during fights
3. Coordinate armor changes before engaging
4. Keep backup weapons in multiple slots

​

Technical Details

​

Thread Safety

synchronized (master) {
    for (int i = 0; i < size; i++) {
        ItemStack stack = inv.getStack(i);
        master.set(i, stack.isEmpty() ? ItemStack.EMPTY : stack.copy());
    }
}

​

Error Handling

• Individual slot failures don’t crash the sync
• Invalid players are skipped
• Removed/dead players are ignored
• Errors are logged but don’t stop the system

​

Reset Behavior

• Master inventory is cleared (all slots set to EMPTY)
• Sync flag is reset
• Players return to normal inventory mechanics

​

Manhunt Mode Interaction

• Runners share inventory with each other
• Hunters each have independent inventories
• Hunters can’t see or access Runner inventory
• This gives Runners coordination advantage but also coordination burden

​

Known Limitations

• Only works in the run world (temporary dimensions)
• Doesn’t sync to players outside the run
• Inventory size fixed at 41 slots (can’t expand)
• No individual “personal” slots

• Crafting table input slots
• Furnace/chest contents
• Ender chest contents (use for personal storage!)
• Cursor item during GUI interactions

​

Related Modes