Minecraft-plugin PhoenixCrates

🔌 Om Phoenix Crates

Phoenix Crates er et Minecraft-plugin til at køre crate-/belønningssystemer på en server. Det giver crate-typer, nøgler (fysiske og virtuelle), animerede åbningssekvenser og en in-game editor til at oprette og administrere crates og belønninger uden at redigere rå filer. Projektet udgives af Phoenix Plugins og findes som en gratis udgave samt en betalt premium-version med ekstra funktioner.

🎯 Formål

At give serveradministratorer et konfigurerbart belønnings-/crate-system, som kan vise animerede åbninger, håndtere nøgler og virtuelle nøgler i valuta-stil og lade staff oprette eller redigere crates og belønninger inde i spillet. Det er målrettet servere, der ønsker event-agtige eller shop-/belønningsmekanikker (for eksempel: reward giveaways, store crates eller event-præmier).

⚙️ Funktioner

• Flere crate-engine-tilstande (vanilla block, vanilla model, Model Engine-integration).
• Animerede åbningssekvenser og idle-animationer med konfigurerbare faser og kombinationer.
• Fysiske nøgler og håndtering af virtuelle nøgler (menuer for virtuelle nøgler, betaling/overførsler, give/take/set-kommandoer).
• In-game editor til at oprette/redigere crates, nøgler, belønninger og animationer.
• Belønnings-typer inklusiv tilfældige og valgfrie (spilleren vælger) belønninger, rerolls og garanterede belønninger.
• Add-ons og premium-ekstrafunktioner (yderligere animationer, MySQL-understøttelse, API og installation af add-ons i premium-planen).
• Grundlæggende Bedrock/Geyser-visningsunderstøttelse til visse animationer og modeller.
• Server-side værktøjer til preview og belønningsstyring (globale/spiller-vindgrænser, nulstilling af cooldowns).

🧩 Hvem det er til

• Survival/SMP- og økonomi-servere, der viser crates eller belønningssystemer.
• Servere, der ønsker animerede/visuelle crate-åbninger og modelunderstøttelse (Model Engine).
• Administratorer, der foretrækker en in-game editor til crate-opsætning frem for manuel filredigering.

🏗️ Eksempler på brug

• Give spillere virtuelle nøgler, som de kan bruge i et GUI til at åbne kosmetiske eller item-crates.
• Oprette højtids-tema crates med brugerdefinerede åbningsanimationer og begrænsede belønninger.
• Bruge in-game editoren til at migrere eller genopbygge crate-opsætninger uden at redigere YAML manuelt.

⌨️ Kommandoer

(Kommandoerne ovenfor er hentet fra den officielle Phoenix Crates-dokumentation og kommandoreference.)

🔐 Tilladelser

(Kun tilladelsesnoder, der eksplicit er dokumenteret af projektet, er listet.)

⚙️ Installation

📥 Opsætning

• Download den officielle Phoenix Crates-plugin-JAR eller hent den fra den officielle distributionskanal.
• Placer JAR-filen i din servers plugins/-mappe for en understøttet server (se Tekniske noter).
• Start eller genstart serveren, og tjek konsollen for at bekræfte, at pluginet blev indlæst.
• Brug in-game editoren eller de medfølgende kommandoer til at oprette crates og nøgler; pluginet tilbyder også reload- og editor-kommandoer.

📦 Afhængigheder

• Som standard er der ingen påkrævede tredjepartsafhængigheder angivet. Pluginet integrerer med valgfri systemer som Model Engine til brugerdefinerede modeller og tilbyder placeholders nævnt i changelogs.

🧠 Tekniske noter

• Understøttet serversoftware (ifølge forfatteren): Spigot og Spigot-forks, Paper og Paper-forks samt Folia.
• Understøttede Minecraft-versioner: ifølge dokumentationen understøtter Phoenix Crates (ved den angivne versionslinje) Minecraft 1.20.4+ (understøttelse af ældre versioner er blevet droppet fra den nævnte større udgave).
• Valgfri integrationer: Model Engine (brugerdefinerede animerede modeller), GeyserMC-kompatibilitetsnoter til Bedrock-visning og PlaceholderAPI-placeholders nævnt i opdateringer.
• Projektet tilbydes i gratis- og premium-niveauer; premium tilføjer funktioner som MySQL-understøttelse, offentlig API-adgang, ubegrænsede crates, yderligere animationer og add-ons.

🤝 Hvornår dette plugin er nyttigt

Hvis du har brug for et konfigurerbart crate-system drevet af animationer med in-game editor og valgfri model-/Bedrock-understøttelse, giver Phoenix Crates både visuelle elementer til spillere og admin-værktøjer til at håndtere belønninger og nøgler fra serveren.