ShadowAcidIsland

Appended to the JDBC connection string.

true = you can open the file with DBeaver while the server is running.

true = when MySQL is configured but does not answer, the plugin falls back to the local database instead of refusing to start. Set it to false only if you would rather have a failed start than islands saved in the wrong place.

Prefix put in front of every table the plugin creates. Useful when the same database is shared with other plugins or services. KEEP IT DIFFERENT from the other island modules of the suite (ShadowSkyBlock uses "ssb_"): two game modes sharing one MySQL database must not share their tables, or one mode's islands end up inside the other's.

Starting radius of an island, in blocks from its centre.

Distance between the centres of two islands side by side on the world grid. It has to be more than twice the largest radius reachable, or neighbouring islands could touch and their protections overlap.

The height (Y) islands are generated at. In this mode it is not a free number: it has to sit ABOVE "acid.world.sea-level" further down, or the starting island is generated underwater and a new player drowns in acid the moment they arrive. Sea level 100 + 1 = 101 puts the island's grass exactly one block clear of the water, which is the classic look.

Name of the world given over to acidisland. Created if it is not there.

From which deletion the wait kicks in (2 = the first is free, from the second onwards there is a wait).

Mobs that break or change blocks: creepers, endermen, ghasts, sheep eating grass, villagers farming.

Natural spawning of hostile mobs inside the island. Spawners, eggs and breeding stay allowed even with this off.

Natural spawning of animals and other passive mobs inside the island.

Whether players can hit each other on the island.

Fire spreads and eats blocks.

Player explosions (TNT, beds in the Nether) break blocks.

Leaves cut off from a log decay on their own.

Dying on your OWN island does not cost you your inventory. See "allow-keep-inventory-choice" below: whether the owner gets to choose it, or whether it stays locked to this value for everybody.

With false, the "keep-inventory" rule above is locked for the whole server: the button disappears from the Island Rules menu and only the default just written counts, ignoring whatever owners had saved before. With true (the default) every island turns it on and off for itself.

With true, the owner - or a member holding SET_HOME - can move with /island sethome the exact spot the island brings them back to: respawn after death, falling into the void under the island, coming back from a private portal and /island home all point there instead of the island's centre. With false the command is off and the centre is always used.

With true, every time a player is brought back to their island's home - death, a fall into the void, the way back from a private portal, /island home - the plugin first clears every item lying on the ground of that island: no mess and no lag piling up over time. CAREFUL: it only touches items on the ground, never what is inside a chest or any other container, but it destroys them for good even when they were left there on purpose (a swap between members, say). Turn it off if you would rather tidy up by hand.

With true, a Nether portal lit on an island really does lead to the server's Nether (the one tied to the "island.world-name" world).

With true, an End portal or gateway lit on an island really does lead to the server's End.

When allow-nether/allow-end are false (the default), every island gets a small PRIVATE platform in the Nether and in the End instead, inside two void worlds shared by all the islands - not one world each, far too heavy. They are reached through a real portal lit on your own island (12 Ender eyes for the End, exactly as usual): the plugin builds both the platform and the way back, already lit. /island end stays a direct shortcut, handy before a real End portal has been built.

Radius of the two private platforms (2 = 5x5, 4 = 9x9), each on its own.

Materials the private platform and portal are built from. Each has to be a valid Bukkit Material name ("NETHERRACK", "END_STONE", "OBSIDIAN"); a misspelt one is reported in the log and the default is used.

The name of a file inside plugins/WorldEdit/schematics/ (WorldEdit or FastAsyncWorldEdit needed) to paste in place of the plain flat platform, centred on X/Z over the centre of the private structure, its base at the right level, the FIRST time that island needs one. Leave it empty ("") for the classic flat platform, which is always available even without WorldEdit. In the Nether every non-air block pasted is recoloured using "private-nether-block-mix" below; in the End the schematic is left exactly as you made it, with no portal added by the plugin.

A horizontal radius used ONLY to work out whether the schematic was already pasted once, since its real size is unknown until it is pasted the first time: it has to cover at least half the width of your structure. Ignored when no schematic is configured, where the flat platform's own radius is used instead.

Dying in the private Nether or End does not cost the inventory. This is a server-wide switch, not a per-island one like "default-rules.keep-inventory" above, and it ships on because death in those two dimensions is nearly always a fall, not a risk the player chose to take.

Below this Y - in the main island world, or on a private Nether/End platform - a falling player is put back at the home of THEIR island, or at spawn when they have none, instead of falling through the void forever. It does not cover the hub area, which has its own threshold in spawn.region.min-y. Keep it BELOW "acid.world.sea-bottom-y": with an ocean floor there is nothing left to fall into, and a value inside the sea would teleport away anybody who swims deep enough instead of only somebody falling.

How many rows each /island top leaderboard shows.

OFF here, unlike the skyblock this mode comes from, and on purpose: a bucket of water is a gift only where there is no water. Here the player is standing in the middle of an ocean and can fill a bucket anywhere - what the acid takes away is the SAFETY of that water, not the water. Turn it on if you would rather have the block already placed next to the chest.

The material forced under a player's feet when they first appear at the centre of an island made from a SCHEMATIC - not the classic platform above. The highest solid block found there (leaves ignored, so a tree over the centre does not spawn them in the canopy) is replaced with this, so the spawn is always the same predictable block instead of whatever the schematic happened to put exactly in the middle.

With true, no thunderstorms in the acidisland world. Weather in Minecraft belongs to a whole world rather than to one area, so this covers all of "world-name", islands included; but since every island still has its own PERSONAL weather (see island.default-rules above, shown to that player only), real lightning stays a nuisance worth switching off here.

The master switch. With false the ocean is ordinary water and this plugin behaves exactly like the skyblock it comes from - useful to compare, or to run the island engine without the mode on top of it.

How often the plugin looks at who is standing in the acid, in ticks. 10 = twice a second. Lower is not "more damage", it is more damage ticks: raise "damage" to hurt more, lower this only if half a second of grace after diving in feels too generous.

Damage per check, in half-hearts (2.0 = one full heart). At the default settings a player with no protection loses about two hearts a second.

With true the damage ignores armour, which is what makes the protective suit and the purifier worth having: without it a diamond set alone would already answer the whole mode. With false acid behaves like any ordinary damage and armour soaks it up.

Bubbles and a hiss when the acid bites. Pure feedback, no gameplay.

The water inside the hub area (see the "spawn.region" section) does not burn. Leave this on unless you know why you are turning it off: the hub sits at sea level, so anybody who steps off its edge lands in the water, and a floating player never sinks far enough for the hub's own safety net to fetch them back - they would just burn next to spawn, usually before they even have the leather suit. The acid starts where the hub ends.

How many island points a harvested acid crystal is worth (see acid_tides.yml). 0 = crystals pay money and items only.

Acid rain: standing in the open while it rains hurts too. A roof - even a single slab - is enough to stop it, and an island set to "always clear" from /island rules does not take it (what a player sees is what hurts them).

OFF out of the box, and not out of caution: with this on, every animal that wanders into the sea dies and leaves its drop, so the world slowly fills with items nobody put there. Fish, squid, dolphins and guardians are always spared - they live in this water, and burning them would make sea farming impossible in a mode made of sea.

A boat keeps you out of the water, so it keeps you out of the acid.

The hazmat suit. Wearing "armour-pieces-for-immunity" of these makes a player immune; wearing fewer does NOT reduce the damage, on purpose - three pieces out of four has to be a problem to solve, not a discount to shrug at. Leather is the classic choice: cheap enough to be the first real goal of a new island, and useless in a fight.

Potion effects that make a player immune while they last.

What the acid leaves behind besides the damage. "none" for nothing. A short slowness is the point: being caught in the open water has to be harder to escape than to enter.

Y of the last water block: the first block of air is one above. "island.height" has to be above this or islands generate underwater.

Y of the first water block from the bottom. The default gives a sea sixty blocks deep, which reads as bottomless while you are swimming in it and costs a fraction of an ocean drawn from the world floor.

The liquid the sea is made of. WATER is the mode; put LAVA here and you have written a different game, which is allowed.

A single layer right under the sea, at "sea-bottom-y" - 1. BEDROCK on purpose: it closes the world downwards - no endless fall, no void-catch firing at somebody who is only diving - and gives away nothing. Sand or stone here would hand every player an infinite mine and end the island economy in an afternoon. Leave it empty ("") for a bottomless ocean with the void underneath.

Only decides the colour of the water, which in a mode built around the sea is not a detail: a frozen ocean and a tropical one tell two different stories.

NOTE: to stand in the middle of block X=-500 the right value is -499.5, not -500.5 (a Location rounds down: -500.5 falls in block -501). Always check it this way when changing these numbers: you want block N, you write N + 0.5, never N - 0.5.

One block above sea level, so the hub platform sits flush with the water instead of floating over it: the plugin builds that platform at y - 1 (see ensureSpawnPlatform), which lands exactly on the surface of the acid. Raise both this and "region.min-y" together if you would rather have the hub high above the sea.

The name of a file inside plugins/WorldEdit/schematics/ (WorldEdit or FastAsyncWorldEdit needed) pasted here automatically - centred on X/Z, its base at "y" - the FIRST time the block at these coordinates is still air. It is the same check used for the safety platform under spawn, which is indeed skipped when something is written here. Leave it empty ("") for the plain quartz platform. To change it or paste it again later, use /island admin pasteschem rather than editing this value, which only counts on the first start.

Material and radius of the plain safety platform built under spawn when "schematic" above is empty. Ignored when it is set.

IMPORTANT: it has to sit BELOW the "y" above, the floor players walk on, or they are teleported at every step instead of only when they really fall out of the structure. The plugin never lets it go past "y - 1" anyway, as a safety net. Here it doubles as the "the acid spat you back out" line: somebody who falls off the edge of the hub sinks a few blocks and is returned to spawn rather than being left to swim.

The language the plugin speaks to players in. It names a file inside plugins/ShadowAcidIsland/lang/, so "en" reads lang/en.yml and "it" reads lang/it.yml: the plugin ships these two, English by default.

Days of grace before the licence stops counting when a subscription has just run out or the address does not match - far more often a NAT or a proxy than a theft. 0-60.

Base address of the activation service. The plugin appends /claim and /check itself. Empty = manual activation with a key only.

Asks the ShadowMC licence service which public address this server has: activation-url + /ip, or https://shadow-licences.riccardobotins.workers.dev/ip while activation-url is empty. It answers with the address it sees, and nothing about the server is sent. It is the only reliable way to know from behind a NAT, and it is what makes a licence sold for "play.example.net" work on a machine whose local addresses are all 10.x. false = never ask. Only when a licence is installed: a server without a key asks nobody.

The address this server is known by, when it differs from the ones it can see for itself. Only needed when a licence looks tied to another address despite being the right one.

The master switch for the whole cycle.

The bar at the top of the screen with the phase in progress and how long is left of it. Only shown to players inside the island world: to anybody else the tide does nothing, and a bar that does not concern them would take the space of one that does.

Announce a phase change in chat, and warn before it happens.

How many seconds before a phase ends players are told what is coming. This is the number that makes the tide fair: a punishment nobody saw coming is unfair, one you watched approach is a choice. 0 = no warning.

The block a crystal is made of. Pick something that glows and that nobody would mistake for part of a build.

How many can exist at once around one island. The cap is per island, so a big server does not end up with a sea of lanterns.

How often the plugin tops each island back up to that cap.

Crystals never form closer than this to the island's centre: the point is to make the player swim for it, and one that surfaces on the doorstep is picked up without ever entering the water.

Paid to the player who harvests it, not to the island bank: the person who swam into the acid is who took the risk.

Drawn at random, one per crystal, on top of the money. Leave the list empty for money only.

The ShadowEconomy currency island money is counted in: bank, costs, rewards and the balance placeholders. Leave it empty ('') for ShadowEconomy's default currency. A name ShadowEconomy does not have falls back to the default one, with a warning in the console. Vault has a single currency, so with Vault this setting is ignored.

Starting balance of the shared bank when an island is created.

Smallest and largest amount for a single deposit or withdrawal, both from /island bank deposit|withdraw and from the bank menu.

How many movements the bank menu keeps available in its history (/island bank -> History). Display only: every transaction is stored in the database for good either way.

Used only when a prestige has no valid material (a config typo): this way the generator never stops working altogether.

The master switch for this scoreboard.

Only read when "enabled" above is true. It says WHERE a board that shows shows, and a board that is off has nothing to place: with "enabled: false" this scoreboard appears nowhere, whatever is written here.

true  = only in the island world (island.world-name in config.yml)
false = in every world. Use it only once ShadowEssentials' own board is off,
        or the two overlap outside the acidisland world.

What a player who has never chosen from /island settings (or /island scoreboard) sees the first time they join.

Below which tide drain multiplier the bubble keeps its full radius. With the default cycle only "alta marea" (1.5) and "tempesta acida" (3.0) go past 1.0, so the bubble is full size for two thirds of the hour and visibly tightens for the rest - which is a warning a player reads without reading anything. Set it very high to make the radius fixed and have the tide affect the drain alone.