EzSeasons

A Simple, Powerful Minecraft Seasons Plugin

---

Overview

EzSeasons brings dynamic, customizable seasons to your Minecraft server! Enhance gameplay with changing weather, temperature, and unique seasonal events. Perfect for survival, roleplay, and SMP servers.

---

Features

• Four fully configurable seasons: Spring, Summer, Autumn, Winter
• Customizable season length and transitions
• Weather changes per season (rain, snow, clear, storms)
• Temperature system affecting gameplay
• Seasonal events and effects (e.g., snow in winter, flowers in spring)
• Per-world support
• API for developers
• Lightweight and performance-friendly
• Easy to use config files

---

Commands & Permissions

• /season - View current season
• /season set <season> - Set the current season (admin)
• /season reload - Reload config
• Permissions: ezseasons.admin, ezseasons.view

---

Installation

1. Download the latest EzSeasons.jar
2. Place it in your plugins folder
3. Restart or reload your server
4. Edit config.yml to your liking

---

Configuration

All settings are in plugins/EzSeasons/config.yml.

• Change season names, durations, weather, and more!

---

Developer Documentation

EzSeasons provides a simple API for developers to integrate seasonal features into their own plugins.

Importing EzSeasons Locally

Download the latest EzSeasons.jar and add it to your plugin's build path or local libs folder. No Maven repository is required.

Registering Your Integration

To hook your plugin into EzSeasons, implement the SeasonsIntegration interface and register it at runtime:

import com.skyblockexp.lifesteal.seasons.api.SeasonsApi;
import com.skyblockexp.lifesteal.seasons.api.SeasonsIntegration;

public class MySeasonsIntegration implements SeasonsIntegration {
    @Override
    public void onRegister(SeasonsApi api) {
        // Subscribe to season events, interact with API, etc.
    }
    @Override
    public void onUnregister() {
        // Cleanup if needed
    }
}

// Register your integration (e.g. in your plugin's onEnable):
SeasonsApi api = ... // obtain from EzSeasons
api.registerIntegration(new MySeasonsIntegration());

Accessing the API

You can access the EzSeasons API via the plugin instance:

SeasonsApi api = com.skyblockexp.lifesteal.seasons.EzSeasonsPlugin.getInstance().getApi();

Getting the Current Season

com.skyblockexp.lifesteal.seasons.api.Season current = api.getCurrentSeason(world);
String name = current.getName();

Listening for Season Change Events

You can listen for season changes using the Bukkit event system:

@EventHandler
public void onSeasonChange(com.skyblockexp.lifesteal.seasons.api.event.SeasonChangeEvent event) {
    com.skyblockexp.lifesteal.seasons.api.Season newSeason = event.getNewSeason();
    // Your code here
}

Available API Methods

• getCurrentSeason(World world): Get the current season for a world
• getSeasonByName(String name): Get a season by its name
• getAllSeasons(): List all configured seasons
• setSeason(World world, Season season): Set the current season
• getSeasonLength(Season season): Get the length of a season
• registerSeasonListener(SeasonListener listener): Register a custom listener

Custom Integrations

You can use the API to:

• Trigger custom events or effects when seasons change
• Adjust gameplay mechanics based on the current season
• Create season-based quests, mobs, or rewards

---

Support & Issues

For help, suggestions, or bug reports:

• Discord

---

Plugins with EzSeasons integration

• EzLifesteal

---

EzSeasons is a standalone seasons framework. Any plugin can integrate via the public API.