InvKeeper - The Complete Solution for Server Inventory Protection

# ✨ InvKeeper - The Complete Solution for Server Inventory Protection

Hi everyone! Let me introduce **InvKeeper**, a Paper 1.21 plugin that gives you fine-grained control over inventory and experience loss on death.

---

## Key Features

### 1. Customizable Drop Protection System
- **Per-world settings**: Set different inventory/experience loss rates for each world
- Example: 0% drop in a peaceful town world, 50% drop in a dangerous dungeon
- **Permission-based tier system**: 11 tiers of permissions from `invkeeper.drop.1` to `invkeeper.drop.11`, letting you apply different rules per server rank
- Regular users → `invkeeper.drop.1` (default drop rate)
- VIP → `invkeeper.drop.5` (50% reduction)
- Admins → `invkeeper.drop.11` (full protection)
- **Protection items**: Consumable items that provide 100% inventory protection
- **Timed protection charms**: Automatically protect your inventory for a set duration

### 2. Soulbind System
- **Item binding**: Bind items so only their owner can use them
- **3 bind types**:
- ⏰ **Timed bind**: Automatically removed after a set time
- **Stack-based bind**: Persists for a limited number of uses (decremented on death)
- ♾️ **Infinite bind**: Permanently bound
- **Unbind tool**: A tool admins can use to remove a bind
- **Automatic protection**: Bound items cannot be picked up or moved by anyone else
- **Lore display**: Bind information is automatically shown on the item

### 3. Full MMOItems Integration
- MMOItems items can also be protected and soulbound
- Register your custom items as protection items
- Soulbind tools can also be crafted as MMOItems

### 4. Quality-of-Life Features
- **bStats integration**: Automatically collects server usage statistics
- **Tab completion**: Permission-filtered tab completion for commands
- **Real-time notifications**: Shows the actual loss percentage on death
- **Fully configurable messages**: All in-game text can be customized

---

## Recommended For

✅ **Survival/RPG servers** - if you want to flexibly tune death penalties
✅ **PVP servers** - if you need loot protection and item binding
✅ **MMOItems servers** - if you need a protection system that integrates with MMOItems
✅ **Economy servers** - if you want to use soulbind tools as economy items
✅ **Hardcore servers** - if you want fine-grained control over inventory loss on death

---

## Commands

```
/invkeeper status - Check your protection status
/invkeeper reload - Reload configuration (admin)
/invkeeper give - Give an item (admin)
/invkeeper soulbind - Manage soulbinds (admin)
```

**Alias**: `/ik` (e.g. `/ik status`)

---

## Permission System

### Basic Permissions
- `invkeeper.status` - Check your own protection status (default: true)
- `invkeeper.admin` - Admin permission (default: op)

### Drop Rule Tiers (11 levels)
- `invkeeper.drop.1` through `invkeeper.drop.11` - Apply drop rules by server rank
- Higher numbers mean more protection (11 = full protection)
- Each tier's drop rate can be configured in config.yml

### Soulbind Permission
- `invkeeper.soulbind.bypass` - Can pick up soulbound items regardless of owner (default: false)

---

## ⚙️ Example Configuration

### config.yml
```yaml
rules:
world:
default:
inventory-drop-percent: 50
exp-drop-percent: 50
spawn:
inventory-drop-percent: 0
exp-drop-percent: 0
permissions:
- permission: invkeeper.drop.11
priority: 100
inventory-drop-percent: 0
exp-drop-percent: 0
- permission: invkeeper.drop.5
priority: 50
inventory-drop-percent: 20
exp-drop-percent: 20
```

### Granting Permissions
```
# Regular user
/lp user <player> permission set invkeeper.drop.1

# VIP
/lp user <player> permission set invkeeper.drop.5

# Admin
/lp user <player> permission set invkeeper.drop.11
```

---

## Installation

1. Set up a Paper 1.21.x server
2. Download `InvKeeper-1.3.5-shaded.jar`
3. Place it in your server's `plugins` folder
4. Restart the server
5. Edit the config files generated in `plugins/InvKeeper/`
6. Apply the settings with `/invkeeper reload`

---

## Download

- **Current version**: v1.3.5
- **Compatible with**: Paper 1.21.x
- **Java version**: Java 21
- **Required dependency**: Paper API
- **Optional dependencies**: MMOItems 6.9.5+, MythicLib 1.6.2+

---

## Version History

- **v1.3.5** (2026-07-26) - Permission-filtered tab completion
- **v1.3.4** (2026-07-26) - bStats integration, reload summary log, item name display
- **v1.3.3** (2026-07-25) - Fixed a bug with stack-based soulbind protection on death
- **v1.3.1** (2026-07-25) - Improved stack-based soulbind protection logic

---

## Contact & Support

- **GitHub**: https://github.com/qlqo0001-beep/InvKeeper
- **Issues**: Bug reports and feature requests
- **License**: MIT License

---

## Feature Summary

✓ Supports the latest Paper 1.21.x
✓ Fully customizable messages
✓ MMOItems integration
✓ 11-tier permission system
✓ Timed, stack-based, and infinite soulbind support
✓ Fine-grained per-world/per-permission configuration
✓ bStats metrics
✓ Actively maintained with regular bug fixes

---

**Make your server stand out with InvKeeper!**

---

*This plugin uses the Paper API and supports integration with MMOItems.*