« RemoteToolkit » : différence entre les versions

De Nefald Wiki
Aller à la navigation Aller à la recherche
Hiob (discussion | contributions)
mAucun résumé des modifications
Hiob (discussion | contributions)
mAucun résumé des modifications
 
(15 versions intermédiaires par le même utilisateur non affichées)
Ligne 1 : Ligne 1 :
{{Note|text=Rédaction en cours}}
{{Infobox Plugin
{{Infobox Plugin| image = drdanick_avatar.jpg| catégorie = utilitaire| dev = drdanick | grade = Intendant | status = installé|}}
| image = No_Logo.png
| catégorie = Administration
| dev = drdanick  
| grade = Intendant
| status = installé
|}}


'''RemoteToolkit''' n'est pas un plugin bukkit, il fonctionne en effet avec n'importe quel serveur minecraft.
'''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.
<br/>Il s'agit d'un [[wikipedia:wrapper|wrapper]] permettant le contrôle du serveur, en [[wikipedia:telnet|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
;[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 ==
== Spécificités ==
=== 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/spigot. Celui-ci permet à RTK de contrôler le serveur en jeu.
 
=== 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 :
<syntaxhighlight lang="Bash">
java -Xmx30M -Xms30M -XX:MaxPermSize=40M -jar Minecraft_RKit.jar USER:PASS
</syntaxhighlight>
 
{{Info|Veillez à remplacer USER et PASS.}}
 
== Commandes ==
== Commandes ==
=== Console telnet ===
=== Console (telnet) ===


{| class="wikitable3"
{{Note|text='''ATTENTION''' - Il s'agit de telnet, alors on oublie pas le <font style="color:red;">.</font> devant chaque commande.}}
 
 
 
{| class="wikitable2"
!'''commande'''
!'''commande'''
!'''description'''
!'''description'''
|-
|-
|.help
|<code>{{Rouge|.}}help</code>
|Displays the list of console commands recognized by the wrapper.
|Afficher la liste des commandes utilisables sur le wrapper.
|-
|-
|.hold
|<code>{{Rouge|.}}hold</code>
|Stops the server until .unhold is used. This is useful if you want to perform an update to Bukkit without stopping the wrapper.
|Arrêter le serveur jusqu'à ce que <code>{{Rouge|.}}unhold</code> soit utilisé. Utile si vous souhaitez effectuer une mise à jour de bukkit sans arrêter le wrapper.
|-
|-
|.unhold
|<code>{{Rouge|.}}unhold</code>
|Unholds a held server.
|Relancer le serveur après avoir utilisé <code>{{Rouge|.}}hold</code>.
|-
|-
|.modules
|<code>{{Rouge|.}}modules</code>
|Displays the list of currently loaded Toolkit Modules.
|Afficher la liste des modules Toolkit actuellement chargés.
|-
|-
|.shutdowntime
|<code>{{Rouge|.}}shutdowntime</code>
|Displays the time left until the next Toolkit shutdown.
|Afficher le temps restant avant le prochain arrêt de Toolkit.
|-
|-
|.restarttime
|<code>{{Rouge|.}}restarttime</code>
|Displays the time left until the next server restart.
|Affiche le temps restant avant le prochain redémarrage du serveur.
|-
|-
|.restart
|<code>{{Rouge|.}}restart</code>
|Gracefully restarts the Minecraft server.
|Redémarrer '''correctement''' le serveur Minecraft.
|-
|-
|.reschedulerestart <time>
|<code>{{Rouge|.}}reschedulerestart <temps></code>
|Reschedules the next restart. The time parameter can either be in either the #h #m #s format, or the HH:MM format.
|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>
|<code>{{Rouge|.}}rescheduleshutdown <temps></code>
|(Re)schedules a Toolkit shutdown. The time parameter can either be in either the #h #m #s format, or the HH:MM format.
|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>
|<code>{{Rouge|.}}cancelshutdown <temps></code>
|Cancels a scheduled Toolkit shutdown.
|Annule l'arrêt programmé de Toolkit.
|-
|-
|.stopwrapper
|<code>{{Rouge|.}}stopwrapper</code>
|Stops the wrapper along with the server.
|Arrête le wrapper.
|-
|-
|.users
|<code>{{Rouge|.}}users</code>
|Displays the list of users currently registered with the Toolkit.
|Afficher la liste des utilisateurs actuellement enregistrés sur Toolkit.
|-
|-
|.useradd <name> <password>
|<code>{{Rouge|.}}useradd <utilisateur> <mot de passe></code>
|Adds a user to the Toolkit.
|Ajouter un utilisateur à Toolkit.
|-
|-
|.userremove <name>
|<code>{{Rouge|.}}userremove <utilisateur></code>
|Removes a user from the Toolkit.
|Retirer un utilisateur de Toolkit.
|-
|-
|.set <option> <value>
|<code>{{Rouge|.}}set <option> <valeur></code>
|Sets a value to an option. (NOTE: Enter '.set help' for a list of valid options and values)
|Définit une valeur pour une option donnée. (REMARQUE: Entrer <code>{{Rouge|.}}set help</code> pour la liste des options et valeurs valides.')
|-
|-
|.version
|<code>{{Rouge|.}}version</code>
|Displays the version of the wrapper.
|Afficher la version du wrapper.
|}
|}
=== En jeu ===
=== Commandes en jeu ===
Il est aussi possible d'utiliser certaines commandes directement en jeu pour les opérateurs.


{| class="wikitable3"
{| class="wikitable2"
!'''commande'''
!'''commande'''
!'''description'''
!'''description'''
|-
|-
|In-game commands|
|<code>/restartsrv <[utilisateur:]mot de passe></code>
|-
|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.
|/restartsrv <[username:]password>
|Restart the server from in-game. If no username is provided, then the player's username will be substituted.
|-
|-
|/reschedulerestart <[username:]password> <time>
|<code>/reschedulerestart <[utilisateur:]mot de passe> <temps></code>
|Reschedules the next server restart. The time parameter can either be in either the #h #m #s format, or the HH:MM format. If no username is provided, then the player's name will be substituted.
|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>
|<code>/stopwrapper <[utilisateur:]mot de passe></code>
|Stops both the server and the Toolkit. THIS WILL SHUT THE SERVER DOWN AND WILL NOT RESTART IT
|Arrête le serveur et le wrapper (remotetoolkit). Il vous faudra relancer le toolkit.
|}
|}


Ligne 85 : Ligne 117 :


==== wrapper.properties  ====
==== wrapper.properties  ====
<syntaxhighlight lang="Bash">
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
</syntaxhighlight>


*<code><nowiki>minecraft-server-jar</nowiki></code> - The name of the Minecraft server jar to launch.
*<code><nowiki>minecraft-server-jar</nowiki></code> - Le nom du .jar utilisé pour lancer le serveur.
*<code><nowiki>extra-runtime-arguments</nowiki></code> - A '''comma separated''' list of arguments to be sent to the java runtime environment.
*<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> - A '''comma separated''' list of arguments to be sent to the server process.
*<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> - Initial amount of memory to allocate to the server. This is equivalent to the -Xms flag.
*<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> - Maximum amount of memory to allocate to the server. This is equivalent to the -Xmx flag.
*<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> - Takes a '''space separated''' list of arguments and overrides the entire command the Toolkit uses to start the Minecraft server. For example setting this to ''java -Xms1024M -Xmx1024M -Djline.terminal=jline.UnsupportedTerminal -jar craftbukkit.jar'' is the same as running the wrapper with the default settings. '''Remember to include -Djline.terminal=jline.UnsupportedTerminal or the console will not work correctly!'''
*<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> - A list of times before a restart at which to warn players of a restart. It is in the same format as server-restart-delay, but it can take multiple values. For example, server-restart-alerts=1h 30m, 30m, 10m would warn the players at 1 hour 30 minutes before a restart, 30 minutes before a restart and 10 minutes before a restart.
*<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> - The period at which to restart the server. It is in the format '''#h #m #s''', where h = hours, m = minutes and s = seconds. For example, if you would want it to restart ever 3 hours and 30 minutes, you would set it as server-restart-delay=3h 30m (notice that #s has been omitted. You can omit segments that are not needed). Alternatively, a sequence of explicit times for restarts can be set. This is done by setting the property to a comma separated list of 24hr times in the format '''HH:MM'''. For example, setting it to 09:30,15:30,00:00 would have it restart at 9:30am, 3:30pm and 12:30am. Setting this option to 0 will disable restarts.
*<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> - The period at which to perform a save-all. Values should be in the '''#h #m #s''' format as specified above. Setting it to 0 will disable automated saves.
*<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> - The amount of time to wait after a scheduled restart is meant to occur before forcing the server to restart. This acts as a failsafe in the event that the toolkit cannot restart the server normally.
*<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> - The amount of time to wait before shutting the toolkit (and server) down. Time is specified in the '''#h #m #s''' or '''HH:MM''' format. Leave blank to disable.
*<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> - A list of times before a shutdown at which to warn players of a shutdown. It is in the same format as server-restart-alerts.
*<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> - True if a save-all should be forced on a server restart/hold/shutdown, false otherwise.
*<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> - True if the server should restart on some "SEVERE" exceptions, false otherwise.
*<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> - Sets the aggressiveness of the severe exception detection algorithm. Aggressiveness is defined by an integer between 1 and 3 (inclusive), where 1 is the least aggressive and 3 is the most.
*<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, 1 est la moins agressive et 3 est le plus.
*<code><nowiki>disable-heartbeats-on-missing-plugin</nowiki></code> - True if heartbeat restarts should be disabled when the bukkit plugin is not detected, false otherwise.
*<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> - Sets the amount of time the Toolkit wrapper waits before sending a heartbeat request to the Toolkit plugin.
*<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> - Sets the number of unanswered heartbeat requests required before a server restart is forced.
*<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> - Set whether or not the toolkit should filter out ansi escape codes (such as colors) from the server console. This can be set as either true, false or auto.
*<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 if jline console formatting should be enabled, false otherwise.
*<code><nowiki>enable-jline</nowiki></code> - True si le formatage de la console jline doit être activée, false pour désactiver.


==== remote.properties  ====
==== remote.properties  ====
<syntaxhighlight lang="Bash">
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
</syntaxhighlight>


*<code><nowiki>remote-control-port</nowiki></code> - The port to bind the remote control servers to.
; paramètres du telnet (et donc le controle à distance! )
*<code><nowiki>remote-bind-address</nowiki></code> - The address to bind the remote control servers to. '''NOTE: In most cases this should be left blank'''
*<code><nowiki>remote-control-port</nowiki></code> - Port d'écoute pour contrôler à distance le serveur.
*<code><nowiki>auth-salt</nowiki></code> - 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.
*<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>telnet-enabled</nowiki></code> - True if the telnet server is enabled. False otherwise.
*<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>shell-password-mask</nowiki></code> - The character(s) to use when masking password input.
*<code><nowiki>telnet-enabled</nowiki></code> - True pour activer le telnet. False pour désactiver.
*<code><nowiki>shell-input-echo</nowiki></code> - True if the telnet shell should echo each character typed, false otherwise.
*<code><nowiki>shell-password-mask</nowiki></code> - Le(s) caractère(s) à utiliser pour masquer l'entrée mot de passe.
*<code><nowiki>message-playback-count</nowiki></code> - The number of console lines to send to users connecting to the remote console.
*<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 ====
==== messages.txt ====
<syntaxhighlight lang="Bash">
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
</syntaxhighlight>
;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é!'''


*<code><nowiki>restart-kick-message</nowiki></code> - The kick message used to alert players that the server is being restarted.
== Notes et références ==
*<code><nowiki>toolkit-shutdown-kick-message</nowiki></code> - The kick message used to alert players that the server is shutting down.
<references/>
*<code><nowiki>hold-kick-message</nowiki></code> - he kick message used to alert players that the server is being held.
*<code><nowiki>restart-time-warning</nowiki></code> - The warning given when a restart alert is scheduled to occur. <code>%t</code> is substituted for the time remaining.
*<code><nowiki>restart-warning</nowiki></code> - Sent to all players approximately 3 seconds before the server is restarted.
*<code><nowiki>toolkit-shutdown-time-warning</nowiki></code> - The warning given when a shutdown alert is scheduled to occur. <code>%t</code> is substituted for the time remaining.
*<code><nowiki>toolkit-shutdown-warning</nowiki></code> - Sent to all players approximately 3 seconds before the server is shut down.
*<code><nowiki>hold-warning</nowiki></code> - Sent to all players approximately 3 seconds before the server is held.
*<code><nowiki>auto-save-start</nowiki></code> - Sent to all players when an auto-save event has started.
*<code><nowiki>auto-save-complete</nowiki></code> - Sent to all players when an auto-save is completed
*<code><nowiki>restart-time-left</nowiki></code> - Reply to players asking for the restart time. '''NOTE: This is not implemented yet!'''
[[Catégorie:Plugin installé]]

Dernière version du 16 février 2016 à 10:43


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 [1] 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!



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



Commandes

Console (telnet)


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


Notes et références

  1. qui devrait être là où vous avez extrait le fichier .zip