Minecraft-plugin AxRewards

🔌 Om AxRewards

AxRewards är ett Minecraft-plugin som erbjuder ett lättviktigt och konfigurerbart belöningssystem. Serveradministratörer definierar belöningar med godtyckliga cooldowns, visar dem i redigerbara GUI:er och kör claim-kommandon när spelare hämtar belöningar. Projektet underhålls av Artillex-Studios och inkluderar databaskopplad lagring samt stöd för flera servrar.

🎯 Syfte

AxRewards löser det vanliga behovet av schemalagda eller återkommande spelarbelöningar (till exempel dagliga eller veckovisa loginbelöningar) samtidigt som det erbjuder flexibla cooldowns, permission-lås och GUI-presentation. Det är avsett för servrar som vill ha ett integrerat, konfigurerbart belöningssystem utan att behöva externa cache-system.

⚙️ Funktioner

• Konfigurerbara belöningar med godtyckliga cooldowns (angivna i sekunder).
• Redigerbara GUI-menyer för att visa belöningar; GUI-items kan visa olika tillstånd (claimable / unclaimable / no-permission).
• Databasslagring med stöd för H2, SQLite, MySQL och PostgreSQL.
• Stöd för flera servrar utan att kräva Redis.
• Auto-uppdaterande GUI (uppdateras periodiskt utan att behöva öppnas igen).
• Möjlighet att låsa belöningar bakom permissions (varje belöning kan kräva en permission).
• Claim-åtgärder implementerade som en lista serverkommandon (stöder %player%-placeholder).
• PlaceholderAPI-integration och stöd för flera färgformat.

🧩 För vem det är

• Survival- och SMP-servrar som vill ha dagliga/veckovisa/anpassade claimbara belöningar.
• Serveroperatörer som behöver databaskopplad persistens mellan omstarter eller över flera servrar.
• Admins som föredrar GUI-baserad belöningspresentation och belöningar som låses med permissions.

🏗️ Exempel på användning

• Erbjud en daglig loginbelöning som ger items eller kör kommandon när den claimas.
• Ge veckovisa VIP-belöningar med begränsad åtkomst som kräver en rang-permission för att claimas.
• Kör kommandobaserade belöningar som ger pengar, items eller utför egna serverkommandon med %player%.

⌨️ Kommandon

(Endast kommandon som bekräftats i den officiella dokumentationen listas.)

⚙️ Installation

📥 Setup

• Ladda ner pluginens JAR och placera den i serverns plugins/-mapp för en server som är kompatibel med Bukkit/Spigot/Paper.
• Starta eller starta om servern så att pluginen kan skapa sina datamappar och sin konfiguration.
• Konfigurations- och menyfiler placeras i pluginmappen (till exempel plugins/AxRewards/menus).

📦 Beroenden

• PlaceholderAPI (valfri integration för placeholders) — stöd bekräftat.

🧠 Tekniska noteringar

• Bekräftade databasenheter: H2, SQLite, MySQL, PostgreSQL.
• Pluginen stöder PlaceholderAPI och vanliga färgformat (inklusive MiniMessage och legacy-format).
• GUI:t uppdateras automatiskt (auto-updating) utan att spelare behöver öppna det igen.
• Belöningar definierar sin cooldown i sekunder; att sätta cooldown till -1 gör att en belöning aldrig uppdateras.
• Projektet är open-source och licensierat under MIT.
• Bekräftad stödjande serverprogramvara och ämnen inkluderar Bukkit, Spigot, Paper och Folia.
• Bekräftat krav: modern Java-runtime (projektnoterna anger Java 21 eller högre för senaste utgåvorna).

🤝 När denna plugin är användbar

Om du behöver ett konfigurerbart belöningssystem styrt via GUI med persistent lagring och stöd över flera servrar, erbjuder AxRewards redigerbara menyer, cooldown-hantering och command-baserade claim-åtgärder samtidigt som det integreras med PlaceholderAPI och vanliga databaser.