Guide

Så gör du ett ekonomiplugin för Minecraft

Uppdaterad 18 oktober 2026

Ett ekonomiplugin håller ett saldo för varje spelare och låter dem betala varandra, tjäna pengar och spendera dem i butiker. Det viktiga är inte kommandona utan kopplingen till Vault: det är den som låter butiks-, jobb- och auktionsplugin använda dina pengar. Den här guiden går igenom upplägget, lagringen och hur du bygger och testar pluginet.

Utgå från det här exemplet och ändra reglerna till dina egna.

Generera det här med Codexe

Steg för steg

  1. 1.Bestäm vad pluginet är

    Antingen är det ekonomin (det lagrar saldon och registrerar sig som Vault-ekonomi), eller så använder det en befintlig ekonomi via Vault (en butik, bounties, ett jobbplugin). De flesta servrar behöver ett av varje, inte två ekonomier.

  2. 2.Välj server och version

    Skriv servermjukvaran och versionen, till exempel Paper 1.21.4. Pluginet byggs för den versionens API och Java-nivå.

  3. 3.Lista kommandona och reglerna

    /balance, /pay <player> <amount>, /baltop och adminkommandon som /eco give|take|set. Lägg till startsaldot, valutans namn, antal decimaler och en minsta betalning.

  4. 4.Välj var saldona sparas

    SQLite för en server, MySQL om flera servrar ska dela samma saldon. Pengar måste klara omstarter och krascher, så de hålls aldrig bara i minnet.

  5. 5.Låt Codexe skriva och bygga det

    Beskriv pluginet och nämn Vault uttryckligen så att det läggs till som beroende. Codexe skriver Java-koden, plugin.yml och config.yml, kompilerar och åtgärdar byggfel innan projektet markeras som Redo.

  6. 6.Testa betalningar i spelet

    Tryck på Prova nu och anslut till testservern. Betala mellan två konton, prova belopp som är för stora, negativa eller inte är siffror, starta sedan om och kontrollera att saldona finns kvar.

  7. 7.Installera det

    Lägg Vault och din .jar i serverns mapp plugins/ och starta om. Ta bort alla andra ekonomiplugin, eller bestäm vilket Vault ska använda.

Så passar Vault in

Vault är en brygga, inte en ekonomi. Ett ekonomiplugin implementerar Vaults gränssnitt Economy och registrerar det hos serverns tjänsthanterare; andra plugin hämtar det med getServer().getServicesManager().getRegistration(Economy.class) och anropar metoder som getBalance, withdrawPlayer och depositPlayer.

Därför behöver ett butiksplugin aldrig veta vilken ekonomi du kör. I plugin.yml använder du depend: [Vault] när pluginet inte fungerar utan det, eller softdepend när Vault är valfritt. Vault-API:et behövs bara för att kompilera; själva Vault installeras på servern.

Beslut att skriva i begäran

  • Penningformat: valutans namn i singular och plural, symbol, antal decimaler.
  • Gränser: startsaldo, maxsaldo, om saldon kan bli negativa.
  • Offlinespelare: om /pay och /eco fungerar på spelare som inte är online.
  • Loggning: en transaktionslogg i databasen eller i en fil, så att personalen kan reda ut tvister.
  • Tjäna pengar: döda mobs, belöningar för speltid, sälja föremål, eller bara adminkommandon.

Var saldona ska sparas

LagringPassar förSe upp med
YAML-filMycket små servrar, lätt att läsaLångsam med många spelare, blir lätt korrupt vid en krasch
SQLiteEn server, ingen uppsättningKan inte delas mellan servrar
MySQL / MariaDBNätverk som delar ett saldoKräver en databasserver och inloggning i config.yml

Exempelbeskrivning

”Ett ekonomiplugin för Paper 1.21.4 som heter Coins och registrerar sig som Vault-ekonomi. /balance [player], /pay <player> <amount> med ett minimum på 1, /baltop med topp 10 och /eco give|take|set för spelare med coins.admin. Nya spelare börjar med 100 coins. Två decimaler. Varje betalning loggas med datum, avsändare, mottagare och belopp. Saldon sparas i SQLite. Valutanamn och alla meddelanden i config.yml.”

Codexe använder SQLite som standard när du inte ber om något annat. Ber du om MySQL skrivs pluginet med en inställning storage-type, och testservern ger det en egen MySQL-databas medan du provar det.

Frågor

Behöver jag Vault?

Inte för en fristående ekonomi som inget annat använder. Du behöver det så fort andra plugin (butiker, jobb, auktioner) ska läsa eller ändra saldon, eftersom det är det API:et de letar efter.

Kan jag köra det bredvid EssentialsX?

EssentialsX har en egen ekonomi och registrerar den också hos Vault. Kör en ekonomi i taget, eller stäng av den du inte vill ha, annars kan andra plugin använda ett annat saldo än det dina kommandon visar.

Kan flera servrar dela samma saldon?

Ja, med MySQL eller MariaDB som lagring och samma databas i varje servers config.yml. Be om det i begäran så att pluginet läser saldon från databasen i stället för att cacha dem för länge.

Hur testar jag det utan en riktig server?

Med Prova nu: en privat Paper-server med din version startar med det kompilerade pluginet, och plugin som anges i depend och softdepend, som Vault, installeras åt det. Gratisplanen ger 3 testservrar per dag, 10 minuter vardera.

Gör din servers ekonomi

Den här prompten öppnas färdig att skicka:

“Ett ekonomiplugin för Paper 1.21.4 som heter Coins och registrerar sig som Vault-ekonomi: /balance, /pay med ett minimum på 1, /baltop topp 10, /eco give|take|set för coins.admin, startsaldo 100, två decimaler, varje betalning loggad, saldon i SQLite, valutanamn och meddelanden i config.yml.”

Generera det här med Codexe
Så gör du ett ekonomiplugin för Minecraft (Vault, Paper) | Codexe