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.
- Gestiona
Optional.empty(). Cualquier módulo puede estar apagado o recargándose. - Nunca bloquees el hilo del servidor con
join()oget()sobre un futuro de sofyCore. - Descarta resultados tardíos comprobando
OnlineUsers.sessionId(uuid)antes de aplicarlos a un jugador. - 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.
- No reintentes a ciegas escrituras inciertas. Un futuro fallido después del commit puede significar que la escritura ocurrió; lee y reconcilia.
- Mantén los resolutores de placeholders y los proveedores de contexto sin I/O.
- Cierra tus suscripciones (
AutoCloseable) enonDisable. - Usa tus propios namespaces en
PersistenceServicey 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.