# ⚔️ CustomItems
**Plugin dodający 11 unikalnych, niestandardowych przedmiotów z własnymi zdolnościami — w pełni konfigurowalnych przez administratora, bez potrzeby restartu serwera.**
Kompatybilny z **Minecraft 26.2** (Paper).
---
## Jak to działa?
- Administrator wydaje przedmioty graczom przez wygodne, klikalne **GUI** (`/customitemgui`)
- Zwykli gracze mogą **podejrzeć** wszystkie dostępne przedmioty przez `/zobaczeventowki` (bez możliwości ich zdobycia)
- **Wszystkie** procenty, cooldowny i wartości liczbowe edytujesz w jednym pliku `config.yml`
- Zmiany w configu wchodzą w życie **natychmiast** dzięki `/customitemsreload` — żadnych restartów serwera
---
## Lista przedmiotów
### Wędka Strażnika
Rzuć wędką, aby przywołać nieruchomego, nieagresywnego Strażnika dokładnie tam, gdzie wyląduje haczyk. Dopóki żyje, nakłada na pobliskich graczy Powolne Kopanie (efekt utrzymuje się jeszcze chwilę po jego śmierci). Strażnik znika sam po ustalonym czasie.
- Konfigurowalny cooldown, czas życia Strażnika, promień i poziom efektu
### Miecz Endermana
Kliknij PPM, aby teleportować się w losowe, bezpieczne miejsce w pobliżu — nigdy do lawy, wody, śniegu ani wewnątrz bloków. Jeśli nie znajdzie bezpiecznego miejsca, zdolność nie zużywa odnowienia.
- Konfigurowalny cooldown i promień obszaru teleportacji
### Miecz Wampira
Każde trafienie leczy Cię o procent zadanych obrażeń. Czysto pasywna zdolność — żadnego cooldownu.
- Konfigurowalny procent leczenia
### Siekiera Tora
Trafienia krytyczne rażą przeciwnika prawdziwym piorunem.
- Konfigurowalny cooldown
### Miecz Feniksa
Gdy Twoje zdrowie spadnie do ustalonego progu, miecz automatycznie leczy Cię i podpala wszystkich wrogów w pobliżu — dosłowne "odrodzenie z ognia" w krytycznym momencie walki.
- Konfigurowalny próg aktywacji, procent leczenia, promień i czas podpalenia, cooldown
### Kilof 3x3
Kopie od razu cały obszar 3x3 wokół trafionego bloku, dropiąc normalny loot. Bezpieczny dla skrzyń i bloków administracyjnych — te nigdy nie zostaną naruszone.
### Lizak
Trzymany w lewej ręce zmniejsza Twój rozmiar i daje Siłę — świetne do zaskakiwania przeciwników albo zabawy.
- Konfigurowalny procent pomniejszenia i poziom siły
### Siekiera Gincha
Trafienie zabiera przeciwnikowi procent jego AKTUALNEGO zdrowia — im więcej HP ma cel, tym mocniejszy cios.
- Konfigurowalny procent i cooldown
### Miecz Królika
Trafienie **realnie blokuje możliwość skoku** przeciwnika na kilka sekund (nie jest to efekt eliksiru — sama akcja skoku zostaje zablokowana).
- Konfigurowalny czas blokady i cooldown
### Kostka Rubika
Główka z prawdziwą teksturą Kostki Rubika — nie da się jej postawić jako bloku. Trafienie gracza losowo miesza cały jego ekwipunek (zbroja i pancerz pozostają nietknięte).
- Konfigurowalny cooldown, tekstura do podmiany w configu
### Totem Ułaskawienia
Działa jak zwykły Totem Nieśmiertelności — ratuje przed śmiercią — ale dodatkowo teleportuje gracza w bezpieczne, ustalone przez administratora miejsce. Jednorazowego użytku, zużywa się automatycznie.
- Miejsce teleportacji ustawiane komendą admina `/ustawtotemulaskawienia`
---
## ️ Komendy
| Komenda | Opis | Uprawnienia |
|---|---|---|
| `/customitemgui` | Otwiera GUI do wydawania przedmiotów | `customitems.admin` |
| `/zobaczeventowki` | Podgląd wszystkich przedmiotów (bez wydawania) | brak — dla każdego gracza |
| `/customitemsreload` | Przeładowuje config.yml bez restartu serwera | `customitems.admin` |
| `/ustawtotemulaskawienia` | Ustawia miejsce teleportacji Totemu Ułaskawienia | `customitems.admin` |
---
## ✅ Dlaczego warto?
- **Pełna konfigurowalność** — dostosuj balans do swojego serwera bez znajomości Javy
- **Bezpieczeństwo** — żadna zdolność nie modyfikuje/nie niszczy bloków poza zamierzonym działaniem (Kilof 3x3), a skrzynie są zawsze chronione
- **Przejrzysty system uprawnień** — pełna kontrola nad tym, kto może wydawać przedmioty
- **Zero configu = zero problemów** — wszystko działa "z pudełka" z sensownymi wartościami domyślnymi
---
*Wymagania: Minecraft 26.2, serwer Paper (lub pochodny).*
**Plugin dodający 11 unikalnych, niestandardowych przedmiotów z własnymi zdolnościami — w pełni konfigurowalnych przez administratora, bez potrzeby restartu serwera.**
Kompatybilny z **Minecraft 26.2** (Paper).
---
## Jak to działa?
- Administrator wydaje przedmioty graczom przez wygodne, klikalne **GUI** (`/customitemgui`)
- Zwykli gracze mogą **podejrzeć** wszystkie dostępne przedmioty przez `/zobaczeventowki` (bez możliwości ich zdobycia)
- **Wszystkie** procenty, cooldowny i wartości liczbowe edytujesz w jednym pliku `config.yml`
- Zmiany w configu wchodzą w życie **natychmiast** dzięki `/customitemsreload` — żadnych restartów serwera
---
## Lista przedmiotów
### Wędka Strażnika
Rzuć wędką, aby przywołać nieruchomego, nieagresywnego Strażnika dokładnie tam, gdzie wyląduje haczyk. Dopóki żyje, nakłada na pobliskich graczy Powolne Kopanie (efekt utrzymuje się jeszcze chwilę po jego śmierci). Strażnik znika sam po ustalonym czasie.
- Konfigurowalny cooldown, czas życia Strażnika, promień i poziom efektu
### Miecz Endermana
Kliknij PPM, aby teleportować się w losowe, bezpieczne miejsce w pobliżu — nigdy do lawy, wody, śniegu ani wewnątrz bloków. Jeśli nie znajdzie bezpiecznego miejsca, zdolność nie zużywa odnowienia.
- Konfigurowalny cooldown i promień obszaru teleportacji
### Miecz Wampira
Każde trafienie leczy Cię o procent zadanych obrażeń. Czysto pasywna zdolność — żadnego cooldownu.
- Konfigurowalny procent leczenia
### Siekiera Tora
Trafienia krytyczne rażą przeciwnika prawdziwym piorunem.
- Konfigurowalny cooldown
### Miecz Feniksa
Gdy Twoje zdrowie spadnie do ustalonego progu, miecz automatycznie leczy Cię i podpala wszystkich wrogów w pobliżu — dosłowne "odrodzenie z ognia" w krytycznym momencie walki.
- Konfigurowalny próg aktywacji, procent leczenia, promień i czas podpalenia, cooldown
### Kilof 3x3
Kopie od razu cały obszar 3x3 wokół trafionego bloku, dropiąc normalny loot. Bezpieczny dla skrzyń i bloków administracyjnych — te nigdy nie zostaną naruszone.
### Lizak
Trzymany w lewej ręce zmniejsza Twój rozmiar i daje Siłę — świetne do zaskakiwania przeciwników albo zabawy.
- Konfigurowalny procent pomniejszenia i poziom siły
### Siekiera Gincha
Trafienie zabiera przeciwnikowi procent jego AKTUALNEGO zdrowia — im więcej HP ma cel, tym mocniejszy cios.
- Konfigurowalny procent i cooldown
### Miecz Królika
Trafienie **realnie blokuje możliwość skoku** przeciwnika na kilka sekund (nie jest to efekt eliksiru — sama akcja skoku zostaje zablokowana).
- Konfigurowalny czas blokady i cooldown
### Kostka Rubika
Główka z prawdziwą teksturą Kostki Rubika — nie da się jej postawić jako bloku. Trafienie gracza losowo miesza cały jego ekwipunek (zbroja i pancerz pozostają nietknięte).
- Konfigurowalny cooldown, tekstura do podmiany w configu
### Totem Ułaskawienia
Działa jak zwykły Totem Nieśmiertelności — ratuje przed śmiercią — ale dodatkowo teleportuje gracza w bezpieczne, ustalone przez administratora miejsce. Jednorazowego użytku, zużywa się automatycznie.
- Miejsce teleportacji ustawiane komendą admina `/ustawtotemulaskawienia`
---
## ️ Komendy
| Komenda | Opis | Uprawnienia |
|---|---|---|
| `/customitemgui` | Otwiera GUI do wydawania przedmiotów | `customitems.admin` |
| `/zobaczeventowki` | Podgląd wszystkich przedmiotów (bez wydawania) | brak — dla każdego gracza |
| `/customitemsreload` | Przeładowuje config.yml bez restartu serwera | `customitems.admin` |
| `/ustawtotemulaskawienia` | Ustawia miejsce teleportacji Totemu Ułaskawienia | `customitems.admin` |
---
## ✅ Dlaczego warto?
- **Pełna konfigurowalność** — dostosuj balans do swojego serwera bez znajomości Javy
- **Bezpieczeństwo** — żadna zdolność nie modyfikuje/nie niszczy bloków poza zamierzonym działaniem (Kilof 3x3), a skrzynie są zawsze chronione
- **Przejrzysty system uprawnień** — pełna kontrola nad tym, kto może wydawać przedmioty
- **Zero configu = zero problemów** — wszystko działa "z pudełka" z sensownymi wartościami domyślnymi
---
*Wymagania: Minecraft 26.2, serwer Paper (lub pochodny).*
CustomItemGui CIG is a free Minecraft Java mod. Compatible with Minecraft 26.2. Downloaded 5 times (via Spigot). Download it and open it directly in the game.