Saltar al contenido

Referencia de la API

Eventos

Eventos publicados en el EventBus de sofyCore, cuándo se disparan, qué datos llevan y cómo suscribirse a ellos.

Los eventos de sofyCore son objetos Java simples publicados en su propio EventBus, no eventos de Bukkit. Suscríbete con api.events().subscribe(Tipo.class, listener). Ninguno es cancelable: informan de cambios ya confirmados.

EventoCamposSe dispara cuandoCancelable
StorageReadyEventnet.sofycore.api.storageSofyCoreApi api()Almacenamiento y Redis conectados; se publica en el hilo de Minecraft.No
UserSessionReadyEventnet.sofycore.api.userUUID sessionId(), UserProfile user()El perfil base de un jugador está cargado para una sesión nueva.No
UserSessionClosedEventnet.sofycore.api.userUUID sessionId(), UUID userId()Una sesión se cerró (salida o apagado).No
RankStateEventnet.sofycore.api.rankUUID playerId, long revision, boolean availableUna vista de rangos se aplicó o dejó de ser utilizable en este servidor.No
ModerationEventnet.sofycore.api.moderationString id, String action, Sanction sanction, Report reportUna sanción emitida/retirada o una transición de reporte confirmada.No
FreezeEventnet.sofycore.api.staffType type (FROZEN, UNFROZEN, DISCONNECTED), FreezeState state, String actorUn cambio de freeze recibido por este servidor.No
VanishStateEventnet.sofycore.api.staffUUID playerId, boolean vanishedCambió el estado de vanish de un jugador.No
AnnouncementBroadcastEventnet.sofycore.api.announcementString id(), int recipients()Se entregó un anuncio local o global.No

Registrar un listener

Java
AutoCloseable sub = api.events().subscribe(RankStateEvent.class, event -> {
    if (!event.available) return; // la vista se invalidó
    // actualiza algo para event.playerId
});
// después, en onDisable:
sub.close();

Notas de ejecución

  • RankStateEvent, FreezeEvent, VanishStateEvent y ModerationEvent se publican en el hilo del servidor de cada servidor que aplica el cambio.
  • StorageReadyEvent se publica en el hilo de Minecraft cuando el almacenamiento está conectado.
  • UserSessionReadyEvent y UserSessionClosedEvent se publican en el hilo del servidor con listeners aislados.
  • No guardes un RankService.State después de un RankStateEvent con available = false.