# Changelog

# Changelog

## v1.0.0 — 2026-11-10

First version: build contests and meetings for your server. Not released yet and not tested in game.

- **Event calendar.** `/ksevent` opens the events window: a week view with every planned event, the next two weeks at a glance, and a detail page for each event with time (server time and "in 4 days"), place, rewards and the sign-up state.
- **Two kinds of events.** **Build contests** with build time, voting and ceremony, and **meetings** at a place or a vanilla warp, with optional attendance rewards and a raffle among everyone who was there. Events can repeat every week on chosen days, and single dates can be skipped.
- **Join, remind me, travel.** Sign up with "Join", or mark an event with "Remind me" just to get the reminders. From 10 minutes before the start you can travel there with a short warm-up (moving or taking damage cancels it); in a contest you land on your own plot. "Back where I was" takes you home again up to 30 minutes after the end. Neither works from inside a dungeon or minigame.
- **Reminders your way.** 60, 10 and 1 minute before the start as a notice at the top, a chat line and a Whisperstone note (also offline). Choose "All events", "Only events I joined" or "Off" in the window, in `/kssettings` or with `/ksevent remind`.
- **Build contests on a real field.** An admin turns a Claims server zone into a build field; Events splits it into numbered plots with paths. Building is only possible during the build time and only on your own plot. The theme is announced at the start.
- **Fair voting.** Rate every plot from one to five diamonds in a bar at the bottom of the screen that keeps the builds visible; "Next plot" takes you to the next one you have not rated. Your own plot is left out, you can change your vote until voting ends, and builders stay anonymous until the ceremony.
- **Ceremony.** Places 1 to 3 are announced with a big title for everyone on the field, fireworks rise over the winning plots, and the podium is shown at the top of the screen. The "Results" tab keeps podiums, all places, attendance and raffle winners.
- **Builds stay on display.** The finished builds remain on the field until the next contest. Five minutes before it starts the field is put back to its saved empty state, spread over a few seconds. Anyone standing on the field is first taken just outside and told why; nothing is changed while somebody is still on it. Travelling to the contest before or while the field is reset takes you straight to that spot next to the field. A server restart during the reset does not switch it off: it simply runs again.
- **Event card.** A small card at the left edge counts down the last 10 minutes and shows the current phase, your plot and your voting progress. It hides while the world map is open and can be switched off in `/kssettings`.
- **Rewards.** Per place, for taking part, for attendance and for raffle winners: items (what does not fit waits in the window until you collect it), coins when the server has an economy, console commands and titles from KyuubiSoft Achievements. New events start without any rewards.
- **Coin rewards say what they were for.** With KyuubiSoft's server currency, [Kronen](https://wiki.kyuubisoft.com/hytale/core/kronen/), a coin reward appears in the history as "1st place · &lt;event&gt;", "Taking part", "Attendance" or "Raffle win", in the reader's language.
- **Admin window.** `/kseventadmin` (needs `ks.events.admin`): an overview with the running event and live controls (skip phase, +5 minutes, end, cancel with a message, remove participants), upcoming dates, suspicious votes to review and strike, planning with templates, the build field with a plot preview, locked plots, themes and the empty-state snapshot, and all rules in one place.
- **Season Pass boost.** Optionally doubles Season Pass XP while an event runs (off by default).
- **Works with other KyuubiSoft mods.** Build fields and build protection with Claims 2.0, notices, the `/ksadmin` hub tile and the settings page with Core, notes and an "Events" tile with Whisperstone, titles with Achievements, the XP boost with Season Pass. Events also runs without any of them; build contests need Claims 2.0.
- **Nine languages:** de, en, es, fr, it, pl, pt-BR, ru and tr – every text follows the player's language.

### Good to know

- **Save the empty state first.** A field is only reset when its empty state was saved (button in the admin window or `/kseventadmin field snapshot <field>`). Chest contents and items lying on the ground are not part of it. `/kseventadmin field selftest` checks the reset on a small test area and writes the result to the server log.
- **When a reset fails.** If a field could not be put back (for example because someone stayed on it until the start), its reset switches off and the build field page says why and when. "Retry reset" there, or `/kseventadmin field retry <field>`, switches it back on; if a contest on that field starts within the next few minutes, the reset runs right away and anyone on the field is taken off it first.
- **Too few sign-ups.** A build contest with fewer than 2 sign-ups at the start is cancelled and everyone who joined is told; the display of the last contest stays. Meetings always take place. The minimum can be changed in the rules.
- **Attendance at meetings** counts when you are within 32 blocks and not idle at some point in the first and in the last 5 minutes.
- **Trowel titles.** Achievements cannot be created by another mod. To reward places 1 to 3 with the Golden, Silver and Bronze Trowel, create three hidden manual achievements with a title and the ids `ks_events_golden_trowel`, `ks_events_silver_trowel` and `ks_events_bronze_trowel`; Events then adds them to the built-in "Build contest" template by itself.
- **Commands.** `/ksevent` (also `/events`) with `list`, `join`, `leave`, `remind`, `travel`, `back`, `vote` and `help`; `/kseventadmin` with `start`, `next`, `extend`, `end`, `cancel`, `reload`, `field` and `help`, also from the console. Player rights `ks.events.user.open`, `join`, `travel` and `vote` are open by default.
- **Server time.** Event times use the server's time zone unless the rules set another one.