PL:

🛠️ Opis projektu

Ghost-Crates to nowoczesny plugin na skrzynie z kluczami na serwer Minecraft. Ma rozbudowane animacje otwierania, edytor dostępny w całości z poziomu gry i hologramy nad skrzyniami. Nie musisz grzebać w plikach: skrzynie, nagrody, klucze i hologramy ustawiasz w wygodnym GUI.

Plugin idealnie sprawdzi się do:

• Tworzenia skrzyń z nagrodami za głosowanie, eventy lub sklep serwera.
• Nagród w postaci przedmiotów oraz komend (rangi, pieniądze, kity, uprawnienia).
• Efektownych otwarć, które widzą wszyscy gracze w pobliżu skrzyni.
• Rozdawania kluczy pojedynczym graczom lub wszystkim graczom online jedną komendą.

🎰 Animacje otwierania

W GUI:

• roulette » Klasyczna ruletka z płynnym zwalnianiem.
• wheel » Koło fortuny ze światłem biegnącym po nagrodach.
• shuffle » Nagrody migają i znikają, aż zostanie jedna.
• pick » Gracz sam wybiera jedną z zakrytych nagród.

W świecie, nad skrzynią:

• world » Wirujący przedmiot unosi się nad blokiem i zatrzymuje na wygranej.
• orbit » Nagrody krążą wokół skrzyni, a wygrywa ta, która zatrzyma się przed graczem.
• fountain » Fontanna nagród wystrzeliwuje ze skrzyni, a na koniec wynurza się wygrana.

Każdą animację możesz dowolnie edytować albo skopiować i stworzyć własną w folderze animacje/.

✨ Najważniejsze funkcje

• Edytor w grze: Skrzynie, nagrody, szanse, klucze, lore i hologramy ustawiasz bez wychodzenia z gry. Tekst wpisujesz w kowadle.
• Uczciwe losowanie: Szanse liczone są z wag nagród, a edytor pokazuje rzeczywisty procent każdej nagrody.
• Nagrody-komendy: Do nagrody możesz dodać komendy wykonywane z konsoli lub jako gracz.
• Hologramy z licznikiem: Teksty nad skrzyniami obsługują kolory HEX i placeholder %opened% z liczbą otwarć.
• Cząsteczki: Animowane efekty wokół skrzyń (ring, spirala, helisa, aureola) z wyborem typu i koloru.
• Ogłoszenia rzadkich dropów: Wiadomość na czacie i fajerwerk (bez obrażeń) przy wylosowaniu cennej nagrody.
• Bezpieczeństwo: Wyjście z serwera lub restart w trakcie animacji nie zabiera klucza, bo nagroda wydawana jest od razu. Skrzynie są chronione przed zniszczeniem i wybuchami.

---

⚠️ Ważne informacje przed pobraniem

🎖️ Komendy

• /case help » Wyświetla listę komend.
• /case create <nazwa> » Tworzy nową skrzynię.
• /case delete <nazwa> » Usuwa skrzynię.
• /case rename <nazwa> <nowa> » Zmienia nazwę skrzyni.
• /case ustaw-lokacje <nazwa> » Ustawia skrzynię na klikniętym bloku.
• /case usun-lokacje » Usuwa skrzynię z klikniętego bloku.
• /case give key <gracz/all> <skrzynia> <ilość> » Daje klucze graczowi lub wszystkim graczom online.
• /case edit » Otwiera edytor GUI.
• /case reload » Przeładowuje konfigurację pluginu.

Aliasy: /crate, /crates, /skrzynie

🍀 Permisje

• ghost.crates.admin » Główna permisja administracyjna, wymagana do wszystkich komend i edytora.
• ghost.crates.open.<skrzynia> » Opcjonalna permisja do otwierania danej skrzyni (włączana w edytorze).

📘 Wymagane pluginy

• Brak (Plugin jest całkowicie samodzielny i nie wymaga zewnętrznych API ani dodatków).
• Wymagany silnik: Paper 1.20.6+

bStats:

• https://bstats.org/plugin/bukkit/Ghost-Crates

---

EN:

🛠️ Project Description

Ghost-Crates is a modern key-based crate plugin for Minecraft servers. It comes with rich opening animations, a fully in-game editor and holograms above crates. No more digging through files: you set up crates, rewards, keys and holograms in a convenient GUI.

The plugin is perfect for:

• Creating reward crates for voting, events or your server store.
• Rewards in the form of items and commands (ranks, money, kits, permissions).
• Eye-catching openings that every nearby player can watch.
• Handing out keys to a single player or to everyone online with one command.

🎰 Opening Animations

In a GUI:

• roulette » Classic roulette with smooth slow-down.
• wheel » Wheel of fortune with a light running around the rewards.
• shuffle » Rewards flicker and disappear until only one remains.
• pick » The player chooses one of the hidden rewards.

In the world, above the crate:

• world » A spinning item rises above the block and stops on the prize.
• orbit » Rewards orbit around the crate, and the one that stops in front of the player wins.
• fountain » A fountain of rewards bursts out of the crate before the prize emerges.

Every animation can be fully customized, or copied to create your own in the animacje/ folder.

✨ Key Features

• In-game editor: Set up crates, rewards, chances, keys, lore and holograms without leaving the game. Text is typed in an anvil.
• Fair rolling: Chances are based on reward weights, and the editor shows the real percentage of each reward.
• Command rewards: Add commands to any reward, executed from the console or as the player.
• Holograms with a counter: Crate holograms support HEX colors and the %opened% placeholder showing how many times the crate was opened.
• Particles: Animated effects around crates (ring, spiral, helix, halo) with selectable type and color.
• Rare drop announcements: A chat broadcast and a harmless firework when a valuable reward is won.
• Safety: Leaving the server or a restart during an animation never wastes a key, because the reward is given instantly. Crates are protected from breaking and explosions.

---

⚠️ Critical Information before downloading

🎖️ Commands

• /case help » Shows the list of commands.
• /case create <name> » Creates a new crate.
• /case delete <name> » Deletes a crate.
• /case rename <name> <new> » Renames a crate.
• /case ustaw-lokacje <name> » Places the crate on the clicked block.
• /case usun-lokacje » Removes the crate from the clicked block.
• /case give key <player/all> <crate> <amount> » Gives keys to a player or to everyone online.
• /case edit » Opens the GUI editor.
• /case reload » Reloads the plugin configuration.

Aliases: /crate, /crates, /skrzynie

🍀 Permissions

• ghost.crates.admin » Main administrative permission, required for all commands and the editor.
• ghost.crates.open.<crate> » Optional permission to open a specific crate (enabled in the editor).

📘 Required plugins

• None (The plugin is fully standalone and does not require any external APIs or dependencies).
• Required server software: Paper 1.20.6+

bStats:

• https://bstats.org/plugin/bukkit/Ghost-Crates