Minecraft plugin AxRewards

🔌 O AxRewards

AxRewards je Minecraft plugin, který poskytuje lehký a snadno konfigurovatelný systém odměn. Správci serveru definují odměny s libovolnými cooldowny, zobrazují je v upravitelných GUI a spouštějí claim příkazy ve chvíli, kdy si hráči odměny vyzvednou. Projekt spravuje Artillex-Studios a zahrnuje úložiště založené na databázi i podporu více serverů.

🎯 Účel

AxRewards řeší běžnou potřebu plánovaných nebo opakovatelných odměn pro hráče (například denní nebo týdenní login rewards) a zároveň nabízí flexibilní cooldowny, uzamčení pomocí permission a zobrazení v GUI. Je určen pro servery, které chtějí integrovaný, konfigurovatelný systém odměn bez potřeby externích caching systémů.

⚙️ Funkce

• Konfigurovatelné odměny s libovolnými cooldowny (v sekundách).
• Upravitelná GUI menu pro zobrazení odměn; GUI items mohou zobrazovat různé stavy (claimable / unclaimable / no-permission).
• Databázové úložiště s podporou H2, SQLite, MySQL a PostgreSQL.
• Podpora více serverů bez nutnosti Redis.
• Automaticky se aktualizující GUI (obnovuje se pravidelně bez znovuotevření).
• Možnost uzamknout odměny za permission (každá odměna může vyžadovat permission).
• Claim akce implementované jako seznam serverových příkazů (podporuje placeholder %player%).
• Integrace PlaceholderAPI a podpora více barevných formátů.

🧩 Pro koho je to určeno

• Survival a SMP servery, které chtějí denní/týdenní/vlastní claimable odměny.
• Správci serverů, kteří potřebují perzistentní úložiště založené na databázi mezi restartováním nebo napříč více servery.
• Admini, kteří preferují GUI zobrazení odměn a odměny uzamčené pomocí permission.

🏗️ Příklady použití

• Nabídnout denní login odměnu, která při vyzvednutí dá předměty nebo spustí příkazy.
• Poskytnout omezené týdenní VIP odměny, které vyžadují permission ranku pro vyzvednutí.
• Spouštět odměny založené na příkazech, které dávají peníze, předměty nebo vykonávají vlastní serverové příkazy pomocí %player%.

⌨️ Příkazy

(Uvedeny jsou pouze příkazy potvrzené v oficiální dokumentaci.)

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu a vložte jej do složky plugins/ vašeho serveru pro server kompatibilní s Bukkit/Spigot/Paper.
• Spusťte nebo restartujte server, aby plugin mohl vytvořit své datové složky a konfiguraci.
• Konfigurační soubory a menu jsou umístěny ve složce pluginu (například plugins/AxRewards/menus).

📦 Závislosti

• PlaceholderAPI (volitelná integrace pro placeholdery) — podpora potvrzena.

🧠 Technické poznámky

• Potvrzené databázové backendy: H2, SQLite, MySQL, PostgreSQL.
• Plugin podporuje PlaceholderAPI a běžné barevné formáty (včetně MiniMessage a legacy formátů).
• GUI se automaticky obnovuje (auto-updating) bez nutnosti, aby ho hráči znovu otevírali.
• Odměny definují svůj cooldown v sekundách; nastavení cooldownu na -1 způsobí, že se odměna nikdy neobnoví.
• Projekt je open-source a licencovaný pod MIT.
• Potvrzený podporovaný serverový software a témata zahrnují Bukkit, Spigot, Paper a Folia.
• Potvrzený požadavek: moderní Java runtime (poznámky projektu uvádějí Java 21 nebo vyšší pro novější verze).

🤝 Kdy je tento plugin užitečný

Pokud potřebujete konfigurovatelný systém odměn řízený přes GUI s perzistentním úložištěm a podporou napříč servery, AxRewards poskytuje upravitelná menu, zpracování cooldownů a claim akce založené na příkazech, přičemž se integruje s PlaceholderAPI a běžnými databázemi.