Time Changes

⏰ Time Change Handling

VotingPlugin uses Java’s LocalDateTime with ZoneId.of() to handle time-based features — like daily, weekly, and monthly resets.

---

⚙️ Configuration Options

🕐 Time Offset

You can shift the plugin’s internal time relative to your system clock:

TimeHourOffSet: 0

Examples:

• TimeHourOffSet: -6 → Runs 6 hours behind system time
• TimeHourOffSet: 2 → Runs 2 hours ahead of system time

---

📅 Weekly Offset (6.19.1+)

You can shift the weekly reset by a number of days using:

TimeWeekOffSet: 0

Examples:

• TimeWeekOffSet: 1 → Moves the weekly reset 1 day later
• TimeWeekOffSet: -2 → Moves the weekly reset 2 days earlier

---

🌍 Time Zone (6.13+)

You can define a specific time zone in Config.yml using standard Java zone IDs.
VotingPlugin validates these using ZoneId.of("YourZoneHere").

TimeZone: 'UTC'

This is useful when you want weekly resets to start on a different weekday than the default (Monday). The offset is applied after timezone and hour offset adjustments.

For example, if your server’s week normally resets Monday at midnight and TimeWeekOffSet: 2, the weekly reset will now occur Wednesday at midnight instead.

✅ Common Working Examples

Example	Description
'UTC'	Universal Coordinated Time
'America/Regina'	Central Canada (no daylight savings)
'America/New_York'	Eastern Time (auto daylight savings)
'America/Los_Angeles'	Pacific Time
'Europe/London'	United Kingdom
'Australia/Sydney'	Eastern Australia
'Asia/Tokyo'	Japan

Use one of the above examples or check the IANA timezone list for your region.
If invalid, Java will throw an error when loading.

---

🧭 Checking Plugin Time

You can view the time VotingPlugin is currently using:

/av CurrentPluginTime

---

🧨 Forcing Time Changes

To manually trigger a time change (for testing):

/av forcetimechange (TimeType)

Valid types:

• DAY
• WEEK
• MONTH

Example:

/av forcetimechange MONTH

Must be run from console.

---

🚫 Skipping Time Changes on Startup

If you need to skip automatic time changes when the server starts,
set this in ServerData.yml:

IgnoreTime: true

---

✅ Summary

Setting	Description
TimeHourOffSet	Adjusts time by a set number of hours.
TimeZone	Uses a valid Java Zone ID to define your region.
IgnoreTime	Skips time-change events on startup.
/av CurrentPluginTime	Displays plugin time.
/av forcetimechange	Forces daily/weekly/monthly reset.