PL:

🛠️ Opis projektu

Ghost-Crates to nowoczesny plugin na skrzynie z kluczami i lootboxami 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, lootboxy 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 (albo tylko otwierający).
• Rozdawania kluczy i lootboxów 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.
• spiral » Nagrody wznoszą się spiralą wokół skrzyni, aż zostanie tylko wygrana.
• rain » Deszcz nagród spada na skrzynię, a na koniec powoli opada wygrana.

Animacje w świecie mogą być widoczne dla wszystkich albo tylko dla otwierającego (opcja only-opener). Wtedy kilku graczy może otwierać tę samą skrzynię jednocześnie. Każdą animację możesz dowolnie edytować albo skopiować i stworzyć własną w folderze animacje/.

🎁 Lootboxy

• Każda skrzynia ma swój lootbox, czyli przedmiot, który otwierasz PPM z ręki, w dowolnym miejscu i bez klucza.
• Lootbox ma ten sam drop i tę samą animację co skrzynia. Animacje w świecie pokazują się przed graczem.
• Wygląd lootboxa (nazwa, lore, przedmiot, poświata, CustomModelData) ustawiasz w osobnej zakładce edytora.

✨ Najważniejsze funkcje

• Edytor w grze: Skrzynie, nagrody, szanse, klucze, lootboxy, lore i hologramy ustawiasz bez wychodzenia z gry. Tekst wpisujesz w kowadle, a wygląd klucza lub lootboxa możesz skopiować z dowolnego przedmiotu.
• 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.
• Powiadomienia o aktualizacjach: Plugin sam sprawdza nowe wersje na Modrinth i informuje administratorów przy wejściu, z klikalnym podglądem zmian.
• 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, a kluczy i lootboxów nie da się postawić jako bloku.
• Pełna konfiguracja: Wszystkie wiadomości (czat, actionbar, title), dźwięki i GUI są w plikach konfiguracyjnych.

---

⚠️ 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 give lootbox <gracz/all> <skrzynia> <ilość> » Daje lootboxy 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 i jej lootboxa (włączana w edytorze).
• ghost.crates.update » Powiadomienia o nowej wersji pluginu przy wejściu (domyślnie OP).

📘 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 crate plugin with keys and lootboxes 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, lootboxes 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 (or only the opener).
• Handing out keys and lootboxes 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.
• spiral » Rewards rise in a spiral around the crate until only the prize remains.
• rain » Rewards rain down onto the crate, and the prize slowly floats down last.

World animations can be visible to everyone or only to the opener (only-opener option), which lets several players open the same crate at once. Every animation can be fully customized, or copied to create your own in the animacje/ folder.

🎁 Lootboxes

• Every crate has its own lootbox: an item you open with a right-click from your hand, anywhere, without a key.
• A lootbox has the same drops and the same animation as its crate. World animations play in front of the player.
• The lootbox look (name, lore, item, glow, CustomModelData) is set in a separate editor tab.

✨ Key Features

• In-game editor: Set up crates, rewards, chances, keys, lootboxes, lore and holograms without leaving the game. Text is typed in an anvil, and a key's or lootbox's look can be copied from any item.
• 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.
• Update notifications: The plugin checks Modrinth for new versions and notifies admins on join, with a clickable changelog preview.
• 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, and keys and lootboxes can't be placed as blocks.
• Fully configurable: All messages (chat, actionbar, title), sounds and GUIs live in config files.

---

⚠️ 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 give lootbox <player/all> <crate> <amount> » Gives lootboxes 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 and its lootbox (enabled in the editor).
• ghost.crates.update » New version notifications on join (OP by default).

📘 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* /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