Configuration

This page contains the configuration-description for version 0.3.0 and above. Refer to the old configuration at http://dev.bukkit.org/bukkit-mods/real-time-rotation/pages/deprecated/configuration for all previous version.

Basics:

This plugin will require a yml-File inside the plugin-folder.
Name of the file: config.yml which will be located within a realtimeroation-directory inside your plugin-directory.

The file will be created on the first init of the plugin though.
The plugin will continue to update the file if config-values are missing from the file.

Example content of the config-file:
config:
  debug: false/true
  worlds:
    [world-name]:
      enabled: true/false
      time:
        modifier: [number]
        ticks_to_update: [number]
        zone: [string]
      dynamic:
        enabled: true/false
        coordinates:
          lat: [number]
          lon: [number]
      static:
        sunrise: [string]
        sunset: [string]


Description:

The placeholder [world] will be replaced by the name of the world you want to configure.
Note that the plugin will create such a section for every world available to the plugin. By default, the plugin will be disabled for those worlds.

version	Option	Description	Example
v0.3.0	config.debug	Enables excessive logging to the command-line of the running server. This is usually only for dev purpose.	true or false
v0.3.0	config.worlds.[world].enabled	Set to true if you want to use real or custom sunset and sunrise. Else set to false.	true or false
v0.3.0	config.worlds.[world].time.modifier	Defines the length a of day within the game.	1 will turn into a full 24h-day 24 will turn into a 1h-day 60 will turn into a 24m-day The higher this value is, the faster the days will pass.
v0.3.0	config.worlds.[world].time.ticks_to_update	Defines how often the time is calculated. The longer the day, the higher this number can be. Setting this to 1 will result significant performance-loss. Depending on the server you might need to increase this value.	>= 1
v0.3.0	config.worlds.[world].time.zone	The time-zone-offset at this region.	Europe/Berlin for Berlin/Germany
v0.3.0	config.worlds.[world].dynamic.enabled	Defines if the time should be defined by geo-location.	true or false
v0.3.0	config.worlds.[world].dynamic.coordinates.lat/lon	Set the latitude/longitude of the location you want to emulate the sunset- and sunrise-time from.	lat: 52.5166667, lon: 13.4 for Berlin
v0.3.0	config.worlds.[world].static.sunrise/sunset	Set the time the sunrise and sunset will be. (will only be use if you set config.worlds.[world].dynamic.enabled to false). Remember the quotation-marks! Format is: "HH:MM:SS"	"20:59:43"

Additional informations to the timemodifier:

Just calculate the seconds you want the a day to be.
If you want a 30 seconds day calculate the following:
( 24 * 60 * 60 ) / 30 => 2880
And set the result as the modifier.

You may not use float as modifier since this will cause an artifact on midnight (day might be in the middle, and switch over to the start of the day).code