MC Warriors 3 (Plugin)

Minecraft Warriors 3 (Minecraft Helden 3)

Bounties, Grappling Hooks and much more

Kein Pemium verkauf!

The ultimate Season/PvP plugin for Paper servers (1.21.11+).
Das ultimative Season-/PvP-Plugin für Paper-Server (1.21.11+).

---

EN – English

What is Warriors3?

Warriors3 is a complete Season/PvP plugin for Paper servers. It turns your Minecraft server into a competitive "Last Hero Standing" experience: every player gets limited blue hearts, a secret bounty target, and must survive the season within a playtime limit while the map is split into two halves that merge after a set time.

Everything is highly configurable via config.yml – no coding required.

---

Features

🩵 Blue Hearts (Custom Lives)

• Every player starts with a configurable number of blue hearts (max-hearts).
• Lose a heart only when you die during combat (while combat-tagged).
• +1 bonus heart for killing your bounty target.
• Hearts are shown in the action bar using a custom resource pack font (minecraft:warriors3).
• Configurable action when all hearts are gone: NONE / SPECTATOR / BAN / CUSTOM_COMMAND.

⚔️ Combat Tag

• Enter combat on PvP hit; the tag stacks while both players fight each other.
• Configurable base duration, max duration, and per-hit increment.
• Container/GUI access is blocked while tagged (toggleable).
• Clean removal when the timer expires.

🎯 Bounty System (Kopfgeld)

• At season start every player receives a secret bounty target.
• Target is revealed after X days (configurable).
• Kill your target → +1 blue heart.
• Modes: RANDOM assignment or MANUAL (admin set via /warriors3 bounty set).
• Dynamic bounty heads: real player head rendered into the resource pack and shown in the action bar (Premium).

📅 Season System

• One timestamp defines the whole season: playtime limit, bounty reveal & border drop all reference it.
• Auto-starts a new season if none is active.
• /warriors3 start <seconds> runs a game-start countdown with configurable actions:
  START_SEASON → SPLIT_BORDER → RTP → APPLY_BORDER → DROP_BORDER.
• Random Teleport (RTP) with configurable radius, spawn points and border-split awareness.

⏱️ Playtime Limit (Season Week)

• Only active during the first week after season start (limited-period-days).
• Daily limit per player with configurable reset hour.
• Warnings at configurable thresholds (e.g. 10 / 5 / 1 minute left).
• Action when the limit is reached: KICK / SPECTATOR / CUSTOM_COMMAND.

🗺️ Map Split / World Border

• The map is divided along the X or Z axis into Half A & Half B.
• Players are automatically balanced to a half on their first join.
• Crossing is blocked until the split drops automatically after split-duration-days.
• Visible split wall: a giant indestructible wall (configurable material, length, stop distance).
• Generic world border (independent of the split) also included.
• Border drop broadcast: "The border has fallen! The map is now one shared world!"

🪦 Graves

• Lost loot on death spawns in a player-head grave block.
• Hologram above the grave (owner, remaining time, protection state).
• Configurable lifetime, max graves per player, breakable/explosive, auto-loot.
• Owner-only protection for the first X seconds.
• Particles above the grave (Premium).

🎒 Backpacks

• Fully configurable tiers (size, item, recipe, permission, owner-only, filtered contents).
• Paginated GUI with custom filler / page buttons.
• Content preview in the item lore.
• Blocked containers & materials (no backpack inside backpacks/chests).
• Tier 2 & 3 are Premium-only (configurable).

🪝 Grappling Hooks

• Custom hooks in 4 tiers (Copper / Iron / Gold / Diamond).
• Right-click to throw, right-click again to reel in, left-click a block to hook it, sneak to climb, fall damage protection while hooked.
• Custom enchantments shipped as a datapack: agility, long_reach, gentle_touch.
• Loot: hooks appear rarely in generated chests (configurable chance).
• Premium-only (configurable).

⚔️ Duels (1v1 & Team) — Premium

• Challenge any player with /duel <player> for a clean 1v1 duel — no blue heart loss, regardless of the combat-tag/heart system.
• Both players get a chat message with clickable Accept/Decline buttons.
• Team duels via /duel team: pick your partner and opposing team in a GUI; every single participant must individually accept.
• Auto-cancelled if nobody lands a hit for a configurable inactivity timeout (default 5 minutes) — no winner/loser, no consequences.
• Fully configurable in config.yml (timeout, arena teleport, team size, request expiry).
• Requires an active Premium license.

🚫 Restriction System (Item Blacklist)

Individually toggleable bans with per-player messages:

• Netherite Nether Mace Totems Potions Villagers Mending Punch II bows Knockback II swords

🎨 Custom Resource Pack (Bundled & Auto-Served)

• The plugin ships its own resource pack and can serve it via a built-in HTTP server (no upload needed) or via an external URL.
• Custom items, GUI textures, heart font and dynamic player heads are included.
• Force-accept mode with KICK / WARN_ONLY / NONE on decline.
• Diagnostics: /warriors3 packinfo, /warriors3 packresend, /warriors3 packtest.

🏆 Leaderboards GUI !!BETA!!

• Open the in-game leaderboards GUI (Premium) via /warriors3 leaderboard.
  ^^**

🔄 Modrinth Update Checker

• Automatic update check on startup + every 60 minutes.
• Admins are notified on join when a new version is available.
• Manual check: /warriors3 update check.

⚙️ Storage & Performance

• SQLite (default, warriors3.db) or YAML storage, switchable in config.
• Asynchronous persistence – no server lag.

---

Premium License

Warriors3 is a premium plugin with a free base version and gated premium features. The base version includes all core systems (blue hearts, combat, bounties, season, playtime, border split, graves, backpacks tier 1, restrictions, resource pack, update checker).

💎 Premium Features

🛒 How to Buy a License

1. Join our Discord server: https://discord.gg/Dqsd9pxwB6
2. Check the #shop channel.
3. Receive your license key after purchase.
4. Enter the key in config.yml:

   premium:
     license-key: "YOUR-KEY-HERE"
   

5. Run restarr and /premium to verify.
   • /warriors3 premium check → re-validate the license manually.

No internet required at runtime: the valid keys are embedded directly in the plugin and validated locally (async). No HTTP calls are made for license checks.

🔍 How to Check Your License Status

• As an admin: /warriors3 premium check

---

Installation

1. Download the latest Warriors3-1.x.x.jar from Modrinth.
2. Stop your Paper server (1.21.11+).
3. Put the jar into your plugins/ folder.
4. Start the server – Warriors3 generates its config files automatically.
5. Optional: configure config.yml and run /warriors3 reload.
6. Make sure your server can serve the resource pack (see resourcepack section in config.yml).

Requirement: A resource pack is required for the full experience (custom hearts, items, bounty heads). The plugin offers both self-hosted (built-in HTTP server) and external URL modes.

---

Commands

Player Commands

Admin Commands (warriors3.admin)

---

Permissions

---

Configuration

Everything is stored in plugins/Warriors3/config.yml and messages.yml. Highlights:

hearts:
  max-hearts: 3          # starting blue hearts
  on-zero-action: BAN    # NONE | SPECTATOR | BAN | CUSTOM_COMMAND

combat:
  tag-duration-seconds: 30
  max-tag-duration-seconds: 350

playtime:
  enabled: true
  limited-period-days: 7      # limit active only in the first week
  daily-limit-minutes: 60
  limit-reached-action: KICK  # KICK | SPECTATOR | CUSTOM_COMMAND

border:
  split-duration-days: 14     # border drops automatically after this
  border-center-axis: x       # split along x or z

bounty:
  assignment-mode: RANDOM     # RANDOM | MANUAL
  reveal-after-days: 14

graves:
  enabled: true
  time-seconds: 900

storage:
  type: sqlite               # sqlite | yaml

Placeholders in messages: %player%, %target%, %hearts%, %seconds%, %minutes%, %days%, %limit%, %discord%, %x%, %y%, %z%, %world%, %victim%, %attacker%, %owner_name_display% and more.

Colors: Minecraft color codes like &c, &6, &l, &o, &n are supported everywhere.

---

FAQ (EN)

Q: Which server software do I need?
A: Paper 1.21.11 or newer (fork like Purpur/Pufferfish also works).

Q: Is the plugin free?
A: Yes, the base version is free. Premium features require a license key.

Q: Where do I buy a license?
A: In our Discord: https://discord.gg/Dqsd9pxwB6

Q: Does the plugin phone home?
A: No. License validation is done locally against keys embedded in the plugin. The only internet connection is the optional Modrinth update check.

Q: Do I need to host a resource pack?
A: Yes, but Warriors3 can serve it for you via a built-in HTTP server – no external upload required. (Open the configured port on your host/router.)

---

DE – Deutsch

Was ist Warriors3?

Warriors3 ist ein komplettes Season-/PvP-Plugin für Paper-Server. Es verwandelt deinen Server in ein kompetitives „Last Hero Standing"-Erlebnis: Jeder Spieler hat limitierte blaue Herzen, ein geheimes Kopfgeld-Ziel und muss die Season innerhalb eines Playtime-Limits überleben, während die Map in zwei Hälften geteilt ist, die nach einer bestimmten Zeit zusammenfallen.

Alles ist über config.yml hochkonfigurierbar – ohne Codekenntnisse.

---

Features (DE)

❤️ Blaue Herzen (Custom-Leben)

• Jeder Spieler startet mit einer konfigurierbaren Anzahl blauer Herzen (max-hearts).
• Herzverlust NUR bei Tod im Combat-Tag.
• +1 Bonus-Herz für den Kill des eigenen Kopfgeld-Ziels.
• Anzeige in der Actionbar über einen Custom-Font des Resourcepacks (minecraft:warriors3).
• Konfigurierbare Aktion bei 0 Herzen: NONE / SPECTATOR / BAN / CUSTOM_COMMAND.

⚔️ Combat-Tag

• Kampfstart bei PvP-Treffer; der Tag stackt bei gegenseitigem Kampf.
• Konfigurierbare Basis-Dauer, Maximum und Zuwachs.
• Container/GUI-Zugriff wird im Kampf blockiert (abschaltbar).
• Sauberes Entfernen, wenn der Timer abläuft.

🎯 Kopfgeld-System (Bounty)

• Jeder Spieler bekommt zu Season-Start ein geheimes Kopfgeld-Ziel.
• Das Ziel wird nach X Tagen enthüllt (konfigurierbar).
• Kill des Ziels → +1 blaues Herz.
• Modi: RANDOM (zufällig) oder MANUAL (Admin setzt per /warriors3 bounty set).
• Dynamische Bounty-Köpfe: echter Spielerkopf wird ins Resourcepack gebacken und in der Actionbar angezeigt (Premium).

📅 Season-System

• Ein Zeitstempel steuert die ganze Season: Playtime-Limit, Bounty-Reveal & Border-Drop beziehen sich darauf.
• Startet automatisch eine neue Season, wenn keine aktiv ist.
• /warriors3 start <sekunden> startet einen Game-Start-Countdown mit konfigurierbaren Aktionen:
  START_SEASON → SPLIT_BORDER → RTP → APPLY_BORDER → DROP_BORDER.
• Random Teleport (RTP) mit konfigurierbarem Radius, Spawnpunkten und Border-Split-Bewusstsein.

⏱️ Playtime-Limit (Season-Woche)

• Nur in der ersten Woche nach Season-Start aktiv (limited-period-days).
• Tageslimit pro Spieler mit konfigurierbarer Reset-Stunde.
• Warnungen bei konfigurierbaren Schwellen (z. B. 10 / 5 / 1 Minute Restzeit).
• Aktion bei Erreichen des Limits: KICK / SPECTATOR / CUSTOM_COMMAND.

🗺️ Map-Split / Worldborder

• Die Map wird entlang der X- oder Z-Achse in Hälfte A & Hälfte B geteilt.
• Spieler werden beim ersten Join automatisch auf eine Hälfte verteilt.
• Überqueren wird blockiert, bis die Grenze nach split-duration-days automatisch fällt.
• Sichtbare Trennwand: eine riesige unzerstörbare Wand (Material, Länge, Stop-Distanz konfigurierbar).
• Zusätzlich eine generische Worldborder (unabhängig vom Split).
• Border-Drop Broadcast: „Die Grenze ist gefallen! – die Map ist jetzt eine gemeinsame Welt!"

🪦 Gräber (GravesX-Stil)

• Verlorener Loot spawnt bei Tod als Kopf-Block-Grab.
• Hologramm über dem Grab (Besitzer, Restzeit, Schutzstatus).
• Konfigurierbare Lebensdauer, max. Gräber pro Spieler, abbaubar/explosionsfähig, Auto-Loot.
• Owner-only-Schutz für die ersten X Sekunden.
• Partikel über dem Grab (Premium).

🎒 Rucksäcke (BackpackPlus-Port)

• Voll konfigurierbare Stufen (Größe, Item, Rezept, Permission, Owner-only, gefilterter Inhalt).
• Paginiertes GUI mit eigenen Filler-/Seiten-Buttons.
• Inhalts-Übersicht in der Item-Lore.
• Blockierte Container & Materialien (keine Rucksäcke in Rucksäcken/Truhen).
• Stufe 2 & 3 sind Premium-only (konfigurierbar).

🪝 Grappling Hooks (YoHooks-Port)

• Custom-Hooks in 4 Stufen (Kupfer / Eisen / Gold / Diamant).
• Rechtsklick: werfen | nochmal Rechtsklick: einholen | Linksklick auf Block: an blocken | Sneak: klettern | Fallschaden-Schutz am Haken.
• Custom-Verzauberungen per Datapack: agility, long_reach, gentle_touch.
• Loot: Hooks erscheinen selten in generierten Truhen (Chance konfigurierbar).
• Premium-only (konfigurierbar).

⚔️ Duelle (1v1 & Team) — Premium

• Fordere andere Spieler mit /duel <spieler> zu einem sauberen 1v1-Duell heraus — kein Verlust blauer Herzen, unabhängig vom Combat-Tag-/Herzsystem.
• Beide Spieler bekommen eine Chat-Nachricht mit klickbaren Annehmen-/Ablehnen-Buttons.
• Team-Duelle per /duel team: Partner und Gegner-Team über ein GUI auswählen; jeder Beteiligte muss einzeln zustimmen.
• Automatischer Abbruch, wenn niemand innerhalb eines konfigurierbaren Inaktivitäts-Timeouts (Standard 5 Minuten) angreift — kein Sieger/Verlierer, keine Konsequenzen.
• Vollständig konfigurierbar in config.yml (Timeout, Arena-Teleport, Team-Größe, Anfrage-Ablaufzeit).
• Benötigt eine aktive Premium-Lizenz.

🚫 Restriktions-System (Item-Blacklist)

Einzeln abschaltbare Verbote mit eigenen Spieler-Nachrichten:

• Netherite Nether Mace Totems Tränke Dorfbewohner Mending Punch II Bögen Knockback II Schwerter

🎨 Custom-Resourcepack (gebündelt & automatisch ausgeliefert)

• Das Plugin bringt sein eigenes Resourcepack mit und kann es per eingebautem HTTP-Server ausliefern (kein Upload nötig) oder über eine externe URL.
• Custom-Items, GUI-Texturen, Herz-Font und dynamische Spielerköpfe sind enthalten.
• Force-Accept-Modus mit KICK / WARN_ONLY / NONE bei Ablehnung.
• Diagnose: /warriors3 packinfo, /warriors3 packresend, /warriors3 packtest.

🏆 Leaderboards-GUI

• Öffne das Leaderboards-GUI im Spiel (Premium) per /warriors3 leaderboard.

🔄 Modrinth-Update-Checker

• Automatischer Update-Check beim Start + alle 60 Minuten.
• Admins werden beim Join informiert, wenn eine neue Version verfügbar ist.
• Manueller Check: /warriors3 update check.

⚙️ Speicher & Performance

• SQLite (Standard, warriors3.db) oder YAML-Speicher, in der Config umschaltbar.
• Asynchrones Speichern – kein Server-Lag.

---

Premium-Lizenz

Warriors3 ist ein Premium-Plugin mit einer kostenlosen Basis-Version und geschützten Premium-Features. Die Basis-Version enthält alle Kernsysteme (Blaue Herzen, Combat, Bounties, Season, Playtime, Border-Split, Gräber, Rucksack Stufe 1, Restriktionen, Resourcepack, Update-Checker).

💎 Premium-Features