MC Warriors 1

MC Warriors 1

Premium & Bug Report: https://discord.gg/pxSJynZC6X

🇬🇧 English:

A Fabric mod for PvP projects featuring a lives system, combat timer, and graves. It brings important project announcements directly into the game and can automatically ban eliminated players from the server.

Features

• Lives System: Configure the starting number of lives. Players can lose a life when dying in combat.
• Elimination at Zero Lives: Players who lose all their lives are automatically banned from the server.
• Revival: Revive eliminated players using a command and automatically remove their ban.
• Combat Timer: After PvP hits, players remain in combat for a configurable duration. The remaining time is displayed in the action bar.
• Moderate Time Extension: After every 5–9 hits, the combat timer is randomly extended by 10–30 seconds.
• Graves: Items are stored in a grave upon death. When dying in combat, the player keeps a portion of their items, while the rest is placed in the grave.
• Death Screen Animation: An optional animation plays once.
• Server Configuration: Customize lives, combat duration, HUD, graves, and other rules through config/helden/config.yml.
• Premium Support: Premium features can be unlocked using a valid key server key.

Installation

1. Install Fabric Loader for Minecraft 1.21.11.
2. Install Fabric API on the server and all clients.
3. Place the mod JAR in the mods folder on the server and on every client.
4. Start the server once to generate the configuration file.

The mod must be installed on both the server and every client.

Commands

All commands start with /helden. Administrative commands require sufficient permissions.

| Command | Description |
|—|—|
| /helden premium | Displays the premium status |
| /helden premium set <KEY> | Saves and validates a premium key |
| /helden premium info | Displays the server ID and masked key |
| /helden lives <Player> | Displays a player’s remaining lives |
| /helden setlives <Player> <Amount> | Sets a player’s lives |
| /helden addlives <Player> <Amount> | Adds lives to a player |
| /helden removelives <Player> <Amount> | Removes lives from a player |
| /helden resetlives <Player> | Resets a player’s lives to the starting amount |
| /helden revive <Player> | Revives an eliminated player and removes their ban |
| /helden combat <Player> | Displays the remaining combat time |
| /helden combat clear <Player> | Clears a player’s combat status |
| /helden combat set <Player> <Seconds> | Sets a player’s combat timer |

Configuration

The file config/helden/config.yml is generated on the first server startup. The premium key can be configured under premium.key:

premium:
  key: ""
debug: false

🇩🇪 German:

Minecraft Helden 1

Eine Fabric-Mod für PvP-Projekte mit Leben-System, Kampf-Timer und Gräbern. Sie bringt wichtige Projektmeldungen direkt ins Spiel und kann ausgeschiedene Spieler automatisch vom Server bannen.

Features

• Leben-System: Lege die Startanzahl an Leben fest. Bei einem Tod im Kampf kann ein Leben verloren gehen.
• Ausscheiden bei null Leben: Spieler, die alle Leben verlieren, werden automatisch gebannt.
• Wiederbelebung: Mit einem Befehl können ausgeschiedene Spieler wiederbelebt und automatisch entbannt werden.
• Kampf-Timer: Spieler bleiben nach PvP-Treffern für eine festgelegte Zeit im Kampf. Die verbleibende Zeit wird in der Actionbar angezeigt.
• Moderate Zeitverlängerung: Nach jeweils 5–9 Treffern verlängert sich die Kampfzeit zufällig um 10–30 Sekunden.
• Gräber: Beim Tod werden Items in einem Grab abgelegt. Bei einem Tod im Kampf behält der Spieler einen Teil seiner Items; der Rest landet im Grab.
• Deathscreen-Animation: Eine optionale Animation wird einmal abgespielt.
• Server-Konfiguration: Passe Leben, Kampfzeit, HUD, Gräber und weitere Regeln über config/helden/config.yml an.
• Premium-Unterstützung: Premium-Funktionen können mit einem gültigen Keyserver-Key freigeschaltet werden.

Installation

1. Installiere Fabric Loader für Minecraft 1.21.11.
2. Installiere Fabric API auf dem Server und auf allen Clients.
3. Lege die Mod-JAR in den mods-Ordner des Servers und der Clients.
4. Starte den Server einmal, damit die Konfiguration erstellt wird.

Die Mod muss auf dem Server und auf jedem Client installiert sein.

Befehle

Alle Befehle beginnen mit /helden. Die Verwaltung ist auf Spieler mit ausreichenden Rechten beschränkt.

| Befehl | Funktion |
|—|—|
| /helden premium | Zeigt den Premium-Status |
| /helden premium set <KEY> | Speichert und prüft einen Premium-Key |
| /helden premium info | Zeigt Server-ID und maskierten Key |
| /helden lives <Spieler> | Zeigt die verbleibenden Leben |
| /helden setlives <Spieler> <Anzahl> | Setzt die Leben eines Spielers |
| /helden addlives <Spieler> <Anzahl> | Fügt Leben hinzu |
| /helden removelives <Spieler> <Anzahl> | Entfernt Leben |
| /helden resetlives <Spieler> | Setzt die Leben auf den Startwert zurück |
| /helden revive <Spieler> | Belebt einen ausgeschiedenen Spieler wieder und hebt den Bann auf |
| /helden combat <Spieler> | Zeigt die verbleibende Kampfzeit |
| /helden combat clear <Spieler> | Beendet den Kampfstatus |
| /helden combat set <Spieler> <Sekunden> | Setzt die Kampfzeit |

Konfiguration

Die Datei config/helden/config.yml wird beim ersten Serverstart erstellt. Der Premium-Key kann dort unter premium.key eingetragen werden:

premium:
  key: ""
debug: false