RemoteToolkit

RemoteToolkit
Plugin
Catégorie	Administration [edit]
Développeur(s)	drdanick
Nefald
Status	installé [edit]
Grade requis	Intendant
Article
Dernière révision	16/02/2016

RemoteToolkit n'est pas un plugin bukkit, il fonctionne en effet avec n'importe quel serveur minecraft.
Il s'agit d'un wrapper permettant le contrôle du serveur, en telnet notamment.

Topic originel sur forums.bukkit.org

Installation

Installation du Wrapper

1. Téléchargez le .zip contenant RemoteToolkit sur le topic originel.
2. Créez un nouveau dossier sur votre ordinateur et extrayez-y le .zip
3. Ouvrez le dossier serverdir Et copiez Minecraft_RKit.jar, les fichiers .sh / .bat et le dossier de Toolkit à la racine de votre répertoire serveur.
4. Si votre craftbukkit.jar ne porte pas ce nom, ouvrez wrapper.properties avec votre éditeur texte préféré, et renseignez minecraft-server-jar= avec le nom de votre .jar.
5. Facultatif : Si vous avez besoin de plus de 1024M (1 Go) de mémoire vive allouée à votre serveur, il suffit d'éditer initial-heap-size et maximum-heap-size en fonction de vos besoins.

Installation du plugin

1. Copiez MinecraftRKitPlugin.jar se trouvant dans serverdir/plugins dans le dossier des plugins bukkit/spigot. Celui-ci permet à RTK de contrôler le serveur en jeu.

Lancer le wrapper

1. En fonction de votre système d'exploitation, ouvrez le fichier .bat (windows) ou le .sh (unix) dans votre éditeur de texte favori.
2. Si vous modifiez le fichier .bat, remplacez les arguments user et pass dans user: pass avec un nom d'utilisateur et mot de passe de votre choix. Si vous modifiez le fichier .sh, changez USER et PASS.
3. Double-cliquez sur le script, ou exécutez-le à partir du terminal / invite de commande!

Information: Si vous utilisez le .sh, n'oubliez pas d'attribuer les permissions d'exécution du script en exécutant la commande suivante : chmod +x rtoolkit.sh

Si vous rencontrez des problèmes avec cette méthode, essayez d'ouvrir une fenêtre de terminal / cmd, naviguez vers le répertoire qui contient Minecraft_RKit.jar, et exécutez la commande suivante :

java -Xmx30M -Xms30M -XX:MaxPermSize=40M -jar Minecraft_RKit.jar USER:PASS

Information: Veillez à remplacer USER et PASS.

Commandes

Console (telnet)

Note: ATTENTION - Il s'agit de telnet, alors on oublie pas le . devant chaque commande.

commande	description
.help	Afficher la liste des commandes utilisables sur le wrapper.
.hold	Arrêter le serveur jusqu'à ce que .unhold soit utilisé. Utile si vous souhaitez effectuer une mise à jour de bukkit sans arrêter le wrapper.
.unhold	Relancer le serveur après avoir utilisé .hold.
.modules	Afficher la liste des modules Toolkit actuellement chargés.
.shutdowntime	Afficher le temps restant avant le prochain arrêt de Toolkit.
.restarttime	Affiche le temps restant avant le prochain redémarrage du serveur.
.restart	Redémarrer correctement le serveur Minecraft.
.reschedulerestart <temps>	Reporte au prochain redémarrage. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM.
.rescheduleshutdown <temps>	Reporte le prochain arrêt de Toolkit. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM.
.cancelshutdown <temps>	Annule l'arrêt programmé de Toolkit.
.stopwrapper	Arrête le wrapper.
.users	Afficher la liste des utilisateurs actuellement enregistrés sur Toolkit.
.useradd <utilisateur> <mot de passe>	Ajouter un utilisateur à Toolkit.
.userremove <utilisateur>	Retirer un utilisateur de Toolkit.
.set <option> <valeur>	Définit une valeur pour une option donnée. (REMARQUE: Entrer .set help pour la liste des options et valeurs valides.')
.version	Afficher la version du wrapper.

Commandes en jeu

Il est aussi possible d'utiliser certaines commandes directement en jeu pour les opérateurs.

commande	description
/restartsrv <[utilisateur:]mot de passe>	Redémarrer le serveur à partir du jeu. Si aucun nom d'utilisateur n'est fourni, alors le nom d'utilisateur sera substitué par celui du joueur.
/reschedulerestart <[utilisateur:]mot de passe> <temps>	Reporte au prochain redémarrage. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM. Si aucun nom d'utilisateur n'est fourni, alors le nom d'utilisateur sera substitué par celui du joueur.
/stopwrapper <[utilisateur:]mot de passe>	Arrête le serveur et le wrapper (remotetoolkit). Il vous faudra relancer le toolkit.

Configuration

wrapper.properties

minecraft-server-jar=craftbukkit.jar
extra-runtime-arguments=-Djline.terminal=jline.UnsupportedTerminal
server-arguments=--nojline,nogui
initial-heap-size=1024M
maximum-heap-size=1024M
overridden-process-arguments=
server-restart-alerts=10m,5m,1m
server-saveall-period=0
server-restart-delay=5h
forced-restart-delay=5m
toolkit-autoshutdown-delay=0
toolkit-autoshutdown-alerts=10m,5m,1m
force-save-on-restart=true
restart-on-severe-exception=false
severe-exception-detection-level=1
disable-heartbeats-on-missing-plugin=true
server-heartbeat-threshold=1m
failed-heartbeat-restart-count=5
filter-ansi-escape-codes=auto
enable-jline=true
import-properties=true

• minecraft-server-jar - Le nom du .jar utilisé pour lancer le serveur.
• extra-runtime-arguments - Une liste d'arguments (séparées par des virgules) devant être envoyées au java runtime.
• server-arguments - Une liste d'arguments (séparées par des virgules) devant être envoyées au processus serveur.
• initial-heap-size - Montant initial de mémoire à allouer au serveur. Ceci est équivalent à l'indicateur -Xms.
• maximum-heap-size - Montant maximal de mémoire à allouer au serveur. Ceci est équivalent à l'indicateur -Xmx.
• overridden-process-arguments - Définir une liste d'arguments (séparés par des virgules) qui l'emporteront sur les commandes du toolkit utilisées au lancement du serveur.
  Par exemple : paramétrer java -Xms1024M -Xmx1024M -Djline.terminal=jline.UnsupportedTerminal -jar craftbukkit.jar et vous obtenez la configuration par défaut.
  
• server-restart-alerts - Définir l'interval entre chaque alertes avertissant les joueurs d'un redémarrage.
  Par exemple : server-restart-alerts=1h 30m, 30m, 10m préviendra 1h30, puis 30 minutes, puis 10 minutes avant le redémarrage.
  
• server-restart-delay - Période de redémarrage du serveur. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM.
  Par exemple: 09:30,15:30,00:00 redémarrera à 9h30, 15h30 et 12h30. Définir sur 0 pour désactiver.
  
• server-saveall-period - Période entre chaque sauvegarde auto (save-all).
  Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM. Définir sur 0 pour désactiver.
  
• forced-restart-delay - Le temps d'attente après qu'un redémarrage planifié est été censé se produire, avant de forcer le redémarrage du serveur.
  Il s'agit d'une sécurité intégrée dans le cas où le ToolKit ne pourrez pas redémarrer le serveur normalement.
• toolkit-autoshutdown-delay - La quantité de temps à attendre avant de fermer Toolkit (et le serveur donc), au format HH:MM. Laissez vide pour désactiver.
• toolkit-autoshutdown-alerts - Intervals durant lesquels les joueurs seront avertis d'un arrêt du serveur, au format HH:MM.
• force-save-on-restart - définir sur True si une sauvegarde de l'ensemble du serveur doit être faite avant chaque redémarrage / hold / une fois arrêté, false pour désactiver.
• restart-on-severe-exception - définir sur True pour que le serveur redémarre en cas d'exceptions "SEVERE". False pour désactiver.
• severe-exception-detection-level - Définit l'agressivité de l'algorithme de détection d'exceptions sévères. L'agressivité est définie par un nombre entier compris entre 1 et 3, où 1 est la moins agressive et 3 est le plus.
• disable-heartbeats-on-missing-plugin - True si l'heartbeat restarts doit être désactivée lorsque le plugin bukkit n'est pas détecté, false pour désactiver.
• server-heartbeat-threshold - Définit la durée pendant laquelle le wrapper Toolkit attend avant d'envoyer une demande de heartbeat pour le plugin Toolkit.
• failed-heartbeat-restart-count - Définit le nombre de demandes de heartbeat sans réponses nécessaires avant qu'un redémarrage du serveur soit forcé.
• filter-ansi-escape-codes - Activer ou non le filtrage les codes d'échappement ANSI (comme les couleurs) à partir de la console. Ceci peut être défini sur True, False ou auto.
• enable-jline - True si le formatage de la console jline doit être activée, false pour désactiver.

remote.properties

remote-control-port=25561
remote-bind-address=
telnet-enabled=true
utf8-support-enabled=true
shell-password-mask=
shell-input-echo=true
message-playback-count=50

paramètres du telnet (et donc le controle à distance! )

• remote-control-port - Port d'écoute pour contrôler à distance le serveur.
• remote-bind-address - Adresse du serveur. NOTE: dans la plupart des cas il est préférable de laisser vide.
• auth-salt - La chaîne est concaténée à la fois avec le nom d'utilisateur et le mot de passe avant d'être haché. Si c'est la clé n'existe pas, le Toolkit va générer un salt aléatoire.
• telnet-enabled - True pour activer le telnet. False pour désactiver.
• shell-password-mask - Le(s) caractère(s) à utiliser pour masquer l'entrée mot de passe.
• shell-input-echo - True si le shell telnet doit echo chaque caractère tapé, false pour désactiver.
• message-playback-count - Le nombre de lignes que la console envoie aux utilisateurs se connectant à distante.

messages.txt

restart-kick-message:Server is restarting! Come back in 1 minute :)
toolkit-shutdown-kick-message:Server is shutting down! Come back later :)
hold-kick-message:Server is shutting down!
restart-time-warning:**SERVER RESTART IN %t**
restart-warning:**SERVER IS RESTARTING**
toolkit-shutdown-time-warning:**SERVER SHUTDOWN IN %t**
toolkit-shutdown-warning:**SERVER IS SHUTTING DOWN**
hold-warning:**SERVER IS SHUTTING DOWN**
auto-save-start:**SERVER IS SAVING THE MAP**
auto-save-complete:**MAP SAVE IS COMPLETE**
restart-time-left:Time until next restart: %t

définissez ici les messages qui seront envoyés par la console.

• restart-kick-message - Le message de kick utilisé pour alerter les joueurs que le serveur va être redémarré.
• toolkit-shutdown-kick-message - Le message de kick utilisé pour alerter les joueurs que le serveur s'arrête.
• hold-kick-message - Le message de kick utilisé pour alerter les joueurs que le serveur se relance.
• restart-time-warning - L'avertissement envoyé lorsqu'un redémarrage est programmé. % tindique la durée restant.
• restart-warning - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne redémarre.
• toolkit-shutdown-time-warning - L'avertissement envoyé lorsqu'un arrêt est programmé. % t est remplacé par la durée restante.
• toolkit-shutdown-warning - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne s'arrête.
• hold-warning - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne se relance.
• auto-save-start - Message envoyé à tous les joueurs quand une sauvegarde automatique se lance.
• auto-save-complete - Message envoyé à tous les joueurs quand une sauvergarde automatique est terminée.
• restart-time-left - Réponse automatique à donner aux joueurs demandant le temps avant le prochain redémarrage. NOTE: Ce n'est pas encore implémenté!