Saltar al contenido

Módulos

API de usuarios y red

Lee perfiles y preferencias, sigue las sesiones de forma segura y localiza jugadores y servidores en la red.

Cargar datos de tu módulo por sesión

  1. Suscríbete a UserSessionReadyEvent (UUID, sesión y perfil base listos).
  2. Lanza tu propia carga asíncrona.
  3. Al terminar, programa el trabajo de Bukkit en el hilo del servidor y comprueba que OnlineUsers.sessionId(uuid) sigue coincidiendo con la sesión del evento.
  4. Suscríbete a UserSessionClosedEvent y descarta los datos de esa sesión.
  5. Si tu plugin se activa con jugadores conectados, recorre OnlineUsers.readySessions() después de suscribirte.

Nunca guardes el objeto Player en tus tareas de carga, y descarta respuestas de una sesión anterior aunque coincida la UUID.

Preferencias

UserService cambia las preferencias con compare-and-set: setAnnouncementsAsync, setBossBarAsync, setPrivateMessagesAsync, setTagAsync, setMentionSoundAsync, setLocalRankAsync. Las escrituras también actualizan al jugador en este servidor.

Directorio de jugadores

PlayerDirectory sabe dónde está conectado cada jugador en la red: findAsync(nombre), findAsync(uuid), serverAsync(serverId) y rosterAsync(). serverId() devuelve el server.id de este servidor.