Voir la source de RemoteToolkit

{{Infobox Plugin| image = remotetoolkit_logo.png| catégorie = utilitaire| dev = drdanick | grade = Intendant | status = installé|}}

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

;[http://forums.bukkit.org/threads/admn-remotetoolkit-r10-a14-restarts-crash-detection-auto-saves-remote-console-1-4-7.674/ Topic originel] sur forums.bukkit.org

== Installation ==
=== Installation du Wrapper ===
#Téléchargez le ''.zip'' contenant RemoteToolkit sur le [http://forums.bukkit.org/threads/674 topic originel].
#Créez un nouveau dossier sur votre ordinateur et extrayez-y le ''.zip''
#Ouvrez le dossier ''serverdir'' <ref>qui devrait être là où vous avez extrait le fichier ''.zip''</ref> Et copiez '''Minecraft_RKit.jar''', les fichiers .sh / .bat et le dossier de Toolkit à la racine de votre répertoire serveur.
#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''.
#'''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 ===
#Copiez '''MinecraftRKitPlugin.jar''' se trouvant dans ''serverdir/plugins'' dans le dossier des plugins bukkit.

=== Lancer le wrapper ===
#En fonction de votre système d'exploitation, ouvrez le fichier ''.bat'' <small>(windows)</small> ou le ''.sh'' <small>(unix)</small> dans votre éditeur de texte favori.
#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.
#Double-cliquez sur le script, ou exécutez-le à partir du terminal / invite de commande!

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


{{Info|N'oubliez pas de remplacer USER et PASS par ce qui convient !}}

== Commandes ==
=== Console (telnet) ===

;<font style="color:red;">ATTENTION</font> 
;C'est du telnet, alors on oublie pas le <font style="color:red;">.</font> devant chaque commande. o/



{| class="wikitable3"
!'''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é <code>.hold</code>.
|-
|.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 <time>
|Reporte au prochain redémarrage. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM.
|-
|.rescheduleshutdown <time>
|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 <time>
|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 <code>.set help</code> pour la liste des options et valeurs valides.')
|-
|.version
|Afficher la version du wrapper.
|}
=== En jeu ===

{| class="wikitable3"
!'''commande'''
!'''description'''
|-
|In-game commands|
|-
|/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> <time>
|Reporte au prochain redémarrage. Le paramètre de temps peut être soit au format #h #m #s , soit au format HH:MM. <br />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  ====

*<code><nowiki>minecraft-server-jar</nowiki></code> - Le nom du .jar utilisé pour lancer le serveur.
*<code><nowiki>extra-runtime-arguments</nowiki></code> - Une liste d'arguments (séparées par des virgules) devant être envoyées au java runtime.
*<code><nowiki>server-arguments</nowiki></code> - Une liste d'arguments (séparées par des virgules) devant être envoyées au processus serveur.
*<code><nowiki>initial-heap-size</nowiki></code> - Montant initial de mémoire à allouer au serveur. Ceci est équivalent à l'indicateur '''-Xms'''.
*<code><nowiki>maximum-heap-size</nowiki></code> -   Montant maximal de mémoire à allouer au serveur. Ceci est équivalent à l'indicateur '''-Xmx'''.
*<code><nowiki>overridden-process-arguments</nowiki></code> - 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. <br/ ><small>'''Par exemple''' : paramétrer  ''java -Xms1024M -Xmx1024M -Djline.terminal=jline.UnsupportedTerminal -jar craftbukkit.jar'' et vous obtenez la configuration par défaut.</small><br/>
*<code><nowiki>server-restart-alerts</nowiki></code> - Définir l'interval entre chaque alertes avertissant les joueurs d'un redémarrage. <br/><small>'''Par exemple''' : ''server-restart-alerts=1h 30m, 30m, 10m'' préviendra 1h30, puis 30 minutes, puis 10 minutes  avant le redémarrage.</small><br/>
*<code><nowiki>server-restart-delay</nowiki></code> - 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. <br/><small>'''Par exemple''': ''09:30,15:30,00:00'' redémarrera à 9h30, 15h30 et 12h30. Définir sur ''0'' pour désactiver.</small><br/>
*<code><nowiki>server-saveall-period</nowiki></code> - Période entre chaque sauvegarde auto (''save-all''). <br/>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.<br/>
*<code><nowiki>forced-restart-delay</nowiki></code> - Le temps d'attente après qu'un redémarrage planifié est été censé se produire, avant de forcer le redémarrage du serveur.<br/> Il s'agit d'une sécurité intégrée dans le cas où le ToolKit ne pourrez pas redémarrer le serveur normalement.
*<code><nowiki>toolkit-autoshutdown-delay</nowiki></code> - La quantité de temps à attendre avant de fermer Toolkit (et le serveur donc), au format HH:MM. Laissez vide pour désactiver.
*<code><nowiki>toolkit-autoshutdown-alerts</nowiki></code> - Intervals durant lesquels les joueurs seront avertis d'un arrêt du serveur, au format HH:MM.
*<code><nowiki>force-save-on-restart</nowiki></code> - 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.
*<code><nowiki>restart-on-severe-exception</nowiki></code> - définir sur True pour que le serveur redémarre en cas d'exceptions "SEVERE". False pour désactiver.
*<code><nowiki>severe-exception-detection-level</nowiki></code> - 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.
*<code><nowiki>disable-heartbeats-on-missing-plugin</nowiki></code> - True si l'heartbeat restarts doit être désactivée lorsque le plugin bukkit n'est pas détecté, false pour désactiver.
*<code><nowiki>server-heartbeat-threshold</nowiki></code> - Définit la durée pendant laquelle le wrapper Toolkit attend avant d'envoyer une demande de heartbeat pour le plugin Toolkit.
*<code><nowiki>failed-heartbeat-restart-count</nowiki></code> - Définit le nombre de demandes de heartbeat sans réponses nécessaires avant qu'un redémarrage du serveur soit forcé.
*<code><nowiki>filter-ansi-escape-codes</nowiki></code> - 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.
*<code><nowiki>enable-jline</nowiki></code> - 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! )
*<code><nowiki>remote-control-port</nowiki></code> - Port d'écoute pour contrôler à distance le serveur.
*<code><nowiki>remote-bind-address</nowiki></code> - Adresse du serveur. '''NOTE: dans la plupart des cas il est préférable de laisser vide'''.
*<code><nowiki>auth-salt</nowiki></code> - 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.
*<code><nowiki>telnet-enabled</nowiki></code> - True pour activer le telnet. False pour désactiver.
*<code><nowiki>shell-password-mask</nowiki></code> - Le(s) caractère(s) à utiliser pour masquer l'entrée mot de passe.
*<code><nowiki>shell-input-echo</nowiki></code> - True si le shell telnet doit '''echo''' chaque caractère tapé, false pour désactiver.
*<code><nowiki>message-playback-count</nowiki></code> - 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.
*<code><nowiki>restart-kick-message</nowiki></code> - Le message de kick utilisé pour alerter les joueurs que le serveur va être redémarré.
*<code><nowiki>toolkit-shutdown-kick-message</nowiki></code> - Le message de kick utilisé pour alerter les joueurs que le serveur s'arrête.
*<code><nowiki>hold-kick-message</nowiki></code> - Le message de kick utilisé pour alerter les joueurs que le serveur se relance.
*<code><nowiki>restart-time-warning</nowiki></code> - L'avertissement envoyé lorsqu'un redémarrage est programmé. <code>% t</code>indique la durée restant.
*<code><nowiki>restart-warning</nowiki></code> - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne redémarre.
*<code><nowiki>toolkit-shutdown-time-warning</nowiki></code> - L'avertissement envoyé lorsqu'un arrêt est programmé. <code>% t</code> est remplacé par la durée restante.
*<code><nowiki>toolkit-shutdown-warning</nowiki></code> - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne s'arrête.
*<code><nowiki>hold-warning</nowiki></code> - Message envoyé à tous les joueurs environ 3 secondes avant que le serveur ne se relance.
*<code><nowiki>auto-save-start</nowiki></code> - Message envoyé à tous les joueurs quand une sauvegarde automatique se lance.
*<code><nowiki>auto-save-complete</nowiki></code> - Message envoyé à tous les joueurs quand une sauvergarde automatique est terminée.
*<code><nowiki>restart-time-left</nowiki></code> - Réponse automatique à donner aux joueurs demandant le temps avant le prochain redémarrage. '''NOTE: Ce n'est pas encore implémenté!'''



== Références ==
<references/>