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.
| Evento | Campos | Se dispara cuando | Cancelable |
|---|---|---|---|
StorageReadyEventnet.sofycore.api.storage | SofyCoreApi api() | Almacenamiento y Redis conectados; se publica en el hilo de Minecraft. | No |
UserSessionReadyEventnet.sofycore.api.user | UUID sessionId(), UserProfile user() | El perfil base de un jugador está cargado para una sesión nueva. | No |
UserSessionClosedEventnet.sofycore.api.user | UUID sessionId(), UUID userId() | Una sesión se cerró (salida o apagado). | No |
RankStateEventnet.sofycore.api.rank | UUID playerId, long revision, boolean available | Una vista de rangos se aplicó o dejó de ser utilizable en este servidor. | No |
ModerationEventnet.sofycore.api.moderation | String id, String action, Sanction sanction, Report report | Una sanción emitida/retirada o una transición de reporte confirmada. | No |
FreezeEventnet.sofycore.api.staff | Type type (FROZEN, UNFROZEN, DISCONNECTED), FreezeState state, String actor | Un cambio de freeze recibido por este servidor. | No |
VanishStateEventnet.sofycore.api.staff | UUID playerId, boolean vanished | Cambió el estado de vanish de un jugador. | No |
AnnouncementBroadcastEventnet.sofycore.api.announcement | String id(), int recipients() | Se entregó un anuncio local o global. | No |
Registrar un listener
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,VanishStateEventyModerationEventse publican en el hilo del servidor de cada servidor que aplica el cambio.StorageReadyEventse publica en el hilo de Minecraft cuando el almacenamiento está conectado.UserSessionReadyEventyUserSessionClosedEventse publican en el hilo del servidor con listeners aislados.- No guardes un
RankService.Statedespués de unRankStateEventconavailable = false.