One vs Team

# 1vs5 — Minecraft Plugin A PvP event plugin for Minecraft 1.21 (Paper/Spigot) in which one solo player fights against a team of attackers across multiple rounds. Includes a point system, kit management, spectator support, and a multi-language system. --- ## Requirements - Paper / Spigot 1.21 - Two worlds on the server: `lobby` and `fightworld_backup` (the backup is copied automatically before each round) --- ## Installation 1. Drop the `.jar` into your `plugins/` folder. 2. Start the server once — the plugin creates its config files automatically. 3. Set up your worlds (see below). 4. Configure `config.yml` to your liking. --- ## World Setup | World | Purpose | |---|---| | `lobby` | Waiting area — PvP, block breaking and placing are disabled here | | `fightworld_backup` | The original arena — copied before every round, never modified directly | | `fightworld` | Generated automatically from the backup before each round | The coordinates for solo and attacker spawns are configured in `config.yml`. --- ## Configuration (`config.yml`) ```yaml language: "en" # Language: "en", "de", or any custom language file # Lobby Settings lobby: world: "lobby" spawn: x: 0.5 y: 3.0 z: 0.5 yaw: 0.0 pitch: 0.0 # Fightworld Settings fightworld: world: "fightworld" solo_spawn: x: 20667.5 y: 148.0 z: 15615.5 attackers_spawn: x: 20803.5 y: 148.0 z: 15615.5 game: default_rounds: 3 # Number of rounds per match countdown_seconds: 5 # Countdown before each round starts post_round_delay_seconds: 5 # Pause between rounds ``` --- ## Commands All admin commands require operator permissions (`/op`). ### Admin — `/1vs5 <subcommand>` | Subcommand | Description | |---|---| | `setsolo <player>` | Set the solo player | | `addattacker <player>` | Add a player to the attacker team | | `removeattacker <player>` | Remove a player from the attacker team | | `rounds <number>` | Set the number of rounds | | `savekit <name> ` | Save your current inventory as a kit; `true` enables natural health regeneration, `false` disables it (default: true) | | `setkit <name>` | Select a kit for the next match | | `deletekit <name>` | Delete a saved kit | | `toggledrops` | Toggle whether players drop items on death | | `start` | Start the match | | `stop` | Abort the running match | | `points` | Show the current leaderboard in chat | | `resetleaderboard` | Reset all points | | `history` | Show past match results | | `reload` | Reload `config.yml` and the language file | ### Players — `/spectatefight` Teleports you to the fight world in spectator mode. Cannot be used by active participants. --- ## Point System | Event | Points | |---|---| | Attacker kills the solo player | +10 pts (killer only) | | Attacker survives the round | +5 pts (all surviving attackers except the killer) | | Solo player kills an attacker | +1 pt per kill | | Solo player wins the round (all attackers eliminated) | +7 pts | | Attacker dies | Points equal to the number of attackers already eliminated before them | --- ## Kit System Kits save the inventory (items, armor, offhand) of the player who runs `savekit`. After the name of the kit you can optionally specify true or false to enable or disable natural health regeneration. By default it is enabled. Kits are stored in `plugins/1vs5/kits/<name>.yml`. --- ## Language System The plugin supports multiple languages. The active language is set via `language:` in `config.yml`. Language files are located in `plugins/1vs5/languages/`. The bundled languages are `en.yml` and `de.yml`. **Adding a new language:** 1. Create a new file, e.g. `plugins/1vs5/languages/fr.yml`. 2. Copy the contents of `en.yml` into it and translate all values. 3. Set `language: "fr"` in `config.yml`. 4. Run `/1vs5 reload` or restart the server. No code changes are needed to add new languages. --- ## Friendly Fire Rules - Melee attacks, projectiles, and explosions **between attackers** are cancelled. - The solo player can damage and be damaged by all attackers. - Friendly fire in the **lobby** is always disabled for all players. --- ## Combat Logging If a participant disconnects during an active round, they are marked as a combat logger. Their inventory is cleared and the round continues as if they had died. When they reconnect, they receive a warning message. --- ## Data & Files | File | Contents | |---|---| | `plugins/1vs5/config.yml` | Main configuration | | `plugins/1vs5/kits/` | Saved kit files | | `plugins/1vs5/history.yml` | Match history with timestamps and results | | `plugins/1vs5/languages/` | Language files |