From 50d7ae91438f82eca314949055221ea94501d1e3 Mon Sep 17 00:00:00 2001 From: TDSTOS Date: Wed, 8 Apr 2026 23:56:46 +0200 Subject: [PATCH] Add README with HardcoreGames project docs Add a new README.md documenting the HardcoreGames (HG) project in German. Includes general mechanics and settings, game phases, leveling/ranking, perks, natural disaster system, detailed kit descriptions and abilities, and a checklist of completed and open tasks (e.g., Custom World-Generation, Ninja, Spielo, Trident, Blitzcrank). --- README.md | 125 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 125 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..23a4d02 --- /dev/null +++ b/README.md @@ -0,0 +1,125 @@ +# 🎼 HardcoreGames (HG) – Projektdokumentation + +## ⚙ Allgemeine Mechaniken & Einstellungen +* **Teams:** Maximal To2 (Teams of 2). Spieler mĂŒssen sich ĂŒber den `/team` Command zusammenschließen. +* **Kompass:** Zeigt ĂŒber der Actionbar in die Richtung des nĂ€chsten Gegners (`< Next Enemy in Direction: %direction% >`). Es werden keine Spielernamen preisgegeben. +* **Hit-Cooldown:** Der Standard-HitCooldown ist entfernt. +* **Ressourcen:** Vor dem Feast kann kein Eisen abgebaut werden. Nach dem Feast greift ein "Iron-Nerf". +* **Auto-Pickup:** Automatisches Aufsammeln von Items ist aktiv. Speziell beim Start gehen Pilze, Kakaobohnen und Kakteen beim Abbauen direkt ins Inventar. +* **Kills & XP:** Ein "Pro Kill" gewĂ€hrt ein halbes XP-Level. + +--- + +## ⏳ Spielphasen +1. **Lobby:** + * *Dauer:* Bis 8 Spieler in der Runde sind, ansonsten Start via `/start` Command. +2. **Invincibility (Schutzzeit):** + * *Dauer:* 3 Minuten. + * *Effekte:* Spieler erhalten Speed & Haste bis zum Ende dieser Phase. +3. **Battle:** + * *Dauer:* Bis nur noch ein Spieler lebt. + * *Events:* + * **Feast:** Startet ab Minute 10. + * **Pit:** Im normalen Spiel ab Minute 30; bei einem Event ab Minute 45. + * **Deathmatch:** Gibt es ab 4 Spielern ein "Loot Feast" beim Deathmatch. + * *Maximale Dauer:* Normales Spiel = 1 Stunde; Event = 1 Stunde 15 Minuten. +4. **End:** + * *Dauer:* 1 Minute. + +--- + +## 📈 Level- & Ranking-System +* **Leveling:** Spieler starten bei Level 1 und können bis Level 100 aufsteigen. Höhere Level schalten bestimmte Extras frei, um schwĂ€cheren Spielern das Spiel zu erleichtern. +* **Einranken:** Es werden 5 Spiele benötigt, um einen Rang zu erhalten. Das Ergebnis berechnet sich aus *Performance + Letzter Rang*. +* **Punktevergabe:** Nach jedem Spiel erhalten Spieler je nach Performance entweder Punkteabzug (`-5 bis -15 RR`) oder Punktezuwachs (`+10 bis +30 RR`). + +--- + +## đŸŒȘ Spiel-Systeme + +### Perks-System +Spieler können anstelle von "Sidekits" verschiedene Perks wĂ€hlen (2 Perks pro Spieler), welche das Spielerlebnis beeinflussen. Man kann so verschiedene Abilities kombinieren. +* **Allgemeine Passive Perks:** Gegner wegkicken oder sich zu einem Gegner teleportieren. +* **Orakel-Perk:** Ähnlich wie der Assassine. Zeigt Kit und Entfernung des nĂ€chsten Gegners an. *Sonderfall:* Wenn das Spielo-Kit ausgewĂ€hlt ist, zeigt das Orakel an, ob der nĂ€chste Gamble gut oder schlecht wird. + +### Naturkatastrophen-System +In jedem Biom können verschiedene Katastrophen auftreten: +* **Mesa:** Tornado, Erdbeben +* **Savanne:** Meteore +* **Generell (bei hoher Bauhöhe):** Donner (Blitze) + +--- + +## đŸ›Ąïž Kit-System +**Grundregel fĂŒr FĂ€higkeiten:** Nach dem Start der Runde hat jeder Spieler *einen* freien Use seiner Abilities. Danach werden die weiteren Uses erst ab einer bestimmten Anzahl an ausgeteilten Hits freigeschaltet. *Wichtig:* Vor der Kitauswahl wird der PlayStyle auf Null gesetzt, um Fehler zu vermeiden. VerlĂ€sst ein Spieler das Inventar ohne Wahl, wird der PlayStyle standardmĂ€ĂŸig auf **DEFENSIVE** gesetzt. + +Hier sind alle dokumentierten Kits und ihre FĂ€higkeiten: + +* **Goblin [Fertig]** + * *Aggressive (Steal):* 60 Sekunden lang aktiv. Kopiert das Kit des Gegners und gibt eine minimale Chance, Suppen zu klauen. + * *Passive (Bunker):* Spawnt bei Aktivierung einen Bunker um den Spieler herum. +* **Venom [Fertig]** + * *Aggressive (Wither):* Bei Aktivierung: Lohen-Sound + Beam + Blindness I (5 Sek.) + Instant Damage (2 Herzen) + Wither I. + * *Passive (Shield of Darkness / Dunklerpanzer):* 8 Sekunden aktiv. Lohen-Sound + Smoke + Barriere. Die Barriere blockt Projektile (SchneebĂ€lle, Eier, Pfeile) und reflektiert TrĂ€nke. Sie bricht ab 15 normalem Schaden. Der Spieler erhĂ€lt nur 1 Herz Damage (1.5 bei Crits) und nur Schaden von Gegnern wird ĂŒbertragen. Bricht die Barriere, ertönt ein Wither-Sound. +* **Eismagier (IceMage) [Fertig]** + * *Aggressive:* Speed I in Eisbiomen. Angriffe auf Gegner haben eine Chance auf Slowness. + * *Passive (Schneeball):* Ein geworfener Schneeball explodiert in alle Richtungen (360°). Getroffene Gegner erhalten Freeze (3 Sek.) und Slowness II (2 Sek.). +* **Backup [Fertig]** + * Kann sich zu jeder beliebigen Zeit in der Runde ein Kit aussuchen. +* **Ninja [In Arbeit]** + * *Aggressive (Teleport):* Wenn der Spieler sneakt, teleportiert er sich hinter den Gegner (der in den letzten 10 Sekunden geschlagen wurde). + * *Passive (Smoke):* Erzeugt Rauch um den Spieler. Laufen Gegner hinein, bekommen sie Blindness I und Slowness I. +* **Spielo [In Arbeit]** + * *Aggressive (Höheres Risiko):* Gambeln auf Knopfdruck ("Automat"). Gibt Random Items oder löst ein Event aus. + * *Passive (Sicherer):* Inventar mit Slot-Automat (wenn kein Spieler in der NĂ€he ist). Der Spieler kann keine Dia-Armor bekommen, hat dafĂŒr aber keinen Instant Death zu befĂŒrchten. +* **Tesla [Fertig]** + * *Aggressive:* Es erscheinen zufĂ€llige Blitze im Umkreis von 5 Blöcken (1,5 Herzen Schaden). + * *Passive:* Gegner in der NĂ€he werden weggeknockt und bekommen Brandschaden. *EinschrĂ€nkung:* Funktioniert ab einer Höhe von 50 Blöcken nicht mehr. +* **Rattlesnake [Fertig]** + * Modus, bei dem man Speed II bekommt. LĂ€d sich durch Sneaken auf (je lĂ€nger, desto weiter springt man; 3 bis 10 Blöcke). + * *Hit:* Wenn man einen Gegner anspringt (Vor Feast 1x, danach 3x nötig), bekommt dieser Poison II (8 Sek.). + * *Miss:* Wenn der Sprung nicht trifft, erhĂ€lt der Gegner verschiedene andere Effekte (Nausea, Slowness). +* **Armorer [Fertig]** + * Bekommt alle 2 Kills bessere RĂŒstung (Schuhe & Brustplatte). + * Falls der Spieler bereits ein Teil besitzt, wird dieses durch das aktuelle RĂŒstungslevel ersetzt, sobald es zerbricht. +* **Voodoo [Fertig]** + * *Aggressive:* 20% Wahrscheinlichkeit, getroffenen Gegnern den Wither-Effekt zu geben. Hat der Gegner unter 50% Leben, kann er fĂŒr 5 Sekunden festgehalten werden. + * *Passive:* Spieler kann Gegner in der NĂ€he mit einem Fluch belegen (gibt negative Effekte). WĂ€hrend der Gegner verflucht ist, erhĂ€lt der Voodoo-Spieler temporĂ€re Buffs. +* **Black Panther [Fertig]** + * *Aggressive:* 12 Sekunden lang 6,5 Damage (3,25 Herzen) mit der Faust. Pusht Gegner in der NĂ€he weg (Partikel fliegen hinterher, Enderperlen machen extra Schaden). + * *Passive ("Wakanda Forever!"):* Springt auf Gegner und macht Instant Damage (3 Herzen) plus eine Explosion mit Krater (Ă€hnlich wie Meteor). +* **Dreizack (Trident) [In Arbeit]** + * Kann 3x hoch und runter jumpen. Beim Aufprall erscheint ein Blitz. +* **Anchor [Fertig]** + * EingeschrĂ€nktes NoKnockback. Baut man den Anchor ab, ertönt der Eisengolem-Sterbesound. + * *Aggressive:* 5-Block-Radius, aus dem man sich nicht bewegen kann, aber man macht 0,5 Herzen mehr Schaden. + * *Passive:* GrĂ¶ĂŸerer Radius (vermutlich 7,5 - 10 Blöcke). +* **Blitzcrank [In Arbeit]** + * *Offensive:* Hook. + * *Defensive:* Stun. + * *Ult (Beide Styles):* FlĂ€chenschaden im Umkreis. +* **Puppet (basiert auf Fiddlesticks) [Fertig]** + * *Aggressive:* Saugt fĂŒr 2 Sekunden Leben von nahen Gegnern (Pro Spieler: 4 Herzen/Sekunde; Max 8 Herzen Heilung). Die FĂ€higkeit kann abgebrochen werden. + * *Defensive:* Gegner in der NĂ€he bekommen Blindness und Slowness fĂŒr 4 Sekunden. +* **TheWorld [Fertig]** + * *Aggressive:* Welle in alle Richtungen mit Partikeln. Teleportiert in Blickrichtung bei Aktivierung (Max 3). + * *Defensive:* Welle in alle Richtungen mit Partikeln. Friert Gegner in der NĂ€he fĂŒr 10 Sekunden ein. Maximal 5 Hits gegen gefrorene Gegner möglich. +* **Gladiator [Fertig]** *(FĂ€higkeiten nicht nĂ€her erlĂ€utert).* + +--- + +## ✅ Checklisten-Status (Stand: 28.03.2026) + +**Abgeschlossene Systeme:** +* [x] Compass +* [x] Start (Speed, Haste, Auto-Pickup) +* [x] Phasen (Lobby, Invis, Battle, End) +* [x] Level (Elo- / Rank-System) +* [x] Perks-System +* [x] Kit-System +* [x] Naturkatastrophen-System +* [x] Map-System + +**Noch Offen:** +* [ ] Custom World-Generation +* [ ] Kits: Ninja, Spielo, Trident, Blitzcrank. \ No newline at end of file