Skip to content

Getting Started

First integration

A complete minimal plugin that reads a player's visible rank, listens to freeze events and shows the VIP points balance.

This plugin logs the visible rank of each player when their sofyCore session is ready, and reacts to network freezes.

FirstIntegration.javaJava
package com.example.first;

import java.util.UUID;
import net.sofycore.api.SofyCoreApi;
import net.sofycore.api.rank.RankAppearanceService;
import net.sofycore.api.staff.FreezeEvent;
import net.sofycore.api.user.UserSessionReadyEvent;
import net.sofycore.api.vippoints.VippointsService;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

public final class FirstIntegration extends JavaPlugin {
    private final java.util.List<AutoCloseable> subscriptions = new java.util.ArrayList<>();

    @Override
    public void onEnable() {
        SofyCoreApi api = Bukkit.getServicesManager().load(SofyCoreApi.class);
        if (api == null) return;

        subscriptions.add(api.events().subscribe(UserSessionReadyEvent.class, event -> {
            UUID id = event.user().id();
            api.service(RankAppearanceService.class)
                .flatMap(service -> service.visibleRank(id))
                .ifPresent(rank -> getLogger().info(id + " is " + rank.label()));
            api.service(VippointsService.class)
                .ifPresent(points -> points.cachedBalance(id)
                    .ifPresent(balance -> getLogger().info("VIP points: " + balance)));
        }));

        subscriptions.add(api.events().subscribe(FreezeEvent.class, event ->
            getLogger().info(event.state.targetName + " " + event.type + " by " + event.actor)));
    }

    @Override
    public void onDisable() {
        for (AutoCloseable s : subscriptions) {
            try { s.close(); } catch (Exception ignored) { }
        }
    }
}