Paper/Paper 项目的搭建 - 版本历史

2024年3月21日 (四) 12:48 Tumuidle

2024-03-21T12:48:52Z

←上一版本		2024年3月21日 (四) 12:48的版本
第164行：		第164行：

	== 使用Paperweight Userdev ==		== 使用Paperweight Userdev ==
			'''此处为插件开发的高阶内容，直接在代码中调用NMS可能会导致插件不再兼容其他版本服务端，如仅需调用Paper API请勿使用Paperweight'''

	[https://docs.papermc.io/paper/dev/userdev 官方文档]		[https://docs.papermc.io/paper/dev/userdev 官方文档]

2024年3月21日 (四) 12:45 Tumuidle

2024-03-21T12:45:34Z

@@ 第5行： / 第5行： @@
 Paper 团队使用 [https://gradle.org/ Gradle] 作为 Paper 等项目的构建工具，其插件开发工具链使用 Gradle 对项目进行依赖管理。 在经过修改后，下文代码也将适用于其它构建工具，例如Maven。不过本文所提供的代码将只涉及Gradle。 阅读[https://docs.gradle.org/current/userguide/migrating_from_maven.html 此文档]学习如何从 Maven 迁移到Gradle。
 === 创建新项目 ===
@@ 第134行： / 第162行： @@
 编译成功后输出的 jar 文件应该存放在 <code>build/libs</code> 文件夹中。<br />
 </blockquote>

2022年12月22日 (四) 08:22 Poikcue

2022-12-22T08:22:02Z

←上一版本		2022年12月22日 (四) 08:22的版本
第116行：		第116行：
	=== 创建 <code>resources</code> 目录 ===		=== 创建 <code>resources</code> 目录 ===

	<code>resources</code> 文件夹是在你的插件中存放 <code>plugin.yml</code> 的地方。在[https://~~docs~~.~~poikcue.com/#/PaperMC/dev~~/~~getting-start~~/~~plugin-yml~~ 这里]了解更多关于plugin.yml的信息。		<code>resources</code> 文件夹是在你的插件中存放 <code>plugin.yml</code> 的地方。在[https://mineplugin.org/Paper/Paper_Plugin_YML 这里]了解更多关于plugin.yml的信息。

	=== 最后 ===		=== 最后 ===

2022年12月22日 (四) 08:21 Poikcue

2022-12-22T08:21:14Z

←上一版本		2022年12月22日 (四) 08:21的版本
第9行：		第9行：

	打开你的 IDE 然后点击创建新项目的按钮。<br />		打开你的 IDE 然后点击创建新项目的按钮。<br />
	~~[[File:https://s1.ax1x.com/2022/10/05/xlD8wq.png\|xlD8wq.png]]~~ 在 Intellij 中，你需要选择你想要创建的项目类型 —— 首先选中 <code>New Project</code>，然后选择 <code>Gradle - Kotlin DSL</code> 后单击 <code>Create</code>。		在 Intellij 中，你需要选择你想要创建的项目类型 —— 首先选中 <code>New Project</code>，然后选择 <code>Gradle - Kotlin DSL</code> 后单击 <code>Create</code>。

	~~[[File:https://s1.ax1x.com/2022/10/05/xlDYkV.png\|thumb\|none\|alt=xlDYkV.png\|xlDYkV.png]]~~

	接着，IDE 将自动为你打开可用于管理项目依赖的 <code>build.gradle.kts</code> 文件。		接着，IDE 将自动为你打开可用于管理项目依赖的 <code>build.gradle.kts</code> 文件。

2022年11月25日 (五) 14:14 Poikcue

2022-11-25T14:14:18Z

←上一版本		2022年11月25日 (五) 14:14的版本
第132行：		第132行：

	</div>		</div>
	<blockquote>提示<br />		<blockquote>'''提示'''<br />
	如果你正在使用 IntelliJ，你可以使用 Gradle 图形界面中的 <code>Build</code> 菜单来编译你的插件 - 它应该位于你的 IDE 的右上角。<br />		如果你正在使用 IntelliJ，你可以使用 Gradle 图形界面中的 <code>Build</code> 菜单来编译你的插件 - 它应该位于你的 IDE 的右上角。<br />
	编译成功后输出的 jar 文件应该存放在 <code>build/libs</code> 文件夹中。<br />		编译成功后输出的 jar 文件应该存放在 <code>build/libs</code> 文件夹中。<br />
	</blockquote>		</blockquote>

Poikcue：创建页面，内容为“
本文的图片都是由译者提供的。供新手开发者找到文章提到的选项。
由于Paper团队主要使用 [https://www.jetbr…”

2022-11-25T14:13:17Z

创建页面，内容为“<blockquote>本文的图片都是由译者提供的。供新手开发者找到文章提到的选项。 </blockquote> 由于Paper团队主要使用 [https://www.jetbr…”

新页面

<blockquote>本文的图片都是由译者提供的。供新手开发者找到文章提到的选项。
</blockquote>
由于Paper团队主要使用 [https://www.jetbrains.com/idea/ IntelliJ IDEA] 进行开发，所以本指南将以该IDE作为重点。 
不过，下文应当也适用于其它IDE，仅需针对性的作一些微小的修改即可。

Paper 团队使用 [https://gradle.org/ Gradle] 作为 Paper 等项目的构建工具，其插件开发工具链使用 Gradle 对项目进行依赖管理。在经过修改后，下文代码也将适用于其它构建工具，例如Maven。不过本文所提供的代码将只涉及Gradle。阅读[https://docs.gradle.org/current/userguide/migrating_from_maven.html 此文档]学习如何从 Maven 迁移到Gradle。

=== 创建新项目 ===

打开你的 IDE 然后点击创建新项目的按钮。 
[[File:https://s1.ax1x.com/2022/10/05/xlD8wq.png|xlD8wq.png]] 在 Intellij 中，你需要选择你想要创建的项目类型 —— 首先选中 <code>New Project</code>，然后选择 <code>Gradle - Kotlin DSL</code> 后单击 <code>Create</code>。

[[File:https://s1.ax1x.com/2022/10/05/xlDYkV.png|thumb|none|alt=xlDYkV.png|xlDYkV.png]]

接着，IDE 将自动为你打开可用于管理项目依赖的 <code>build.gradle.kts</code> 文件。


=== 将 Paper 作为依赖项添加 ===

要将 Paper 作为插件项目的一个依赖项，你需要将 Paper 仓库 ( <code>repository</code> ) 和 Paper 依赖 ( <code>dependency</code> ) 添加到你的 <code>build.gradle.kts</code> 文件中。

<syntaxhighlight lang="kotlin">repositories {
mavenCentral()
maven("https://repo.papermc.io/repository/maven-public/")
}

dependencies {
compileOnly("io.papermc.paper:paper-api:1.19.2-R0.1-SNAPSHOT")
}

java {
toolchain.languageVersion.set(JavaLanguageVersion.of(17))
}
</syntaxhighlight>

=== 创建 <code>src</code> 目录 ===

<blockquote>'''跳过''' 
如果 IDE 已经为你的项目自动创建 <code>src</code> 目录，你就可以跳过这一步了。
</blockquote>
要创建 <code>src</code> 目录，你需要新建一个名为 <code>src</code> 的文件夹，然后在里面创建子目录，叫做 <code>main</code>。 
接下来，在<code>main</code>之中创建两个文件夹，分别命名为 <code>java</code> 和 <code>resources</code>。

该文件夹的目录结构形如下：

<pre>...
example-plugin
├── build.gradle.kts
├── settings.gradle.kts
└── src
└── main
├── java
└── resources
...
</pre>

=== 创建 <code>java</code> 目录 ===

Java 源代码存放在 <code>java</code> 目录中。你必须先创建一些包来管理你的 Java 代码。拿下面这个结构举例，我们创建了一个三层的包并将其命名为 <code>io.papermc.testplugin</code>。而在包中有一个<code>ExamplePlugin</code> 类 ( <code>class</code> )。

<pre>...
example-plugin
├── build.gradle.kts
├── settings.gradle.kts
└── src
└── main
├── java
│ └── io
│ └── papermc
│ └── testplugin
│ └── ExamplePlugin.java
└── resources
...
</pre>
=== 包 ===

可以看到，<code>ExamplePlugin</code> 类在 <code>io.papermc.testplugin</code> 包中。 
包用于管理代码。本质上，包就是个文件夹。在 Java 中，我们用包来管理一组相互间有一定关联的类。 
如果你想要了解更多关于包的信息，你可以在 Oracle 的指南中[https://docs.oracle.com/javase/tutorial/java/package/packages.html 查看]。

要为你的包[https://docs.oracle.com/javase/tutorial/java/package/namingpkgs.html 命名]，你需要将域名颠倒顺序排列。比如有一个叫做 <code>papermc.io</code>的域名，你的包就应该命名为 <code>io.papermc</code>。 
如果你还没有一个域名，你可以将你的 GitHub 用户名作为包名（格式大概是：io.github.用户名）。 
若你的名字叫做 Linus Torvalds，你的包应该是 <code>io.github.torvalds</code>。

跟随域名的应该是你的项目名。 
比如，你有一个的工程叫做 <code>ExamplePlugin</code>，你的包应该是<code>io.github.torvalds.exampleplugin</code>。 
你的每个插件都会有一个独一无二的包名。

=== 主类 ===

主类是你的插件中所有代码执行的起点，是唯一一个继承 <code>JavaPlugin</code> 的类。 
下面是一个 <code>ExamplePlugin</code> 类的示例：

<syntaxhighlight lang="java">package io.papermc.testplugin;

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

public class ExamplePlugin extends JavaPlugin implements Listener {

@Override
public void onEnable() {
Bukkit.getPluginManager().registerEvents(this, this);
}

@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
event.getPlayer().sendMessage(Component.text("Hello, " + event.getPlayer().getName() + "!"));
}

}
</syntaxhighlight>

=== 创建 <code>resources</code> 目录 ===

<code>resources</code> 文件夹是在你的插件中存放 <code>plugin.yml</code> 的地方。在[https://docs.poikcue.com/#/PaperMC/dev/getting-start/plugin-yml 这里]了解更多关于plugin.yml的信息。

=== 最后 ===

现在，你就有一个将 Paper 作为依赖的插件项目啦！ 
接下来，编译你的插件，然后在 Paper 服务器上运行插件，就大功告成了。

<div class="tip">

如果你想要精简测试插件的流程，你可以使用 [https://github.com/jpenilla/run-paper Run-Paper] Gradle task。 
它将帮你自动下载一个 Paper 服务端并运行，以便测试你的插件。

</div>
<blockquote>提示 
如果你正在使用 IntelliJ，你可以使用 Gradle 图形界面中的 <code>Build</code> 菜单来编译你的插件 - 它应该位于你的 IDE 的右上角。 
编译成功后输出的 jar 文件应该存放在 <code>build/libs</code> 文件夹中。 
</blockquote>