# 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 ` » Tworzy nową skrzynię. * `/case delete ` » Usuwa skrzynię. * `/case rename ` » Zmienia nazwę skrzyni. * `/case ustaw-lokacje ` » Ustawia skrzynię na klikniętym bloku. * `/case usun-lokacje` » Usuwa skrzynię z klikniętego bloku. * `/case give key ` » Daje klucze graczowi lub wszystkim graczom online. * `/case give lootbox ` » 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.` » 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 ` » Creates a new crate. * `/case delete ` » Deletes a crate. * `/case rename ` » Renames a crate. * `/case ustaw-lokacje ` » Places the crate on the clicked block. * `/case usun-lokacje` » Removes the crate from the clicked block. * `/case give key ` » Gives keys to a player or to everyone online. * `/case give lootbox ` » 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.` » 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.` » 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

Ghost-Crates

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

skrzynia

Podgląd dropu