Guide

Slik lager du et økonomiplugin for Minecraft

Oppdatert 18. oktober 2026

Et økonomiplugin holder en saldo for hver spiller og lar dem betale hverandre, tjene penger og bruke dem i butikker. Det viktigste er ikke kommandoene, men koblingen til Vault: det er den som lar butikk-, jobb- og auksjonsplugins bruke pengene dine. Denne guiden tar for seg designet, lagringen og hvordan du bygger og tester det.

Start fra dette eksempelet og endre reglene til dine egne.

Generer dette med Codexe

Steg for steg

  1. 1.Bestem hva pluginet skal være

    Enten er det økonomien (det lagrer saldoer og registrerer seg som Vault-økonomien), eller så bruker det en eksisterende økonomi via Vault (en butikk, dusører, et jobbplugin). De fleste servere trenger ett av hvert, ikke to økonomier.

  2. 2.Velg server og versjon

    Skriv serverprogramvaren og versjonen, for eksempel Paper 1.21.4. Pluginet bygges for API-et og Java-nivået til den versjonen.

  3. 3.List opp kommandoene og reglene

    /balance, /pay <player> <amount>, /baltop og adminkommandoer som /eco give|take|set. Ta med startsaldo, navnet på valutaen, desimaler og minste betaling.

  4. 4.Velg hvor saldoene lagres

    SQLite for én server, MySQL hvis flere servere må dele de samme saldoene. Pengene må overleve omstarter og krasj, så de holdes aldri bare i minnet.

  5. 5.La Codexe skrive og bygge det

    Beskriv pluginet og nevn Vault eksplisitt, så det legges til som avhengighet. Codexe skriver Java-koden, plugin.yml og config.yml, kompilerer det og retter byggefeil før prosjektet er Klar.

  6. 6.Test betalinger i spillet

    Trykk på Prøv nå og koble til testserveren. Betal mellom to kontoer, prøv beløp som er for store, negative eller ikke er tall, start så serveren på nytt og sjekk at saldoene fortsatt er der.

  7. 7.Installer det

    Legg Vault og .jar-filen din i serverens plugins/-mappe og start på nytt. Fjern alle andre økonomiplugins, eller bestem hvilket Vault skal bruke.

Slik passer Vault inn

Vault er en bro, ikke en økonomi. Et økonomiplugin implementerer Vaults Economy-grensesnitt og registrerer det hos serverens services manager. Andre plugins ber om det med getServer().getServicesManager().getRegistration(Economy.class) og kaller metoder som getBalance, withdrawPlayer og depositPlayer.

Et butikkplugin trenger altså aldri å vite hvilken økonomi du kjører. I plugin.yml bruker du depend: [Vault] når pluginet ikke fungerer uten, eller softdepend når Vault er valgfritt. Vault-API-et trengs bare for å kompilere; selve Vault installeres på serveren.

Valg du bør skrive i forespørselen

  • Pengeformat: valutanavn i entall og flertall, symbol og antall desimaler.
  • Grenser: startsaldo, maksimal saldo og om saldoer kan gå i minus.
  • Frakoblede spillere: om /pay og /eco fungerer på spillere som ikke er pålogget.
  • Logging: en transaksjonslogg i databasen eller en fil, så staben kan sjekke tvister.
  • Tjene penger: drepe mobs, belønninger for spilletid, selge gjenstander, eller bare adminkommandoer.

Hvor saldoene bør lagres

LagringPasser forVær obs på
YAML-filSvært små servere, lett å leseTreg med mange spillere, lett å ødelegge ved krasj
SQLiteÉn server, ingen oppsettKan ikke deles mellom servere
MySQL / MariaDBNettverk som deler én saldoKrever en databaseserver og innlogging i config.yml

Eksempelbeskrivelse

«Et Paper 1.21.4-økonomiplugin kalt Coins som registrerer seg som Vault-økonomien. /balance [player], /pay <player> <amount> med minimum 1, /baltop med topp 10, og /eco give|take|set for spillere med coins.admin. Nye spillere starter med 100 coins. To desimaler. Hver betaling logges med dato, avsender, mottaker og beløp. Saldoer lagres i SQLite. Valutanavn og alle meldinger i config.yml.»

Codexe bruker SQLite som standard når du ikke ber om noe annet. Ber du om MySQL, skrives pluginet med en storage-type-innstilling, og testserveren gir det en egen MySQL-database mens du prøver det.

Spørsmål

Trenger jeg Vault?

Ikke for en frittstående økonomi som ingenting annet bruker. Du trenger det så snart andre plugins (butikker, jobber, auksjoner) skal lese eller endre saldoer, fordi det er det API-et de ser etter.

Kan jeg kjøre det sammen med EssentialsX?

EssentialsX har sin egen økonomi og registrerer den også hos Vault. Kjør én økonomi om gangen, eller slå av den du ikke vil ha, ellers kan andre plugins bruke en annen saldo enn den kommandoene dine viser.

Kan flere servere dele de samme saldoene?

Ja, med MySQL eller MariaDB som lagring og den samme databasen i config.yml på hver server. Be om det i forespørselen, så pluginet leser saldoene fra databasen i stedet for å mellomlagre dem for lenge.

Hvordan tester jeg det uten en ekte server?

Med Prøv nå: en privat Paper-server med din versjon starter med det kompilerte pluginet, og plugins som står i depend og softdepend, som Vault, installeres for det. Gratisabonnementet har 3 testservere om dagen, 10 minutter hver.

Lag økonomien til serveren din

Denne prompten åpnes klar til å sendes:

“Et Paper 1.21.4-økonomiplugin kalt Coins som registrerer seg som Vault-økonomien: /balance, /pay med minimum 1, /baltop topp 10, /eco give|take|set for coins.admin, startsaldo 100, to desimaler, alle betalinger logget, saldoer i SQLite, valutanavn og meldinger i config.yml.”

Generer dette med Codexe
Slik lager du et økonomiplugin for Minecraft (Vault, Paper) | Codexe