bukkit 튜토리얼
bukkit 시작하기

비고

버전

플러그인 만들기

선결 요건

• JDK 7 이상 (권장 : JDK 8 이상)

Bukkit을 의존성으로 추가하기

Bukkit API를 프로젝트에 추가하는 가장 간단한 방법은 Spigot Repository 에서 Bukkit.jar을 직접 다운로드하여 프로젝트의 클래스 경로에 추가하는 것입니다. Bukkit의 레거시 버전은 Bukkit 저장소 에서 찾을 수 있습니다.

다른 하나는 pom.xml 다음 행을 추가하여 Maven 종속성으로 추가하는 것입니다.

<repositories>
    <repository>
        <id>spigot-repo</id>
        <url>https://hub.spigotmc.org/nexus/content/repositories/snapshots/</url>
    </repository>
</repositories>
<dependencies>
    <!--Bukkit API-->
    <dependency>
        <groupId>org.bukkit</groupId>
        <artifactId>bukkit</artifactId>
        <version>{VERSION}</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

메인 클래스

플러그인의 기본 클래스는 Bukkit이 플러그인과의 상호 작용을로드하는 시작점입니다. JavaPlugin 을 확장 한 클래스이며 플러그인의 인스턴스는 하나만 만들어야합니다. 규칙에 따라이 클래스에 플러그인과 동일한 이름을 지정하는 것이 좋습니다.

다음은 플러그인 "MyPlugin"에 대한 기본 플러그인 클래스의 예제입니다.

package com.example.myplugin; //{$TopLevelDomain}.{$Domain}.{$PluginName};

import org.bukkit.plugin.java.JavaPlugin;

public final class MyPlugin extends JavaPlugin {

    @Override
    public void onEnable() {
        //Called when the plugin is enabled
        getLogger().info("onEnable has been invoked!");
    }

    @Override
    public void onDisable() {
        //Called when the plugin is disabled
        getLogger().info("onDisable has been invoked!");
    }

}

다른 클래스의 플러그인 인스턴스에 액세스하려면 클래스 외부에서 액세스 할 수 있도록 Bukkit에서 만든 MyPlugin 클래스의 인스턴스를 저장해야합니다.

public class MyPlugin extends JavaPlugin {

    private static MyPlugin instance; //Effectively final variable containing your plugin's instance

    public MyPlugin(){
        if(MyPlugin.instance != null) { //Unnecessary check but ensures your plugin is only initialized once.
            throw new Error("Plugin already initialized!");
        }

        MyPlugin.instance = this; //A plugin's constructor should only be called once
    }

    public static MyPlugin getInstance(){ //Get's your plugin's instance
        return instance;
    }

    //your other code...
}

그런 다음 다른 클래스에서 기본 클래스에 액세스하려면 MyPlugin.getInstance()

public class MyOtherClass {

    public void doSomethingWithMainClass(){
        MyPlugin.getInstance().getLogger().info("We just used MyPlugin");
    }

}

plugin.yml 만들기

plugin.yml 파일은 최종 jar 파일의 루트에 있으며 Bukkit에 플러그인을로드하는 데 필요한 필수 정보를 제공합니다. 가장 간단한 plugin.yml은 다음과 같이 보입니다.

name: {$PluginName}               //The name of the plugin
main: {$PackageName}.{$MainClass} //The fully qualified name of the main class.
version: {$Version}               //The plugin's version

예를 들어 위의 MyPlugin 클래스

name: MyPlugin
main: com.example.myplugin.MyPlugin
version: 1.0

Windows에서 테스트 서버 만들기

서버를 만들려면 spigot 또는 bukkit jar 파일이 있어야합니다. 항아리를 선택하려면 버전 항목 을 열어 둡니다.

1. 먼저 새 폴더를 만듭니다. 해당 폴더에 spigot / bukkit jar 파일을 넣으십시오.
2. 폴더를 마우스 오른쪽 단추로 클릭하고 새로 만들기> 텍스트 문서를 선택하십시오.
3. 새 문서의 이름을 start.bat로 지정하고 마우스 오른쪽 단추로 클릭 한 다음 편집을 클릭하십시오.
4. 다음 코드를 추가하십시오.

@echo off
java -Xms512M -Xmx1G -XX:+UseConcMarkSweepGC -jar {YOUR_JAR.jar}
pause

이 주제를 시작하기 전에 다운로드 한 jar에 대해 {YOUR_JAR.jar}을 (를) 변경하는 것을 잊지 마십시오.

5. -Xms 를 편집하여 허용되는 최소 RAM (예 : -Xms1024M = 1024MB, -Xms1G = 1GB)을 변경할 수 있습니다. -Xmx 를 편집하여 허용되는 최대 RAM을 변경할 수도 있습니다. 최대 값이 최소값보다 큰 지 확인하십시오.
6. 파일을 저장하고 창을 닫은 다음 start.bat 파일을 시작하십시오. 이제 서버가 열립니다. 서버를 실행하려면 EULA에 동의해야합니다.
7. EULA에 동의하면 eula.txt eula=false 로 eula=true 하십시오. "저장"을 클릭하면 이제 서버를 시작할 수 있습니다.
8. 서버에 연결하려면 start.bat 실행하고 Minecraft를 열고 서버를 추가 한 다음 localhost 를 IP로 지정하십시오.

BuildTools

이게 뭐야?

BuildTools.jar은 Bukkit, CraftBukkit, Spigot 및 Spigot-API를 빌드하는 솔루션입니다. 이 모든 작업은 컴퓨터에서 수행됩니다! 몇 가지 전제 조건 프로그램이 필요하지만 아래 지침에 따라 필요한 모든 사항을 안내합니다.

선결 요건

BuildTools를 사용하려면 Git과 Java의 두 가지 애플리케이션이 필요하다.

Windows

망할 놈

Windows에서 BuildTools를 실행하려면 Git을 설치해야합니다. Windows의 경우 git-scm을 통해 배포되며 여기에서 다운로드 할 수 있습니다. 원하는 위치에 설치하면 BuildTools jar를 실행하는 git bash가 제공됩니다. 설치 프로그램을 실행할 때 다음에 계속 누르십시오.

자바

여기 에서 JRE 8을 다운로드하여 설치하십시오. 설치 프로그램을 실행할 때 다음에 계속 누르십시오.

리눅스

유틸리티 명령뿐만 아니라 git 및 Java는 모두 패키지 관리자를 통해 단일 명령을 사용하여 설치할 수 있습니다.

데비안 / 우분투 : sudo apt-get install git openjdk-7-jre-headless tar

CentOS / RHEL : sudo dnf install git java-1.7.0-openjdk-devel tar

아치 : pacman -S jdk8-openjdk git

맥

힘내는 http://sourceforge.net/projects/git-osx-installer/files/ 에서 다운로드 할 수 있습니다 .

Java는 Apple 배포 버전에서 업데이트해야 할 수도 있습니다. 이전에 업데이트 한 경우에도 쉘 사용을 위해 링크해야 할 수 있습니다. 다음 단계를 따르십시오 : https://gist.github.com/johan/10590467

BuildTools 실행하기

1. https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar 에서 BuildTools.jar을 다운로드 하십시오 .

2. 리눅스를 사용하고 있다면 터미널을 열거 나 윈도우즈에서는 git bash를여십시오.

   1. Git bash는 바탕 화면이나 시작 메뉴에서 "git bash"라는 이름으로 찾을 수 있습니다. 컨텍스트 메뉴의 항목이므로 아무 것도 마우스 오른쪽 버튼으로 클릭하여 열 수도 있습니다.

3. BuildTools.jar을 다운로드 한 곳으로 이동하거나 커맨드 라인 방식으로 현재 디렉토리에 jar 파일을 다운로드하십시오.

   1. Windows에서 cd ​​명령을 사용하여 디렉토리를 변경하거나 BuildTools.jar이있는 폴더의 빈 공간을 마우스 오른쪽 버튼으로 클릭하고 (BuildTools.jar 자체를 클릭하지 마십시오) "git bash"를 클릭하여 열 수 있습니다 귀하의 현재 디렉토리에 있습니다.

4. 다음을 수행하여 터미널에서 BuildTools.jar을 실행하십시오 (BuildTools.jar을 두 번 누르지 마십시오).

   1. Linux에서 git config --global --unset core.autocrlf를 실행 한 다음 bash 또는 다른 적절한 쉘에서 java -jar BuildTools.jar을 실행하십시오.
   2. Windows에서 열리는 git bash 창에서 아래 명령을 실행하십시오. java -jar BuildTools.jar BuildTools # 35 이상이 필요하며 이전 버전이 작동하지 않아야합니다.
   3. Mac에서 아래 명령을 실행하면 MAVEN_OPTS = "- Xmx2G"java -Xmx2G -jar BuildTools.jar
   4. 이전 버전이 필요한 경우 1.8.8의 경우 BuildTools에 --rev 인수를 사용하여 버전을 지정할 수 있습니다. java -jar BuildTools.jar --rev 1.8.8

5. 항아리가 만들어지면 기다려주세요. 몇 분 안에 새로 컴파일 한 항아리가 있어야합니다!

6. CraftBukkit과 Spigot은 BuildTools.jar를 실행 한 것과 같은 디렉토리에 있습니다 (minecraft 버전 1.10에서는 craftbukkit-1.10.jar 및 spigot-1.10.jar). \ Spigot \ Spigot-API \ target \에서 Spigot-API를 찾을 수 있습니다 (minecraft 버전 1.10의 경우 spigot-api-1.10-R0.1-SNAPSHOT.jar).