NPParties

# NPParties > **Full GUI for the Parties plugin — Lists, info, invites, management** --- ## 🎯 What is this? **NPParties** adds **beautiful graphical interfaces (GUIs)** to the **[Parties](https://github.com/AlessioDP/Parties)** plugin by AlessioDP. No more unreadable chat commands — your players manage parties visually: - 📋 **Party List** — Browse, filter, join - 👥 **Party Info** — Members, locations, classes, levels - ✉️ **Invitations** — Click to invite, no more `/party invite username` - 🚪 **Leave / Kick / Disband** — With visual confirmation (anti-mistake) > **Requires**: **[NorrionProjectPluginCore](https://modrinth.com/project/npplugincore)** + **Parties** (main plugin) > **Optional**: **MMOCore** (shows classes/levels) --- ## ✨ Features ### 📋 "Party List" Inventory - **Smooth pagination** (◀ Previous / ▶ Next) - Each party = 1 clickable item showing: - Party name - 👥 Online / max members (e.g., `3/8`) - 🟢 Players online - 👑 Party leader - Click → opens **Party Info** ### 👥 "Party Info" Inventory Detailed view of all members: | Info shown | Source | |------------|--------| | Username + prefix/suffix | LuckPerms/Chat | | 📍 Location (world, X, Y, Z) | Real-time | | 🟢 Online since / 🔴 Offline since | Timestamp | | ⚔️ **MMO Class + Level** | **MMOCore** (if installed) | | 👑 Role (Leader, Officer, Member) | Parties API | **Actions by your role:** - **Leader / Officer**: Right-click member → **Kick** (with confirmation) - **Member**: `§cLeave Party` button → Confirmation → Leaves - **Leader**: `§cLeave Party` button → Choose "Disband Party" → Confirmation → Deletes party ### ✉️ Simplified Invites 1. Open **your** Party Info 2. Click `§aInvite Player` 3. Type username in chat 4. Invitation sent automatically via Parties API ### 🛡️ Visual Confirmations (anti-accidental click) - **Leave** → Clickable confirmation message `[§cLeave Party§r]` - **Disband** → Confirmation `[§cDisband Party§r]` - **Kick** → Right-click → Confirmation message - Player must **click the message** to confirm — impossible to leave/disband by accident ### 🌍 Multilingual - English / French included - All GUI text, messages, confirmations translatable --- ## 📦 Installation ### Required 1. **NorrionProjectPluginCore** 2. **Parties** by AlessioDP — [Download](https://github.com/AlessioDP/Parties/releases) ### Optional - **MMOCore** — Automatically shows class + MMO level of members ### Steps 1. `NPParties-.jar` → `plugins/` 2. Verify **Parties** is installed and working 3. Restart server 4. **No config required** — works out of the box! --- ## ⚙️ Configuration (`config.yml`) All documentation is provided in `plugins/NorrionProject/parties-config.yml` --- ## 🎮 Player Usage | Action | How to do it | |--------|--------------| | **View parties** | `/party list` (Parties command) → GUI opens | | **Create party** | In List GUI → Click `§aCreate Party` → Type name | | **Invite** | In Info GUI → Click `§aInvite Player` → Type username | | **View party info** | Click a party in List → Info GUI | | **Kick (leader/officer)** | In Info GUI → Right-click member → Confirm | | **Leave (member)** | In Info GUI → Click `§cLeave Party` → Confirm | | **Disband (leader)** | In Info GUI → Click `§cLeave Party` → Choose "Disband" → Confirm | --- ## 🔧 Commands All commands are provided by the **Parties** plugin. NPParties simply opens GUIs instead of text lists. Just do `/party` --- ## ❓ FAQ **Q: I don't have Parties installed, will it work?** A: **No**, NPParties is a **GUI layer** for Parties. Install Parties first. **Q: MMO classes not showing?** A: Verify **MMOCore** is installed and loads **before** NPParties. Restart if needed. **Q: Conflict with another Parties GUI plugin?** A: Disable the other. NPParties registers its own listeners on Parties events. --- ## 🔗 Useful Links - **Website & Wiki**: [norrion.eu](https://norrion.eu) - **Support / Bugs**: [Norrion Discord](https://discord.gg/WHUZNQe) --- *Plugin **NorrionProject** — Requires NorrionProjectPluginCore + Parties — Optional: MMOCore*