From e04bc33c0917dbc4a2c40335925895d6d6997170 Mon Sep 17 00:00:00 2001
From: admin <admin@milujukockoholky.eu>
Date: Sun, 26 Jul 2026 23:49:50 +0200
Subject: [PATCH] =?UTF-8?q?P=C5=99id=C3=A1ny=20nov=C3=A9=20schopnosti=20(S?=
 =?UTF-8?q?uper=20Powers),=20kompletn=C4=9B=20p=C5=99epracov=C3=A1na=20arc?=
 =?UTF-8?q?hitektura=20syst=C3=A9mu=20schopnost=C3=AD,=20refaktorov=C3=A1n?=
 =?UTF-8?q?=20BasePower=20a=20spr=C3=A1va=20=C5=BEivotn=C3=ADho=20cyklu=20?=
 =?UTF-8?q?schopnost=C3=AD,=20optimalizov=C3=A1na=20registrace=20a=20zprac?=
 =?UTF-8?q?ov=C3=A1n=C3=AD=20ud=C3=A1lost=C3=AD,=20opraveny=20p=C3=A1dy=20?=
 =?UTF-8?q?zp=C5=AFsoben=C3=A9=20uvoln=C4=9Bn=C3=BDmi=20deleg=C3=A1ty=20(G?=
 =?UTF-8?q?C),=20stabilizov=C3=A1ny=20callbacky=20CheckTransmit=20a=20Next?=
 =?UTF-8?q?WorldUpdate,=20vylep=C5=A1ena=20implementace=20Wallhacku,=20opr?=
 =?UTF-8?q?aveny=20chyby=20FunctionReference,=20zv=C3=BD=C5=A1en=20v=C3=BD?=
 =?UTF-8?q?kon,=20odstran=C4=9Bny=20chyby=20kompilace=20a=20buildu=20.NET?=
 =?UTF-8?q?=208,=20vy=C4=8Di=C5=A1t=C4=9Bn=20a=20sjednocen=20zdrojov=C3=BD?=
 =?UTF-8?q?=20k=C3=B3d,=20vylep=C5=A1ena=20inicializace=20pluginu,=20aktua?=
 =?UTF-8?q?lizov=C3=A1na=20dokumentace=20a=20celkov=C3=A1=20struktura=20pr?=
 =?UTF-8?q?ojektu.?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 285 ++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 285 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..ba64b35
--- /dev/null
+++ b/README.md
@@ -0,0 +1,285 @@
+# CS2 Super Powers
+
+Moderní plugin pro **Counter-Strike 2 (CounterStrikeSharp)**, který přidává unikátní schopnosti hráčům. Plugin je navržen s důrazem na modularitu, výkon a snadné rozšiřování.
+
+---
+
+# ✨ Funkce
+
+- 🦸 Modulární systém schopností
+- ⚡ Jednoduché přidávání nových Powers
+- 🔄 Automatická registrace schopností
+- 🎯 Event-based architektura
+- 🚀 Optimalizované callbacky
+- 🛡️ Opravené GC (Garbage Collector) problémy
+- 📦 Přehledná struktura projektu
+- ⚙️ Jednoduchá konfigurace
+- 🧩 Podpora CounterStrikeSharp API
+- 🔥 Optimalizováno pro vysoký počet hráčů
+
+---
+
+# Dostupné schopnosti
+
+## Double Jump
+
+- druhý skok ve vzduchu
+
+## Jetpack
+
+- létání pomocí jetpacku
+- řízení směru letu
+- omezení rychlosti
+
+## Wallhack
+
+- zvýraznění hráčů skrz zdi
+- bezpečná implementace CheckTransmit
+
+## Shield
+
+- dočasný ochranný štít
+
+## Explosive Bullets
+
+- výbušné střely
+- poškození v okolí zásahu
+
+## Random Teleport
+
+- náhodný teleport
+
+## Time Slowdown
+
+- zpomalení času
+- ovlivnění okolních hráčů
+
+---
+
+# Architektura
+
+Projekt byl kompletně přepracován.
+
+```
+Plugin
+│
+├── BasePower
+│
+├── Powers
+│   ├── DoubleJump
+│   ├── Jetpack
+│   ├── Shield
+│   ├── Wallhack
+│   ├── ExplosiveBullets
+│   ├── RandomTeleport
+│   └── TimeSlowdown
+│
+├── Managers
+│
+├── Helpers
+│
+└── Utilities
+```
+
+Každá schopnost dědí ze společné třídy **BasePower**, která poskytuje:
+
+- inicializaci
+- registraci eventů
+- správu timerů
+- NextFrame callbacky
+- cleanup
+- správu hráčů
+
+---
+
+# Refaktoring
+
+Projekt prošel rozsáhlým refaktoringem.
+
+### Změny
+
+- nová architektura BasePower
+- sjednocení všech Powers
+- odstranění duplicitního kódu
+- centralizovaná registrace eventů
+- lepší organizace projektu
+- jednodušší údržba
+- vyšší rozšiřitelnost
+
+---
+
+# Optimalizace
+
+Bylo provedeno mnoho optimalizací.
+
+- méně alokací
+- efektivnější callbacky
+- rychlejší registrace eventů
+- opětovné využití handlerů
+- nižší využití paměti
+- lepší výkon serveru
+
+---
+
+# Opravy
+
+## Garbage Collector
+
+Opraven kritický problém, kdy .NET Garbage Collector uvolňoval delegáty registrované do CounterStrikeSharp.
+
+Vyřešeno:
+
+- CheckTransmit
+- NextWorldUpdate
+- PlayerSpawn
+- PlayerDeath
+- PlayerDisconnect
+- PlayerTeamChange
+
+Používají se persistentní delegate instance.
+
+---
+
+## FunctionReference
+
+Opraveny pády způsobené:
+
+- FunctionReference
+- Callback disposed
+- Invalid delegate
+- GC Collection
+
+---
+
+## Wallhack
+
+Kompletně přepsaná implementace.
+
+Novinky:
+
+- bezpečné callbacky
+- persistentní CheckTransmit
+- lepší výkon
+- vyšší stabilita
+
+---
+
+# Event systém
+
+Kompletně přepracovaný event systém.
+
+Podporuje:
+
+- automatickou registraci
+- automatické odregistrování
+- bezpečné callbacky
+- správu životního cyklu
+- jednodušší implementaci nových Powers
+
+---
+
+# Build
+
+Opraveny problémy s kompilací.
+
+Vyřešeno:
+
+- .NET 8
+- CounterStrikeSharp API
+- Callback registrace
+- Build Errors
+- Compiler Warnings
+
+Projekt se nyní sestavuje bez chyb.
+
+---
+
+# Výkon
+
+Po refaktoringu bylo dosaženo:
+
+- vyšší stability
+- menší spotřeby paměti
+- rychlejší registrace
+- menší počet alokací
+- lepší práce s callbacky
+- bezpečnější práce s delegáty
+
+---
+
+# Přidání nové schopnosti
+
+Stačí vytvořit novou třídu:
+
+```csharp
+public class MyPower : BasePower
+{
+}
+```
+
+a zaregistrovat ji do pluginu.
+
+---
+
+# Použité technologie
+
+- C#
+- .NET 8
+- CounterStrikeSharp
+- CounterStrikeSharp.API
+
+---
+
+# Stav projektu
+
+✅ Kompletně refaktorováno
+
+✅ Opraveny kritické pády
+
+✅ Optimalizován výkon
+
+✅ Nová architektura
+
+✅ Modulární systém schopností
+
+✅ Stabilní callback systém
+
+✅ Připraveno pro další rozšiřování
+
+---
+
+# Changelog
+
+## Přidáno
+
+- BasePower
+- nové Powers
+- systém registrace
+- helper utility
+- timer management
+- NextFrame helpery
+
+## Změněno
+
+- architektura pluginu
+- registrace eventů
+- správa callbacků
+- životní cyklus Powers
+- inicializace pluginu
+
+## Opraveno
+
+- Garbage Collector crash
+- FunctionReference crash
+- CheckTransmit
+- NextWorldUpdate
+- Build chyby
+- Wallhack
+- callbacky
+- delegate reference
+
+---
+
+# Licence
+
+Tento projekt je určen pro Counter-Strike 2 servery využívající CounterStrikeSharp.
\ No newline at end of file