Parallel Inventory Plugin

A unique Minecraft plugin that gives each player two parallel inventories with tactical switching mechanics.

Features

Core Concept

Each player has two separate inventories that exist in parallel:

• Normal Inventory - Your default inventory
• Mirror Inventory - Your secondary inventory

You can switch between these inventories based on configurable triggers, creating unique tactical gameplay possibilities.

Switching Triggers

1. Death Trigger

When enabled, players switch to their mirror inventory on death instead of dropping items. This creates strategic gameplay where:

• You can prepare a "death loadout" in your mirror inventory
• Items from your normal inventory are preserved
• No items are dropped on death

2. World Change Trigger

Automatically switch to mirror inventory when entering specific worlds (e.g., Nether, End, custom worlds).

3. Manual Switch

Players can manually switch between inventories using /parallel switch command with configurable cooldown.

4. Region-Based (Coming Soon)

Switch inventories when entering specific regions (requires WorldGuard).

Configurable Options

All features are fully configurable in config.yml:

• Triggers: Enable/disable death switching, world-based switching, manual switching
• Item Handling:
  • Preserve items when switching
  • Optionally sync armor, offhand, experience, health, and hunger between inventories
• Death Handling:
  • Keep experience on death
  • Control respawn behavior
  • Auto-switch back after respawn
• Effects:
  • Custom sounds and particles when switching
  • Customizable messages
• Storage: YAML-based storage (MySQL/SQLite support coming soon)
• Cooldowns: Prevent spam-switching with configurable cooldowns

Commands

Command	Description	Permission
/parallel switch	Switch between normal and mirror inventory	parallel.switch
/parallel info	Check which inventory you're currently using	parallel.use
/parallel reset <normal|mirror>	Reset an inventory	parallel.reset
/parallel reload	Reload the configuration	parallel.reload
/parallel help	Show help message	parallel.use

Command Aliases

• /pi
• /parallelinv

Permissions

Permission	Description	Default
parallel.*	Access to all commands	OP
parallel.use	Basic command access	All players
parallel.switch	Manually switch inventories	All players
parallel.reset	Reset inventories	OP
parallel.reload	Reload configuration	OP

Installation

1. Download the latest release
2. Place the JAR file in your server's plugins folder
3. Restart your server
4. Configure the plugin in plugins/Parallel/config.yml
5. Use /parallel reload to apply changes

Configuration Example

# Enable death switching
triggers:
  on-death: true
  manual-switch:
    enabled: true
    cooldown: 30

# Keep items when switching
item-handling:
  preserve-items: true
  sync-armor: false
  sync-experience: false

# Death behavior
death-handling:
  switch-on-death: true
  keep-experience: true
  respawn-with-mirror: true

Use Cases

1. PvP Arenas

• Normal inventory: Your regular gear
• Mirror inventory: PvP-specific loadout
• Switch automatically when entering arena worlds

2. Resource Gathering

• Normal inventory: Combat gear
• Mirror inventory: Mining/farming tools
• Manually switch based on activity

3. Death Protection

• Normal inventory: Valuable items
• Mirror inventory: Backup gear
• Automatically switch on death to preserve valuables

4. Role-Based Gameplay

• Different inventory setups for different roles
• Quick switching for multi-role players

Technical Details

• API Version: 1.21+
• Storage: YAML (default), SQLite and MySQL support planned
• Auto-save: Configurable interval (default: 5 minutes)
• Thread-safe: Asynchronous storage operations
• Data persistence: Player data saved on quit and server shutdown

Building from Source

git clone https://github.com/cynive/Parallel.git
cd Parallel
mvn clean package

The compiled JAR will be in the target folder.

Support

For issues, feature requests, or questions:

• Open an issue on GitHub
• Join our Discord server
• Check the wiki for detailed documentation

License

This project is licensed under the MIT License.

Credits

Created by Cynive