# HOSH Duels<\/p>\n
A fully-featured 1v1 duel system for Spigot servers with kit management, WorldEdit-powered arenas, isolated temporary worlds, rematches, and persistent fight stats \u2014 all driven through an intuitive GUI and a single `\/hoshd` command.<\/p>\n
—<\/p>\n
## Requirements<\/p>\n
– **Paper** (or compatible) \u2014 **1.19.x \/ 1.20.x \/ 1.21.x**
\n– **Java 17+**
\n– **Hosh Loader (mandatory)** \u2014 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.
\n– **WorldEdit (mandatory)** \u2014 Required for arena selection and copying. If WorldEdit is missing, the plugin disables and ops are notified on join.
\n– Use **`\/hosh duels reload`** (via Hosh Loader) to reload this plugin after config changes.
\n– Use **`\/hosh update all`** (via Hosh Loader) to prepare newest compatible HOSH updates for next restart.<\/p>\n
## Downloads<\/p>\n
| | Modrinth |
\n|—|———-|
\n| **Hosh Loader** (install first) | Download Hosh Loader |
\n| **HOSH Duels** (this plugin) | Download HOSH Duels |
\n| **WorldEdit** (dependency) | Download WorldEdit |<\/p>\n
—<\/p>\n
## Features<\/p>\n
– **Temporary isolated worlds** \u2014 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
\n– **Kit system** \u2014 Save, edit, and delete kits from your current inventory via GUI or commands. Full armor + inventory support with a visual editor
\n– **Arena system** \u2014 Define arenas using WorldEdit selections and player spawn points. Arenas are persisted to YAML and loaded on startup
\n– **Countdown & invulnerability** \u2014 Players are invulnerable during the configurable countdown. Once the fight goes live, damage is tracked
\n– **Rematch system** \u2014 After a fight ends, either player can request a rematch. Both players must request within 60 seconds for the rematch to start
\n– **Fight statistics** \u2014 Wins and total damage dealt are tracked per player and saved to `stats.yml`
\n– **State restoration** \u2014 Player location, gamemode, inventory, and armor are saved before the fight and fully restored afterward
\n– **Disconnect handling** \u2014 If a player leaves mid-fight, the fight is aborted and the temp world is cleaned up
\n– **Full GUI** \u2014 Main menu, kit list, arena list, and kit editor inventories with intuitive click actions
\n– **Chat-based naming** \u2014 Create kits and arenas by clicking a GUI button and typing the name in chat
\n– **Tab completion** \u2014 All subcommands support tab-completing kit names, arena names, and online players<\/p>\n
—<\/p>\n
## Commands<\/p>\n
All commands are subcommands of `\/hoshd` (alias: `\/hoshduels`).<\/p>\n
| Command | Permission | Description | —<\/p>\n ## Arena Setup Guide<\/p>\n Setting up an arena takes four steps:<\/p>\n 1. **Create** \u2014 Run `\/hoshd arena create You can cancel at any time with `\/hoshd cancel`.<\/p>\n —<\/p>\n ## Configuration<\/p>\n All settings live in the default `config.yml` generated on first run.<\/p>\n “`yaml defaults: features: ### Config Options<\/p>\n | Option | Default | Description | —<\/p>\n ## Data Files<\/p>\n | File | Purpose | —<\/p>\n ## Dependencies<\/p>\n | Plugin | Required | Why | —<\/p>\n ## Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## Installation<\/p>\n 1. Download and install **Hosh Loader** in `plugins\/` (required). Modern duel system with temporary worlds and zero map damage.<\/p>\n","protected":false},"featured_media":82198,"template":"","meta":{"_minecraft_slug":"hosh-duels","_minecraft_project_id":"VixPQRjg","_minecraft_author":"Hoshiy","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":28,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hosh-duels.zip","_minecraft_size_bytes":495047,"_minecraft_version_count":7,"_minecraft_updated_at":"2026-05-15T22:10:09.535006Z","_minecraft_date_created":"2026-04-11T21:06:47.546310Z","_minecraft_date_modified":"2026-04-07T15:59:54.891735Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hosh-duels","_minecraft_icon_attachment_id":82198,"_minecraft_imported_at":"2026-06-04T17:16:42+00:00","_minecraft_import_hash":"948c1819aa124dafd1ed76cb85dad315","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[866,127,128],"mod_loader":[132,133],"minecraft_version":[54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-82197","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-minigame","mod_category-paper","mod_category-purpur","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|
\n| `\/hoshd` | \u2014 | Show all available commands |
\n| `\/hoshd gui` | \u2014 | Open the main duel GUI |
\n| `\/hoshd kit create
\n| `\/hoshd kit delete
\n| `\/hoshd arena create
\n| `\/hoshd arena setarea` | `hoshd.arena.setarea` | Use your WorldEdit selection as the arena area |
\n| `\/hoshd arena setpos1` | `hoshd.arena.setpos1` | Set player 1 spawn at your current location |
\n| `\/hoshd arena setpos2` | `hoshd.arena.setpos2` | Set player 2 spawn at your current location |
\n| `\/hoshd arena confirm` | `hoshd.arena.confirm` | Finalize and save the arena |
\n| `\/hoshd arena delete
\n| `\/hoshd cancel` | `hoshd.cancel` | Cancel your current arena setup session |
\n| `\/hoshd fight
\n| `\/hoshd rematch
\n2. **Set area** \u2014 Make a WorldEdit selection, then run `\/hoshd arena setarea`
\n3. **Set spawns** \u2014 Stand where each player should spawn and run `\/hoshd arena setpos1` and `\/hoshd arena setpos2`
\n4. **Confirm** \u2014 Run `\/hoshd arena confirm` to save the arena<\/p>\n
\nprefix: “&8[&bHOSH Duels&8] ”<\/p>\n
\n max-name-length: 24
\n duel-countdown-seconds: 5<\/p>\n
\n delete-temp-worlds: true
\n restore-player-inventory-after-fight: true
\n auto-set-survival-in-duel: true
\n rematch-enabled: true
\n fight-stats-enabled: true
\n“`<\/p>\n
\n|—|—|—|
\n| `max-name-length` | `24` | Maximum characters for kit and arena names |
\n| `duel-countdown-seconds` | `5` | Countdown before players become vulnerable (0 = instant) |
\n| `delete-temp-worlds` | `true` | Delete temporary duel worlds after fights end |
\n| `restore-player-inventory-after-fight` | `true` | Restore player inventory and armor after a fight |
\n| `auto-set-survival-in-duel` | `true` | Force players into Survival gamemode during duels |
\n| `rematch-enabled` | `true` | Allow rematch requests after fights |
\n| `fight-stats-enabled` | `true` | Track wins and damage dealt per player |<\/p>\n
\n|—|—|
\n| `kits.yml` | Persistent storage for all saved kits |
\n| `arenas.yml` | Persistent storage for all arena definitions |
\n| `stats.yml` | Per-player win count and total damage dealt |<\/p>\n
\n|—|—|—|
\n| **WorldEdit** | Yes | Arena area selection and copying arenas to temporary worlds |<\/p>\n
\n|—|—|—|
\n| `hoshd.arena.create` | None | Create new arenas |
\n| `hoshd.arena.setarea` | None | Set arena area from WorldEdit selection |
\n| `hoshd.arena.setpos1` | None | Set player 1 spawn point |
\n| `hoshd.arena.setpos2` | None | Set player 2 spawn point |
\n| `hoshd.arena.confirm` | None | Confirm and save an arena |
\n| `hoshd.arena.delete` | None | Delete arenas |
\n| `hoshd.cancel` | None | Cancel arena setup sessions |
\n| `hoshd.fight` | None | Start fights and request rematches |<\/p>\n
\n2. Install **WorldEdit** on your server (required).
\n3. Download **HOSH Duels** and place `hosh-duels-
\n4. Restart the server (full restart recommended after first install).
\n5. Edit `plugins\/HOSH_Duels\/config.yml` to your liking.
\n6. Start creating kits and arenas with `\/hoshd gui`. Use **`\/hosh duels reload`** when you change config files.<\/p>\n","protected":false},"excerpt":{"rendered":"