bukkit ट्यूटोरियल
शुरू हो रही है बुक्किट से

टिप्पणियों

संस्करण

एक प्लगइन बनाना

आवश्यक शर्तें

• JDK 7 या उच्चतर (अनुशंसित: JDK 8+)

बुककिट को एक निर्भरता के रूप में जोड़ना

बुककैट एपीआई को अपनी परियोजना में जोड़ने का सबसे सरल तरीका है, बुककैट.जर को स्पिगोट रिपॉजिटरी से सीधे डाउनलोड करना और इसे अपनी परियोजना के क्लासपाथ में जोड़ना। बुककिट के विरासत संस्करण बुककिट रिपॉजिटरी में पाए जा सकते हैं।

अन्य इसे मावेन निर्भरता के रूप में जोड़ना है, अपने pom.xml में निम्नलिखित पंक्तियों को जोड़कर:

<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>

मुख्य वर्ग

प्लगइन का मुख्य वर्ग अपने प्लगइन के साथ एक बातचीत को लोड करने के लिए बुक्किट के लिए प्रवेश बिंदु है। यह एक वर्ग है जो JavaPlugin विस्तार 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!");
    }

}

अपने प्लगइन उदाहरण को किसी अन्य वर्ग से एक्सेस करने के लिए, आपको अपने 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 फ़ाइल आपकी अंतिम जार फ़ाइल की जड़ में जाती है और अपने प्लगइन को लोड करने के लिए बुक्किट को आवश्यक जानकारी प्रदान करती है। सबसे सरल 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

विंडोज पर एक टेस्ट सर्वर बनाएं

सर्वर बनाने में सक्षम होने के लिए, आपके पास स्पिगॉट या bukkit जार फ़ाइल होना चाहिए। अपने जार का चयन करने के लिए संस्करण विषय का संदर्भ लें

1. सबसे पहले, एक नया फ़ोल्डर बनाएं। उस फ़ोल्डर में, स्पिगोट / bukkit जार फ़ाइल डालें।
2. फ़ोल्डर में राइट क्लिक करें, और नया> टेक्स्ट डॉक्यूमेंट चुनें।
3. नए दस्तावेज़ start.bat को नाम दें, उस पर राइट क्लिक करें और संपादित करें पर क्लिक करें।
4. निम्नलिखित कोड जोड़ें:

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

इन विषयों को शुरू करने से पहले आपके द्वारा डाउनलोड किए गए जार के लिए {your_JAR.jar} को बदलना न भूलें।

5. आप न्यूनतम अनुमत रैम (उदा: -Xms1024M = 1024MB, -Xms1G = 1GB) को बदलने के लिए -Xms को संपादित कर सकते हैं। अधिकतम अनुमत रैम को बदलने के लिए आप -Xmx को भी संपादित कर सकते हैं। सुनिश्चित करें कि अधिकतम न्यूनतम से बड़ा है।
6. फ़ाइल सहेजें, विंडो बंद करें और अपनी start.bat फ़ाइल प्रारंभ करें। अब आपका सर्वर खुल जाना चाहिए। सर्वर को चलाने के लिए, आपको EULA को स्वीकार करना होगा।
7. यदि आप EULA से सहमत हैं, तो eula.txt खोलें eula eula=false से eula eula=true क्लिक करें "सहेजें" पर क्लिक करें और फिर अब आपको अपना सर्वर शुरू करने में सक्षम होना चाहिए।
8. अपने सर्वर से कनेक्ट करने के लिए, start.bat , Minecraft खोलें, एक सर्वर जोड़ें और IP के रूप में localhost ।

BuildTools

यह क्या है?

BuildTools.jar बुककिट, क्राफ्टबुकिट, स्पिगोट और स्पिगोट-एपीआई के निर्माण का एक समाधान है। जो सभी आपके कंप्यूटर पर किया जाता है! कुछ आवश्यक कार्यक्रम आवश्यक हैं, लेकिन नीचे दिए गए निर्देश आपको वह सब कुछ बताएंगे जो आपको करने की आवश्यकता है।

आवश्यक शर्तें

BuildTools: Git और Java का उपयोग करने के लिए दो एप्लिकेशन आवश्यक हैं।

खिड़कियाँ

Git

Windows पर चलने के लिए BuildTools के लिए, आपको Git को स्थापित करना होगा। विंडोज के लिए इसे git-scm के माध्यम से वितरित किया जाता है, जिसे यहां डाउनलोड किया जा सकता है । इसे स्थापित करें जहां आप चाहें, यह गिट बैश प्रदान करेगा, जिसका उपयोग बिल्डटूल जार को चलाने के लिए किया जाएगा। इंस्टॉलर को चलाते समय बस आगे की ओर रखें।

जावा

यहां से JRE 8 डाउनलोड करें और इंस्टॉल करें। इंस्टॉलर को चलाते समय बस आगे की ओर रखें।

लिनक्स

दोनों git और Java, साथ ही उपयोग कमांड, को आपके पैकेज मैनेजर के माध्यम से सिंगल कमांड का उपयोग करके इंस्टॉल किया जा सकता है।

डेबियन / Ubuntu: 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

मैक

Git से डाउनलोड किया जा सकता है: http://sourceforge.net/projects/git-osx-installer/files/

जावा को Apple वितरित संस्करण से अद्यतन करने की आवश्यकता हो सकती है, और यहां तक कि यदि पहले अद्यतन किया गया है, तो शेल उपयोग के लिए लिंक करने की आवश्यकता हो सकती है। कृपया यहाँ पाए गए चरणों का पालन करें: https://gist.github.com/johan/10590467

बिल्डटूल चल रहे हैं

1. BuildTools.jar को https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar से डाउनलोड करें ।

2. अपने टर्मिनल को खोलें यदि आप लिनक्स पर हैं, या विंडोज पर गेट बैश करें।

   1. Git bash डेस्कटॉप पर या स्टार्ट मेनू में "git bash" नाम से मिल सकता है। किसी भी चीज़ पर राइट-क्लिक करके इसे खोलना भी संभव है, क्योंकि यह अब आपके संदर्भ मेनू में एक आइटम है।

3. जहां आपने BuildTools.jar डाउनलोड किया है, वहां नेविगेट करें, या अपने वर्तमान निर्देशिका में जार डाउनलोड करने के लिए कमांड लाइन तरीके का उपयोग करें।

   1. विंडोज पर, आप या तो निर्देशिकाओं को बदलने के लिए cd कमांड का उपयोग कर सकते हैं, या आप फ़ोल्डर के रिक्त स्थान पर राइट क्लिक कर सकते हैं जहां BuildTools.jar है (BuildTools.jar पर क्लिक न करें) और "गिट बैश" पर क्लिक करें, जो इसे खोल देगा। अपनी वर्तमान निर्देशिका में।

4. टर्मिनल से BuildTools.jar को चलाएं (निम्न पर BuildTools.jar को डबल क्लिक न करें):

   1. लिनक्स चलाने पर git config --global --unset core.autocrlf, फिर java -jar BuildTools.jar को बैश या किसी अन्य उपयुक्त शेल में चलाएं।
   2. विंडोज़ पर गिट बश विंडो के अंदर नीचे कमांड को चलाएं जो खोला: java -jar BuildTools.jar कृपया ध्यान रखें कि यह आवश्यक है कि आपके पास BuildTools # 35 या बाद के संस्करण हैं, पुराने संस्करण काम नहीं करेंगे।
   3. Mac पर नीचे दिए गए आदेश चलाएँ, MAVEN_OPTS = "- Xmx2G" java -Xmx2G -jar BuildTools.jar निर्यात करें
   4. यदि आपको पुराने संस्करण की आवश्यकता है, तो आप संस्करण का उपयोग कर सकते हैं - Buildvools पर तर्क। 1.8.8 के लिए उदाहरण के लिए: java -jar BuildTools.jar --rev 1.8.8

5. प्रतीक्षा करें क्योंकि यह आपके जार बनाता है। कुछ ही मिनटों में आपको ताजा संकलित जार होना चाहिए!

6. आप क्राफ्टबुकिट और स्पिगोट को उसी निर्देशिका में पा सकते हैं, जिसमें आपने BuildTools.jar (Minecraft संस्करण 1.10 के लिए) चलाया था, वे क्राफ्टबुकिट-1.10.jar और स्पिगोट-1.10.jar) होंगे। आप Spigot-API को \ Spigot \ Spigot-API \ target \ (minecraft संस्करण 1.10 के लिए) में पा सकते हैं, यह spigot-api-1.10-R0.1-SNAPSHOT.jar) होगा।