For the complete documentation index, see llms.txt. This page is also available as Markdown.

Eigene Abstimmungen

In diesem Guide lernst du, wie du eigene Abstimmungen (Votes) für dein Abstimmungen-Plugin erstellst und verwaltest.


Grundlagen des Abstimmungs-Systems

Das System ermöglicht Spielern, über ein GUI-Menü Umfragen zu starten. Ein Vote hat folgende Eigenschaften:

  1. Kosten: Das Starten eines Votes kostet In-Game-Geld (price).

  2. Ziel-Eingabe (playernameneeded): Bestimmt, ob der Abstimmende einen Spielernamen in den Chat eingeben muss (z. B. für Kick-Votes).

  3. Ausführung: Wenn die Mehrheit mit "JA" stimmt, wird der hinterlegte Befehl ausgeführt (entweder durch den Spieler oder die Konsole).

  4. Interaktive Buttons: Während des Votes werden "JA" und "NEIN" Buttons im Chat angezeigt.


Konfigurations-Struktur

Jeder Abstimmungstyp wird unter dem Key votes auf einem bestimmten GUI-Slot konfiguriert (z. B. Slot '11').

votes:
  '11': # Slot im GUI-Menü (0-26)
    material: 'MATERIALNAME'       # Symbol im GUI
    shortid: 0                     # Sub-ID (für ältere Minecraft-Versionen)
    name: 'Anzeigename'             # Name des Items im Menü
    price: 500                     # Kosten zum Starten des Votes
    playernameneeded: true         # Muss der Spieler einen Namen im Chat eingeben?
    command: '[CONSOLE]kick %target% &cMehrheitlich gekickt!' # Auszuführender Befehl bei Erfolg
    
    # Broadcast-Meldungen im Chat
    broadcast:
      start:
        - '&6&l%player% &7hat eine Abstimmung gestartet, um &c%target% &7zu kicken!'
        - '%vote%'                 # Dieser Platzhalter rendert die JA/NEIN-Klickbuttons!
      yes:
        - '&aDie Abstimmung war erfolgreich! &e%target% &7wurde gekickt.'
        - '%result%'               # Dieser Platzhalter rendert das Endergebnis (JA/NEIN Stimmenanzahl)!
      no:
        - '&cDie Abstimmung ist fehlgeschlagen! &e%target% &7darf bleiben.'
        - '%result%'

Platzhalter & Optionen

  • [CONSOLE]-Präfix im Befehl: Wenn der Befehl unter command mit [CONSOLE] beginnt, führt die Konsole den Befehl aus (z. B. [CONSOLE]kick %target%). Fehlt das Präfix, wird der Befehl im Namen des abstimmenden Spielers ausgeführt.

  • Platzhalter im Befehl & in Nachrichten:

    • %player%: Der Name des Spielers, der die Abstimmung gestartet hat.

    • %target%: Der Name des Ziel-Spielers (falls playernameneeded: true).

    • %world%: Der Name der Welt, in der die Abstimmung gestartet wurde.

    • %vote%: Rendert die interaktiven Klick-Buttons im Chat zum Abstimmen.

    • %result%: Zeigt das Endergebnis der Abstimmung im Chat an.


Konfigurations-Beispiele

1. Kick-Abstimmung (mit Spielername)

Ein Vote, um einen störenden Spieler durch die Konsole kicken zu lassen:

2. Sonnen-Abstimmung (ohne Spielername)

Ein Vote, um das Wetter auf Sonne zu stellen (wird im Namen des Spielers ausgeführt):


Schritt-für-Schritt-Anleitung: Neue Abstimmung hinzufügen

1

Slot bestimmen

Wähle einen freien Slot in der GUI (Slots 0 bis 26, standardmäßig 27 Slots insgesamt).

2

playernameneeded konfigurieren

Soll die Abstimmung eine bestimmte Person betreffen?

  • Falls ja, setze playernameneeded: true (der Spieler wird beim Klick aufgefordert, den Namen im Chat einzugeben).

  • Falls nein, setze playernameneeded: false.

3

Befehl festlegen

Definiere den auszuführenden Befehl bei erfolgreichem Votingergebnis. Verwende [CONSOLE] am Anfang, falls der Spieler für den Befehl keine Rechte besitzt.

4

Broadcasts eintragen

Passe die Start-, Erfolgs- und Fehlschlag-Nachrichten an. Vergiss nicht die Platzhalter %vote% und %result%.

Zuletzt aktualisiert