RRR    EEEE   AA   DD        M     M  EEEE
R  R   E     A  A  D D       MM   MM  E
R  R   E     A  A  D  D      MM   MM  E
RRR    EEEE  AAAA  D  D      M M M M  EEEE
R  R   E     A  A  D D       M M M M  E
R   R  EEEE  A  A  DD        M  M  M  EEEE
==========================================

*For best viewing results, it is recommended to open this file with a text editor/viewer without page wrapping.*
*Many computers come with such a program/application pre-installed. Using one to read this file is not required.*

VERSION INFORMATION
-----------------------------------------

This readme file corresponds to The Seasons Mod v1.8.1 for 1.5.1. It is not to be edited, deleted, or replaced in part or 
in whole, and is to be distributed with all copies of The Seasons Mod v1.8.1 for 1.5.1.

This copy of The Seasons Mod v1.8.1 is for Minecraft 1.5.1, and should support multi-player game-play, both from a client 
and from a dedicated server. All clients must have the mod in order to connect to a server that uses it. The two editions
of this mod might be able to communicate, as long as Mojang's code allows for it. One edition is for Minecraft 1.5 and 
the other is for Minecraft 1.5.1.

The codename for The Seasons Mod v1.8.1 is "Celebration".


HOW TO INSTALL
-----------------------------------------

To install this mod, install the required version of Forge, then put the mod's files into the Minecraft jar. If this 
is not possible, then putting this mod into the mods folder as a .jar works, but incompletely. Do not place 
this mod as a zip folder into the mods folder. The two installation methods each have their own pros and cons, as well 
as incompatibilities. Installing into the jar has the best results, but cannot be done properly on MCPC+ servers. 

The files "aab.class", "aav.class", "acy.class", "apa.class", "apa$1.class", "qq.class", and "zx.class" are required.
"bfr.class" and "iz.class" are optional, but highly recommended as they fix problems involving snow and rain.

In the event that the mod is incorrectly installed by being placed into the mods folder as a zip or by being 
overwritten in the Minecraft jar, the mod will not stop Minecraft from loading and will do it's best to continue 
on. This will usually lead to unwanted results.


MODIFICATION SUPPORT
-----------------------------------------

The official website for this mod is http://www.minecraftforum.net/topic/1482770- . Downloads from websites other than 
http://www.minecraftforum.net/topic/1482770- are unsupported, as they may have changes to them.
New as of v1.7, when starting a server, the mod will attempt to run a version check through the internet. If successful, 
the mod will alert the user the current status for how it compares to other versions, giving download links if 
applicable. If there are two releases with the same name and intended Minecraft version, meaning the first is recalled, 
and the user manages to successfully run a/one of the recalled releases for that version, a direct, no-advertisement, 
download link is given.

All instructions on installation and usage is at http://www.minecraftforum.net/topic/1482770- . In the event that 
English is not a language you are fluent in, you may send The_WeatherPony a private message on www.minecraftforum.net 
in your language, or use a translator to translate and post in the mod's thread, as printed above. The_WeatherPony will 
do his best to communicate with you in your language if you private message him in that language.

Websites other than http://www.minecraftforum.net/topic/1482770- are not to host the mod. In no case is there to be a 
download mirror for the mod, nor provide the mod other than as provided at http://www.minecraftforum.net/topic/1482770- 
by The_WeatherPony, the programmer producing this mod. 

In the event that I, "The_WeatherPony", go to another forum regarding my work, I will be "The_WeatherPony", 
"TheWeatherPony", or "WeatherPony". When doing such, I may instruct proper guidelines as set forth here and on 
http://www.minecraftforum.net/topic/1482770- or express thanks for following the guidelines. In the event that I have 
other instructions, I will always put such notifications on http://www.minecraftforum.net/topic/1482770- and reference 
to them. Never will I post requests or instructions contrary to the guidelines expressed here and my webpage without 
posting it on the web page directly.


UPGRADING WORLDS FROM A PREVIOUS VERSION
-----------------------------------------

To upgrade a world from a version before v1.6, including the entire v2 series, delete the Seasons.dat file for the 
world before loading with this version. Failure to do so will cause unwanted effects to arise within that world.
To upgrade a world from a v1.6 or from a v1.7, simply play the world with v1.8.1. All new save data will be written 
as needed with the default settings. While the new data is written, however, it is recommended to delete the settings 
files, known as SeasonsData.dat, so that the new recommended settings can be applied if it was not saved by v1.7.3 or 
newer, or edited to have the same effect. This is not required, however, but will fix problems involving sleeping.
If using Mystcraft, it is now safe to remove any directories/folders that you added to allow compatibility. This mod 
now looks to the correct location.

SeasonsData.dat is located in the world's and it's dimensions' folders. For servers, the world's folder is in the 
server's directory. For clients, the world's folder is in the saves folder inside the Minecraft directory.


Achievements
-----------------------------------------
New as of v1.8, there is an achievement page with some achievements. Some achievements may be trickier than others 
to acquire. Some achievements can be obtained without The Seasons Mod installed on the connected server, and some 
achievements cannot be obtained with The Seasons Mod alone. Please do not reveal how to get these achievements.

Due to a problem with Forge, the achievements will reset every time the game is loaded. This is known, and The Seasons 
Mod will be implementing it's own way to keep track of obtained achievements, when the code is completed for a future 
release.


EDITING MOD SETTINGS
-----------------------------------------

New as of v1.8, there is a config file at <Minecraft directory>/config/Seasons/Settings.cfg. This file offers changes 
to basic features that normally come standard with mods, such as changing ID numbers and such. It is meant to be self 
explanatory. It can be edited using a normal text editor.

In that same folder is a file named "Seasons.wpvd" which is not meant to be edited or viewed. It contains version 
information and is overwritten frequently by this mod.


EDITING WORLD SETTINGS
-----------------------------------------

To edit settings for a world on a by-dimension basis, open the file SeasonsData.dat in the world's dimension's folder 
with an NBT editor. The NBTs are all found in a sub-NBT, and are as follows. Please understand that some have hidden 
or recently changed functionality, so description may not be 100% accurate.

"SummerDesert" (boolean) - should players take burn damage from deserts in Summer
"SummerDesertDamage" (integer) - how much damage should players take from deserts in Summer
"SummerDesertInterval" (integer) - how many ticks (20 per second) should be between occurrences of desert Summer burns

"WinterFrost" (boolean) - should players take frost damage from cold biomes in Winter
"WinterFrostDamage" (integer) - how much damage should players take from cold biomes in Summer
"WinterFrostInterval" (integer) - how many ticks (20 per second) should be between occurrences of cold-biome Winter frostbite

"SummerLength" (integer) - how long should Summer be in days. -1 makes the season never end
"AutumnLength" (integer) - how long should Autumn be in days. -1 makes the season never end
"WinterLength" (integer) - how long should Winter be in days. -1 makes the season never end
"SpringLength" (integer) - how long should Spring be in days. -1 makes the season never end

"DayTransition_hour" (integer) - what hour of the day should days and seasons change (0-23)
"DayTransition_minute" (integer) - what minute of that hour should days and seasons change (0-59)

"NerfSeeds" (double decimal) - how much should seed drops be nerfed. There is a 1/NerfSeeds chance that a single item drop 
		from tall grass is not destroyed. If NerfSeeds is less than 1, then drops do not change. 
"SummerRainTundra" (boolean) - should it rain in cold biomes in Summer
"SummerThunder" (boolean) - should rains be thunderstorms when in Summer
"SummerRainDestroy" (boolean) - should rains in Summer destroy small plants. offsets "SpringGrow"
"AutumnWheat" (integer) - up to how much additional wheat should crops drop in Autumn. Each has a 1/2 chance of 
		actually dropping, with the minimum of the original wheat dropping by itself.
"WinterSnow" (boolean) - should it always rain/snow in Winter
"WinterSnowLeaves" (boolean) - should snow form on leaves when it snows (currently unused)
"SpringGrow" (boolean) - should small plants grow on grass blocks in Spring
"SpringGrowSapling" (integer) - should saplings grow on grass blocks in Spring (0 to disable. 1 or 2 otherwise)
"SpringDisableFlowers" (boolean) - should flowers grow on grass blocks in Spring
"SpringCustomIDs" (string of characters) - a list of block IDs to grow on grass blocks in Spring. * **
"SpringCustomMeta" (string of characters) - a list of metadata for block IDs for each in "SpringCustomIDs". * **

"timetick" (integer) - used by the mod for timing. Advised not to change.
"daytick" (integer) - used by the mod for timing. Advised not to change.

"currentSeason" (string of characters) - The name of the current season. ("Spring", "Summer", "Autumn", "Winter")
"seasonDay" (integer) - the day number in the current season.

"SeasonTransition" (boolean) - should players experience an overlay telling them that a new season has come

"lastWorldTime" (long integer) - the previous world time. Advised not to change under normal circumstances.
"haslastdaypassed" (boolean) - used by the mod for timing. Advised not to change.

"cold_biomes" (string of characters) - a list of biomes considered to be cold. *
"hot_biomes" (string of characters) - a list of biomes considered to be hot. *

* the semi-colon character separates entries
** should be the same length


UPDATES TO THE MODIFICATION
-----------------------------------------

Updates will be made to this mod, and will be found at http://www.minecraftforum.net/topic/1482770- . New as of v1.7, 
the mod will attempt to alert the user of updates.
Unfortunately, the code that parses the information was not correctly coded to handle more than one version of 
Minecraft. There are now three versions of Minecraft in the information: 1.4.7, 1.5, and 1.5.1. The parser can handle 
releases of this mod with the same name on multiple versions of Minecraft, but it cannot handle those multiple versions 
of Minecraft, same name version of this mod or not. Because of this, there are no update notifications in either v1.8.1 
edition. This will be fixed in a coming release of the mod, but will not effect v1.8.1.



SEMI-LEGAL NOTICE
-----------------------------------------

This mod is just that: a mod. Minecraft's Terms of Service say, as copied on the thirty-first of October, 2012:

      If you've bought the game, you may play around with it and modify it. We'd appreciate it if you didn't 
      use this for griefing, though, and remember not to distribute the changed versions of our software. 
      Basically, mods (or plugins, or tools) are cool (you can distribute those), hacked versions of the 
      Minecraft client or server are not (you can't distribute those).

      Any tools you write for the game from scratch belongs to you. Other than commercial use (unless 
      specifically authorized by us in our brand and assets usage guidelines - for instance you are allowed 
      to put ads on your YouTube videos containing Minecraft footage), you're free to do whatever you want 
      with screenshots and videos of the game, but don't just rip art resources and pass them around, that's 
      no fun. Plugins for the game also belong to you and you can do whatever you want with them, as long as 
      you don't sell them for money. We reserve the final say regarding what constitutes a tool/plugin and 
      what doesn't.

This modification entails only the new content that it adds to Minecraft. As such, this mod is not distributed with the 
rest of Minecraft, and only the edited .class files are distributed with this modification.

The Terms of Service for this mod are the same as the Terms of Service for Minecraft, wherever applicable.
