Minecraft-plugin EconomyAPI

🔌 Om EconomyAPI

EconomyAPI är ett kärnplugin för ekonomi och en API-implementering som ursprungligen skapades av onebone. Det publiceras och distribueras för serverekosystem i Bedrock/PocketMine-stil (PocketMine/Nukkit-varianter) och är avsett att tillhandahålla en delad valuta-backend och programmässiga metoder som andra plugins kan anropa.

🎯 Syfte

EconomyAPI tillhandahåller ett centraliserat valutasystem så att pluginförfattare kan läsa och ändra spelares saldon, registrera händelser relaterade till ekonomi och låta serveradministratörer exponera grundläggande ekonomikommandon för spelare. Det löser problemet med att flera plugins behöver separata ekonomiintegrationer genom att erbjuda ett gemensamt API-lager.

⚙️ Funktioner

• Exponerar programmässiga API-metoder för att fråga saldo och uppdatera det (exempel i dokumentationen inkluderar en getInstance-liknande accessor).
• Tillhandahåller spelarnära ekonomikommandon som balance, pay och administrativa money-justeringar.
• Utsänder events och hooks som andra plugins kan lyssna på för transaktionshantering.
• Används ofta som beroende/kärnkomponent för andra PocketMine/Nukkit-ekonomiaddons och tillägg.

🧩 Vem det är för

• Server- och pluginutvecklare som behöver en delad ekonomi-backend på Bedrock-serverprogramvara i PocketMine/Nukkit-stil.
• Administratörer av små till medelstora Bedrock-servrar som förlitar sig på plugin-ekosystem som integrerar med EconomyAPI.

🏗️ Exempel på användning

• Ett shop- eller marketplace-plugin läser och drar av spelarsaldon via EconomyAPI-anrop.
• Ett auktions- eller belöningsplugin ger valuta genom att anropa API:ets add/reduce-metoder.
• Servernätverk som levererar addon-plugins som förväntar sig en gemensam ekonomileverantör.

⌨️ Kommandon

(Kommandona och permission-noderna ovan är hämtade från publicerade PocketMine/Nukkit-resurslistningar; exakt tillgänglighet kan variera beroende på build/fork.)

🔐 Behörigheter

⚙️ Installation

📥 Installation

• Ladda ner den officiella plugin-builden för din serverdistribution (PocketMine/Poggit eller en community-build för Nukkit).
• Placera den nedladdade plugin-filen i serverns plugins/-katalog.
• Stoppa och starta servern igen (restart) och kontrollera konsolutmatningen för att bekräfta att pluginet laddades.

(Det exakta paketformatet kan variera beroende på distribution och build; följ installationsstegen för den valda distributionen.)

🧠 Tekniska noteringar

• EconomyAPI distribueras i flera builds/forks för PocketMine- och Nukkit-ekosystemen; olika builds kan innehålla något olika kommandon eller API-inträdespunkter.
• Pluginet exponerar programmässiga åtkomstmönster som används av andra addons (exempel i communitydokumentation visar anrop som EconomyAPI::getInstance() eller EconomyAPI.getInstance().addMoney(...)).
• Ibland har pluginet markerats i distributionskanaler på grund av prestanda- eller underhållsproblem; överväg aktuell underhållsstatus och kompatibla alternativ när du driftsätter på produktionsservrar.

🤝 När detta plugin är användbart

Om din server eller ditt add-on-ekosystem förväntar sig en gemensam ekonomileverantör för Bedrock/PocketMine/Nukkit-style-servrar, erbjuder EconomyAPI ett allmänt använt API och en uppsättning grundläggande spelarkommandon som många andra plugins integrerar med.