Saltar al contenido

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

Java
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:

Java
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

Java
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.