Módulos
API de rangos
Lee vistas de rangos, inspecciona jugadores, aplica cambios de rango y registra contextos de permisos con RankService y sus servicios asociados.
Leer la vista de un jugador conectado
api.service(RankService.class)
.flatMap(ranks -> ranks.online(player.getUniqueId()))
.ifPresent(state -> {
long revision = state.revision;
// state.ranks: catálogo en esta revisión, state.user: grants y reglas
});online() lee memoria y nunca hace I/O. Durante una invalidación puede estar vacío; espera al siguiente RankStateEvent.
Actores
Toda operación autorizada recibe un RankService.Actor:
RankService.Actor actor = new RankService.Actor(player.getUniqueId(), false, RankContexts.EMPTY, player::isOnline);
RankService.Actor console = new RankService.Actor(null, true);El último argumento indica a sofyCore si el actor sigue siendo válido cuando la operación se confirma.
Aplicar un cambio
changeAsync(actor, change) aplica un RankService.Change. Las acciones son CREATE, EDIT, DELETE, RANK_PERMISSION, INHERIT, TEMPLATE, OWNER, GRANT, REVOKE, EXTEND, USER_PERMISSION, COLOR, RANK_RULE, USER_RULE y CLOCK. La autorización se vuelve a evaluar al confirmar el cambio, igual que con /access.
Contextos propios
AutoCloseable reg = api.service(RankContextService.class).get()
.register(java.util.Collections.singleton("arena"), uuid -> java.util.Collections.singletonMap("arena", arenaOf(uuid)));Los callbacks se ejecutan en el hilo de la plataforma y solo deben leer memoria local. Llama a refresh(uuid) cuando cambie el valor.