PvPArena-Light

Advanced PvP practice plugin for Paper/Folia with duel flow, queue matching, arena rollback, spectator tools, and configurable mode kits.

Highlights

• Queue + direct duel workflows (/pvp, /duel)
• Multi-mode arena settings with per-mode kits
• Winner loot phase + early leave (/duel dleave)
• Spectator browser, hotbar tools, and state isolation
• Arena rollback and crash-recovery safeguards
• Optional integrations: ProtocolLib, PlaceholderAPI, HuskSync

Compatibility

• Java 21+
• Paper/Folia 1.21.x
• Maven build (artifact: pvparena-light-1.0.7.jar)

Installation

1. Download build artifact from Actions or Releases.
2. Place jar in server plugins/.
3. Start server once to generate defaults.
4. Configure files under plugins/PvPArena-Light/.

Quick Setup

1. Create arena: /arena create <id> [world]
2. Set spawns: /arena setspawn <id> <1|2>
3. set kit: /arena addkit <id>
4. Open menu: /pvp

Winner Leave Wait Music

Config path in config.yml:

match:
	winner-leave-wait:
		play-sound: true
		sound: "music_disc.otherside"
		volume: 1.0
		pitch: 1.0

• Plays during winner loot/leave waiting phase.
• Stops when player leaves early or when match ends.

Runtime SQLite Dependency

• Build output is thin jar (no fat dependency bundle).
• If sqlite driver is missing at startup, plugin auto-downloads it to plugins/lib.
• If the jar already exists in plugins/lib, download is skipped.

Commands

See docs/COMMANDS.md.

Build

mvn -DskipTests package

Output:

• target/pvparena-light-1.0.7.jar

Project Structure

• src/main/java plugin source
• src/main/resources default config/messages/plugin.yml
• docs operator/admin docs

Changelog

See CHANGELOG.md.