API 方法表 ​

import com.github.ginirohikocha.chaui.api.ChaUIAPI;
import com.github.ginirohikocha.chaui.api.ChaUIEntityAPI;
import com.github.ginirohikocha.chaui.api.ChaUISlotAPI;
import com.github.ginirohikocha.chaui.api.GlobalScriptExecutionInfo;
import com.github.ginirohikocha.chaui.api.PageRegistrationResult;
import com.github.ginirohikocha.chaui.api.PersistentWorldPage;
import com.github.ginirohikocha.chaui.api.WorldMoveType;
import com.github.ginirohikocha.chaui.api.event.ChaUIClientReadyEvent;
import com.github.ginirohikocha.chaui.api.event.ChaUIPacketEvent;
import com.github.ginirohikocha.chaui.api.event.ChaUISlotClickEvent;
import java.util.List;

String executionId = ChaUIAPI.executeGlobalMethod(
        player, "notify_player", "欢迎回来");

List<GlobalScriptExecutionInfo> active = ChaUIAPI.activeGlobalScripts();
boolean stopped = ChaUIAPI.stopGlobalScript(executionId);

// 打开普通页面或 HUD
ChaUIAPI.open(player, "welcome");

// 使用页面 yml 中配置的世界坐标和朝向
ChaUIAPI.openWorld(player, "world_welcome", "主城欢迎牌");

// 临时覆盖世界坐标，并让竖直页面朝向跟随玩家
ChaUIAPI.openWorld(player, "world_welcome", "副本入口", 120.5, 65.0, -30.5, "follow_player");

// 把地图正面朝上横放；固定 yaw 可保持地图方向不随玩家旋转
ChaUIAPI.openWorld(player, "ground_map", "主城地图", 120.5, 64.01, -30.5, "0", 90.0D);

// 立即移动现有实例，不触发 close/open 生命周期
ChaUIAPI.moveWorld(player, "副本入口", 125.0, 66.0, -28.0);

// 在 800 毫秒内平滑移动；新移动会立即取代尚未完成的旧移动
ChaUIAPI.moveWorld(player, "副本入口", 130.0, 66.0, -25.0,
        800L, WorldMoveType.EASE_IN_OUT);

// 普通页面和 HUD 按页面 ID 关闭
ChaUIAPI.close(player, "welcome");

// 把当前内容子页面替换为商店页，并在真正打开后发送初始变量
ChaUIAPI.replaceSubPage(player, "barn_shop").thenAccept(sessionId ->
        ChaUIAPI.setVariables(player, "barn_shop", Map.of("quantity", 1))
);

// 重置该玩家在当前服务器下记住的全部组件位置
ChaUIAPI.resetRememberedComponentPositions(player);

// 世界页面按全局唯一的实例 ID 关闭，不填写页面 ID
ChaUIAPI.closeWorld(player, "主城欢迎牌");

ChaUIAPI.setVariable(player, "welcome", "progress", 0.75);
ChaUIAPI.setComponentState(player, "welcome", "tip", "visible", true);
ChaUIAPI.setComponentState(player, "welcome", "dialog", "pointerEvents", "block");
ChaUIAPI.setComponentState(player, "welcome", "dialog", "scale", 1.05);
ChaUIAPI.setComponentState(player, "welcome", "dialog", "opacity", 0.9);
ChaUIAPI.runScript(player, "welcome", "vars.ready = true");

ItemStack prototype = new ItemStack(Material.DIAMOND, 1);

// 页面中的 itemSlot.maxStack 必须允许 999。
ChaUISlotAPI.setSlotItem(player, "persistent", "roi_loot_000", prototype, 999);

// 持久化时分别保存原型和逻辑数量。
ItemStack savedPrototype = ChaUISlotAPI.getSlotPrototype(
        player, "persistent", "roi_loot_000");
int savedAmount = ChaUISlotAPI.getSlotAmount(
        player, "persistent", "roi_loot_000");

public final class ChaUIReadyListener implements Listener {
    @EventHandler
    public void onClientReady(ChaUIClientReadyEvent event) {
        ChaUIAPI.open(event.getPlayer(), "welcome");
    }
}

public final class RewardSlotListener implements Listener {
    @EventHandler
    public void onSlotClick(ChaUISlotClickEvent event) {
        if (!"reward_input".equals(event.getBind())) {
            return;
        }

        ItemStack result = event.getSlotItemAfter();
        if (result != null && result.getAmount() > 16) {
            event.setCancelled(true);
        }
    }
}

public final class ChaUIPacketListener implements Listener {
    @EventHandler
    public void onPacket(ChaUIPacketEvent event) {
        if (!"treasure.claim".equals(event.getPacketId())) {
            return;
        }

        Player player = event.getPlayer();
        List<String> data = event.getData();
        // 在这里校验业务状态，再执行奖励逻辑。
    }
}

@Override
public void onEnable() {
    getServer().getPluginManager().registerEvents(new RewardSlotListener(), this);
    getServer().getPluginManager().registerEvents(new ChaUIPacketListener(), this);
    getServer().getPluginManager().registerEvents(new ChaUIReadyListener(), this);
}