Saltar al contenido

Avanzado

Buenas prácticas

Recomendaciones para integrar sofyCore de forma segura y eficiente, desde la búsqueda de servicios hasta los errores y el rendimiento.

  1. Gestiona Optional.empty(). Cualquier módulo puede estar apagado o recargándose.
  2. Nunca bloquees el hilo del servidor con join() o get() sobre un futuro de sofyCore.
  3. Descarta resultados tardíos comprobando OnlineUsers.sessionId(uuid) antes de aplicarlos a un jugador.
  4. Respeta la jerarquía. Crea los actores a partir del jugador real; reserva los actores de consola para decisiones que tu plugin toma por sí mismo.
  5. No reintentes a ciegas escrituras inciertas. Un futuro fallido después del commit puede significar que la escritura ocurrió; lee y reconcilia.
  6. Mantén los resolutores de placeholders y los proveedores de contexto sin I/O.
  7. Cierra tus suscripciones (AutoCloseable) en onDisable.
  8. Usa tus propios namespaces en PersistenceService y nunca edites directamente los de sofyCore.

Limitaciones

  • No hay transacciones de varios registros en PersistenceService.
  • Los mensajes pub/sub son transitorios y pueden perderse durante desconexiones.
  • PlaceholderAPI solo expone las claves propias de sofyCore, no las registradas por otros plugins.