Server Events
KyuubiSoft Events puts a calendar on your server. Admins plan build contests and meetings, once or every week. Players see what is coming, sign up, get reminded and travel there with one click. In a build contest everyone builds on their own plot of a build field, then rates the other plots with one to five diamonds; the best three are celebrated with fireworks and get their rewards. At a meeting everyone who is there at the start and the end counts as present, and prizes can be drawn among them.
How it works
Section titled “How it works”- Two kinds of events. A build contest runs on a build field in phases: sign-up, build time (60 min), voting (20 min) and award ceremony (5 min). A meeting point is a place or a vanilla warp where players meet for a set time (60 min).
- The calendar.
/kseventopens the events window with a week view, the dates of the next two weeks and a detail page for each date. All times are server time. - Join or just be reminded. Join signs you up. Remind me only marks a date for the reminders. Reminders come 60, 10 and 1 minute before the start.
- Travel there. From 10 minutes before the start until the end, Travel there takes you to the event after a short warm-up; in a contest you land on your own plot. Back where I was takes you home again up to 30 minutes after the end.
- Build fields. A build field is a server zone of KyuubiSoft Claims 2.0. Events splits it into numbered plots (24 × 24 blocks with 4-block paths). Building there is only possible during the build time and only on your own plot.
- Fair voting. Everyone rates the plots from one to five diamonds, never their own. Builders stay anonymous until the ceremony. A plot needs at least 3 votes to be ranked.
- Builds stay. The finished builds stay on the field as an exhibition. Five minutes before the next contest on that field, the field is put back to its saved empty state.
- Data. Everything is stored in JSON files in the mod’s data folder. No database is needed.
Features
Section titled “Features”Calendar and sign-up
Section titled “Calendar and sign-up”- A week view with every planned date, a list of the next 14 days and a detail page with time, place, schedule and rewards.
- Events can happen once or every week on chosen days. Single dates can be skipped.
- Sign up or withdraw in the window or with
/ksevent joinand/ksevent leave. In a contest you can still sign up 10 minutes after the start while plots are free. /ksevent listshows the coming dates with numbers; the other commands take these numbers.
Reminders
Section titled “Reminders”- 60, 10 and 1 minute before the start as a card at the top of the screen, a chat line and, with KyuubiSoft Whisperstone, a note on the whisper stone that also reaches players who are offline.
- Each player chooses All events, Only events I joined (default) or Off: in the window, in
/kssettings(with KyuubiSoft Core) or with/ksevent remind. A date marked with Remind me reminds in every mode. - At the start, everyone online gets a short notice.
Travel
Section titled “Travel”- Travel there from 10 minutes before the start until the end. Standing still for 3 seconds starts the trip; moving more than one block or taking damage cancels it.
- In a contest you land on your own plot. Back where I was works until 30 minutes after the end.
- No trips from dungeons or minigames.
Build contests
Section titled “Build contests”- Build fields come from server zones of KyuubiSoft Claims 2.0. Events lays out the plots block by block, numbers them and shows a preview in the admin window. Single plots can be locked.
- The theme is fixed per event or drawn from the field’s theme list, and is announced at the start.
- During the build time, the build rule of the zone is switched on, and you can only build on your own plot. Outside the build time nobody builds on the field.
- Voting: a bar at the bottom of the screen with five diamonds that keeps the builds visible. Next plot takes you to the next plot you have not rated. You can change a vote until the voting ends.
- Ceremony: places 1 to 3 as a big title for everyone on the field, fireworks over the winning plots and a podium card at the top of the screen.
- Suspicious votes (from accounts younger than 24 hours, or only 1s and 5s) show up in the admin window, where an admin can strike them. Optionally, a result with such votes waits for an admin to release it.
- Exhibition and reset: the builds stay until the next contest on that field. The field is then put back to its saved empty state, spread over a few seconds. Players standing on the field are taken just outside first.
Meeting points
Section titled “Meeting points”- A place where you stand, or a vanilla warp.
- Present counts when you are within 32 blocks and not idle at some point in the first 5 and in the last 5 minutes.
- Optional rewards for everyone present and an optional raffle with prizes drawn among those present.
Rewards
Section titled “Rewards”- Per place 1 to 3 and for taking part (contests), for everyone present and for raffle winners (meetings).
- Items, coins (with an economy through KyuubiSoft Core, for example Kronen), console commands and titles from KyuubiSoft Achievements.
- Items that do not fit into the inventory wait in the window under Results and are collected with Collect.
- New events start without any rewards.
Event card
Section titled “Event card”- A small card at the left edge of the screen counts down the last 10 minutes before a start and shows the current phase, your plot, your voting progress or your place.
- It hides while the world map is open. Players can switch it off in
/kssettings(with KyuubiSoft Core).
Admin window
Section titled “Admin window”/kseventadmin(needsks.events.admin): an overview with the running event and live controls (next phase, +5 min, end, cancel with a message, remove participants), the coming dates, suspicious votes and the latest results, a planning page with templates, the build field page with plot preview, themes, rating rules and the empty state, and all rules.
Languages
Section titled “Languages”- 9 languages: en, de, es, fr, it, pl, pt-BR, ru, tr. Each player can pick a language with
/kslang, which all KyuubiSoft mods share.
Requirements
Section titled “Requirements”- Hytale server 0.7.x (built against 0.7.6) and Java 25.
- No other mod is required for meetings. Build contests need KyuubiSoft Claims 2.0.0 or newer.
Optional KyuubiSoft mods
Section titled “Optional KyuubiSoft mods”Events works without any of them. When one is installed, the matching part is added; the admin window and the server log show what is connected right now.
| Mod | What it adds |
|---|---|
| Claims 2.0.0 or newer | Build contests: server zones as build fields, building only during the build time and only on your own plot. Without it, only meetings can be planned |
| Core | Cards at the top of the screen in Core’s shared row, an Events tile in the /ksadmin hub, an Events page in /kssettings, item rewards, console command rewards and coins with an economy through Core (Kronen or a different economy). From Core 2.10.0, coin payments carry the reason (“1st place”, “Taking part”, …) |
| Whisperstone | Reminders and cancellations as a note on the whisper stone, also for players who are offline, and an Events tile that opens the window |
| Achievements | Titles as rewards. With three hidden manual achievements (see FAQ) the built-in template rewards places 1 to 3 with the Golden, Silver and Bronze Trowel |
| Season Pass | Optional Season Pass XP ×2 while an event runs (off by default) |
Without Core, the cards at the top of the screen still work, and notices come as chat lines when a card cannot be shown. Rewards that cannot be granted right now (the player is offline, or Core or Achievements is missing) wait for the player and are tried again; coins are only paid while an economy is connected.
Where to go
Section titled “Where to go”| Page | Read it for |
|---|---|
| Getting Started | Installing, the files, first steps for players and admins |
| Commands | Every command with syntax and permission |
| Permissions | The permission nodes and who has them by default |
| Configuration | Every option of config.json and where it is in the admin window |
| UI Pages | The events window, the rating bar, the event card, the cards at the top and the admin window |
| FAQ | Common questions about contests, voting, the field reset, attendance and rewards |
| Changelog | What changed in each version |
Quick Reference
Section titled “Quick Reference”| Item | Details |
|---|---|
| Plugin | KyuubiSoft Events (manifest kyuubisoft:events) |
| Version | 1.0.0 (not released yet) |
| Jar | KyuubiSoftEvents-1.0.0.jar |
| Player command | /ksevent (alias /events) |
| Admin command | /kseventadmin |
| Permissions | ks.events.user.open, .join, .travel, .vote (players, allowed by default), ks.events.admin |
| Data folder | mods/kyuubisoft_events/ |
| Config | mods/kyuubisoft_events/config.json |
| Required | nothing else; build contests need KyuubiSoft Claims 2.0.0 or newer |
| Optional | KyuubiSoft Core, Claims, Whisperstone, Achievements, Season Pass |