# ==================================================================================================
# FioClock - Advanced Configuration File
# ==================================================================================================
# This file is intentionally heavily documented and sectioned so staff can understand each value.
# The plugin reads only specific keys. Additional sections below are "documentation blocks" only.
#
# MiniMessage format:
# Use tags like <red>, <green>, <yellow>, <gray>, <bold>, <italic>, <underlined>
# Examples:
# <gold><bold>Title</bold></gold>
# <gray>Muted text</gray> <white>normal</white>
#
# Placeholder tokens are wrapped in braces, example: {time}, {date}, {symbol}
# ==================================================================================================

# global prefix used by command feedback messages
# set to "" to disable globally
# this overrides messages.prefix if both are present
prefix: "<dark_gray>[<gradient:#FFBB00:#7289da>FioClock</gradient>]</dark_gray> <gray>"

# --------------------------------------------------------------------------------------------------
# [1/6] Core Time + Timezone Controls
# --------------------------------------------------------------------------------------------------
# timezone:
# auto -> use machine/server timezone
# SYSTEM -> legacy alias for system timezone (still supported)
# Or set explicit zone like "Asia/Bangkok", "UTC", "America/New_York"
timezone: auto

# timezone-toggle-alternate:
# Secondary timezone used by "/fioclock admin timezone toggle"
timezone-toggle-alternate: UTC

# timezone-mode:
# primary -> use `timezone`
# alternate -> use `timezone-toggle-alternate`
timezone-mode: primary

# time-mode:
# reallife -> clock follows real-world time
# minecraft -> clock follows world tick time
time-mode: reallife

# date-format:
# Java DateTimeFormatter pattern
# Common examples:
# MM/dd/yyyy -> 03/10/2026
# yyyy-MM-dd -> 2026-03-10
# dd MMM yyyy -> 10 Mar 2026
# EEE, MMM dd, yyyy -> Tue, Mar 10, 2026
date-format: MM/dd/yyyy

# update-interval-ticks:
# Plugin refresh interval.
# 1 tick = 0.05 second (20 updates/second)
# 20 ticks = 1 second
# Keep low for smooth visuals, increase for lower CPU usage.
update-interval-ticks: 1

# --------------------------------------------------------------------------------------------------
# [2/6] Display Templates (Bossbar + Clock Render String)
# --------------------------------------------------------------------------------------------------
# clock-format:
# Used for "/fioclock now" and any message using {clock}.
# Supports all placeholders listed in [5/6].
clock-format: "<yellow>Weather:</yellow> <white>{weather}</white> <yellow>{symbol}</yellow> <gray>|</gray> <yellow>Days:</yellow> <white>{days}</white> <gray>|</gray> <yellow>Hours:</yellow> <white>{hours}</white> <gray>|</gray> <yellow>Minutes:</yellow> <white>{minutes}</white> <gray>|</gray> <yellow>Seconds:</yellow> <white>{seconds}</white> <gray>|</gray> <yellow>Milli Seconds:</yellow> <white>{milliseconds}</white> <gray>|</gray> <yellow>AM PM:</yellow> <white>{ampm}</white> <gray>|</gray> <yellow>Date:</yellow> <white>{date}</white>"

# boss-bar-format:
# Live bossbar line shown when player enables "/fioclock toggle bar"
# Recommended to keep this shorter than chat lines.
boss-bar-format: "<yellow>{weather}</yellow> <white>{symbol}</white> <gray>|</gray> <white>Time:</white> <yellow>{time}</yellow> <gray>|</gray> <white>{date}</white>"

# boss-bar-auto-on-clock-hold:
# enabled:
# true -> automatically show bossbar while player holds a CLOCK (main/off hand)
# false -> disable auto-show; only "/fioclock toggle bar" controls visibility
boss-bar-auto-on-clock-hold:
enabled: true

# boss-bar-auto-on-compass-hold:
# enabled:
# true -> automatically show compass bossbar while player holds COMPASS/RECOVERY_COMPASS
# false -> disable auto-show from compass
# format:
# dedicated bossbar text used while compass auto mode is active.
# tokens: {direction} {direction_full} {x} {z} and all normal FioClock placeholders.
boss-bar-auto-on-compass-hold:
enabled: true
format: "<white>Direction:</white> <yellow>{direction}</yellow> <gray>|</gray> <white>X:</white> <yellow>{x}</yellow> <gray>|</gray> <white>Z:</white> <yellow>{z}</yellow>"

# boss-bar-style:
# style:
# SOLID, SEGMENTED_6, SEGMENTED_10, SEGMENTED_12, SEGMENTED_20
# color-mode:
# weather -> use per-weather color map below
# fixed -> force one color for all weather states
# daynight -> day uses colors.day, night uses colors.night
# fixed-color and colors.* valid values:
# PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
boss-bar-style:
style: SOLID
color-mode: daynight
fixed-color: WHITE
colors:
clear: GREEN
cloudy: WHITE
rain: BLUE
thunder: PURPLE
snowy: WHITE
sakura: PINK
pale_leaves: WHITE
obsidian_tear: PURPLE
lava: RED
honey: YELLOW
zap: PURPLE
day: YELLOW
night: BLUE

# time-format:
# Controls the output of {time} placeholder (used in bossbar/messages).
# Available tokens:
# {hours} -> 12-hour clock (01-12)
# {hours24} -> 24-hour clock (00-23)
# {minutes} -> 00-59
# {seconds} -> 00-59
# {milliseconds} -> 000-999
# {ampm} -> AM or PM
# Examples:
# "{hours}:{minutes}:{seconds} {ampm}"
# "{hours24}:{minutes}:{seconds}"
# "{hours24}:{minutes}"
time-format: "{hours}:{minutes}:{seconds} {ampm}"

# symbols:
# Every symbol used by the plugin can be customized here.
# You may use plain characters, unicode escapes, emojis, or text words.
symbols:
symbol_day: "\u2600"
symbol_cloudy: "\u2601"
symbol_rain: "\uD83C\uDF27"
symbol_thunder: "\u26C8"
symbol_night: "\u263D"
symbol_snow: "\u2744"
symbol_sakura: "\uD83C\uDF38"
symbol_pale_leaves: "\uD83C\uDF42"
symbol_obsidian_tear: "\uD83D\uDCA7"
symbol_lava: "\uD83D\uDD25"
symbol_honey: "\uD83C\uDF6F"
symbol_cold: "\u2745"
symbol_zap: "\u26A1"

# --------------------------------------------------------------------------------------------------
# [3/6] Real-Life Weather Sync (External API Source)
# --------------------------------------------------------------------------------------------------
# IMPORTANT:
# - Set enabled=true to allow "/fioclock admin weather set reallife"
# - Coordinates should represent the city/region you want to mirror.
# - update-interval-seconds has a minimum runtime floor of 30 seconds.
real-life-weather:
# Master switch for real-life weather mode.
enabled: false

# Latitude/Longitude of target location.
# Example: New York City ~= 40.7128, -74.0060
latitude: 40.7128
longitude: -74.0060

# Poll frequency for real-life weather updates.
# Lower = fresher but more HTTP requests.
update-interval-seconds: 600

# --------------------------------------------------------------------------------------------------
# [4/7] Environmental Effects (Snow Reach / Cloud Freeze / Sunburn)
# --------------------------------------------------------------------------------------------------
# Tip:
# Keep placeholders intact unless you intentionally remove that dynamic value.
#
# effects:
# snow:
# Controls custom far-range snowfall particles used in warm biomes during SNOWY mode.
# cloudy-freeze:
# If enabled, players without overhead cover begin freezing after long cloudy exposure.
# sunburn:
# If enabled, players in very hot clear-day exposure take periodic fire/damage after delay.
effects:
snow:
# Particle amount per spawn burst.
particle-count: 32

# Horizontal spread radius around player (blocks).
radius-min: 1.0
radius-max: 8.5

# Vertical spawn range above player feet (blocks).
height-min: 2.2
height-max: 6.5

# Spawn interval jitter in milliseconds.
interval-min-ms: 120
interval-max-ms: 240

pale-leaves:
# Particle used for pale_leaves weather.
# On 1.21.0 API, PALE_OAK_LEAVES may not exist yet; plugin falls back to CHERRY_LEAVES.
particle: PALE_OAK_LEAVES

obsidian-tear:
# Particle used for obsidian_tear weather.
# Suggested values: FALLING_OBSIDIAN_TEAR, DRIPPING_OBSIDIAN_TEAR, LANDING_OBSIDIAN_TEAR
particle: FALLING_OBSIDIAN_TEAR

lava:
# Particle used for lava weather.
# Suggested values: FALLING_LAVA, DRIPPING_LAVA, LANDING_LAVA
particle: FALLING_LAVA

honey:
# Particle used for honey weather.
# Suggested values: FALLING_HONEY, DRIPPING_HONEY, LANDING_HONEY
particle: FALLING_HONEY

cloudy-freeze:
# Master switch for cloudy exposure freezing.
enabled: true

# Continuous uncovered cloudy exposure required before freezing begins.
exposure-seconds: 60

# Freeze progression tuning.
freeze-step-interval-ms: 1200
freeze-step-ticks: 20

# Damage while fully frozen.
damage: 0.5
damage-interval-ms: 4000

sunburn:
# Master switch for hot-day sunburn.
enabled: true

# Continuous uncovered daytime exposure required before sunburn starts.
exposure-seconds: 180

# Temperature threshold for sunburn checks (Fahrenheit).
hot-threshold-f: 92.0

# Damage and fire tuning while burning.
damage: 1.0
damage-interval-ms: 5000
fire-ticks: 60

# --------------------------------------------------------------------------------------------------
# [5/8] Command / Feedback Messages
# --------------------------------------------------------------------------------------------------
# Tip:
# Keep placeholders intact unless you intentionally remove that dynamic value.
messages:
# Prefix is controlled by top-level `prefix`.
# Add [prefix="false"] anywhere in a message string to suppress prefix for that specific message.

bossbar-enabled: "<green>Bossbar information enabled.</green>"
bossbar-disabled: "<red>Bossbar information disabled.</red>"

# {clock} expands using clock-format.
current: "{clock}"

reloaded: "<green>FioClock config reloaded.</green>"
only-player-toggle-bar: "<red>Only players can toggle bossbar view.</red>"
admin-timezone-toggle: "<green>Real-life timezone mode switched to <yellow>{timezone_mode}</yellow> (<white>{timezone}</white>).</green>"
no-permission: "<red>You do not have permission.</red>"
timezone: "<white>Server timezone: <yellow>{timezone}</yellow></white>"
date: "<white>Server date: <yellow>{date}</yellow> <gray>|</gray> <yellow>{day_short}</yellow> <gray>(</gray><yellow>{day_full}</yellow><gray>)</gray></white>"
time-current: "<white>Time mode: <yellow>{time_mode}</yellow> <gray>|</gray> World time: <yellow>{world_time}</yellow> <gray>|</gray> Phase: <yellow>{day_phase}</yellow></white>"
weather-current: "<white>Weather mode: <yellow>{weather_mode}</yellow> <gray>|</gray> Day state: <yellow>{weather}</yellow> <gray>|</gray> Type: <yellow>{weather_type} {weather_symbol}</yellow> <gray>|</gray> Temp: <yellow>{temperature_f}F</yellow> <gray>|</gray> Remaining: <yellow>{weather_duration}</yellow></white>"
admin-time-set: "<green>Time mode set to <yellow>{time_mode}</yellow>.</green>"
admin-weather-set: "<green>Weather mode set to <yellow>{weather_mode}</yellow> for <yellow>{weather_duration}</yellow>.</green>"
admin-weather-set-permanent: "<green>Weather mode set to <yellow>{weather_mode}</yellow>.</green>"
invalid-duration: "<red>Invalid time format. Use values like 20s, 5m, 2h, 1d, or 1d2h30m.</red>"
reallife-weather-disabled: "<red>Real-life weather sync is disabled. Set real-life-weather.enabled: true in config.</red>"
admin-version: "<white>Version: <yellow>{version}</yellow></white>"
admin-author: "<white>Author(s): <yellow>{author}</yellow></white>"
# --------------------------------------------------------------------------------------------------
# [6/8] Configurable Usage Messages
# --------------------------------------------------------------------------------------------------
# usage:
# Fully separated usage entries. Each command is its own key (easy to edit).
# The plugin reads these groups:
# usage.single
# usage.player
# usage.admin
# usage.admin-time
# usage.admin-timemode
# usage.admin-weather
usage:
header: "[prefix=\"false\"] <red>Usage:</red>"
single:
root: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock help</white>"
toggle: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock toggle bar</white>"
time-current: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock time current</white>"
weather-current: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock weather current</white>"
admin: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin help</white>"
admin-timezone-toggle: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin timezone toggle</white>"
admin-weather-clear: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin weather clear</white>"
admin-time-set: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin time set</white> <gold><status> [time]</gold>"
admin-timemode-set: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin timemode set</white> <gold><mode></gold>"
admin-weather-set: "[prefix=\"false\"] <yellow>Usage:</yellow> <white>/fioclock admin weather set</white> <gold><type> [time]</gold>"

player:
help: "<yellow>/fioclock help</yellow>"
placeholders: "<yellow>/fioclock placeholders</yellow>"
toggle-bar: "<yellow>/fioclock toggle bar</yellow>"
now: "<yellow>/fioclock now</yellow>"
time-current: "<yellow>/fioclock time current</yellow>"
weather-current: "<yellow>/fioclock weather current</yellow>"
timezone: "<yellow>/fioclock timezone</yellow>"
date: "<yellow>/fioclock date</yellow>"

admin:
help: "<yellow>/fioclock admin help</yellow>"
reload: "<yellow>/fioclock admin reload</yellow>"
placeholders: "<yellow>/fioclock admin placeholders</yellow>"
version: "<yellow>/fioclock admin version</yellow>"
author: "<yellow>/fioclock admin author</yellow>"
timezone-toggle: "<yellow>/fioclock admin timezone toggle</yellow>"
time-set-day: "<yellow>/fioclock admin time set day</yellow>"
time-set-night: "<yellow>/fioclock admin time set night</yellow>"
time-set-midnight: "<yellow>/fioclock admin time set midnight</yellow>"
time-set-afternoon: "<yellow>/fioclock admin time set afternoon</yellow>"
time-set-morning: "<yellow>/fioclock admin time set morning</yellow>"
time-set-reallife: "<yellow>/fioclock admin time set reallife</yellow>"
time-set-minecraft: "<yellow>/fioclock admin time set minecraft</yellow>"
timemode-set-reallife: "<yellow>/fioclock admin timemode set reallife</yellow>"
timemode-set-minecraft: "<yellow>/fioclock admin timemode set minecraft</yellow>"
weather-clear: "<yellow>/fioclock admin weather clear</yellow>"
weather-set-rain: "<yellow>/fioclock admin weather set rain</yellow> <gold>[time]</gold>"
weather-set-cloudy: "<yellow>/fioclock admin weather set cloudy</yellow> <gold>[time]</gold>"
weather-set-thunder: "<yellow>/fioclock admin weather set thunder</yellow> <gold>[time]</gold>"
weather-set-snowy: "<yellow>/fioclock admin weather set snowy</yellow> <gold>[time]</gold>"
weather-set-sakura: "<yellow>/fioclock admin weather set sakura</yellow> <gold>[time]</gold>"
weather-set-pale-leaves: "<yellow>/fioclock admin weather set pale_leaves</yellow> <gold>[time]</gold>"
weather-set-obsidian-tear: "<yellow>/fioclock admin weather set obsidian_tear</yellow> <gold>[time]</gold>"
weather-set-lava: "<yellow>/fioclock admin weather set lava</yellow> <gold>[time]</gold>"
weather-set-honey: "<yellow>/fioclock admin weather set honey</yellow> <gold>[time]</gold>"
weather-set-zap: "<yellow>/fioclock admin weather set zap</yellow> <gold>[time]</gold>"
weather-set-reallife: "<yellow>/fioclock admin weather set reallife</yellow>"

admin-time:
set-day: "<yellow>/fioclock admin time set day</yellow>"
set-night: "<yellow>/fioclock admin time set night</yellow>"
set-midnight: "<yellow>/fioclock admin time set midnight</yellow>"
set-afternoon: "<yellow>/fioclock admin time set afternoon</yellow>"
set-morning: "<yellow>/fioclock admin time set morning</yellow>"
set-reallife: "<yellow>/fioclock admin time set reallife</yellow>"
set-minecraft: "<yellow>/fioclock admin time set minecraft</yellow>"

admin-timemode:
set-reallife: "<yellow>/fioclock admin timemode set reallife</yellow>"
set-minecraft: "<yellow>/fioclock admin timemode set minecraft</yellow>"

admin-weather:
clear: "<yellow>/fioclock admin weather clear</yellow>"
set-rain: "<yellow>/fioclock admin weather set rain</yellow> <gold>[time]</gold>"
set-cloudy: "<yellow>/fioclock admin weather set cloudy</yellow> <gold>[time]</gold>"
set-thunder: "<yellow>/fioclock admin weather set thunder</yellow> <gold>[time]</gold>"
set-snowy: "<yellow>/fioclock admin weather set snowy</yellow> <gold>[time]</gold>"
set-sakura: "<yellow>/fioclock admin weather set sakura</yellow> <gold>[time]</gold>"
set-pale-leaves: "<yellow>/fioclock admin weather set pale_leaves</yellow> <gold>[time]</gold>"
set-obsidian-tear: "<yellow>/fioclock admin weather set obsidian_tear</yellow> <gold>[time]</gold>"
set-lava: "<yellow>/fioclock admin weather set lava</yellow> <gold>[time]</gold>"
set-honey: "<yellow>/fioclock admin weather set honey</yellow> <gold>[time]</gold>"
set-zap: "<yellow>/fioclock admin weather set zap</yellow> <gold>[time]</gold>"
set-reallife: "<yellow>/fioclock admin weather set reallife</yellow>"

# --------------------------------------------------------------------------------------------------
# [7/8] Configurable Help Messages
# --------------------------------------------------------------------------------------------------
# These lists control:
# /fioclock help
# /fioclock admin help
#
# Tokens:
# Any normal placeholder can also be used if desired ({date}, {time}, etc.).
help-messages:
player:
- "[prefix=\"false\"]"
- "[prefix=\"false\"]<yellow><bold>FioClock</bold></yellow>"
- "[prefix=\"false\"]<#7a7a7a>[Help Command]"
- "[prefix=\"false\"]"
- "[prefix=\"false\"]<yellow>/fioclock</yellow> <gold><help|placeholders|now|timezone|date></gold> <gray>- Basic info, placeholders, clock snapshot, timezone, and date</gray>"
- "[prefix=\"false\"]<yellow>/fioclock toggle</yellow> <gold><bar></gold> <gray>- Enable or disable your bossbar display</gray>"
- "[prefix=\"false\"]<yellow>/fioclock</yellow> <gold><time|weather></gold> <white>current</white> <gray>- Show current server time or weather details</gray>"
- "[prefix=\"false\"]<dark_gray>(/fioclock, /clock)"
- "[prefix=\"false\"]"

admin:
- "[prefix=\"false\"]"
- "[prefix=\"false\"]<yellow><bold>FioClock</bold></yellow> <red>(Admin)</red>"
- "[prefix=\"false\"]<#7a7a7a>[Help Command]"
- "[prefix=\"false\"]"
- "[prefix=\"false\"]<yellow>/fioclock admin</yellow> <gold><help|reload|placeholders|version|author></gold> <gray>- Main admin utilities and plugin metadata</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin timezone</yellow> <gold><toggle></gold> <gray>- Switch between primary and alternate timezone mode</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin time set</yellow> <gold><day|night|midnight|afternoon|morning|reallife|minecraft></gold> <gray>- Force specific time phase or source mode</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin timemode set</yellow> <gold><reallife|minecraft></gold> <gray>- Set global time engine mode directly</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin weather</yellow> <gold><clear></gold> <gray>- Clear forced weather and return to normal</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin weather set</yellow> <gold><rain|cloudy|thunder|snowy|sakura|pale_leaves|obsidian_tear|lava|honey|zap></gold> <white>[time]</white> <gray>- Apply custom weather (optional duration)</gray>"
- "[prefix=\"false\"]<yellow>/fioclock admin weather set</yellow> <gold><reallife></gold> <gray>- Mirror real-life weather from configured API location</gray>"
- "[prefix=\"false\"]"
- "[prefix=\"false\"]<gray>Time examples: <white>20s</white>, <white>5m</white>, <white>2h</white>, <white>1d2h30m</white></gray>"
- "[prefix=\"false\"]<dark_gray>(/fioclock, /clock)"
- "[prefix=\"false\"]"

# --------------------------------------------------------------------------------------------------
# [8/8] Placeholder Reference (Documentation Section - Not Required by Runtime)
# --------------------------------------------------------------------------------------------------
placeholder-reference:
# Time and date values
base:
- "{days}"
- "{hours}"
- "{hours24}"
- "{minutes}"
- "{seconds}"
- "{milliseconds}"
- "{ampm}"
- "{time}"
- "{date}"
- "{day_short}"
- "{day_full}"
- "{moon_phase}"
- "{moon_phase_symbol}"
- "{moon_phase_index}"
- "{x}"
- "{z}"
- "{direction}"
- "{direction_full}"
- "{timezone}"
- "{timezone_mode}"
- "{world_time}"
- "{day_phase}"
- "{time_mode}"

# Weather values
weather:
- "{weather_mode}"
- "{weather}"
- "{weather_type}"
- "{weather_duration}"
- "{temperature_c}"
- "{temperature_f}"
- "{weather_symbol}:\u2601/\uD83C\uDF27/\u26C8/\u2744/\uD83C\uDF38/\uD83C\uDF42/\uD83D\uDCA7/\uD83D\uDD25/\uD83C\uDF6F/\u26A1"
- "{is_cold_biome}:\u2745"

# Symbols
symbols:
- "{symbol}:\u2600/\u263D/\u2601/\uD83C\uDF27/\u26C8/\u2744/\uD83C\uDF38/\uD83C\uDF42/\uD83D\uDCA7/\uD83D\uDD25/\uD83C\uDF6F/\u2745/\u26A1"
- "{time_symbol}:\u2600/\u263D"
- "{symbol_day}:\u2600"
- "{symbol_cloudy}:\u2601"
- "{symbol_rain}:\uD83C\uDF27"
- "{symbol_thunder}:\u26C8"
- "{symbol_night}:\u263D"
- "{symbol_snow}:\u2744"
- "{symbol_sakura}:\uD83C\uDF38"
- "{symbol_pale_leaves}:\uD83C\uDF42"
- "{symbol_obsidian_tear}:\uD83D\uDCA7"
- "{symbol_lava}:\uD83D\uDD25"
- "{symbol_honey}:\uD83C\uDF6F"
- "{symbol_cold}:\u2745"
- "{symbol_zap}:\u26A1"

Overview
FioClock is a modern Paper plugin built for Minecraft 1.21.x, focused on immersive time and weather presentation.

It combines:
• Real-life date/time synchronization
• Minecraft-native time mode
• Rich weather control (including custom visual weather types)
• BossBar/PlaceholderAPI integration
• Admin command controls with optional timed weather states

Core Features
• Dual time mode: RealLife or Minecraft
• Date + day name + moon phase information
• Full PlaceholderAPI expansion support ( %fioclock_%)
• Configurable symbols for day/night/weather states
• Custom weather modes:
rain, cloudy, thunder, snowy, sakura, pale_leaves, obsidian_tear, lava, honey, zap, reallife
• Timed weather setting support: [time] (e.g. 20s, 5m, 2h, 1d2h)
• BossBar formatting/color/style customization
• Optional bossbar auto-display when holding:
- Clock (time/weather/date info)
- Compass (direction + X/Z)
• Toggleable player bossbar visibility
• Combo-style help messages with descriptions
• Alias support: /fioclock, /clock

Command System
Player Commands
• /fioclock <help|placeholders|now|timezone|date>
• /fioclock toggle <bar>
• /fioclock <time|weather> current

Admin Commands
• /fioclock admin <help|reload|placeholders|version|author>
• /fioclock admin timezone <toggle>
• /fioclock admin time set <day|night|midnight|afternoon|morning|reallife|minecraft>
• /fioclock admin timemode set <reallife|minecraft>
• /fioclock admin weather <clear>
• /fioclock admin weather set <rain|cloudy|thunder|snowy|sakura|pale_leaves|obsidian_tear|lava|honey|zap> [time]
• /fioclock admin weather set <reallife>

Weather Visual Effects
FioClock includes custom particle weather visuals for themed states:
• Sakura leaves
• Pale leaves
• Obsidian tear drops
• Lava drops
• Honey drops
• Cloudy water-drop ambience

For cloudy/sakura/pale_leaves/obsidian_tear/lava/honey, particles can spread across nearby chunks (2-chunk radius around the player area), not only within the current chunk.

PlaceholderAPI Support
Built-in expansion identifier: %fioclock_%

Examples:
Permissions
• fioclock.use — Player access to info/toggle commands
• fioclock.admin — Admin access to reload/time/weather control

Compatibility
✔ Minecraft 1.21.x only
✔ Paper / Purpur (API version 1.21)
✔ Optional PlaceholderAPI soft dependency

Why Use FioClock?
• Gives your server a polished, “alive” world-time experience
• Makes time/weather data visible and interactive for players
• Offers powerful admin weather/time tools with clean formatting
• Provides extensive placeholders for scoreboards, HUDs, chat, and GUIs