tapscrollWIKI

Installation

Gavel installieren, Vault verbinden, Gebühren setzen und das Auktionshaus öffnen.

Gavel v1.0.0Paper · Folia supported1.21 – 1.21.x

  1. Vault und ein Economy-Plugin installieren

    Gavel braucht ein Guthaben, das es bewegen kann. Vault plus ein beliebiges Economy-Plugin (EssentialsX, CMI, CoinsEngine über das Provider-Interface) reicht.

    Ohne Economy-Provider lädt Gavel zwar, verweigert aber Käufe.

  2. Jar einspielen

    Lege Gavel-1.0.0.jar in plugins/ und starte neu.

    Beim ersten Start holt Papers Library-Loader HikariCP, den SQLite-Treiber und — nur wenn du sie konfigurierst — den MySQL-Treiber und Jedis. Nichts davon steckt in der Jar, der erste Start braucht also Internetzugang; spätere Starts nutzen die gecachten Kopien.

  3. Servernamen setzen

    plugins/Gavel/config.yml
    general:  server-name: "survival-1"  default-language: "de"  follow-client-locale: true

    server-name wird auf jedes Angebot gestempelt, damit du siehst, wo etwas gelistet wurde. Halte ihn pro Server eindeutig, auch wenn du (noch) kein Netzwerk betreibst.

  4. Gebühren festlegen

    Die Standardwerte sind bewusst mild: 1 % Einstellgebühr und 5 % Verkaufssteuer, beide als Senke.

    YAML
    auction:  listing-fee:    percent: 1.0    flat: 0.0  sales-tax-percent: 5.0  tax-destination: NOTHING

    NOTHING ist meistens richtig

    NOTHING nimmt das Geld aus der Wirtschaft. Auf den meisten Servern ist das der Sinn der Sache — ein Auktionshaus ohne Senke ist eine Inflationsmaschine. ACCOUNT nur, wenn du einen Grund hast, die Gebühren einem bestimmten Spieler auszuzahlen.

  5. Permissions vergeben

    Die spielerseitigen Permissions stehen standardmäßig auf true, eine frische Installation funktioniert also sofort. Setzen musst du die rangabhängigen Limits:

    BASH
    lp group default permission set gavel.limit.5 truelp group vip permission set gavel.limit.15 truelp group vip permission set gavel.tax.2 truelp group vip permission set gavel.duration.72 true

    Vollständige Liste unter Permissions.

  6. Öffnen

    BASH
    /ah

    Das Browse-Menü öffnet sich. /ah sell 5000 listet das Item in deiner Hand für 5.000.

Sprachen

Jeder spielerseitige Text liegt in plugins/Gavel/lang/<code>.yml. Englisch und Deutsch liegen dem Plugin bei.

YAML
general:  default-language: "de"  follow-client-locale: true

Mit follow-client-locale: true bekommt ein Spieler, dessen Minecraft-Client auf Deutsch steht, automatisch de.yml, sofern die Datei existiert. /ah lang <code> schlägt immer beides.

Für eine weitere Sprache kopierst du en.yml nach z. B. fr.yml und übersetzt sie. Der Dateiname ist der Sprachcode.

Menüs

Die Menü-Layouts liegen in plugins/Gavel/gui/: browse.yml, sell.yml, price.yml, market.yml, confirm.yml, filters.yml, inspect.yml, listing.yml, mailbox.yml, my-listings.yml, offers.yml, watchlist.yml und menu.yml. Slot-Positionen, Materialien und Lore sind alle editierbar.

Update

  1. Server stoppen.
  2. Alte Jar entfernen — keine zwei Versionen in plugins/ liegen lassen.
  3. Neue Jar einlegen und starten.

Datenbank-Migrationen laufen beim Start automatisch. config.yml, lang/ und gui/ werden nicht überschrieben; neue Optionen greifen auf ihre Standardwerte zurück, bis du sie einträgst.

Cross-Server planen

Wenn du einen Markt über mehrere Server teilen willst, lies Cross-Server, bevor Spieler etwas listen. Später von SQLite auf MySQL zu wechseln bedeutet, laufende Angebote zu migrieren — vermeidbare Arbeit.