NPEnderChest

# NPEnderChest > **Multi-page Ender Chest with progression (levels, money, items, permissions)** --- ## 🎯 What is this? **NPEnderChest** replaces the vanilla Ender Chest with an **evolutive multi-page chest**. Players unlock additional pages by progressing through: - 📈 **Player level** (vanilla or MMOCore class level) - 💰 **Money** (Vault economy) - 📦 **Materials** (vanilla items) - 🔑 **Permission** (LuckPerms/Vault rank) > **Requires**: **[NorrionProjectPluginCore](https://modrinth.com/project/npplugincore)** + **Vault** (economy) > **Optional**: **MMOCore**, **ProtocolLib** --- ## ✨ Features ### 📄 Unlimited & Configurable Pages - Page 0 = Vanilla Ender Chest (always accessible) - Pages 1, 2, 3… = bonus pages, each with its own requirements - Custom GUI: ◀ ▶ navigation, per-page title ### 🎯 Combinable Requirements per Page/Slot | Type | Example | Integration | |------|---------|-------------| | Vanilla level | `level: 15` | Native | | MMO class level | `mmo-level: 10` | **MMOCore** | | Money | `money: 25000` | **Vault** | | Permission | `permission: "norrion.enderchest.page2"` | Native | | Vanilla items | `DIAMOND:5, NETHERITE_INGOT:2` | Native | > A single slot can require **multiple** conditions at once (e.g., level 20 **AND** $10k **AND** 5 Diamonds). ### 🎨 100% Configurable GUI - **Item names** for navigation, locked, purchasable states - **Lore (tooltips)** with variables: `{cost}`, `{material}`, `{level}`, `{mmo-level}`, `{permission}`, `{icon}` - **Display materials** (Emerald = purchasable, Redstone = locked, Barrier = purchased) - **Custom page titles** ### 💾 Persistent Storage - Unlocked pages per player (UUID) - Survives restarts - YAML storage (default) or SQL (via PluginCore) ### 🌍 Multilingual - English / French included - Easy to add more languages --- ## 📦 Installation ### Required 1. **[NorrionProjectPluginCore](https://modrinth.com/project/npplugincore)** 2. **Vault** + an economy plugin (EssentialsX, CMI, etc.) ### Optional (for advanced features) - **MMOCore** — Class/profession levels - **ProtocolLib** — Smoother inventory handling ### Steps 1. `NPEnderChest-.jar` → `plugins/` 2. Restart 3. Configure `plugins/NorrionProject/ender-chest-config.yml` 4. Restart --- ## ⚙️ Configuration ### `config.yml` — Pages & Requirements All documentation is provided in `plugins/NorrionProject/ender-chest-config.yml` ### Variables available in `lore` | Variable | Displays | |----------------|-----------------------------------------------| | `{cost}` | Formatted price (e.g., `§7Cost: §a5,000 §6€`) | | `{material}` | Required items with icons | | `{level}` | `§7Level §e10 §7required` | | `{mmo-level}` | `§7MMO Level §e5 §7required` | | `{permission}` | `§7Permission: §enorrion.enderchest.page2` | | `{icon}` | Requirement type icon (configurable) | --- ## 🎮 Player Usage 1. **Open**: Right-click an Ender Chest **or** command `/enderchest` 2. **Navigate**: Click `§e▸ Next Page` / `§e▸ Previous Page` 3. **Unlock**: Click a locked slot - If requirements met → becomes ✅ purchasable - Otherwise → shows what's 🔴 missing 4. **Enjoy**: New storage space unlocked! --- ## ❓ FAQ **Q: How to reset a player's progress?** A: Delete their file in `plugins/NorrionProject/enderchest/data/.yml` (or SQL entry). **Q: Works with player-placed Ender Chests?** A: Yes, right-click any Ender Chest opens the custom GUI. **Q: Conflict with another Ender Chest plugin?** A: Disable the other. NPEnderChest takes full control of Ender Chest opening. --- ## 🔗 Useful Links - **Website & Wiki**: [norrion.eu](https://norrion.eu) - **Support / Bugs**: [Norrion Discord](https://discord.gg/WHUZNQe) --- *Plugin **NorrionProject** — Requires NorrionProjectPluginCore + Vault — Optional: MMOCore, ProtocolLib*