前言 - 如何搭建环境

本小节目录：

一、环境搭建
二、调试插件
三、本地的导入和打包
零、IDEA的汉化

参与编写者：MagicLu550

后期修订：愉悦师柑也

本版本可能为非正式版本，但不影响阅读，请您悉知。

本小节建议学习时间：40 分钟；

学习要点: 学会使用IDEA搭建Maven环境和Nukkit开发环境，并学习调试Nukkit项目；

一、环境搭建

搭建环境是我们学习Nukkit的第一步。虽然安装IDE不是必要的一步，但这是我们能以便捷的方式进行开发的第一步。

首先上 IDEA官网下载我们所需要的版本，我们一般选择免费的Community版本，因为它已经符合我们的需求了。作者这里使用的是Ultimate版本。
打开IDEA后，我们这里使用 Maven 项目进行构建。这里使用 JDK1.8 ，只要是图中这样的就可以了。

3.输入 groupId 和 artifactId （这些是需要你来写的，支持自定义），并且创建项目后，我们会进入到下图的界面。图中的 artifactId 为 MyFirstPlugin.
1-03

关于groupId为何物，Snake1999做出了非常详细的解释(转)：
这里有必要做一些详细说明。
GroupId 经常也是Java项目的包名。Java项目的包命名规则有这样的约定：
“以网站倒着写.项目名字” 或者 “网站倒着写.项目名字.模块名字” 为结构。
必须以小写字母开头，
必须与别的Java包相区别。
Nukkit内核的所有包都是遵循这个规定的，
例如Nukkit的网站是nukkit.cn，所以里面包含所有方块（block）的包的包名应该是：
cn.nukkit.block

各位在编写Nukkit插件的时候，需要编写一个独特的、和他人的项目不一样的包名，以便与他人开发的插件相区别。
比如译者的网站是snake1999.com，如果译者编写了一个叫ExamplePlugin的Nukkit插件，就可以放在包名为com.snake1999.exampleplugin的包内。以下包名的结构都是可以使用的：
com.snake1999.exampleplugin
net.mcbbs.tutorialplugin
ru.nukkit.nkexample
me.fromgate.firstplugin
而以下的包名都是不被推荐使用的：
main.java.plugin
TestPlugin

另外，开发Nukkit插件，我们规定不能把插件的任何部分存放在cn.nukkit包下，否则后果自负。

关于主类的名称，只要能和别人的主类区分开就可以了，但是不推荐使用MainClass之类的名称。

在pom.xml中加入以下标签可以导入


<repositories>
   <repository>
            <id>opencollab-repo-release</id>
            <url>https://repo.opencollab.dev/maven-releases/</url>
            <releases>
                <enabled>true</enabled>
            </releases>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
        <repository>
            <id>opencollab-repo-snapshot</id>
            <url>https://repo.opencollab.dev/maven-snapshots/</url>
            <releases>
                <enabled>false</enabled>
            </releases>
            <snapshots>
                <enabled>true</enabled>
            </snapshots>
        </repository>
</repositories>
    
<dependencies>
    <dependency>
        <groupId>cn.nukkit</groupId>
        <artifactId>nukkit</artifactId>
        <version>1.0-SNAPSHOT</version>
    </dependency>
</dependencies>

如图所示
1-04

接下来在程序上可以进行开发了

二、调试插件

其实调试插件很简单，这里我们需要以下四个过程：

编译，打包 → 部署 → 运行加载 → 调试

编译打包很简单。我们使用IDE可以轻松实现Maven打包。

PS: 在打包之前，建议在pom.xml里加上以下代码，可以解决IDEA编译器版本无效等一系列问题。

<build>
    <plugins>
       
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.2</version>
            <configuration>
                <source>1.8</source>
                <target>1.8</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>

    </plugins>
</build>

本项目所采用的JDK版本为JDK8。如果您使用的不是JDK8，则需要修改一些地方。

JDK9

<build>
    <plugins>
       
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.2</version>
            <configuration>
                <source>1.9</source>
                <target>1.9</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>

    </plugins>
</build>

JDK10

<build>
    <plugins>
        
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>3.2</version>
            <configuration>
                <source>1.10</source>
                <target>1.10</target>
                <encoding>UTF-8</encoding>
            </configuration>
        </plugin>

    </plugins>
</build>