Minecraft-plugin AxRewards

🔌 Om AxRewards

AxRewards er et Minecraft-plugin, der leverer et let og konfigurerbart belønningssystem. Serveradministratorer definerer belønninger med vilkårlige cooldowns, viser dem i redigerbare GUI'er og udfører claim-kommandoer, når spillere indløser belønninger. Projektet vedligeholdes af Artillex-Studios og inkluderer databasebaseret lagring samt understøttelse af flere servere.

🎯 Formål

AxRewards løser det almindelige behov for planlagte eller gentagne spillerbelønninger (for eksempel daglige eller ugentlige login-belønninger) og tilbyder samtidig fleksible cooldowns, permission-lås og GUI-præsentation. Det er tiltænkt servere, der ønsker et integreret, konfigurerbart belønningssystem uden behov for eksterne caching-systemer.

⚙️ Funktioner

• Konfigurerbare belønninger med vilkårlige cooldowns (angivet i sekunder).
• Redigerbare GUI-menuer til at præsentere belønninger; GUI-items kan vise forskellige tilstande (claimable / unclaimable / no-permission).
• Databaselagring med understøttelse af H2, SQLite, MySQL og PostgreSQL.
• Understøttelse af flere servere uden krav om Redis.
• Auto-opdaterende GUI (GUI'en opdateres periodisk uden at blive åbnet igen).
• Mulighed for at låse belønninger bag permissions (hver belønning kan kræve en permission).
• Claim-handlinger implementeret som en liste af serverkommandoer (understøtter %player%-placeholder).
• PlaceholderAPI-integration og understøttelse af flere farveformater.

🧩 Hvem det er til

• Survival- og SMP-servere, der ønsker daglige/ugentlige/tilpassede claimable belønninger.
• Serveroperatører, som har brug for databasebaseret persistens på tværs af genstarter eller flere servere.
• Admins, der foretrækker GUI-baseret belønningspræsentation og belønninger låst med permissions.

🏗️ Eksempel på brug

• Tilbyd en daglig login-belønning, der giver items eller kører kommandoer ved indløsning.
• Tilbyd begrænsede ugentlige VIP-belønninger, der kræver en rang-permission for at blive indløst.
• Kør kommandobaserede belønninger, der giver penge, items eller udfører tilpassede serverkommandoer ved hjælp af %player%.

⌨️ Kommandoer

( მხოლოდ kommandoer, der er bekræftet i den officielle dokumentation, er listet.)

⚙️ Installation

📥 Opsætning

• Download pluginets JAR-fil og placer den i din servers plugins/-mappe til en server, der er kompatibel med Bukkit/Spigot/Paper.
• Start eller genstart serveren, så pluginet kan oprette sine datamapper og sin konfiguration.
• Konfigurations- og menufiler placeres i pluginmappen (for eksempel plugins/AxRewards/menus).

📦 Afhængigheder

• PlaceholderAPI (valgfri integration til placeholders) — understøttelse bekræftet.

🧠 Tekniske noter

• Bekræftede database-backends: H2, SQLite, MySQL, PostgreSQL.
• Pluginet understøtter PlaceholderAPI og almindelige farveformater (inklusive MiniMessage og legacy-formater).
• GUI'en opdateres automatisk (auto-updating) uden at spillere behøver at åbne den igen.
• Belønninger definerer deres cooldown i sekunder; hvis cooldown sættes til -1, bliver en belønning aldrig opdateret.
• Projektet er open-source og licenseret under MIT.
• Bekræftet understøttet serversoftware og emner inkluderer Bukkit, Spigot, Paper og Folia.
• Bekræftet krav: moderne Java-runtime (projektets noter angiver Java 21 eller højere for nyere udgivelser).

🤝 Hvornår dette plugin er nyttigt

Hvis du har brug for et konfigurerbart belønningssystem styret via GUI med vedvarende lagring og understøttelse på tværs af servere, tilbyder AxRewards redigerbare menuer, cooldown-håndtering og kommandobaserede claim-handlinger, samtidig med at det integrerer med PlaceholderAPI og almindelige databaser.