RemoteToolkit

Note: Rédaction en cours

RemoteToolkit
RemoteToolkit
Plugin
Catégorie	utilitaire [edit]
Développeur(s)	drdanick
Nefald
Status	installé [edit]
Grade requis	Intendant
Article
Dernière révision	13/04/2013

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

Topic originel sur forums.bukkit.org

Installation and startup

Wrapper installation

1. Download the .zip provided in the Remote Toolkit thread.
2. Create a new folder anywhere on your computer and extract the .zip there
3. Open the serverdir folder (which should be where you extracted the .zip) and copy Minecraft_RKit.jar, the .sh/.bat files and the toolkit folder to the root of your minecraft server directory. (That's the folder with craftbukkit.jar in it)
4. If your craftbukkit .jar is not named craftbukkit.jar, then you will need to open wrapper.properties (which is inside the toolkit folder) with your favorite text editor, and set minecraft-server-jar= to the name of your bukkit server jar file.
5. Optional: If you need more than 1024M (1GB) of RAM allocated to your server, just edit initial-heap-size and maximum-heap-size to suit your needs.

Installation du plugin

1. Copiez MinecraftRKitPlugin.jar se trouvant dans serverdir/plugins dans le dossier des plugins bukkit.

Lancer le wrapper

1. Depending on your operating system, open either the included.bat file or the included .sh file in your favorite text editor.
2. If you are editing the .bat file, change the user and pass arguments in user:pass to a username and password of your choosing (e.g. bobby:ilikepies123). Otherwise, if you are editing the .sh file, change the USER and PASS variables to anything of your choosing.
3. Double click the script, or run it from the terminal/cmd prompt!

Note: {{{text}}}

If you are experiencing problems with running it that way, try opening a terminal/cmd window, navigating to the directory that holds Minecraft_RKit.jar, and running the command:

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

Note: {{{text}}}

Commandes

Console (telnet)

ATTENTION

C'est du telnet, alors on oublie pas le . devant chaque commande. o/

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	Reporte au prochain redémarrage. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM.
.rescheduleshutdown	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	Annule l'arrêt programmé de Toolkit.
.stopwrapper	Arrête le wrapper.
.users	Afficher la liste des utilisateurs actuellement enregistrés sur Toolkit.
.useradd <name> <password>	Ajouter un utilisateur à Toolkit.
.userremove <name>	Retirer un utilisateur de Toolkit.
.set <option> <value>	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.

En jeu

commande	description
/restartsrv <[username:]password>	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 <[username:]password>	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 <[username:]password>	Arrête le serveur et le toolkit. CECI arrête le serveur et ne le RELANCE PAS.

Configuration

wrapper.properties

• 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

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

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