ShadowOneBlock

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 - including another island module of the suite pointed at the same MySQL.

true = the items listed in starter_chest.yml go straight into the inventory of whoever creates the island. There is no starter CHEST in a oneblock, because there is nowhere to stand one: the island is a single block hanging in the void. Set it to false for a server where players start with literally nothing.

How much empty space is cleared around the block when an island is created, in blocks. It matters in one case, but it is a case that happens: a grid slot handed to a new island before the clean-up of the previous one has finished, which without this would drop the new player inside somebody else's leftovers. 0 to 8.

How far the phase's biome is painted around the block, in blocks. A biome is written one block at a time, so covering a whole island would mean hundreds of thousands of writes at every phase change - a server freeze everybody would notice. Around the block is also the only place it is really needed: it is what colours the sky and the water and decides which mobs the game itself will spawn. 0 switches biomes off entirely.

The most living creatures allowed within 8 blocks of the block before it stops adding more. The block's mobs do NOT go through Minecraft's own population limit - that one covers natural spawning, while these are put there by the plugin - so without a ceiling a phase at full mob-chance, tripled by the Swarm mutation, turns an island into a crowd nobody is obliged to clear. It is a safety net, not a tuning knob: raise it only if you know your server can carry it.

true = when creating an island, players first pick a starting structure from island_schematics/ (needs WorldEdit or FastAsyncWorldEdit, and it is a Premium feature). Whatever the structure builds, the plugin then clears a pocket of air at the centre and puts the block there, so the structure can never bury it.

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.

Name of the world given over to oneblock. 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 /ob 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 /ob 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, /ob 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. /ob 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 oneblock 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.

How many rows each /ob top leaderboard shows.

With true, no thunderstorms in the oneblock 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.

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.

The real floor of the Hub.schematic pasted here is at Y133 (checked block by block): below it there is a decorative solid mass down to Y105 and then a pocket of air, not a floor to stand on. 101 was wrong: a player put there floats in the void above that pocket, and the game "corrects" it by looking for solid ground, making them appear at Y133 as if teleported (a reported bug, fixed here).

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 /ob 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.

The language the plugin speaks to players in. It names a file inside plugins/ShadowOneBlock/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 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 /ob bank deposit|withdraw and from the bank menu.

How many movements the bank menu keeps available in its history (/ob 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.

false = infusion is off server-wide. /ob infuse says so and stops there.

How many breaks of duration each item handed over is worth.

The ceiling on duration, however many items are handed over.

Fewest items that will start an infusion at all. Below this the menu shows the affinity greyed out, with how many are missing.

Most items taken in one go. Anything past this stays in the inventory: it is what stops somebody dumping a double chest of iron into one infusion.

The wait after an infusion ENDS before another can start, in seconds. 0 removes it. Counted from the end and not from the start, so a long infusion is not also a long wait.

How much strength each item adds. Strength is what multiplies the weight of a boosted material: at 1.0 a material already in the phase comes up twice as often, at 3.0 four times as often.

The ceiling on strength. Past it, more items only make the infusion last longer - which is deliberate: it turns "hand over everything you own" into a choice about duration rather than a way to break the loot table.

The weight a material that the current phase does NOT have gets when it is added to the table. This one number is what makes infusion interesting rather than a small nudge, so it is worth understanding: the injected weight is this value times the infusion's strength. With 4.0 and a strength of 2.0 an absent material joins the table at weight 8 - a real presence next to the phase's own entries, without drowning them.

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 oneblock world.

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

false = the block does not come back at all. Only useful while you are rewriting this file on a live server and would rather nobody advanced meanwhile.

Put down if a phase somehow ends up with no valid block at all. It should never happen; it exists so that a mistake leaves a broken table rather than a hole in the world.

true  = after the last phase the island starts again from the first one,
        keeping its total block count. Endless mode.
false = the island stays on the last phase for good. Its rewards are handed
        out once, at the moment it gets there, and never again.

The progress bar over the hotbar, redrawn at every break. Off for a server that would rather keep the action bar for something else.

Announce a new phase in chat to the island's online members.

Ticks to wait before putting the block back. 1 is the tick straight after the break: the player standing on it drops a twentieth of a second, which is not visible. Raise it only to make breaking deliberately slower; 0 is not recommended (the break is still being applied on that tick, and the server would place a block into a spot it is about to clear).

How many phases are put to the vote. 2 to 7 (they are the middle slots of the menu). Three is the sweet spot: enough of a choice to argue about, few enough to read at a glance.

How long the vote runs. It closes early on its own as soon as every ONLINE member has voted, so this is the wait for the ones who are away, not the wait for the ones who are playing.

How many votes the owner's counts for. 2 breaks a tie in a small island without letting them decide alone in a full one. 1 = everybody equal.

How far down the list the draw may reach, starting from the phase that just ended. 1 would make the draft pointless (only one candidate, the next one); large numbers let an island leap deep into the file, which makes for a wilder server.

true = phases the island has already been through can come up again. Turn it on for an endless server where phases are places to revisit rather than steps to climb.

false = the vote is on the phase alone, with no mutation attached.