Saltar al contenido

Primeros pasos

Inicializar la API

Carga SofyCoreApi desde el ServicesManager de Bukkit, espera StorageReadyEvent sin bloquear y pide los servicios de forma segura.

Cargar el punto de entrada

MyPlugin.javaJava
import net.sofycore.api.SofyCoreApi;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

public final class MyPlugin extends JavaPlugin {
    private SofyCoreApi sofy;

    @Override
    public void onEnable() {
        sofy = Bukkit.getServicesManager().load(SofyCoreApi.class);
        if (sofy == null) {
            getLogger().severe("sofyCore is not available");
            getServer().getPluginManager().disablePlugin(this);
            return;
        }
    }
}

Esperar al almacenamiento sin bloquear

Los servicios con persistencia se registran cuando el arranque asíncrono termina con éxito. Suscríbete a StorageReadyEvent (publicado en el hilo de Minecraft) y comprueba también si el core ya está listo. Nunca bloquees onEnable esperando el evento.

MyPlugin.javaJava
import net.sofycore.api.storage.PersistenceService;
import net.sofycore.api.storage.StorageReadyEvent;

AutoCloseable readySub = sofy.events().subscribe(StorageReadyEvent.class, event -> start(event.api()));
if (sofy.service(PersistenceService.class).isPresent()) {
    start(sofy); // el almacenamiento ya estaba listo
}

private void start(SofyCoreApi api) {
    // pide aquí los servicios
}

Pedir servicios

Java
api.service(RankService.class).ifPresent(ranks -> {
    // el módulo de rangos está en marcha
});

service() devuelve Optional.empty() si el módulo está apagado, falló o no está listo. No guardes un servicio para siempre: una recarga del módulo retira y vuelve a registrar su servicio.