KeepInventoryShop

!(https://cdn.modrinth.com/data/cached_images/653554537259c0f3ab5b72794bc0e8f3b798b40e.png) # KeepInventoryShop

The ultimate solution for balancing the vanilla Minecraft survival experience with player convenience. Some players prefer the authentic survival aspect where `/gamerule keepInventory` is false, but this can be punishing for less experienced players who struggle with losing their hard-earned items. KeepInventoryShop bridges that gap!

## Key Features: - Balance and Authenticity: Preserve the vanilla experience with keepInventory set to false while eliminating the frustration of lost drops. - Player Convenience: Empower players of all skill levels with the ability to purchase or earn KeepInventory lives, ensuring their valuable items are always protected. - Elevate Your Gameplay: Add an exhilarating layer of strategic resource management where players protect their inventory and stay in control of their survival. - KeepTotem Upgrades: Upgrade normal lives to KeepTotem lives. When you would die, you're saved with full health, potion effects, and a flashy totem animation! - Multi-Currency Support: Players can pay with server economy, emeralds, or XP levels. Server owners configure exchange rates in the config, and players select their preferred currency in the GUI. - Play-Time Timer System: Reward active players with free lives after a configurable amount of play time. Timer pauses on disconnect and resumes when they rejoin. - Interactive GUI Shop: Beautiful inventory-based menus for buying lives, upgrading to KeepTotem, and admin management. No commands needed! - Fully Customizable Messages: Every player-facing message can be customized via `messages.yml` with full color code support and placeholders. - Smart Totem Detection: KeepTotem respects real Totems of Undying. If you're holding one, it activates first before consuming KeepTotem lives. - Gamerule Aware: If the `keepInventory` gamerule is enabled, the plugin won't waste your lives. Vanilla handles it automatically. - Customization at its Finest: Fine-tune initial lives, costs, timer duration, currency values, messages, and more for a tailored gameplay experience.

!(https://cdn.modrinth.com/data/cached_images/a3b1d73a83d7f61dc19899e2a459219feb9b420e.png)

## Dependencies: - Required: Vault, Economy Plugin (EssentialsX, CMI, or any Vault-compatible economy) - Optional: WorldGuard, PlaceholderAPI, ProtocolLib

## Configuration:

### config.yml - `initial-lives`: Lives players receive when joining for the first time. - `use-timer`: Enable/disable the play-time timer. - `timer-lives`: Lives awarded when the timer fires. - `timer-duration`: Seconds of play time before awarding lives. - `cost-per-life`: Cost of a single KeepInventory life (in money). - `cost-per-upgrade`: Cost of a single KeepTotem upgrade (in money). - `use-region`: Enable WorldGuard region support.

Alternative Currency Options: - `allow-emerald-payment`: Allow players to pay with emeralds (true/false). - `allow-xp-payment`: Allow players to pay with XP levels (true/false). - `emerald-value`: How much money 1 emerald is worth (e.g., 100 means 1 emerald = $100). - `xp-level-value`: How much money 1 XP level is worth (e.g., 50 means 1 level = $50).

### messages.yml Customize all player-facing messages with color codes (`&a`, `&c`, `&d`, etc.) and placeholders: - `{amount}` - number of lives - `{lives}` - "life" or "lives" - `{player}` - player name - `{cost}` - formatted cost - `{balance}` - player's balance - `{remaining}` - remaining lives - `{time}` - formatted time

## Commands: - /keepinventory or /ki: Opens the GUI shop. - /keepinventory lives : View your lives or another player's. - /keepinventory buy \: Buy lives via command. - /keepinventory upgrade \: Upgrade lives to KeepTotem. - /keepinventory set \ \: Set a player's lives. - /keepinventory add \ \: Add lives to a player. - /keepinventory remove \ \: Remove lives from a player. - /keepinventory help: Show help. - /keepinventory reload: Reload configuration and messages.

## Permissions: - keepinventoryshop.set: Set lives for others. Default: OP - keepinventoryshop.add: Add lives to others. Default: OP - keepinventoryshop.remove: Remove lives from others. Default: OP - keepinventoryshop.view.others: View other players' lives. Default: OP - keepinventoryshop.reload: Reload configuration. Default: OP - keepinventoryshop.limit.\: Cap normal lives for a permission group. - **keepinventoryshop.limitupgrade