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)

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> [true	false]`
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