Minecraft plugin AxRewards

🔌 Over AxRewards

AxRewards is een Minecraft-plugin die een lichtgewicht, configureerbaar rewardsysteem biedt. Serverbeheerders stellen beloningen in met willekeurige cooldowns, tonen ze in bewerkbare GUI's en voeren claim-commando's uit wanneer spelers beloningen claimen. Het project wordt onderhouden door Artillex-Studios en bevat opslag op basis van een database en ondersteuning voor meerdere servers.

🎯 Doel

AxRewards lost de veelvoorkomende behoefte aan geplande of herhaalbare spelersbeloningen op (bijvoorbeeld dagelijkse of wekelijkse inlogbeloningen) en biedt daarbij flexibele cooldowns, permission-vergrendeling en GUI-weergave. Het is bedoeld voor servers die een geïntegreerd, configureerbaar beloningssysteem willen zonder externe caching-systemen nodig te hebben.

⚙️ Functies

• Configureerbare beloningen met willekeurige cooldowns (opgegeven in seconden).
• Bewerkbare GUI-menu's voor het tonen van beloningen; GUI-items kunnen verschillende statussen tonen (op te claimen / niet op te claimen / geen permission).
• Databaseopslag met ondersteuning voor H2, SQLite, MySQL en PostgreSQL.
• Ondersteuning voor meerdere servers zonder Redis nodig te hebben.
• Automatisch bijgewerkte GUI (de GUI ververst periodiek zonder opnieuw te openen).
• Mogelijkheid om beloningen achter permissions te vergrendelen (elke beloning kan een permission vereisen).
• Claim-acties geïmplementeerd als een lijst servercommando's (ondersteunt %player%-placeholder).
• PlaceholderAPI-integratie en ondersteuning voor meerdere kleurformaten.

🧩 Voor wie het is

• Survival- en SMP-servers die dagelijkse/wekelijkse/custom op te claimen beloningen willen.
• Serverbeheerders die database-opslag nodig hebben tussen herstarts of over meerdere servers heen.
• Admins die de voorkeur geven aan GUI-gebaseerde beloningsweergave en beloningen die door permissions worden beperkt.

🏗️ Voorbeeldtoepassingen

• Bied een dagelijkse inlogbeloning aan die items geeft of commando's uitvoert wanneer deze wordt geclaimd.
• Geef afgeschermde wekelijkse VIP-beloningen waarvoor een rang-permission nodig is om te claimen.
• Voer command-gebaseerde beloningen uit die geld of items geven, of aangepaste servercommando's uitvoeren met %player%.

⌨️ Commando's

(Alleen commando's die in de officiële documentatie zijn bevestigd, worden vermeld.)

⚙️ Installatie

📥 Setup

• Download de JAR van de plugin en plaats deze in de plugins/-map van je server voor een server die compatibel is met Bukkit/Spigot/Paper.
• Start of herstart de server zodat de plugin zijn datamappen en configuratie kan aanmaken.
• Configuratie- en menubestanden worden geplaatst in de pluginmap (bijvoorbeeld plugins/AxRewards/menus).

📦 Afhankelijkheden

• PlaceholderAPI (optionele integratie voor placeholders) — ondersteuning bevestigd.

🧠 Technische notities

• Bevestigde database-backends: H2, SQLite, MySQL, PostgreSQL.
• De plugin ondersteunt PlaceholderAPI en veelgebruikte kleurformaten (inclusief MiniMessage en legacy-formaten).
• De GUI ververst automatisch (auto-updating) zonder dat spelers deze opnieuw hoeven te openen.
• Beloningen definiëren hun cooldown in seconden; een cooldown van -1 zorgt ervoor dat een beloning nooit ververst.
• Het project is open-source en gelicentieerd onder MIT.
• Bevestigde ondersteunde serversoftware en onderwerpen zijn onder meer Bukkit, Spigot, Paper en Folia.
• Bevestigde vereiste: een moderne Java-runtime (projectnotities geven aan Java 21 of hoger voor recente releases).

🤝 Wanneer deze plugin nuttig is

Als je een configureerbaar, GUI-gestuurd rewardsysteem nodig hebt met permanente opslag en ondersteuning voor meerdere servers, biedt AxRewards bewerkbare menu's, cooldown-afhandeling en command-gebaseerde claim-acties, samen met integratie met PlaceholderAPI en veelgebruikte databases.