« RemoteToolkit » : différence entre les versions

De Nefald Wiki
Aller à la navigation Aller à la recherche
Hiob (discussion | contributions)
Hiob (discussion | contributions)
mAucun résumé des modifications
Ligne 82 : Ligne 82 :
|}
|}


== Configuration ==
==== wrapper.properties  ====
*<code><nowiki>minecraft-server-jar</nowiki></code> - The name of the Minecraft server jar to launch.
*<code><nowiki>extra-runtime-arguments</nowiki></code> - A '''comma separated''' list of arguments to be sent to the java runtime environment.
*<code><nowiki>server-arguments</nowiki></code> - A '''comma separated''' list of arguments to be sent to the server process.
*<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>maximum-heap-size</nowiki></code> -  Maximum amount of memory to allocate to the server. This is equivalent to the -Xmx flag.
*<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>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-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-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>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>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-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>force-save-on-restart</nowiki></code> - True if a save-all should be forced on a server restart/hold/shutdown, false otherwise.
*<code><nowiki>restart-on-severe-exception</nowiki></code> - True if the server should restart on some "SEVERE" exceptions, false otherwise.
*<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>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>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>failed-heartbeat-restart-count</nowiki></code> - Sets the number of unanswered heartbeat requests required before a server restart is forced.
*<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>enable-jline</nowiki></code> - True if jline console formatting should be enabled, false otherwise.
==== remote.properties  ====
*<code><nowiki>remote-control-port</nowiki></code> - The port to bind the remote control servers to.
*<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>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>telnet-enabled</nowiki></code> - True if the telnet server is enabled. False otherwise.
*<code><nowiki>shell-password-mask</nowiki></code> - The character(s) to use when masking password input.
*<code><nowiki>shell-input-echo</nowiki></code> - True if the telnet shell should echo each character typed, false otherwise.
*<code><nowiki>message-playback-count</nowiki></code> - The number of console lines to send to users connecting to the remote console.
==== messages.txt ====
*<code><nowiki>restart-kick-message</nowiki></code> - The kick message used to alert players that the server is being restarted.
*<code><nowiki>toolkit-shutdown-kick-message</nowiki></code> - The kick message used to alert players that the server is shutting down.
*<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é]]
[[Catégorie:Plugin installé]]

Version du 13 avril 2013 à 09:27


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

Spécificités

Commandes

Console telnet

commande description
.help Displays the list of console commands recognized by the wrapper.
.hold Stops the server until .unhold is used. This is useful if you want to perform an update to Bukkit without stopping the wrapper.
.unhold Unholds a held server.
.modules Displays the list of currently loaded Toolkit Modules.
.shutdowntime Displays the time left until the next Toolkit shutdown.
.restarttime Displays the time left until the next server restart.
.restart Gracefully restarts the Minecraft server.
.reschedulerestart Reschedules the next restart. The time parameter can either be in either the #h #m #s format, or the HH:MM format.
.rescheduleshutdown (Re)schedules a Toolkit shutdown. The time parameter can either be in either the #h #m #s format, or the HH:MM format.
.cancelshutdown Cancels a scheduled Toolkit shutdown.
.stopwrapper Stops the wrapper along with the server.
.users Displays the list of users currently registered with the Toolkit.
.useradd <name> <password> Adds a user to the Toolkit.
.userremove <name> Removes a user from the Toolkit.
.set <option> <value> Sets a value to an option. (NOTE: Enter '.set help' for a list of valid options and values)
.version Displays the version of the wrapper.

En jeu

commande description
/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> 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.
/stopwrapper <[username:]password> Stops both the server and the Toolkit. THIS WILL SHUT THE SERVER DOWN AND WILL NOT RESTART IT

Configuration

wrapper.properties

  • minecraft-server-jar - The name of the Minecraft server jar to launch.
  • extra-runtime-arguments - A comma separated list of arguments to be sent to the java runtime environment.
  • server-arguments - A comma separated list of arguments to be sent to the server process.
  • initial-heap-size - Initial amount of memory to allocate to the server. This is equivalent to the -Xms flag.
  • maximum-heap-size - Maximum amount of memory to allocate to the server. This is equivalent to the -Xmx flag.
  • overridden-process-arguments - 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!
  • server-restart-alerts - 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.
  • server-restart-delay - 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.
  • server-saveall-period - 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.
  • forced-restart-delay - 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.
  • toolkit-autoshutdown-delay - 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.
  • toolkit-autoshutdown-alerts - 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.
  • force-save-on-restart - True if a save-all should be forced on a server restart/hold/shutdown, false otherwise.
  • restart-on-severe-exception - True if the server should restart on some "SEVERE" exceptions, false otherwise.
  • severe-exception-detection-level - 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.
  • disable-heartbeats-on-missing-plugin - True if heartbeat restarts should be disabled when the bukkit plugin is not detected, false otherwise.
  • server-heartbeat-threshold - Sets the amount of time the Toolkit wrapper waits before sending a heartbeat request to the Toolkit plugin.
  • failed-heartbeat-restart-count - Sets the number of unanswered heartbeat requests required before a server restart is forced.
  • filter-ansi-escape-codes - 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.
  • enable-jline - True if jline console formatting should be enabled, false otherwise.

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!