插件出生

检查 Java 与编译器 · 位置见本节说明

java -version
javac -version

运行结果

两条命令都应显示21系列版本

目录清单 · 位置见本节说明

BlockAcademyL31/
  build.gradle.kts
  settings.gradle.kts
  gradlew  gradlew.bat  gradle/wrapper/
  src/main/java/de/teacherma/lesson31/WelcomePlugin.java
  src/main/resources/plugin.yml

settings 文件内容 · 位置见本节说明

rootProject.name = "BlockAcademyL31"

完整构建脚本 · 完整文件

plugins { java }
group = "de.teacherma"
version = "1.0.0"
repositories {
    mavenCentral()
    maven("https://repo.papermc.io/repository/maven-public/")
}
dependencies {
    compileOnly("io.papermc.paper:paper-api:1.21.11-R0.1-SNAPSHOT")
}
java {
    toolchain.languageVersion.set(JavaLanguageVersion.of(21))
}
tasks.withType<JavaCompile>().configureEach {
    options.encoding = "UTF-8"
    options.release.set(21)
}

完整 plugin.yml · 完整文件

name: BlockAcademyL31
version: 1.0.0
main: de.teacherma.lesson31.WelcomePlugin
api-version: '1.21.11'
author: TeacherMa
website: https://www.teacher-ma.de

主类对应关系 · 位置见本节说明

package de.teacherma.lesson31;
// 主类名称 WelcomePlugin
// main: de.teacherma.lesson31.WelcomePlugin

打开和关闭欢迎台 · 位置见本节说明

@Override
public void onEnable() {
    getLogger().info("欢迎台开门");
}
@Override
public void onDisable() {
    getLogger().info("欢迎台关门");
}

登记当前对象 · 位置见本节说明

// 主类声明：extends JavaPlugin implements Listener
// 放进 onEnable
getServer().getPluginManager().registerEvents(this, this);

接收加入事件 · 位置见本节说明

@EventHandler
public void onJoin(PlayerJoinEvent event) {
    var player = event.getPlayer();
    player.sendMessage(Component.text("欢迎来到方块学院"));
}

判断新老玩家 · 位置见本节说明

String greeting = player.hasPlayedBefore()
        ? "欢迎回来，" : "初次见面，";
player.sendMessage(Component.text(greeting + player.getName()));

显示当前在线人数 · 位置见本节说明

int count = getServer().getOnlinePlayers().size();
player.sendMessage(Component.text("当前在线：" + count));

给文字染色 · 位置见本节说明

player.sendMessage(Component.text("欢迎！")
        .color(NamedTextColor.GREEN));

WelcomePlugin 源码 · 位置见本节说明

package de.teacherma.lesson31;

import net.kyori.adventure.text.Component;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerJoinEvent;
import org.bukkit.plugin.java.JavaPlugin;

public final class WelcomePlugin extends JavaPlugin implements Listener {
    @Override
    public void onEnable() {
        getServer().getPluginManager().registerEvents(this, this);
        getLogger().info("方块学院欢迎台已开门");
    }

    @EventHandler
    public void onJoin(PlayerJoinEvent event) {
        var player = event.getPlayer();
        String greeting = player.hasPlayedBefore()
                ? "欢迎回来，" : "初次见面，";
        player.sendMessage(Component.text(greeting + player.getName() + "！"));
        int online = getServer().getOnlinePlayers().size();
        player.sendMessage(Component.text("当前在线：" + online + " 人"));
    }

    @Override
    public void onDisable() {
        getLogger().info("欢迎台下班了，火把留给下一次冒险");
    }
}

Windows 构建命令 · 位置见本节说明

.\gradlew.bat clean build

运行结果

成功时末尾出现 BUILD SUCCESSFUL

生成 Wrapper 的备用方法 · 位置见本节说明

gradle wrapper --gradle-version 8.14.2

检查打包内容 · 位置见本节说明

jar tf build/libs/BlockAcademyL31-1.0.0.jar

运行结果

清单应包含 plugin.yml 与 WelcomePlugin.class

在服务器文件夹启动 · 位置见本节说明

java -Xms1G -Xmx2G -jar paper.jar --nogui

给一次修改做标记 · 位置见本节说明

player.sendMessage(Component.text("欢迎台 v2 已上线"));