CalendarPlugin

Calendar Plugin

Bring your world to life with Calendar Plugin! This plugin introduces a complete calendar, dynamic seasons, and a powerful custom event system. It takes full control of the day/night cycle to create season-dependent durations, adds immersive visual effects like winter snow, and manages a robust event manager. The plugin is fully translatable through the built-in language system and automatically detects new language files.

✨ MAIN FEATURES

• Full-Fledged Calendar: Automatic day, month, and year system that advances exactly at midnight.
• Dynamic Seasons: Spring, Summer, Autumn, and Winter with unique gameplay impacts.
• Custom Day/Night Cycle: Configure different day and night durations for each season.
• Configurable Seasonal Farming: Decide exactly which crops can grow in which seasons via config.yml.
• Immersive Visual Effects: Manage seasonal freezing and thawing of biomes and flower spawning via config.yml.
• Dynamic Boss Bar: Keep players informed with a display showing the date, season, weather, time, and active event.
• Seasonal Resource Packs: Automatically send a different server resource pack to players each season.
• Powerful Event System:
  • Create fixed-date (FIXED_DATE), annual (ANNUAL), or random (RANDOM) events.
  • Time-Based Events: Set specific start (hour-event) and end (hour-stopevent) times for your events.
  • Event Priority: FIXED_DATE and ANNUAL events automatically interrupt RANDOM events if they overlap.
  • Execute custom commands at the start and end of events.
• PlaceholderAPI Integration: Display calendar data in any other compatible plugin.
• Multiplayer Sleep: Allows players to sleep to skip the night, respecting the configured percentage.
• Multilingual Support: All messages are translatable. Comes with EN, IT, ES out of the box and automatically saves new .yml files from the JAR's lang folder.

🚀 INSTALLATION

1. Drop CalendarioPlugin.jar into your /plugins/ folder.
2. (Recommended) Install PlaceholderAPI.
3. Start your server to generate the configuration files (config.yml, events.yml, events_it.yml, events_es.yml, lang/).
4. Customize the files to your liking and run /calendar reload.

💻 COMMANDS

All commands require operator permissions (OP).

• /calendar help: Shows the help menu.
• /calendar set <day|month|year> <value>: Sets the current date.
• /calendar reload: Reloads all configuration files from disk.
• /calendar event <start|end|status> [event_id]: Manually manages events.
  • start <event_id>: Force-starts a specific event.
  • end: Force-ends the currently active event.
  • status: Shows the currently active event.

⚙️ CONFIGURATION (config.yml)

The config.yml file allows you to customize every aspect of the plugin.

• language: Sets the plugin's language (e.g., "en_US", "it_IT", "es_ES"). Matches the filename in lang/.
• debug: Set to true to see detailed logs in the console.
• time-cycle: Control the duration (in seconds) of day and night for each season (spring, summer, autumn, winter).
• visual-effects:
  • mild-biomes: List of biomes where seasonal freezing/thawing effects apply.
  • spawnable-flowers: List of flowers that can spawn in spring.
• seasonal-farming:
  • out-of-season-growth-chance: Growth probability (0.0-1.0) for out-of-season crops.
  • crops: Lists of allowed crops for each season.
• sleep-mechanics:
  • players-sleeping-percentage: Percentage (0-100) of players required to sleep to skip the night.
• bossbar:
  • format: Customize the text. Placeholders: {date}, {season}, {weather}, {time}, {event}.
  • no-event-text: Text displayed in {event} when no event is active.
• data.yml: (Do not edit) File where the current date and world ticks are saved.

🎉 EVENT SYSTEM (events.yml)

Create your own unique server events. Example files events_it.yml and events_es.yml are included.

• Event Types:
  • ANNUAL: Triggers on a specific day/month, every year (e.g., "31/10").
  • FIXED_DATE: Triggers only once on a specific full date (e.g., "01/01/2025").
  • RANDOM: Triggers randomly based on chance (0-100 probability) and can be restricted to specific seasons (list of UPPERCASE ENGLISH season names, e.g., ["WINTER", "AUTUMN"]).
• Timing:
  • trigger-date: The activation date (required for ANNUAL/FIXED).
  • hour-event: Start time (HH:MM, defaults to 00:00).
  • duration-days: Number of full days the event lasts (defaults to 0 = ends same day).
  • hour-stopevent: End time (HH:MM, defaults to 23:59).
• Actions:
  • start-commands: List of commands executed by the console at the start.
  • end-commands: List of commands executed by the console at the end.

📊 PLACEHOLDERAPI

⚠️ Important: The prefix is calendar_.

• %calendar_day%: The current day number.
• %calendar_month%: The name of the current month (localized).
• %calendar_year%: The current year.
• %calendar_season%: The name of the current season (localized, with colors).
• %calendar_time%: The current in-game time (HH:MM format).
• %calendar_weather%: The current weather (localized, uses bossbar.weather-* keys).