Events API

Die Events API ermöglicht das Reagieren auf Änderungen in deinem Netzwerk in Echtzeit. Zugriff über api.event().

Event-Kategorien

Methode	Events
`api.event().group()`	Gruppe erstellt, aktualisiert, gelöscht
`api.event().server()`	Server gestartet, gestoppt, Status geändert, aktualisiert, gelöscht
`api.event().persistentServer()`	Persistenter Server erstellt, gestartet, gestoppt, aktualisiert, gelöscht
`api.event().blueprint()`	Blueprint erstellt, aktualisiert, gelöscht

Alle Event-Objekte stellen getNetworkId() und getTimestamp() bereit.

Server Events

Server Events werden für laufende Instanzen ausgelöst. Ein Server kann aus einer Gruppe oder aus einem persistenten Server stammen. Nutze das enthaltene Server-Model, um die Quelle zu prüfen.

Server gestartet

Subscription sub = api.event().server().onStarted(event -> {
    Server server = event.getServer();

    System.out.println("Server gestartet: " + event.getServerId());

    if (server.isFromPersistentServer()) {
        System.out.println("Persistenter Server: " + server.getPersistentServerId());
    } else {
        System.out.println("Gruppe: " + server.getGroup().getName());
    }
});

Server gestoppt

api.event().server().onStopped(event -> {
    System.out.println("Server gestoppt: " + event.getServerId());

    if (event.getCrashed()) {
        System.out.println("Exit-Code: " + event.getExitCode());
        System.out.println("Grund: " + event.getReason());
    }
});

Server-Status geändert

api.event().server().onStateChanged(event -> {
    System.out.println(event.getServerId() + ": " +
        event.getOldState() + " -> " + event.getNewState());
});

Server aktualisiert und gelöscht

api.event().server().onUpdated(event -> {
    System.out.println("Server aktualisiert: " + event.getServerId());
});

api.event().server().onDeleted(event -> {
    System.out.println("Server gelöscht: " + event.getServerId());
});

Gruppen Events

api.event().group().onCreated(event -> {
    System.out.println("Gruppe erstellt: " + event.getGroup().getName());
});

api.event().group().onUpdated(event -> {
    System.out.println("Gruppe aktualisiert: " + event.getGroup().getName());
});

api.event().group().onDeleted(event -> {
    System.out.println("Gruppe gelöscht: " + event.getName());
});

Persistent Server Events

api.event().persistentServer().onCreated(event -> {
    System.out.println("Persistenter Server erstellt: " + event.getPersistentServerId());
});

api.event().persistentServer().onStarted(event -> {
    System.out.println("Persistenter Server gestartet: " + event.getPersistentServerId());
    System.out.println("Laufender Server: " + event.getServerId());
});

api.event().persistentServer().onStopped(event -> {
    System.out.println("Persistenter Server gestoppt: " + event.getPersistentServerId());
});

api.event().persistentServer().onUpdated(event -> {
    System.out.println("Persistenter Server aktualisiert: " + event.getName());
});

api.event().persistentServer().onDeleted(event -> {
    System.out.println("Persistenter Server gelöscht: " + event.getName());
});

Blueprint Events

api.event().blueprint().onCreated(event -> {
    System.out.println("Blueprint erstellt: " + event.getBlueprint().getName());
});

api.event().blueprint().onUpdated(event -> {
    System.out.println("Blueprint aktualisiert: " + event.getBlueprint().getName());
});

api.event().blueprint().onDeleted(event -> {
    System.out.println("Blueprint gelöscht: " + event.getName());
});

Subscriptions verwalten

Subscriptions implementieren AutoCloseable. Räume sie immer auf, wenn du fertig bist.

Manuelles Aufräumen

Subscription sub = api.event().server().onStarted(event -> {
    System.out.println("Gestartet: " + event.getServer().getServerId());
});

// Später, beim Herunterfahren
sub.close();

Plugin-Lebenszyklus

public class MeinPlugin extends JavaPlugin {
    private final List<Subscription> subscriptions = new ArrayList<>();
    private CloudApi api;

    @Override
    public void onEnable() {
        api = CloudApi.create();

        subscriptions.add(api.event().server().onStarted(this::handleServerStart));
        subscriptions.add(api.event().server().onStopped(this::handleServerStop));
    }

    @Override
    public void onDisable() {
        subscriptions.forEach(Subscription::close);
    }

    private void handleServerStart(ServerStartedEvent event) {
        getLogger().info("Server gestartet: " + event.getServerId());
    }

    private void handleServerStop(ServerStoppedEvent event) {
        getLogger().info("Server gestoppt: " + event.getServerId());
    }
}

Event-Referenz

Felder entsprechen Java-Gettern. serverId wird zum Beispiel über getServerId() bereitgestellt. Jedes Event enthält diese gemeinsamen Felder:

string

Netzwerk-ID, zu der das Event gehört.

string

ISO-8601-Zeitpunkt, zu dem das Event ausgelöst wurde.

Server Events

ServerStartedEvent

string

ID der gestarteten Serverinstanz.

string

ID der Servergruppe, zu der dieser Server gehört.

Server

Gestartete Serverinstanz mit vollständiger Konfiguration und Laufzeitinformationen.

ServerStoppedEvent

string

ID der gestoppten Serverinstanz.

string

ID der Servergruppe, zu der dieser Server gehört.

Server

Gestoppte Serverinstanz mit vollständiger Konfiguration und Laufzeitinformationen.

boolean

Gibt an, ob der Server unerwartet gestoppt wurde.

integer | null

Exit-Code des Prozesses oder null, wenn kein Exit-Code verfügbar ist.

string | null

Stop-Grund oder null, wenn kein Grund verfügbar ist.

ServerStateChangedEvent

string

ID des Servers, dessen Status sich geändert hat.

ServerState

Vorheriger Serverstatus.

ServerState

Neuer Serverstatus.

Server

Aktuelle Serverinstanz mit vollständiger Konfiguration und Laufzeitinformationen.

ServerUpdatedEvent

string

ID der aktualisierten Serverinstanz.

string

ID der Servergruppe, zu der dieser Server gehört.

Server

Aktualisierte Serverinstanz mit vollständiger Konfiguration und Laufzeitinformationen.

ServerDeletedEvent

string

ID der gelöschten Serverinstanz.

string

ID der Servergruppe, zu der dieser Server gehörte.

Server

Gelöschte Serverinstanz mit den zuletzt verfügbaren Konfigurations- und Laufzeitinformationen.

Gruppen Events

GroupCreatedEvent

string

ID der erstellten Servergruppe.

Group

Erstelltes Gruppenmodell.

GroupUpdatedEvent

string

ID der aktualisierten Servergruppe.

Group

Aktualisiertes Gruppenmodell.

GroupDeletedEvent

string

ID der gelöschten Servergruppe.

string | null

Name der gelöschten Gruppe oder null, wenn der Name nicht mehr verfügbar ist.

Persistent Server Events

PersistentServerCreatedEvent

string

ID des erstellten persistenten Servers.

string | null

Name des erstellten persistenten Servers oder null, wenn kein Name verfügbar ist.

PersistentServerStartedEvent

string

ID des gestarteten persistenten Servers.

string | null

ID der zugehörigen laufenden Serverinstanz oder null, wenn sie nicht verfügbar ist.

PersistentServerStoppedEvent

string

ID des gestoppten persistenten Servers.

string | null

ID der zugehörigen Serverinstanz oder null, wenn sie nicht verfügbar ist.

PersistentServerUpdatedEvent

string

ID des aktualisierten persistenten Servers.

string | null

Name des aktualisierten persistenten Servers oder null, wenn kein Name verfügbar ist.

PersistentServerDeletedEvent

string

ID des gelöschten persistenten Servers.

string | null

Name des gelöschten persistenten Servers oder null, wenn der Name nicht mehr verfügbar ist.

Blueprint Events

BlueprintCreatedEvent

string

ID des erstellten Blueprints.

Blueprint

Erstelltes Blueprint-Modell.

BlueprintUpdatedEvent

string

ID des aktualisierten Blueprints.

Blueprint

Aktualisiertes Blueprint-Modell.

BlueprintDeletedEvent

string

ID des gelöschten Blueprints.

string | null

Name des gelöschten Blueprints oder null, wenn der Name nicht mehr verfügbar ist.

Getting Started

Cloud API

Guides

Event-Kategorien

Server Events

Server gestartet

Server gestoppt

Server-Status geändert

Server aktualisiert und gelöscht

Gruppen Events

Persistent Server Events

Blueprint Events

Subscriptions verwalten

Manuelles Aufräumen

Plugin-Lebenszyklus

Event-Referenz

Server Events

Gruppen Events

Persistent Server Events

Blueprint Events

​Event-Kategorien

​Server Events

​Server gestartet

​Server gestoppt

​Server-Status geändert

​Server aktualisiert und gelöscht

​Gruppen Events

​Persistent Server Events

​Blueprint Events

​Subscriptions verwalten

​Manuelles Aufräumen

​Plugin-Lebenszyklus

​Event-Referenz

​Server Events

​Gruppen Events

​Persistent Server Events

​Blueprint Events

Event-Kategorien

Server Events

Server gestartet

Server gestoppt

Server-Status geändert

Server aktualisiert und gelöscht

Gruppen Events

Persistent Server Events

Blueprint Events

Subscriptions verwalten

Manuelles Aufräumen

Plugin-Lebenszyklus

Event-Referenz

Server Events

Gruppen Events

Persistent Server Events

Blueprint Events