HOSH Duels

HOSH Duels

A fully-featured 1v1 duel system for Spigot servers with kit management, WorldEdit-powered arenas, isolated temporary worlds, rematches, and persistent fight stats — all driven through an intuitive GUI and a single /hoshd command.

Requirements

• Paper (or compatible) — 1.19.x / 1.20.x / 1.21.x
• Java 17+
• Hosh Loader (mandatory) — This plugin will not stay enabled without it. If HoshLoader.jar is missing, HOSH Duels disables itself and server operators get a message on join.
• WorldEdit (mandatory) — Required for arena selection and copying. If WorldEdit is missing, the plugin disables and ops are notified on join.
• Use /hosh duels reload (via Hosh Loader) to reload this plugin after config changes.
• Use /hosh update all (via Hosh Loader) to prepare newest compatible HOSH updates for next restart.

Downloads

Features

• Temporary isolated worlds — Every duel spawns in its own void world. The arena layout is copied from your WorldEdit selection, and the world is automatically deleted after the fight ends
• Kit system — Save, edit, and delete kits from your current inventory via GUI or commands. Full armor + inventory support with a visual editor
• Arena system — Define arenas using WorldEdit selections and player spawn points. Arenas are persisted to YAML and loaded on startup
• Countdown & invulnerability — Players are invulnerable during the configurable countdown. Once the fight goes live, damage is tracked
• Rematch system — After a fight ends, either player can request a rematch. Both players must request within 60 seconds for the rematch to start
• Fight statistics — Wins and total damage dealt are tracked per player and saved to stats.yml
• State restoration — Player location, gamemode, inventory, and armor are saved before the fight and fully restored afterward
• Disconnect handling — If a player leaves mid-fight, the fight is aborted and the temp world is cleaned up
• Full GUI — Main menu, kit list, arena list, and kit editor inventories with intuitive click actions
• Chat-based naming — Create kits and arenas by clicking a GUI button and typing the name in chat
• Tab completion — All subcommands support tab-completing kit names, arena names, and online players

Commands

All commands are subcommands of /hoshd (alias: /hoshduels).

Arena Setup Guide

Setting up an arena takes four steps:

1. Create — Run /hoshd arena create <name> to start a setup session
2. Set area — Make a WorldEdit selection, then run /hoshd arena setarea
3. Set spawns — Stand where each player should spawn and run /hoshd arena setpos1 and /hoshd arena setpos2
4. Confirm — Run /hoshd arena confirm to save the arena

You can cancel at any time with /hoshd cancel.

Configuration

All settings live in the default config.yml generated on first run.

prefix: "&8[&bHOSH Duels&8] "

defaults:
  max-name-length: 24
  duel-countdown-seconds: 5

features:
  delete-temp-worlds: true
  restore-player-inventory-after-fight: true
  auto-set-survival-in-duel: true
  rematch-enabled: true
  fight-stats-enabled: true

Config Options

Data Files

Dependencies

Permissions

Installation

1. Download and install Hosh Loader in plugins/ (required).
2. Install WorldEdit on your server (required).
3. Download HOSH Duels and place hosh-duels-<version>.jar in plugins/.
4. Restart the server (full restart recommended after first install).
5. Edit plugins/HOSH_Duels/config.yml to your liking.
6. Start creating kits and arenas with /hoshd gui. Use /hosh duels reload when you change config files.