bukkit – Commencez avec bukkit – Resoudre les problemes d’un serveur MineCraft

Remarques

versions

Créer un plugin

• JDK 7 ou supérieur (recommandé: JDK 8+)

La façon la plus simple d'ajouter l'API Bukkit à votre projet consiste à télécharger Bukkit.jar directement à partir du référentiel Spigot et à l'ajouter au chemin de classe de votre projet. Les versions héritées de Bukkit sont disponibles dans le référentiel Bukkit.

L'autre consiste à l'ajouter en tant que dépendance Maven, en ajoutant les lignes suivantes à votre pom.xml :

    
        spigot-repo
        https://hub.spigotmc.org/nexus/content/repositories/snapshots/
    


    
    
        org.bukkit
        bukkit
        VERSION
        À condition de
    

La classe principale du plugin est le point d'entrée pour Bukkit pour charger une interaction avec votre plugin. C’est une classe qui s’étend JavaPlugin et une seule instance doit être créée par votre plugin. Par convention, il est bon de donner à cette classe le même nom que votre plugin.

Voici un exemple de la classe de plugin principale pour le plugin "MyPlugin":

package com.example.myplugin;  // $ TopLevelDomain. $ Domaine.  $ PluginName;

import org.bukkit.plugin.java.JavaPlugin;

classe finale publique MyPlugin étend JavaPlugin 

@Passer outre
public void onEnable () 
// Appelé lorsque le plugin est activé
getLogger (). info ("onEnable a été invoqué!");


@Passer outre
public void onDisable () 
// Appelé lorsque le plugin est désactivé
getLogger (). info ("onDisable a été invoqué!");

Pour accéder à votre instance de plug-in à partir d'une autre classe, vous devez stocker l'instance de votre classe MyPlugin créée par Bukkit afin qu'elle soit accessible de l'extérieur de la classe.

public class MyPlugin étend JavaPlugin 

instance MyPlugin statique privée; // Variable effectivement finale contenant l'instance de votre plugin

public MyPlugin () 
if (MyPlugin.instance! = null) // Vérification inutile mais garantit que votre plugin n'est initialisé qu'une seule fois.
throw new Error ("Plugin déjà initialisé!");


MyPlugin.instance = this; // Le constructeur d'un plugin ne doit être appelé qu'une seule fois


public statique MyPlugin getInstance () // Récupère l'instance de votre plugin
instance de retour;


// votre autre code ...

Ensuite, pour accéder à votre classe principale à partir d'une autre classe, utilisez simplement MyPlugin.getInstance ()

public class MyOtherClass 

public void doSomethingWithMainClass () 
MyPlugin.getInstance (). GetLogger (). Info ("Nous venons d'utiliser MyPlugin");

Le fichier plugin.yml va à la racine de votre fichier jar final et fournit des informations essentielles pour que Bukkit charge votre plugin. Le plugin.yml le plus simple ressemble à ceci

name: $ PluginName // Le nom du plugin
main: $ PackageName. $ MainClass // Le nom complet de la classe principale.
version: $ Version // La version du plugin

Par exemple avec la classe MyPlugin ci-dessus

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

Créer un serveur de test sous Windows

Pour pouvoir créer un serveur, vous devez avoir le fichier spigot ou le fichier jar bukkit. Reportez-vous à la section des versions pour sélectionner votre fichier.

1. Créez d'abord un nouveau dossier. Dans ce dossier, placez le fichier jar spigot / bukkit.
2. Cliquez avec le bouton droit dans le dossier et choisissez Nouveau> Document texte.
3. Nommez le nouveau document start.bat, faites un clic droit dessus et cliquez sur Modifier.
4. Ajoutez le code suivant:

@Écho off
java -Xms512M -Xmx1G -XX: + UseConcMarkSweepGC -jar YOUR_JAR.jar
pause

N'oubliez pas de modifier YOUR_JAR.jar pour le fichier jar que vous avez téléchargé avant de commencer ces sections.

5. Vous pouvez éditer -Xms pour changer la RAM minimum autorisée (Ex: -Xms1024M = 1024MB, -Xms1G = 1GB). Vous pouvez également modifier -Xmx pour modifier la RAM maximale autorisée. Assurez-vous que le maximum est supérieur au minimum.
6. Enregistrez le fichier, fermez la fenêtre et démarrez votre fichier start.bat . Votre serveur devrait maintenant s'ouvrir. Pour exécuter le serveur, vous devez accepter le CLUF.
7. Si vous acceptez le CLUF, ouvrez eula.txt échange eula = false dans eula = true Cliquez sur "Enregistrer" et vous devriez maintenant pouvoir démarrer votre serveur.
8. Pour vous connecter à votre serveur, lancez start.bat , ouvrez Minecraft, ajoutez un serveur et placez localhost comme adresse IP.

BuildTools.jar est une solution pour construire Bukkit, CraftBukkit, Spigot et l'API Spigot. Tout cela se fait sur votre ordinateur! Certains programmes préalables sont nécessaires, mais les instructions ci-dessous vous guideront à travers tout ce que vous devez faire.

Il faut deux applications pour utiliser BuildTools: Git et Java.

Git

Pour que BuildTools fonctionne sous Windows, vous devez installer Git. Pour Windows, il est distribué via git-scm, qui peut être téléchargé ici. Installez-le où vous voulez, il fournira git bash, qui sera utilisé pour exécuter le pot BuildTools. Continuez à taper tout en exécutant le programme d'installation.

Java

Téléchargez JRE 8 à partir d'ici et installez-le. Continuez à taper tout en exécutant le programme d'installation.

Les commandes git et Java, ainsi que les commandes util, peuvent être installées à l'aide d'une seule commande via votre gestionnaire de paquets.

Debian / Ubuntu: sudo apt-get install git openjdk-7-jre-headless tar

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

Cambre: pacman -S jdk8-openjdk git

Git peut être téléchargé à partir de: http://sourceforge.net/projects/git-osx-installer/files/

Java peut devoir être mis à jour à partir de la version distribuée d'Apple, et même s'il a déjà été mis à jour, il peut être nécessaire de le lier pour l'utiliser dans le shell. Veuillez suivre les étapes trouvées ici: https://gist.github.com/johan/10590467

1. Téléchargez BuildTools.jar à partir de https://hub.spigotmc.org/jenkins/job/BuildTools/lastSuccessfulBuild/artifact/target/BuildTools.jar.

2. Ouvrez votre terminal si vous êtes sous Linux ou git bash sous Windows.

   1. Git bash se trouve sur le bureau ou dans le menu Démarrer sous le nom "git bash". Il est également possible de l'ouvrir en cliquant avec le bouton droit sur n'importe quoi, car il s'agit désormais d'un élément de votre menu contextuel.

3. Accédez à l'emplacement où vous avez téléchargé BuildTools.jar ou utilisez la ligne de commande pour télécharger le fichier jar dans votre répertoire actuel.

   1. Sous Windows, vous pouvez soit utiliser la commande cd pour modifier les répertoires, soit cliquer avec le bouton droit sur l'espace vide du dossier où se trouve BuildTools.jar (NE PAS cliquer sur BuildTools.jar lui-même) et cliquer sur "git bash" pour ouvrir il. dans votre répertoire actuel.

4. Exécutez BuildTools.jar à partir du terminal (ne double-cliquez pas sur BuildTools.jar) en procédant comme suit:

   1. Sous Linux, exécutez git config –global –unset core.autocrlf, puis exécutez java -jar BuildTools.jar dans bash ou un autre shell approprié.
   2. Sous Windows, exécutez la commande ci-dessous dans la fenêtre git bash qui s'ouvre: java -jar BuildTools.jar Veuillez noter que vous devez disposer de BuildTools # 35 ou version ultérieure, les anciennes versions ne fonctionneront pas.
   3. Sur Mac, exécutez les commandes ci-dessous, exportez MAVEN_OPTS = "- Xmx2G" java -Xmx2G -jar BuildTools.jar
   4. Si vous avez besoin d'une version antérieure, vous pouvez spécifier la version en utilisant l'argument –rev dans BuildTools, par exemple pour 1.8.8: java -jar BuildTools.jar –rev 1.8.8

5. Attendez pendant qu'il construit vos pots. En quelques minutes, vous devriez avoir des pots fraîchement compilés!

6. Vous pouvez trouver CraftBukkit et Spigot dans le même répertoire que celui où vous avez exécuté BuildTools.jar (pour minecraft version 1.10, ce serait craftbukkit-1.10.jar et spigot-1.10.jar). Vous pouvez trouver Spigot-API dans Spigot Spigot-API target (pour minecraft version 1.10, ce serait spigot-api-1.10-R0.1-SNAPSHOT.jar).