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
- Suscríbete a
UserSessionReadyEvent(UUID, sesión y perfil base listos). - Lanza tu propia carga asíncrona.
- 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. - Suscríbete a
UserSessionClosedEventy descarta los datos de esa sesión. - 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.