NightCode - Crates

1. ENG (English Version) Summary:

Advanced, high-performance Crates plugin featuring 3D models (Nexo/ItemsAdder), TextDisplay holograms, and 4 animations.

Full Description:

NightCode-Crates Required Version: 1.16+ to 1.21.x+ (Paper / Purpur / Spigot)

Required Plugins: None (The plugin is fully standalone)

Optional Plugins: PlaceholderAPI, Nexo / ItemsAdder (3D models and textures)

Plugin Description:

An advanced, seamlessly optimized, and fully modular crates/mystery boxes plugin designed for modern Minecraft servers. It allows you to apply custom 3D models and textures from Nexo/ItemsAdder to keys and rewards with full CustomModelData support. Featuring 4 stunning unboxing animations and a lightning-fast Instant Mode that eliminates tedious cursor resetting to the center of the screen. Powered by a modern hologram system built on single TextDisplay entities (zero server overhead, invisible in Spectator GM 3, with support for HEX/ARGB background colors and transparency). Every crate is completely independent—featuring its own directory with dedicated GUI files, custom messages using the {PREFIX} tag, drop rate settings, and automatic config updating via the Okaeri Configs library.

Commands:

/case help - Displays a list of all available commands

/case create <id> - Creates a new, fully configured crate with its own folder

/case delete <id> - Safely deletes the specified crate alongside its files

/case set <id> - Links the target block to a crate and spawns a hologram

/case edit <id> - Opens an in-game interactive GUI editor for rewards and chances

/case key give <player> <id> <amount> [physical/virtual] - Grants physical or virtual keys to a player

/case key giveall <id> <amount> [physical/virtual] - Distributes keys to all online players

/case reload - Instantly reloads configurations and refreshes all holograms

Permissions:

nc.crates.admin - Access to administrative commands, in-game GUI editor, and crate removal (Shift + LMB)

Placeholders (PlaceholderAPI):

%crates_keys_<id>% - Returns the total number of keys owned by the player (virtual + physical)

%crates_keys_virtual_<id>% - Returns the exact count of virtual keys bound to the player's account

%crates_keys_item_<id>% - Returns the number of physical key items currently in the inventory

%crates_opened_<id>% - Returns the number of times the crate has been opened by the player

%crates_pity_<id>% - Returns current progress in the Pity guarantee counter

%crates_pitymax_<id>% - Returns the required opening threshold to trigger the Pity reward

Key Features:

3D Model Support (Nexo / ItemsAdder) – Simple setup for custom key and reward textures via CustomModelData or direct Nexo IDs.

Modern TextDisplay Holograms – Lightweight single entities instead of multiple armor stands, perfectly aligned, invisible in Spectator Mode (GM 3).

Custom Hologram Backgrounds & Shadows – Ability to toggle text shadows and configure ARGB/HEX background colors.

4 Smooth Animations – Classic CS:GO Roulette, Wheel of Fortune, Slot Machine, and Mystery Box opening styles.

Instant Unboxing Mode – Direct in-place slot swap in the GUI without resetting mouse cursor coordinates.

Fully Configurable Pity System – Toggle status, adjust thresholds, specify main rewards, and toggle reset-on-hit options.

Per-Crate Independent Structure – Each crate operates out of its own crates/<id>/ folder containing individual GUI configs and settings.

Physical and Virtual Keys – Complete flexibility using traditional inventory items or account-bound virtual keys.

Auto-Updating Configs (Okaeri) – Plugin updates automatically append missing fields without overriding custom settings.

World & Chunk Stability – Handles ChunkLoadEvent and WorldLoadEvent dynamically so holograms never vanish.

In-Game GUI Editor (/case edit) – Interactive menu to modify items, drop chances, and commands on the fly.

Command Execution Rewards – Trigger console commands with the {PLAYER} placeholder alongside item drops.

Broadcast System – Customizable chat announcements for rare drops using dynamic placeholders.

Audio & Visual Effects – Highly configurable sound triggers, particle, and firework effects upon opening crates.

Multi-Page Reward Preview (RMB) – Intuitive preview GUI with page navigation and drop percentage calculations.

Placement & Loss Protection – Prevents accidental placement of key items and protects crate blocks from destruction.

Global {PREFIX} Tag Support – Fully customizable messages with options to strip the prefix completely.

Developer API – Public methods for easy integration into battle passes, quests, and leaderboards.

Smart Tab-Completer – Automatic completions for subcommands, crate IDs, player names, and key types under the TAB key.

Author: NightCode

Version: 1.0.0

1. PL (Wersja Polska) Summary:

Zaawansowany, wydajny plugin na skrzynki (Crates) z obsługą modeli 3D (Nexo/ItemsAdder), hologramami TextDisplay i 4 animacjami.

Full Description:

NightCode-Crates Wymagana wersja: 1.16+ do 1.21.x+ (Paper / Purpur / Spigot)

Wymagane pluginy: Brak (Plugin jest w pełni samodzielny)

Opcjonalne pluginy: PlaceholderAPI, Nexo / ItemsAdder (modele 3D i tekstury)

Opis pluginu:

Zaawansowany, bezkompromisowo zoptymalizowany i w pełni modułowy plugin na skrzynki (Crates / Mystery Boxes) stworzony dla nowoczesnych serwerów Minecraft. Umożliwia nakładanie customowych modeli 3D i tekstur Nexo/ItemsAdder na klucze oraz nagrody z pełnym wsparciem CustomModelData. Oferuje 4 widowiskowe animacje losowania oraz błyskawiczny tryb natychmiastowy bez uciążliwego resetowania kursora myszy na środek ekranu. Posiada nowoczesny system hologramów oparty na pojedynczych encjach TextDisplay (zerowe obciążenie serwera, brak widoczności na Spectatorze GM 3, obsługa przezroczystości i kolorów tła HEX/ARGB). Każda skrzynka jest całkowicie niezależna – posiada własny folder z dedykowanymi plikami GUI, wiadomościami z tagiem {PREFIX}, konfiguracją szans oraz wbudowaną auto-aktualizacją nowych pól dzięki bibliotece Okaeri Configs.

Komendy:

/case help - Wyświetla listę wszystkich dostępnych komend

/case create <id> - Tworzy nową, w pełni skonfigurowaną skrzynkę z osobnym folderem

/case delete <id> - Bezpiecznie usuwa wskazaną skrzynkę wraz z jej plikami

/case set <id> - Przypisuje blok, na który patrzysz, do danej skrzynki i stawia hologram

/case edit <id> - Otwiera interaktywne menu GUI w grze do edycji nagród i szans

/case key give <gracz> <id> <ilość> [physical/virtual] - Wręcza graczowi klucze fizyczne lub wirtualne

/case key giveall <id> <ilość> [physical/virtual] - Rozdaje klucze wszystkim graczom online

/case reload - Błyskawicznie przeładowuje konfiguracje i odświeża wszystkie hologramy

Permisje:

nc.crates.admin - Dostęp do komend administracyjnych, edytora GUI oraz usuwania skrzynek (Shift + LPM)

Placeholdery (PlaceholderAPI):

%crates_keys_<id>% - Zwraca łączną sumę kluczy gracza do danej skrzynki (wirtualne + w ekwipunku)

%crates_keys_virtual_<id>% - Zwraca dokładną ilość wirtualnych kluczy przypisanych do konta gracza

%crates_keys_item_<id>% - Zwraca ilość fizycznych kluczy trzymanych aktualnie w ekwipunku

%crates_opened_<id>% - Zwraca liczbę otwarć danej skrzynki przez gracza

%crates_pity_<id>% - Zwraca aktualny postęp w liczniku gwaranta Pity dla danej skrzynki

%crates_pitymax_<id>% - Zwraca wymagany próg otwarć do zdobycia nagrody z systemu Pity

Główne Funkcje:

Wsparcie Modeli 3D (Nexo / ItemsAdder) – proste podpinanie customowych tekstur kluczy i nagród przez CustomModelData lub bezpośrednie ID z Nexo.

Nowoczesne Hologramy TextDisplay – jedna lekka encja zamiast wielu stojaków, idealne wyśrodkowanie, brak niewidzialnych kolizji i brak widoczności w trybie Spectator (GM 3).

Cienie i Kolorowe Tła Hologramów – możliwość całkowitego wyłączenia cienia oraz konfiguracja tła w formatach HEX i ARGB.

4 Płynne Animacje Losowania – Klasyczna Ruletka CS:GO (Roulette), Koło Fortuny (Wheel), Automat (Slot Machine) oraz Skrzynia Tajemnic (Mystery Box).

Płynne Otwieranie Instant – natychmiastowe losowanie z in-place podmianą slotu w GUI.

W pełni Konfigurowalny System Pity – możliwość wyłączenia systemu, ustawienia progu gwaranta, wyboru nagród głównych oraz opcji resetu po trafieniu.

Niezależna Struktura Per-Skrzynka – każda skrzynka posiada własny folder crates/<id>/ z osobnymi plikami GUI, wiadomościami i konfiguracją.

Klucze Fizyczne oraz Wirtualne – wsparcie dla tradycyjnych itemów w EQ oraz kluczy wirtualnych przypisanych do konta.

Auto-Aktualizacja z Okaeri Configs – automatyczne dopisywanie nowych opcji bez resetowania starych configów.

Niezawodność Chunków i Światów – dynamiczna obsługa zdarzeń gwarantująca, że hologramy nie znikają po wyjściu gracza z terenu.

Edytor GUI w Grze (/case edit) – interaktywne menu umożliwiające szybką edycję przedmiotów, szans i komend w locie.

Wykonywanie Komend przy Wygranej – nagrody mogą wykonywać polecenia konsoli z placeholderem {PLAYER}.

System Ogłoszeń (Broadcast) – powiadomienia na czacie o wylosowaniu rzadkiego dropu.

Dźwięki i Efekty Wizualne – pełna konfiguracja dźwięków, cząsteczek i fajerwerków.

Wielostronicowy Podgląd Nagród (PPM) – menu podglądu z dokładnym wyliczeniem szans procentowych.

Blokady i Bezpieczeństwo – ochrona przed przypadkowym postawieniem klucza i niszczeniem skrzynek.

Obsługa Tagu {PREFIX} – pełna swoboda konfiguracji wiadomości.

API dla Developerów – publiczne metody do integracji z questami i battlepassami.

Wygodny Tab-Completer – automatyczne podpowiadanie argumentów pod klawiszem TAB.

Autor: NightCode

Wersja: 1.0.0