Compatibility
Minecraft: Java Edition
Platforms
Links
Tags
Creators
Details
PL:
🛠️ Opis projektu
Ghost-Crates to nowoczesny plugin na skrzynie z kluczami i lootboxami na serwer Minecraft. Ma rozbudowane animacje otwierania, otwieranie masowe, modele 3D skrzyń, edytor dostępny w całości z poziomu gry i hologramy nad skrzyniami. Nie musisz grzebać w plikach: skrzynie, nagrody, klucze, lootboxy, modele 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ą.
- Szybkiej przesiadki z getCase lub ExcellentCrates dzięki wbudowanemu importowi.
🎰 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/.
🔥 Otwieranie masowe
- W podglądzie skrzyni jest przycisk Otwieranie masowe, w którym wybierasz, ile skrzyń otworzyć naraz: 2, 3, 4 lub 5.
- W GUI kręci się kilka rzędów ruletki jednocześnie, a każdy rząd to osobna wygrana.
- Menu pokazuje, ile kluczy potrzeba i ile masz. Wygląd, szybkość i układ ustawisz w plikach.
🧊 Modele 3D skrzyń
- Zamiast zwykłego bloku skrzynia może być przedmiotem z modelem 3D z resource packa (CustomModelData).
- W edytorze ustawiasz model z przedmiotu w ręce, a także skalę i obrót. Oryginalny blok wraca po wyłączeniu modelu.
- Animacja modelu przy otwieraniu: podskok z obrotem, sam obrót, sam podskok albo brak, osobno dla każdej skrzyni.
🎁 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.
📦 Import z innych pluginów
/case import getcaselub/case import excellentcratesprzenosi skrzynie razem z nagrodami (przedmioty, szanse, komendy), kluczami i lokacjami.- Na czas importu stary plugin musi być włączony. Potem możesz go usunąć.
✨ Najważniejsze funkcje
- Edytor w grze: Skrzynie, nagrody, szanse, klucze, lootboxy, modele, lore i hologramy ustawiasz bez wychodzenia z gry. Tekst wpisujesz w kowadle, a wygląd klucza lub lootboxa możesz skopiować z przedmiotu w ręce.
- CustomModelData w GUI: Każdy przedmiot w każdym GUI może mieć własny model z resource packa.
- 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 import <getcase/excellentcrates>» Importuje skrzynie z innego pluginu./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).
- Opcjonalnie: getCase lub ExcellentCrates, tylko na czas importu skrzyń.
- Wymagany silnik: Paper 1.20.6+
bStats:
EN:
🛠️ Project Description
Ghost-Crates is a modern crate plugin with keys and lootboxes for Minecraft servers. It comes with rich opening animations, mass opening, 3D crate models, a fully in-game editor and holograms above crates. No more digging through files: you set up crates, rewards, keys, lootboxes, models 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.
- Switching from getCase or ExcellentCrates in minutes with the built-in importer.
🎰 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.
🔥 Mass Opening
- The crate preview has a Mass opening button where you choose how many crates to open at once: 2, 3, 4 or 5.
- Several roulette rows spin at the same time in one GUI, and each row is a separate prize.
- The menu shows how many keys you need and how many you have. Look, speed and layout are set in config files.
🧊 3D Crate Models
- Instead of a regular block, a crate can be an item with a 3D model from your resource pack (CustomModelData).
- In the editor you set the model from the item in your hand, plus its scale and rotation. The original block comes back when the model is turned off.
- Model opening animation: bounce with spin, spin only, bounce only or none, set per crate.
🎁 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.
📦 Import from Other Plugins
/case import getcaseor/case import excellentcratesmoves your crates with their rewards (items, chances, commands), keys and locations.- The old plugin must be enabled during the import. You can remove it afterwards.
✨ Key Features
- In-game editor: Set up crates, rewards, chances, keys, lootboxes, models, 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 the item in your hand.
- CustomModelData in GUIs: Every item in every GUI can use its own resource pack model.
- 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 import <getcase/excellentcrates>» Imports crates from another plugin./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).
- Optional: getCase or ExcellentCrates, only while importing crates.
- Required server software: Paper 1.20.6+


