From b1062979e16998717a123443e794775926e741cf Mon Sep 17 00:00:00 2001 From: Bryson Steck Date: Fri, 20 Aug 2021 00:33:59 -0600 Subject: updated sample files readme --- data/README.md | 28 +++++++++++++++++++++++----- 1 file changed, 23 insertions(+), 5 deletions(-) diff --git a/data/README.md b/data/README.md index b08748e..8700df4 100644 --- a/data/README.md +++ b/data/README.md @@ -1,12 +1,14 @@ -# `playerData.resurrection` Example File +# Example Files -This file is crucial to Resurrection as it contains important timing data for the plugin. This file should only contain one line of data at all times and new users are appended to such line. +These files are crucial to Resurrection as they contain important timing data and resources for the plugin. -This directory contains a sample file for you to visualize what this file will contain. The plugin creates this file in the same directory as the Spigot server jar file. +This directory contains sample files for you to visualize what these files will/may contain. The plugin creates these files in the same directory as the Spigot server `plugins` directory. -Avoid touching this file while the plugin is enabled and avoid deleting or moving the file at any time after it's creation to prevent breaking the plugin. +Avoid touching these files while the plugin is enabled and avoid deleting or moving the files at any time after it's creation to prevent breaking the plugin. -## Formatting +## Formatting of `playerData.resurrection` + +This file should only contain one line of data at all times as new users are appended to such line. The file is read as follows: ``` @@ -20,3 +22,19 @@ The file is read as follows: * `timeUntilResurrection` is a long containing the milliseconds for when the user shall be resurrected. * This value is reset to 0 if the `dead` flag is false. +## Formatting of `settings.resurrection` + +The file contains two types of lines: comments and settings. +``` +# Comments start the line with a '#'. Anything in the line will be ignored by Resurrection. +# Settings contain the name of the settings, a '=' and then it's value as shown below. +setting=value +``` + +Currently, Resurrection looks for two settings: +* `resurrection_time` + * The time between death and respawn (known as "resurrection" in my docs) in milliseconds. Value must be a number (long to be specific). Default value is 24 hours/`86400000`. +* `debug` + * Displays debug messages for the command sender. Value must be a boolean (true/false). Default value is `false`. + +If any settings are missing or have an invalid value, the plugin will shutdown and notify you of what needs to be changed. -- cgit v1.2.3