Loslegen

Vielen Dank für den Kauf meiner CoinsAPI.

ColorCodes werden immer mit einem & Zeichen definiert. Eine Liste der möglichen ColorColdes gibt es hier. Nutze bitte aus der angezeigten Tabelle die Spalte CHAT CODE und ersetze das § -Zeichen mit dem &-Zeichen.

Wenn du die CoinsAPI heruntergeladen und den Server gestartet hast, sollte jetzt in deinem Plugins-Ordner ein Ordner Namens CoinsAPI erstellt haben. Öffne nun diesen Ordner und bearbeite die config.yml.

Lizenz eintragen

Füge in der config.yml dein private Lizenz ein. Wenn du noch keine Besitzt, öffne ein Supportticket auf meinem Discordserver.

Warum benötige ich eine private Lizenz? Die Antwort gibt es hier

Datenbank

Stelle in der config.yml den Datenbankentypen ein.

MySQL

Setze database: "mysql" um deine Daten in einer MySQL Datenbank zu speichern. Auf die Daten kannst du Serverübergreifend zugreifen. Um die Verbindung zu MySQL Datenbank herzustellen öffne die Datei mysql.yml und trage deine MySQL Daten ein.

mysql.yml

mysql:
  HOST: localhost
  PORT: '3306'
  DATABASE: database
  USER: root
  PASSWORD: password

SQL

Setze database: "sql" um deine Daten Lokal auf dem Server zu Speichern. Auf diese Daten kann dann nur dieser eine Server zugreifen. Dafür wird vom Plugin im Plugins-Ordner ein Ordner namens database erstellt. In diesem Ordner wird die Datenbankdatei database.db erstellt.

Datei System

Es gibt 2 verschiedene Datei Systeme. Diese werden weiter unten erklärt.

single

Das single Datei System bedeutet schlicht und einfach das alle Nachrichten aller Sprachen in einer Datei enthalten sind. Hier das Beispiel von der CoinsAPI:

Standard Sprache

Mit LanguageAPI

Wenn du meine LanguageAPI für Spigot besitzt, kannst du den Punkt defaultLanguage: "english" auslassen, da die Sprache des Spielers über diese Verwaltet ist. Vergewissere dich nur, dass du alle Nachrichten in den Sprachen eingestellt hast, die in der config.yml der LanguageAPI eingestellt sind.

single-Dateisystem

Wenn du zum Beispiel die Sprache Deutsch, Englisch und Spanisch unterstützt, muss du in diesem Fall die Nachrichten auf z.B. Englischen kopieren und diesen am Ende der Datei einfügen und jede einzelne Sprache übersetzen.

multi-Dateisystem

Genau wie beim single-Dateisystem musst du hier nur z.B. die english.yml-Datei kopieren und in den Namen der Sprache umändern. In dem Beispiel mit der spanischen Sprache in español.yml. (Wenn du die Sprache als español in der config.yml der LanguageAPI so eingestellt hast)

Schaue dir sonst nochmal die Einstellung zur Sprache bei der LanguageAPI an. Klicke hier

Ohne LanguageAPI

Wenn du allerdings meine LanguageAPI nicht gekauft hast, kannst du unter dem Punkt defaultLanguage: "english" die Standard Sprache der CoinsAPI einstellen. Dies bedeutet jeder Spieler bekommt alle Nachrichten des Plugins auf dieser Sprache gesendet.

payCommand

Wenn diese Einstellung auf true steht, können sich die Spieler gegenseitg ihr Geld senden.

Präfix

Der Präfix wird immer vor jeder Nachricht von der CoinsAPI gesetzt. Du kannst den Präfix ändern, in dem du die Zeile prefix: "&7[&fCoin&6System&7]&r" änderst.

Währung

Unter den folgenden Punkten kannst du den Namen der Währung auf deinem Server einstellen.

singleCurrencyAmount: "coin"
multiCurrencyAmount: "coins"

resetSize

Hier kannst du einstellen, auf welchen Wert das Geld vom Spieler gesetzt werden soll, wenn ein Admin dies zurücksetzt.

resetSize: '0.00'

coinsOnFirstJoin

Hier stellst du ein wie hoch der Anfangsbetrag eines Spielers sein soll, wenn er das 1. mal dein Netzwerk beitritt.

coinsOnFirstJoin: '0.00'

Standard Konfiguration

config.yml

# Please insert here your private license.
# If you do not have a private license, please join my Discord-Server to get your own one (link: https://discord.herrtechniker.eu).
license: ""

# Insert "mysql" to use mysql (cross-server access) or insert "sql" to use local database (only local servers have access)
database: "mysql"

# if LanguageAPI NOT enabled, what is the default-Language for this system
defaultLanguage: "english"

# if set true, the user can pay each other the coins
payCommand: false

prefix: "&7[&fCoin&6System&7]&r"

# set the name of currency for your server.
# will replace in messages with placeholder %CURRENCY%
# Single is for singular (for example 1 coin)
# Multi is for plural (for example 2 coins)
singleCurrencyAmount: "coin"
multiCurrencyAmount: "coins"

# set the amount for the reset (when an admin reset the coins for a player)
resetSize: '0.00'
# if a player join the first time, the player gets ... coins
coinsOnFirstJoin: '0.00'

Kommando

Syntax

/coins	--/--	Sehe deinen Kontostand
/coins help	--/--	Zeige alle mögliche Kommandos an
/coins see <Spieler>	coinsapi.seeother	Sehe den Kontostand eines anderen Spielers
/coins add <Spieler> <Betrag>	coinsapi.add	Füge einen bestimmten Betrag auf ein Konto eines Spielers hinzu
/coins remove <Spieler> <Betrag>	coinsapi.remove	Entferne einen bestimmten Betrag von ein Konto eines Spielers
/coins set <Spieler> <Betrag>	coinsapi.set	Setze den Kontostand eines Spielers auf einen bestimmten Betrag
/coins reset <Spieler>	coinsapi.reset	Setze den Kontostand eines Spielers zurück (siehe hier)
/coins reset <Spieler> <Betrag>	coinsapi.reset	Setze den Kontostand eines Spielers auf einen bestimmten Wert zurück
/pay <Spieler> <Betrag>	coinsapi.pay	Sende einem Spieler einen bestimmten Betrag (weitere Informationen findest du hier)
/coins pay <Spieler> <Betrag>	coinsapi.pay	Sende einem Spieler einen bestimmten Betrag (weitere Informationen findest du hier)