Handleiding
Een economy-plugin voor Minecraft maken
Bijgewerkt 18 oktober 2026
Een economy-plugin houdt voor elke speler een saldo bij en laat spelers elkaar betalen, geld verdienen en uitgeven in winkels. Het belangrijkste zijn niet de commando's maar de koppeling met Vault: daardoor kunnen winkel-, job- en veilingplugins jouw geld gebruiken. Deze handleiding behandelt het ontwerp, de opslag en hoe je de plugin bouwt en test.
Begin met dit voorbeeld en pas de regels aan naar die van jou.
Genereer dit met CodexeStap voor stap
1.Bepaal wat de plugin is
Of hij is de economy (hij slaat saldi op en registreert zichzelf als Vault-economy), of hij gebruikt een bestaande economy via Vault (een winkel, premies, een jobplugin). De meeste servers hebben van elk één nodig, niet twee economy's.
2.Kies de server en de versie
Noteer de serversoftware en versie, bijvoorbeeld Paper 1.21.4. De plugin wordt gebouwd voor de API en het Java-niveau van die versie.
3.Zet de commando's en regels op een rij
/balance,/pay <player> <amount>,/baltopen admincommando's zoals/eco give|take|set. Voeg het startsaldo, de naam van de valuta, het aantal decimalen en een minimumbetaling toe.4.Kies waar de saldi worden opgeslagen
SQLite voor één server, MySQL als meerdere servers dezelfde saldi moeten delen. Geld moet herstarts en crashes overleven, dus het staat nooit alleen in het geheugen.
5.Laat Codexe hem schrijven en bouwen
Beschrijf de plugin en noem Vault expliciet, zodat het als dependency wordt toegevoegd. Codexe schrijft de Java-code,
plugin.ymlenconfig.yml, compileert alles en lost buildfouten op voordat het project Klaar is.6.Test betalingen in de game
Druk op Probeer het nu en join de testserver. Betaal tussen twee accounts, probeer bedragen die te groot, negatief of geen getal zijn, herstart dan en controleer of de saldi er nog zijn.
7.Installeer het
Zet Vault en je .jar in de map
plugins/van de server en herstart. Verwijder andere economy-plugins of bepaal welke Vault moet gebruiken.
Waar Vault in past
Vault is een brug, geen economy. Een economy-plugin implementeert de Economy-interface van Vault en registreert die bij de services manager van de server; andere plugins vragen erom met getServer().getServicesManager().getRegistration(Economy.class) en roepen methoden aan zoals getBalance, withdrawPlayer en depositPlayer.
Een winkelplugin hoeft dus nooit te weten welke economy je draait. Gebruik in plugin.yml depend: [Vault] als de plugin niet zonder kan, of softdepend als Vault optioneel is. De Vault-API is alleen nodig om te compileren; Vault zelf wordt op de server geïnstalleerd.
Keuzes om in het verzoek te zetten
- Geldnotatie: naam van de valuta in enkelvoud en meervoud, symbool, aantal decimalen.
- Limieten: startsaldo, maximumsaldo, of saldi negatief mogen worden.
- Offline spelers: of
/payen/ecowerken op spelers die niet online zijn. - Logging: een transactielog in de database of in een bestand, zodat het team geschillen kan nakijken.
- Geld verdienen: mobs doden, beloningen voor speeltijd, items verkopen, of alleen admincommando's.
Waar je saldi opslaat
| Opslag | Geschikt voor | Let op |
|---|---|---|
| YAML-bestand | Heel kleine servers, makkelijk te lezen | Traag met veel spelers, raakt makkelijk beschadigd bij een crash |
| SQLite | Eén server, geen installatie | Kan niet tussen servers worden gedeeld |
| MySQL / MariaDB | Netwerken die één saldo delen | Vereist een databaseserver en inloggegevens in config.yml |
Voorbeeldbeschrijving
"Een Paper 1.21.4-economy-plugin genaamd Coins die zichzelf registreert als Vault-economy. /balance [player], /pay <player> <amount> met een minimum van 1, /baltop met de top 10, en /eco give|take|set voor spelers met coins.admin. Nieuwe spelers beginnen met 100 coins. Twee decimalen. Elke betaling gelogd met datum, afzender, ontvanger en bedrag. Saldi opgeslagen in SQLite. Valutanamen en alle berichten in config.yml."
Codexe gebruikt standaard SQLite als je niet om iets anders vraagt. Vraag je om MySQL, dan krijgt de plugin een instelling storage-type, en de testserver geeft hem een eigen MySQL-database zolang je hem uitprobeert.
Vragen
Heb ik Vault nodig?
Niet voor een losse economy die door niets anders wordt gebruikt. Je hebt het nodig zodra andere plugins (winkels, jobs, veilingen) saldi moeten lezen of wijzigen, want dat is de API waar ze naar zoeken.
Kan ik het naast EssentialsX draaien?
EssentialsX heeft een eigen economy en registreert die ook bij Vault. Draai één economy tegelijk of zet de economy uit die je niet wilt, anders gebruiken andere plugins misschien een ander saldo dan je commando's tonen.
Kunnen meerdere servers dezelfde saldi delen?
Ja, met MySQL of MariaDB als opslag en dezelfde database in de config.yml van elke server. Vraag erom in het verzoek, zodat de plugin saldi uit de database leest in plaats van ze te lang in de cache te houden.
Hoe test ik het zonder echte server?
Met Probeer het nu: er start een privé-Paper-server van jouw versie met de gecompileerde plugin, en plugins die in depend en softdepend staan, zoals Vault, worden ervoor geïnstalleerd. Het gratis abonnement geeft 3 testservers per dag, elk 10 minuten.
Maak de economy van je server
Deze prompt opent klaar om te versturen:
“Een Paper 1.21.4-economy-plugin genaamd Coins die zich registreert als Vault-economy: /balance, /pay met een minimum van 1, /baltop top 10, /eco give|take|set voor coins.admin, startsaldo 100, twee decimalen, elke betaling gelogd, saldi in SQLite, valutanamen en berichten in config.yml.”
Genereer dit met Codexe