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

• remote-control-port - The port to bind the remote control servers to.
• remote-bind-address - The address to bind the remote control servers to. NOTE: In most cases this should be left blank
• auth-salt - The string that is concatenated with both the username and password before being hashed. If this is key does not exist, the toolkit will generate a random salt.
• telnet-enabled - True if the telnet server is enabled. False otherwise.
• shell-password-mask - The character(s) to use when masking password input.
• shell-input-echo - True if the telnet shell should echo each character typed, false otherwise.
• message-playback-count - The number of console lines to send to users connecting to the remote console.

messages.txt

• restart-kick-message - The kick message used to alert players that the server is being restarted.
• toolkit-shutdown-kick-message - The kick message used to alert players that the server is shutting down.
• hold-kick-message - he kick message used to alert players that the server is being held.
• restart-time-warning - The warning given when a restart alert is scheduled to occur. %t is substituted for the time remaining.
• restart-warning - Sent to all players approximately 3 seconds before the server is restarted.
• toolkit-shutdown-time-warning - The warning given when a shutdown alert is scheduled to occur. %t is substituted for the time remaining.
• toolkit-shutdown-warning - Sent to all players approximately 3 seconds before the server is shut down.
• hold-warning - Sent to all players approximately 3 seconds before the server is held.
• auto-save-start - Sent to all players when an auto-save event has started.
• auto-save-complete - Sent to all players when an auto-save is completed
• restart-time-left - Reply to players asking for the restart time. NOTE: This is not implemented yet!