Skip to main content
Met de valutamodule maak je eigen valuta naast de euro, bijvoorbeeld munten of punten. Elke valuta krijgt een eigen commando. Spelers kunnen een valuta automatisch verdienen door online te zijn. Valuta staan los van de bank. Ze hebben geen rekening, geen pinautomaat en geen Vault-koppeling.

​
Hoe het werkt

  • Je stelt valuta in via currencies.yml. Elke valuta heeft een ID, zoals graycoin.
  • Bij het joinen krijgt een speler van elke ingestelde valuta een saldo van 0, als hij dat nog niet had.
  • Heeft een valuta een automatic-blok, dan krijgt een speler elke interval seconden speeltijd amount erbij. Hij krijgt daar een bericht over in de chat.
  • Staff past saldo’s aan met het commando van de valuta.

​
Een valuta toevoegen

1

Open currencies.yml

Het bestand staat in de map van OpenMinetopia in plugins.
2

Voeg een valuta toe

Zet een nieuw blok onder currencies:. De key is het ID van de valuta en ook de naam van het commando.
3

Herstart de server

Valuta en hun commando’s worden alleen bij het opstarten ingeladen. /openminetopia reload laadt currencies.yml niet opnieuw.

​
Configuratie

Dit is het standaardbestand currencies.yml:
Dit maakt de valuta graycoin met het commando /graycoin en de alias /gc. Een speler krijgt elk uur speeltijd 1 Gray Coin. ignore-unused staat niet in het bestand dat de plugin meelevert. Bij de eerste start zet de plugin de key zelf in het bestand, naast currencies:. Daarna ziet het bestand er zo uit:
De speeltijd telt alleen als de speler online is. De teller loopt door tussen sessies.

​
Commando’s

Elke valuta heeft een eigen commando met de naam van haar ID. In de tabel hieronder staat <id> voor dat ID, bijvoorbeeld graycoin.
De aliassen uit aliases werken voor alle subcommando’s, dus /gc add <speler> 5 doet hetzelfde als /graycoin add <speler> 5. /currency heeft ook de alias /currencies.
  • /<id> zonder argumenten werkt alleen in-game.
  • De speler moet al eens op de server zijn geweest. Anders krijg je de melding dat de speler niet bestaat.
  • Tab-completion voor het commando werkt alleen met openminetopia.currency.<id>.
  • remove kan het saldo onder 0 brengen.
Voor de valuta graycoin zijn de permissies dus openminetopia.currency.graycoin, openminetopia.currency.info.graycoin, openminetopia.currency.set.graycoin, openminetopia.currency.add.graycoin en openminetopia.currency.remove.graycoin.

​
Oude valuta opruimen

Haal je een valuta uit currencies.yml, dan blijven de saldo’s van spelers in de database staan. Met ignore-unused: true (de standaard) negeert de plugin die saldo’s gewoon. Zet je ignore-unused op false, dan krijg je in de console steeds waarschuwingen over valuta die niet meer bestaan. Om de oude saldo’s echt te verwijderen gebruik je /currency purge-unused. Voer het commando twee keer uit binnen 20 seconden om te bevestigen.
/currency purge-unused verwijdert de saldo’s definitief uit de database. Dit kun je niet ongedaan maken.

​
Placeholders

In teksten van OpenMinetopia zelf, zoals het scoreboard en het chatformaat, gebruik je <currency_<id>>, bijvoorbeeld <currency_graycoin>. Beide werken alleen voor online spelers. Zie Placeholders voor het volledige overzicht.

​
Berichten

De teksten van deze module pas je aan in messages.yml. Dit zijn de keys: In de berichten over saldo’s kun je <amount> en <display_name> gebruiken. currency_show_other, currency_balance_set, currency_balance_add en currency_balance_remove hebben ook <target>.