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.ChaUIReloadCompleteEvent;
import com.github.ginirohikocha.chaui.api.event.ChaUISlotClickEvent;
import java.util.List;

// Bukkit 主线程中执行，theme 已在 globals 中声明为字符串。
ChaUIAPI.setGlobalVariable("theme", "red");
Object theme = ChaUIAPI.getGlobalVariable("theme");
Map<String, Object> globals = ChaUIAPI.globalVariables();

import com.github.ginirohikocha.chaui.api.ChaUIAPI;
import org.bukkit.entity.Entity;
import org.bukkit.entity.Player;

public final class HealthPageService {
    public static void show(Player viewer, Entity target) {
        // entity_health 的完整页面见世界界面教程。
        // 调用前等待 viewer 的 ChaUIClientReadyEvent。
        ChaUIAPI.openWorldFollowingEntity(
                viewer, "entity_health", "target_health", target.getUniqueId(), 0, 2.4, 0);
    }

    public static void pin(Entity target) {
        // 全服常驻 ID 不能重复；添加会保存记录并向就绪玩家打开。
        ChaUIAPI.addPersistentWorldPageFollowingEntity(
                "entity_health", "pinned_health", target, 0, 2.4, 0);
    }

    public static void hide(Player viewer) {
        ChaUIAPI.closeWorld(viewer, "target_health");
    }

    public static void unpin() {
        ChaUIAPI.removePersistentWorldPage("pinned_health");
    }
}

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

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

import com.github.ginirohikocha.chaui.api.ChaUIAPI;
import org.bukkit.entity.Player;

public final class PlayerNames {
    public static void hideForEveryone(Player target) {
        ChaUIAPI.setPlayerNameVisible(target, false);
    }

    public static void showToViewer(Player target, Player viewer) {
        ChaUIAPI.setPlayerNameVisible(target, viewer, true);
    }

    public static void restoreForEveryone(Player target) {
        ChaUIAPI.setPlayerNameVisible(target, true);
    }
}

// 打开普通页面或 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");
    }
}

import com.github.ginirohikocha.chaui.api.event.ChaUIReloadCompleteEvent;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;

public final class TagReloadListener implements Listener {
    @EventHandler
    public void onChaUIReloadComplete(ChaUIReloadCompleteEvent event) {
        // 重新更新依赖最新 ChaUI 页面定义的业务实例。
    }
}

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);
}