Hosting manual

The manual for EE Icarus Server Core 1.15.2.

Switches

A switch is one rule that a claim enforces inside its rectangle: no PvP, no mob damage, no building, and so on. Every claim has the same fifteen switches. The server owner decides which of them claims on this server are allowed to use, and the holder of each claim decides which ones are on and who they apply to. This page explains how to set a switch and what each one does.

Setting a switch

You set a switch with the flag command, naming the claim, the switch and whether the activity is allowed:

/claim flag <id> <switch> on|off

The switch word names an activity, and the last word says whether that activity is allowed inside the claim. So pvp off means no PvP inside, and pvp on means PvP is allowed. For the three meter switches it reads the same way: hunger off means your hunger does not go down inside the claim. If you are used to the older words deny and allow, they still work and mean the same as off and on.

/claim flag kolb weather off

Requested: kolb, weather blocked.

kolb: weather blocked.

The first line is the server accepting the change, and the second is the portal confirming it a few seconds later. From then on, storms do no damage inside the claim.

The fifteen switches

Switch word What off stops Who it applies to unless you say otherwise
pvp everything a player does to another player or to the claim's tames: weapons, arrows, thrown things, explosives, and attacks by a player's tame everyone
mobs everything a wild creature does to a player or to the claim's tames, including fish everyone
weather storm damage to players and the claim's tames from wind and lightning, exposure damage, and all cold and heat everyone
spawns wild creatures appearing inside the claim; the world's own spawns are moved just outside the edge, and a nest's or a trap's spawn is refused nobody in particular
hunger (or food) your food meter going down while you are inside everyone
thirst (or water) your water meter going down while you are inside everyone
air (or oxygen) your oxygen meter going down while you are inside, even under water everyone
traversal being inside the claim at all; anyone it applies to is moved back outside the edge the moment they step in, along with their tames and mounts strangers
damage every hit the mod can see on the claim's buildings and deployables, whoever or whatever deals it: players (you and your members too), tames, creatures, explosions, storms and fire (see what the switches cannot do) everyone without the bypass, whatever the audience says; on a claim held by the server, everyone
building placing a deployable or a building piece inside; it is taken down within a second and the item goes back into the player's backpack. A cable or pipe laid inside with the Electricity Tool, the Water Pipe Tool, the Biofuel Pipe Tool or the Crude Oil Piping Tool is taken down the same way, with nothing to give back because those tools use nothing up (built, not yet tried on a server) strangers
use opening doors, gates and windows, using crafting stations, beds and seats, mounting, taming or petting a creature, and picking up a placed deployable strangers
containers opening a chest, crate, cupboard, fridge or any other storage strangers
pickup picking up an item lying on the ground inside strangers
decay food spoiling in packs, containers and saddlebags, ripe crops wilting, and storms killing crop plots, for everything that stands inside (No decay) nobody in particular: it is about things, not people
drop dropping an item while standing inside, whether by dragging it out of the inventory or with the drop key strangers

Six of the switches cost Ren a day on top of the claim's land: pvp, mobs, weather, hunger, thirst and air, the ones that look after the player. The owner sets each price on the rules page, and the rest are free. Paying the upkeep explains it.

A single door, chest, bench or bed can also carry a level of its own. For that one object, use and containers go by its level instead of the audience, so you can let visitors through the front door and keep every other door shut. Doors and chests explains how to set one.

There used to be another switch, falls, for fall damage. It is withdrawn: a claim cannot stop fall damage.

When you make a claim with /claim name, every switch the owner allows starts out blocking, with four exceptions that start out allowed: traversal, pickup, drop and decay. So a new claim's buildings are protected by damage from the start, as long as the owner allows that switch.

Note

The three meter switches do not feed you. They stop the meter from going down while you are inside. If you walk in hungry you stay hungry until you eat, eating and drinking still raise the meters as usual, and once you step outside they go down again as they always did.

Who a switch applies to

Every switch applies to a group of people, which the game calls its audience. You can change it by adding a fifth word to the command: everyone, members (you and the claim's members), holder (you alone), non-members (everyone except you and your members) or non-holders (everyone except you). If you leave the word out, the audience stays as it was. The spawns switch has no audience, because it is about creatures rather than people, and the damage switch ignores it, because it stops everyone's hits on the claim's buildings.

/claim flag kolb pvp off non-members

With that setting, you and your members can fight each other inside the claim, but a stranger who attacks anyone inside is stopped. The claim's buildings and deployables are the damage switch's, so this setting does not change who can hit them.

Exactly what "applies to" means depends on the kind of switch:

  • For pvp, it is the attacker who is judged when the target is a player or a tame. A tame's attack counts as its owner's. pvp does nothing for buildings and deployables.
  • For mobs and weather, it is the player being hit who is judged. The covered tames are protected no matter what the audience is.
  • For damage, nobody is judged: while it is off, nobody can damage the claim's buildings and deployables, and that includes you and your members. Working on your own base explains how you take down your own wall.
  • For building, use, containers, pickup and drop, it is the player doing the thing who is judged. With the usual setting, strangers, you and your members can do all of it. A door or chest with a level of its own goes by that level instead.
  • For hunger, thirst and air, it is the player whose meter it is.
  • For traversal, it is who gets put out. Setting it to everyone closes the claim to everybody except the owner and admins, and that includes you.

The owner and the admins hold the claims bypass, which means no switch stops them while their bypass is on, whatever the audience says. That includes damage: with their bypass on, their hits on a claim's buildings land, which is how a base is taken down.

A claim held by the server is the exception. The bypass does nothing there, on or off, and the owner and the admins are judged like any other member of the server: a switch stops them wherever it would stop a stranger, damage stops everyone's hits, and traversal set to everyone closes the claim to them too.

Working on your own base

While damage is off, your own hits on the claim's buildings and deployables are stopped like anyone else's, and you get the same "no damage here" line. There are two ways to work on your base:

  • If you hold the claims bypass (the owner and the admins do), keep it on. With your bypass on, your hits land on your own base while damage keeps protecting it from everyone else. /claim bypass tells you whether yours is on.
  • If you do not hold the bypass, allow damage in the claim with /claim flag kolb damage on while you work, and block it again with /claim flag kolb damage off when you are done. While damage is allowed, anyone can damage the claim's buildings, and so can creatures and storms, so block it again as soon as you have finished.

The claim's spawn point

The claim's spawn point is not a switch, but it has an audience in the same way. Stand where you want it and type /claim flag <id> spawn here. From then on, a player the point applies to (your members, unless you change it) who dies inside the claim comes back at that point instead of at their bed or dropship. /claim flag <id> spawn on its own removes the point. A player can also have a spawn point of their own, for a death anywhere: see Your own spawn point.

What the switches cannot do

  • Some world events destroy structures directly rather than damaging them, and damage cannot stop that. Nor can it stop a shield's returned damage. A burning building stops losing health while damage is off, though the piece keeps burning and can still light its neighbours.
  • World bosses, hordes and missions bring their own creatures, and spawns does not stop them. Neither does it stop a creature that simply walks in from outside; mobs deals with that one.
  • A cable or pipe counts as standing where it was started. So building does not stop one that is started outside the claim and laid into it, even when it ends at a device inside, such as a generator.
  • drop does not stop the Drop and Drop all buttons on the inventory menu.