Guide

Sådan laver du et økonomiplugin til Minecraft

Opdateret 18. oktober 2026

Et økonomiplugin holder styr på en saldo for hver spiller og lader dem betale hinanden, tjene penge og bruge dem i butikker. Det vigtige er ikke kommandoerne, men koblingen til Vault: det er den, der lader butiks-, job- og auktionsplugins bruge dine penge. Denne guide gennemgår designet, lagringen, og hvordan du bygger og tester det.

Start fra dette eksempel, og tilpas reglerne til dine egne.

Generér dette med Codexe

Trin for trin

  1. 1.Beslut, hvad pluginet skal være

    Enten er det økonomien (det gemmer saldi og registrerer sig selv som Vault-økonomien), eller også bruger det en eksisterende økonomi via Vault (en butik, dusører, et jobplugin). De fleste servere har brug for én af hver, ikke to økonomier.

  2. 2.Vælg server og version

    Skriv serversoftwaren og versionen, for eksempel Paper 1.21.4. Pluginet bygges til den versions API og Java-niveau.

  3. 3.Skriv kommandoerne og reglerne ned

    /balance, /pay <player> <amount>, /baltop og admin-kommandoer som /eco give|take|set. Tilføj startsaldoen, valutaens navn, antal decimaler og en minimumsbetaling.

  4. 4.Vælg, hvor saldi gemmes

    SQLite til én server, MySQL hvis flere servere skal dele de samme saldi. Penge skal overleve genstarter og nedbrud, så de må aldrig kun ligge i hukommelsen.

  5. 5.Lad Codexe skrive og bygge det

    Beskriv pluginet, og nævn Vault eksplicit, så det tilføjes som afhængighed. Codexe skriver Java-koden, plugin.yml og config.yml, kompilerer det og retter build-fejl, før projektet er Klar.

  6. 6.Test betalinger i spillet

    Tryk på Prøv det nu, og join testserveren. Betal mellem to konti, prøv beløb, der er for store, negative eller ikke er tal, genstart derefter, og tjek, at saldiene stadig er der.

  7. 7.Installér det

    Læg Vault og din .jar i serverens plugins/-mappe, og genstart. Fjern andre økonomiplugins, eller beslut, hvilket Vault skal bruge.

Sådan passer Vault ind

Vault er en bro, ikke en økonomi. Et økonomiplugin implementerer Vaults Economy-interface og registrerer det hos serverens services manager; andre plugins henter det med getServer().getServicesManager().getRegistration(Economy.class) og kalder metoder som getBalance, withdrawPlayer og depositPlayer.

Så et butiksplugin behøver aldrig at vide, hvilken økonomi du kører. Brug depend: [Vault] i plugin.yml, når pluginet ikke kan fungere uden, eller softdepend, når Vault er valgfrit. Vault-API'en skal kun bruges til at kompilere; selve Vault installeres på serveren.

Beslutninger, du skal skrive i anmodningen

  • Pengeformat: valutaens navn i ental og flertal, symbol, hvor mange decimaler.
  • Grænser: startsaldo, maksimal saldo, om saldi kan blive negative.
  • Offline-spillere: om /pay og /eco virker på spillere, der ikke er online.
  • Logning: en transaktionslog i databasen eller i en fil, så staff kan tjekke uenigheder.
  • Tjene penge: dræbe mobs, belønninger for spilletid, sælge genstande eller kun admin-kommandoer.

Hvor saldi skal gemmes

LagringGod tilPas på med
YAML-filMeget små servere, nem at læseLangsom med mange spillere, nem at ødelægge ved et nedbrud
SQLiteÉn server, ingen opsætningKan ikke deles mellem servere
MySQL / MariaDBNetværk, der deler én saldoKræver en databaseserver og login i config.yml

Eksempel på beskrivelse

"Et Paper 1.21.4-økonomiplugin kaldet Coins, der registrerer sig selv som Vault-økonomien. /balance [player], /pay <player> <amount> med et minimum på 1, /baltop med top 10 og /eco give|take|set for spillere med coins.admin. Nye spillere starter med 100 coins. To decimaler. Hver betaling logges med dato, afsender, modtager og beløb. Saldi gemmes i SQLite. Valutanavne og alle beskeder i config.yml."

Codexe bruger SQLite som standard, når du ikke beder om andet. Hvis du beder om MySQL, skrives pluginet med en storage-type-indstilling, og testserveren giver det sin egen MySQL-database, mens du prøver det.

Spørgsmål

Har jeg brug for Vault?

Ikke til en selvstændig økonomi, som intet andet bruger. Du får brug for det, så snart andre plugins (butikker, jobs, auktioner) skal læse eller ændre saldi, for det er den API, de leder efter.

Kan jeg køre det sammen med EssentialsX?

EssentialsX har sin egen økonomi og registrerer den også hos Vault. Kør én økonomi ad gangen, eller slå den fra, du ikke vil have, ellers kan andre plugins bruge en anden saldo end den, dine kommandoer viser.

Kan flere servere dele de samme saldi?

Ja, med MySQL eller MariaDB som lagring og den samme database i hver servers config.yml. Bed om det i anmodningen, så pluginet læser saldi fra databasen i stedet for at cache dem for længe.

Hvordan tester jeg det uden en rigtig server?

Med Prøv det nu: en privat Paper-server i din version starter med det kompilerede plugin, og plugins angivet i depend og softdepend, såsom Vault, bliver installeret til det. Det gratis abonnement har 3 testservere om dagen, 10 minutter hver.

Lav din servers økonomi

Denne prompt åbnes klar til at sende:

“Et Paper 1.21.4-økonomiplugin kaldet Coins, der registrerer sig som Vault-økonomien: /balance, /pay med et minimum på 1, /baltop top 10, /eco give|take|set for coins.admin, startsaldo 100, to decimaler, hver betaling logget, saldi i SQLite, valutanavne og beskeder i config.yml.”

Generér dette med Codexe
Sådan laver du et økonomiplugin til Minecraft (Vault, Paper) | Codexe