EventEngine/README.md

EventEngine

EventEngine ist ein Minecraft-Plugin für Paper 1.21+, mit dem du automatisch oder manuell Server-Events starten, verwalten und rotieren lassen kannst.

Der Fokus liegt auf:

• vielen eingebauten Event-Typen (100+)
• planbaren Events über Uhrzeit/Wochentage
• zufälliger Event-Rotation mit Gewichtung
• Custom-Events per Ingame-Builder
• schneller Admin-Steuerung per Befehl und GUI

Inhalt

• Features
• Voraussetzungen
• Installation
• Schnellstart
• Befehle
• Berechtigungen
• Konfiguration
• Zeitplan konfigurieren
• Event-Overrides (eingebaute Events anpassen)
• Custom Events
• Rotation und RANDOM
• Typische Abläufe
• Fehlerbehebung

Features

• Event-System mit eingebauten Kategorien (PvP, Survival, Build, Fun, Quiz, Economy, Team uvm.)
• GUI und Commands für schnelle Steuerung
• Zeitplan in config.yml mit Tagesfilter und Uhrzeit
• Intervall-Modus (alle X Minuten)
• Event-Rotation mit Gewichtung (weight)
• Ingame-Custom-Event-Builder (/event create <id>)
• Laufende Events verwalten (join/leave, stop, score)
• Konfigurations-Reload ohne Server-Neustart

Voraussetzungen

• Paper-Server 1.21.x
• Zugriff auf den plugins-Ordner

Installation

1. Plugin-JAR in den plugins-Ordner kopieren.
2. Server starten oder neu starten.
3. Es werden automatisch Konfigurationsdateien erzeugt:

• plugins/EventEngine/config.yml
• plugins/EventEngine/custom_events.yml (bzw. anhand des Beispiels)

Schnellstart

1. Liste aller Events anzeigen:

• /event list

2. Ein Event sofort starten:

• /event start random

3. Aktives Event anzeigen:

• /event info

4. Event beenden:

• /event stop

5. Änderungen an der Config übernehmen:

• /event reload

Befehle

Hauptbefehl:

• /event (Aliases: /ee, /events)

Verfügbare Subcommands:

• /event gui öffnet die Event-GUI
• /event start <id|random> startet ein Event
• /event stop [grund] beendet das laufende Event
• /event join nimmt am aktiven Event teil
• /event leave verlässt das aktive Event
• /event info [id] zeigt Info zum aktiven Event oder zu einer Event-ID
• /event list [seite] listet registrierte Events
• /event schedule zeigt den aktuellen Zeitplan
• /event create <id> startet den Ingame-Custom-Builder
• /event delete <id> löscht ein Custom-Event
• /event score <spieler> <punkte> vergibt Punkte im laufenden Event
• /event rotation <add|remove> <id> aktiviert/deaktiviert Rotation für ein Event
• /event reload lädt Config, Registry und Scheduler neu

Berechtigungen

• eventengine.admin
• eventengine.participate
• eventengine.notify

Empfehlung:

• Admin-Befehle nur an Team-Ränge vergeben.
• Teilnahme/Benachrichtigung an Standard-Spielerrollen vergeben.

Konfiguration

Datei: plugins/EventEngine/config.yml

Wichtige Bereiche:

• settings.prefix
• settings.log-events
• settings.announce-before-seconds
• settings.use-interval
• settings.interval-minutes
• settings.default-event
• settings.random-on-interval
• schedule
• event-overrides

Beispiel: Intervall-Modus aktivieren

settings:
  use-interval: true
  interval-minutes: 60
  default-event: "RANDOM"
  random-on-interval: true

Zeitplan konfigurieren

Jeder Zeitplan-Eintrag hat:

• days: Liste von Wochentagen (MONDAY bis SUNDAY), leer = täglich
• time: Uhrzeit im 24h-Format HH:MM
• event: Event-ID oder RANDOM

Beispiel:

schedule:
  - days: []
    time: "12:00"
    event: "RANDOM"

  - days: [FRIDAY, SATURDAY]
    time: "20:00"
    event: "pvp_hunger_games"

Event-Overrides (eingebaute Events anpassen)

Mit event-overrides kannst du Werte einzelner Builtin-Events überschreiben.

Beispiel:

event-overrides:
  pvp_deathmatch:
    duration-seconds: 600
    min-players: 4
    rewards:
      - "eco give %player% 500"
      - "give %player% diamond 3"

Custom Events

Custom Events liegen in custom_events.yml unter events:.

Du kannst sie:

• per Ingame-Builder erstellen (/event create <id>)
• per /event delete <id> entfernen
• manuell in der Datei pflegen

Wichtige Felder pro Event:

• display-name
• description
• category
• duration-seconds
• min-players
• max-players
• announcement
• in-rotation
• weight
• start-commands
• end-commands
• rewards
• settings

Rotation und RANDOM

RANDOM wählt aus allen Events mit in-rotation: true.

Die Häufigkeit wird über weight gesteuert:

• höheres weight = höhere Chance
• weight: 1 ist Standard

Rotation verwalten:

• /event rotation add <id>
• /event rotation remove <id>

Typische Abläufe

Custom Event anlegen:

1. /event create parkour_night
2. Builder durchlaufen
3. Mit /event list prüfen
4. Optional in Rotation aufnehmen: /event rotation add parkour_night

Geplantes Event testen:

1. Eintrag in config.yml anlegen
2. /event reload
3. Mit /event schedule prüfen
4. Teststart mit /event start <id>

Fehlerbehebung

Event startet nicht:

• Mit /event info prüfen, ob bereits ein Event läuft.
• Mit /event list prüfen, ob die ID korrekt ist.
• Prüfen, ob Mindestspielerzahl erreicht ist.

Zeitplan greift nicht:

• Zeitformat prüfen (HH:MM).
• Wochentage prüfen (MONDAY ... SUNDAY).
• Nach Änderungen immer /event reload ausführen.

RANDOM findet nichts:

• Mindestens ein Event muss in der Rotation aktiv sein (in-rotation: true).
• Mit /event rotation add <id> Events hinzufügen.

Hinweis

Die Event-Liste kann je nach Plugin-Version variieren. Verwende /event list, um alle aktuell registrierten IDs auf deinem Server zu sehen.