# FAQ

**Version:** 1.0.0

## Calendar and sign-up

### What is the difference between Join and Remind me?

**Join** signs you up: you get a plot in a contest, you count as coming to a meeting, and dates you joined remind you by default. **Remind me** only marks a date for the reminders, without signing up. A marked date reminds you even when your reminder setting is **Off**.

### Why can't I join?

- **All plots taken:** a contest takes as many players as its field has free plots.
- **Signup closed:** you can join a contest until 10 minutes after its start (`contest.lateSignupMinutes`), a meeting until its end.
- **Paused** or **Cancelled:** an admin paused the event or cancelled this date.
- **Joining not allowed:** your group lacks `ks.events.user.join`.

### Can I leave a contest?

Yes, until the build time ends. Leaving during the build time frees your plot; what you built stays. During the voting and the ceremony, leaving is closed.

### Why do I get no reminders?

- Your setting is **Only events I joined** (default) and you did not join the date: join it, mark it with **Remind me**, or switch to **All events**.
- Your setting is **Off**: only dates marked with **Remind me** remind you.
- The admin switched a channel off (**Rules** → **Channels**). Notes on the whisper stone need KyuubiSoft Whisperstone.

Each event has its own reminder times, 60, 10 and 1 minute before the start by default.

### Which time zone are the times in?

Server time. The admin can set a time zone on **Rules** (`timezone`); by default it is the server clock. The window always says "(server time)".

---

## Travelling

### Why can't I travel?

- **Travel there** opens 10 minutes before the start and closes at the end.
- You cannot travel from a dungeon or minigame. Leave it first.
- The trip starts after 3 seconds of standing still. Moving more than one block or taking damage cancels it; try again.

### Where do I land?

In a build contest on your own plot, on a safe spot near its middle. Without a plot at the event's place or in the middle of the field. At a meeting at the meeting point or the warp. While the field is being reset before a contest, you land just outside the field and can walk in once the reset is done.

**Back where I was** takes you back to where you were before your first trip to that date, until 30 minutes after its end.

---

## Build contests

### What do I need for build contests?

KyuubiSoft Claims 2.0.0 or newer with a **server zone** for the field. Without it, **Build contest** is greyed out on the **Plan** page and only meetings can be planned. Contests that are already planned are cancelled at their start with "KyuubiSoft Claims 2.0 is not available".

### Why can't I build on the field?

Building on a build field is only possible **during the build time** and **only on your own plot**. Before the start, during the voting and afterwards, nobody builds there. Your plot number is in the chat at the start, on the **Now** tab and on the event card.

### What happens to the builds after the contest?

They stay on the field as an exhibition until the next contest on that field. Five minutes before it starts, the field is put back to its saved empty state. Players on the field are taken just outside first.

### What does the empty state contain?

The blocks of the field's box: from 4 blocks below to 60 blocks above the height where the admin stood when the field was created. Chest contents and items lying on the ground are not part of it. Save the empty state while the field is really empty: **Save empty state** on the **Build field** page, or `/kseventadmin field snapshot <field>`.

Without a saved empty state the field is not reset; **Reset before the next contest** can only be switched on with one.

### The field reset failed. What now?

When the reset could not finish (for example because someone stayed on the field until the start), the contest takes the next field of the event's list, and the failed field's reset switches off. The **Build field** page says why and when. Click **Retry reset** there, or type `/kseventadmin field retry <field>`, to switch it back on. If a contest on that field starts within the next minutes, the reset runs right away.

A server restart during the reset does not count as a failure: the reset simply runs again.

### Why was a contest cancelled?

The **Results** tab and the cancel notice give the reason:

| Reason | What happened |
|--------|---------------|
| not enough sign-ups | Fewer than 2 sign-ups at the start (`contest.minParticipants`) |
| no build field was free | No field of the event was free or could be reset |
| the build field is in use | Another contest runs on the field; only one contest runs per field |
| KyuubiSoft Claims 2.0 is not available | Claims was missing at the start |
| the server was offline at the start | The server was off for the whole first phase |
| cancelled by the team | An admin cancelled it, maybe with a message |

If the server was off at the start but the first phase is not over yet, the contest still starts and keeps its planned end.

### Who may rate?

Everyone who signed up, and by default also everyone who stands on the field during the voting. Admins can limit it to those signed up (**Everyone on the field may rate**). Nobody rates their own plot. You need `ks.events.user.vote` for the rating bar.

### How is the ranking calculated?

Each plot gets the average of its votes (1 to 5), shown with one decimal. A plot needs at least 3 votes (`voting.minVotes`) to be ranked; the others are listed as "not ranked". A tie on the shown average goes to the plot with more votes, then to the earlier sign-up.

### What are suspicious votes?

Votes of players whom Events first saw less than 24 hours before the vote, and votes of players who rated at least 3 plots with only 1s and 5s. Admins see them under **Check votes** in the admin window and can strike single votes; struck votes do not count and the ranking is recalculated. With **Result only after release** on, a result with suspicious votes waits until an admin releases it.

### Who sees the names of the builders?

With **Builders anonymous until the ceremony** on (default), players see only their own plot's name until the ceremony. Admins always see the names.

---

## Meetings

### When do I count as present?

When you are within 32 blocks of the meeting point and not idle at some point in the first 5 minutes **and** at some point in the last 5 minutes. Standing still for more than 2 minutes does not count. The values are on the **Rules** page.

### How does the raffle work?

At the end of the meeting, the set number of prizes is drawn among everyone present. The winners are announced, get the raffle reward and appear on the **Results** tab. Meetings without raffle prizes have no raffle.

---

## Rewards

### Where are my rewards?

- **Items** go into your inventory. What does not fit waits on the **Results** tab; click **Collect**.
- **Titles, coins and commands** that could not be given (for example because you were offline) are tried again at your next login.
- New events have no rewards; the admin decides what each event gives.

### Can an event give coins?

Yes, when KyuubiSoft Core has an economy connected: [Kronen](https://wiki.kyuubisoft.com/hytale/core/kronen/), KyuubiSoft's own server currency, or a different economy. Without an economy coins are not paid. From Core 2.10.0 the payment carries its reason, so it shows up as "1st place · &lt;event&gt;", "Taking part", "Attendance" or "Raffle win".

### How do the trowel titles work?

The built-in template **Build contest** can reward places 1 to 3 with the titles **Golden Trowel**, **Silver Trowel** and **Bronze Trowel**. Events cannot create achievements in KyuubiSoft Achievements by itself, so:

1. In Achievements, create three **hidden manual** achievements with a title and the ids `ks_events_golden_trowel`, `ks_events_silver_trowel` and `ks_events_bronze_trowel`.
2. Events finds them and adds them to the built-in template by itself, unless an admin edited that template already.

Until then the **Plan** page shows a hint. Any other hidden achievement can be used as a **Title** reward by its id.

### Who may add command rewards?

Admins with `ks.core.admin.dialog.console` (a KyuubiSoft Core node). Commands run as the console; `{player}` becomes the player's name.

---

## Admins

### How do I change a running event?

In the admin window, **Overview**: **Next phase**, **+5 min**, **End** or **Cancel …**. The same works with `/kseventadmin next`, `extend`, `end` and `cancel`, also from the console. **End** gives the result and the rewards from what is there; **Cancel** gives no rewards and tells everyone signed up.

### How does the Season Pass boost work?

With **Season Pass XP ×2 during the event** on, Events runs Season Pass's own command `ksseasonpassadmin doublexp <minutes>` as the console when the event starts, and `ksseasonpassadmin stopdoublexp` when it ends. It needs KyuubiSoft Season Pass and Core. Season Pass has one boost for the whole server, so a boost that is already running is replaced.

### Events was removed after a crash during the build time. Can players build on the field now?

Events switches the zone's build rule in Claims on for the build time and off again at the end, at every server start (unless a build time is running) and at every stop. If the server crashes during the build time and Events is then removed, nobody switches the rule off again. Switch the build rule of that server zone off in Claims yourself.

### How do I test the field reset?

Run `/kseventadmin field selftest`, also from the console. It saves a small area high above the default world, changes it, puts it back and compares it, and writes `[Events] Field selftest PASS: ...` or `FAIL: ...` to the server log.

---

## Other mods

### Does Events work without other mods?

Yes, for meetings: with chat lines and the cards at the top of the screen, travel and attendance. Build contests need KyuubiSoft Claims 2.0. Item, coin and command rewards need KyuubiSoft Core; titles need KyuubiSoft Achievements. See [the list on the start page](https://wiki.kyuubisoft.com/hytale/events/#optional-kyuubisoft-mods).