package com.example.myplugin;

import org.bukkit.plugin.java.JavaPlugin;

public class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        // 插件启用时调用
        getLogger().info("MyPlugin 已启用！");
    }

    @Override
    public void onDisable() {
        // 插件禁用时调用
        getLogger().info("MyPlugin 已禁用！");
    }
}

// Paper 原生异步聊天事件（非阻塞主线程）
@EventHandler
public void onAsyncChat(AsyncChatEvent event) {
    // 使用 Adventure API 的 Component
    Component message = event.message();
    // 这里的处理不会阻塞主线程
    Bukkit.getScheduler().runTaskAsynchronously(plugin, () -> {
        // 可以安全地进行数据库操作等耗时任务
    });
}

<!-- 仅 Bukkit（兼容性最广） -->
<dependency>
    <groupId>org.bukkit</groupId>
    <artifactId>bukkit</artifactId>
    <version>1.21.4-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

<!-- Paper（推荐，API 最丰富） -->
<dependency>
    <groupId>io.papermc.paper</groupId>
    <artifactId>paper-api</artifactId>
    <version>1.21.4-R0.1-SNAPSHOT</version>
    <scope>provided</scope>
</dependency>

public class MyPlugin extends JavaPlugin {

    @Override
    public void onLoad() {
        // 阶段 1: 加载（早于大多数插件启用）
        getLogger().info("正在加载...");
    }

    @Override
    public void onEnable() {
        // 阶段 2: 启用
        // 注册事件
        getServer().getPluginManager().registerEvents(new MyListener(), this);
        // 注册命令
        getCommand("mycommand").setExecutor(new MyCommand());
        // 加载配置
        saveDefaultConfig();
        getLogger().info("已启用！");
    }

    @Override
    public void onDisable() {
        // 阶段 3: 禁用
        // 保存数据、清理资源
        getLogger().info("已禁用！");
    }
}