[Addon] BedWars1058 PrivateGames (PRO) | Better than any other addons

# BedWars1058 PrivateGames PRO

**The Ultimate Private Games & Party System for BedWars1058**

[](https://www.minecraft.net/)
[](https://www.spigotmc.org/)
[

A premium-grade plugin for Bedwars1058 party system, and other paid private games plugin's replacement. Built for server owners who demand quality, functionality, and player satisfaction.

---

## Features

### Full Party System
- **Create & Manage Parties** - Easy party creation with leader management
- **Invite System** - Send invites with cooldown protection
- **Kick Command** - Remove unwanted members (`/p kick <player>`)
- **Open/Close Parties** - Toggle public/private party access
- **Party Chat** - Private communication channel for party members
- **Join Open Parties** - Join parties without invites when open
- **Party List** - View all party members with online/offline status
- **Leadership Transfer** - Promote members to party leader

### Private Game Modes
- **Normal Mode** - Standard 4-player party cap
- **Private Mode** - Expanded 16-player cap for large private matches (`/p private`)
- **Smart Arena Detection** - Automatically prevents party members from joining public arenas in private mode

### Team Randomization System
**Leader-Chosen Mode Toggle:**
- **Together Mode** - Keep all party members on the same team when possible
- **Random Mode** - Distribute party members randomly across all available teams
- **4-Team Color Support** - Red, Blue, Green, Yellow maps
- **8-Team Color Support** - Red, Blue, Green, Yellow, Gray, White, Pink, Aqua maps
- **Dynamic GUI** - Visual team selection with player assignment

### Warp System
- **Auto-Warp** - Party members automatically warp when leader joins an arena
- **Manual Warp** - Use `/p warp` to bring all online party members to your arena
- **Smart Arena Check** - Only works when leader is already in an arena

### Duel System
- **Challenge Other Parties** - Send duel requests to other party leaders
- **Map Selection** - Choose specific maps or let the system pick randomly
- **Best of Series** - Support for BO3 and BO5 series (`/p duel <leader> bo3`)
- **Rematch System** - Quick rematch with previous opponents
- **Duel History** - Track wins/losses against other players

### Premium Admin Features
- **Admin Control Panel** (`/pgadmin`) - GUI for managing all active parties
- **Party Chat Spy** - Monitor party chats (admin permission)
- **Force Host** - Host games with all online players (admin only)

### Database & Persistence
- **SQLite Storage** - Persistent party data across server restarts
- **YAML Backup** - Secondary storage for reliability
- **Async Operations** - Non-blocking database operations for performance
- **Grace Period** - 5-minute rejoin window for disconnected party members

---

## Commands

### Party Commands (`/party` or `/p`)
| Command | Description | Permission |
|---------|-------------|------------|
| `/p create` | Create a new party | `pg.party.create` |
| `/p invite <player>` | Invite a player to your party | `pg.party.invite` |
| `/p accept` | Accept a pending invite | `pg.party.accept` |
| `/p deny` | Deny a pending invite | `pg.party.deny` |
| `/p leave` | Leave your current party | `pg.party.leave` |
| `/p kick <player>` | Kick a player from your party | `pg.party.kick` |
| `/p promote <player>` | Transfer party leadership | `pg.party.promote` |
| `/p list` | View all party members | `pg.party.list` |
| `/p join <leader>` | Join an open party | `pg.party.join` |
| `/p open` | Make party public | `pg.party.open` |
| `/p close` | Make party invite-only | `pg.party.close` |
| `/p host [map]` | Host a private game | `pg.party.host` |
| `/p warp` | Warp party to your arena | `pg.party.warp` |
| `/p private` | Toggle private mode (16 players) | `pg.party.private` |
| `/p duel <leader> [map] [bo3/bo5]` | Challenge another party | `pg.party.duel` |
| `/p chat <message>` | Send party chat message | `pg.party.chat` |
| `/p spy` | Toggle party chat spy | `pg.admin.spy` |
| `/p help` | Show help menu | Default |

### Admin Commands
| Command | Description | Permission |
|---------|-------------|------------|
| `/forcepg [map]` | Force host with all online players | `pg.forcehost` |
| `/pgadmin` | Open admin control panel | `pg.admin` |

---

## Permissions

```
pg.party.* - All party permissions
pg.party.create - Create parties
pg.party.invite - Invite players
pg.party.accept - Accept invites
pg.party.deny - Deny invites
pg.party.leave - Leave parties
pg.party.kick - Kick members
pg.party.promote - Promote members
pg.party.join - Join open parties
pg.party.list - View party list
pg.party.host - Host private games
pg.party.warp - Warp party members
pg.party.private - Toggle private mode
pg.party.duel - Send duel challenges
pg.party.chat - Use party chat
pg.forcehost - Force host command
pg.admin - Admin panel access
pg.admin.spy - Party chat spy
```

---

## Installation

1. **Requirements:**
- Spigot/Paper 1.8.8 or higher
- BedWars1058 v22.9 or higher
- Java 8 or higher

2. **Install:**
- Place `BedWars1058-PrivateGames.jar` in your `plugins/` folder
- Restart your server
- Configure `config.yml` and `messages.yml` as needed

3. **Configuration Files:**
- `config.yml` - Main configuration
- `messages.yml` - All messages and formatting
- `parties.yml` - Party data storage (auto-generated)
- `privategames.db` - SQLite database (auto-generated)

---

## Configuration

### config.yml
```yaml
cooldowns:
invite-seconds: 5
duel-seconds: 10

party:
max-size: 16
rejoin-grace-minutes: 5

sounds:
enabled: true

chat:
party-format: '&8[&bParty&8] &b{player}&8: &f{message}'
spy-format: '&8[&bSPY&8] &7{party} &b{player}&8: &7{message}'
```

### messages.yml
Fully customizable messages with color code support. All messages support placeholders like `{player}`, `{leader}`, `{count}`, etc.

---

## Team Randomization Examples

### Scenario 1: 4-Team Map (Red, Blue, Green, Yellow)
Party: Hyper (Leader), Bobby, Freddy
- **Random Mode:** Hyper → Red, Bobby → Blue, Freddy → Green
- **Together Mode:** All three → Same team (if capacity allows)

### Scenario 2: 8-Team Map (Red, Blue, Green, Yellow, Gray, White, Pink, Aqua)
Party: Hyper (Leader), Bobby, Freddy
- **Random Mode:** Hyper → Aqua, Bobby → White, Freddy → Green
- **Together Mode:** All three → Same team (if capacity allows)

### Scenario 3: Large Party on Solos Map
Party: 3 players on Solos map (1 player per team)
- System automatically distributes across available teams
- Prevents impossible team assignments

---

## Team Selection GUI

The plugin features an intuitive GUI for team selection:
- **Dynamic Team Display** - Shows all available teams on the selected map
- **Mode Toggle** - Switch between Together and Random modes
- **Randomize Button** - Auto-assign teams based on current mode
- **Individual Assignment** - Click team wool to assign specific players
- **Start Game** - Begin the private game when ready

---

## Statistics System (Coming Soon)

Track player performance:
- Wins/Losses
- Kills/Deaths (KDR)
- Games Played
- Beds Broken
- Duel History

*Note: Statistics require PlaceholderAPI for full functionality*

---

## Support & Documentation

- **SpigotMC:** N/A
- **Discord:** N/A
- **Wiki:** N/A
- **Developer:** Hypnr (discord: chearing)

---

## Premium Features Summary

✅ **Full Party Management** - Create, invite, kick, promote, warp
✅ **Dual Warp System** - Auto-warp + Manual warp command
✅ **Smart Team Randomization** - Leader chooses Together or Random mode
✅ **8-Team Color Support** - Works with all BedWars map configurations
✅ **Private Game Mode** - 16 player capacity toggle
✅ **Duel System** - Challenges with map selection and series support
✅ **SQLite Persistence** - Reliable data storage
✅ **Admin Control Panel** - GUI for managing all parties
✅ **Customizable Messages** - Full localization support
✅ **Performance Optimized** - Async database operations

---

## Screenshots

*[Add screenshots of the Team Selection GUI, Admin Panel, and Party List here]*

---

## Changelog

### v1.0.0 - Initial Release
- Merged RBW and Normal PrivateGames features
- Added `/p kick` command
- Added `/p warp` command
- Added `/p private` toggle (16 player mode)
- Implemented Together/Random team modes
- Added PartyArenaListener for auto-warp
- Added Admin GUI (`/pgadmin`)
- SQLite persistence with YAML backup
- Full 4-team and 8-team color support

---

## License

This plugin is licensed for use on a single server/network. Redistribution is prohibited.

---

**All Credits goes to Hypnr (me AKA the main dev)**

*NOTE: Requires BedWars1058 plugin to function.*

Report bugs to the developer (Hypnr) on discord: user- chearing