Protection raids

Raids give every protection a number of lives. Enemies take them by hitting the core and by killing members inside it. A protection with no lives left is raidable for a while: enemies may break, place and open containers in it, and anybody may walk in. Once the raid ends, the protection gets a life back and a cooldown during which it cannot lose any.

Raids are off by default. Turn them on with submodules.raids in modules/protections/config.yml; every setting on this page sits under raids in that file. For the protections themselves (tiers, roles, flags, the backends) see Protections.

Who counts as an enemy

A player is an enemy of a protection unless they are:

• the owner,
• a member, including through a clan added to it and a tenant renting the whole protection,
• a clan ally of the owner, while allies-are-friends is true (the default) and a clan plugin is installed.

Only enemies damage a core, take lives through kills, and get the raid permissions below. Anybody else who breaks the core is refused as usual. When the owner breaks it, the core is picked up, as always.

Lives

A protection's maximum lives are its tier's lives plus the bonus-lives of its level, while upgrades are on (see Protection economy). The maximum is never below 1. Lowering a tier's lives in the config caps the lives protections already hold.

Growing back. A life grows back every regen-minutes, up to the maximum. The clock starts when the first life is lost, not when the protection was made. Unfinished progress is kept: with 60 minutes a life, a protection that lost two lives has one back after 60 minutes and both after 120. Nothing grows back during a raid.

Buying one back. Any member clicks the lives button of the protection's menu to buy one life for restore-price, in restore-currency (see Economy). It is refused while the protection is raidable or already full. It is allowed during the cooldown.

Lives are stored with the protection, so they are the same on every server of a network.

The core's health

An enemy who breaks the core does not break it. The core takes damage instead, and it loses a life once its health runs out.

Every hit deals at least 1. At the defaults, one life costs 150 hits with an empty hand, or 38 with a netherite pickaxe, and a hit counts at most once every half second. When health reaches 0 the protection loses a life and the core starts again at full health.

The action bar reads ⚔ Core » %health%/%max_health% ┃ Lives » %lives%/%max_lives%. It also takes %name% and %owner%.

A core's health is kept only in the memory of the protection's server. A restart heals it, which changes little because a quiet core heals after 30 seconds anyway.

Kills

The victim must be the owner or a member, killed inside that protection by an enemy player. The offline shield never applies to a kill, since the victim was online. Siege windows, a raid already running and the cooldown still do.

When lives cannot be taken

A hit or a kill takes nothing, and the attacker is told why, when:

1. raids are off,
2. the protection is already raidable,
3. it is in the cooldown after a raid,
4. siege windows are on and none is open,
5. for a hit only: the offline shield is up.

The attacker sees these messages at most once every two seconds.

The raid

Taking the last life starts the raid.

While it lasts:

• Every player with raid announcements on is told that %raider% raided %name% and for how long it is open. Players switch this in their preferences, the raid-announcements setting.
• Enemies have the raidable-permissions inside, whatever the roles say.
• Anybody may enter, whatever the lock or the bans say.
• Everybody standing inside sees a red boss bar, ⚔ %name% is raidable » %time_left% ⌚, draining as time runs out. It also takes %owner% and %raider%.
• The protection cannot be picked up, moved, deleted, sold, given away, offered for rent or upgraded. A sale already listed is cancelled. The same refusal applies while its core is damaged and not yet healed.
• Member perks stop and its public warp is hidden or refused.

When time runs out, the protection has lives-after-raid lives and starts its cooldown. The server ends raids once a second. Short of the last life, each lost life is told to the attacker and to every defender online on that server.

Siege windows

With windows on, lives can only be lost at the times you choose.

raids:
  siege-windows:
    enabled: true
    timezone: "Europe/Madrid"
    windows:
      - "SATURDAY 18:00-22:00"
      - "FRIDAY 23:00-02:00"
      - "DAILY 12:00-12:30"

A window is a day in English (MONDAY to SUNDAY), or DAILY for every day, then HH:MM-HH:MM. The start is inside the window and the end is not. A window that ends before it starts runs past midnight into the next day: FRIDAY 23:00-02:00 is open on Saturday at 01:30. Lines that cannot be read are skipped.

When a window opens or closes, every player with raid announcements on is told. A raid that started inside a window runs its full raidable-minutes, even past the window's end. With effects.no-flight-during-siege on, member flight stops while a window is open.

The offline shield

The shield stops a core from being hit while nobody who defends the protection is online.

The defenders are the owner and the members, plus the members of added clans when clan-members-count is on. A defender online on the protection's server, or one who left it less than grace-minutes ago, keeps the shield down.

On a network, the other servers are asked next, about the first 32 defenders. If none of them is online anywhere, the shield is up. If the answer does not come, the shield stays up and the land stays protected. The grace only counts players who left this server.

The shield blocks hits on the core only, not kills.

Raid states

The lives button of the protection's menu and %exyliasurvivalcore_protections_raid_state% show one of five states, checked in this order:

The same menu button shows the core's health, the time left of a raid or cooldown, and the restore price.

Placeholders

These read the protection the player stands in, and are blank outside one or while raids are off.

Admins set a protection's lives, or clear its raid, from the admin menu. The in-game tier editor writes a tier's lives. See Administering protections.