DUXPLIMA Documentation

presets.conf

The islands a player may start, and what each starts with.

Starter Presets.

This file is the list of islands a player may start with. Add a block here and the choice appears in /is create and in its suggestions.

display-name and description are catalogue keys. A key beginning with @ is looked up in the language files, so every language answers it in its own words. Write a key here, and the sentence in messages_en.conf, messages_tr.conf and every other language file you ship.

schematic is a path under the plugin's data folder: the Sponge schematic that "uxm:platform" pastes, its centre on the block players arrive standing on. The plugin writes the platform it ships to that path on its first start, so the file is there to change, with WorldEdit, FAWE or /is schematic save, and none of them needs to be installed for the island to paste. Without the file the shipped platform is laid. biome is one of the IslandBiome values, and an unknown one falls back to PLAINS.

mode is the game mode the island plays: one of the modes listed under modes below. An unknown one is skyblock.

start lists what builds the island, in order. "uxm:platform" lays the starter platform and is what a preset without a start list gets. "uxm:oneblock" sets a OneBlock island's single block, and exists while modules/oneblock.conf is enabled. "uxm:chunkblock" starts a ChunkBlock island's territory as the one chunk its centre stands in, and exists while modules/chunkblock.conf is enabled. "uxm:acid-sea" lays the acid sea around an AcidIsland island, and exists while modules/acidisland.conf is enabled. "uxm:cavern" encloses a CaveBlock island in rock with its cave carved out, and exists while modules/caveblock.conf is enabled. "uxm:skygrid" makes the island a sparse grid of blocks, and exists while modules/skygrid.conf is enabled. "uxm:boxed" makes the island a Boxed island, its box grown by advancements, and exists while modules/boxed.conf is enabled. "uxm:ocean" lays the ocean a Poseidon island lies at the bottom of, and exists while modules/poseidon.conf is enabled. "uxm:shipwreck", "uxm:ruin" and "uxm:ruins" lay the wrecks and ruins modules/poseidon.conf names, each while it is enabled. "uxm:upside-down" makes the island a StrangerRealms island and mirrors its land into the Upside Down, and exists while modules/strangerrealms.conf is enabled. "uxm:course" makes the island a Parkour course with its start plate, and exists while modules/parkour.conf is enabled. "uxm:vessel" makes the island a TradeWinds vessel on a sea of its own, and exists while modules/tradewinds.conf is enabled. A preset whose start names an action this server does not provide is not offered.

world is the world the preset's islands are made in. Leave it out and they are made in the server's island world, the one config.conf names. A mode played on land of its own names a world the server makes the usual way. Each such world is an island world: its islands are protected, kept alive and scanned there.

dimensions says how the island starts in every other dimension, by dimension id: the_nether, the_end, or one a server adds such as myserver:mining_realm. Each names its own start list and the height players arrive standing on. A preset without a dimensions block lays a platform at height 64 in the Nether and the End. One with it builds only in the dimensions it names.

dimensions {
  the_nether { start = ["uxm:dimension-platform"], height = 70 }
}

icon is the item the preset's tile wears in the window a player picks an island from, menus/island-create.conf. permission is a node a player needs to start the preset. Leave it out and every player may. Name any node you like and give it to whom you like: the tile of a preset a player may not start says it is locked. order is where its tile stands in that window, the lowest first. A preset that names none stands after every one that does.

The file is plugins/uxmSkyblock/modules/presets.conf. Every default below is the shipped value.

presets

KeyDefaultWhat it does
modesskyblockThe game modes this server offers. Only the kinds of these modes are shown in the window and made by /is create, so a classic server shows its skyblock islands and nothing else. A OneBlock server writes ["oneblock"], and a server that plays several writes each: ["skyblock", "oneblock", "chunkblock"]. "all" offers every mode. A mode left out still runs for the islands that play it already, so taking one away strands nobody. The words are the mode values the entries below name: skyblock, oneblock, chunkblock, acid_island, caveblock, skygrid, boxed, poseidon, stranger_realms, parkour, brix and tradewinds. When one kind is left to offer, /is makes it at once with no window.
defaultclassicThe preset a player who names none gets. One of a mode the line above leaves out gives way to the first kind it offers.
when-no-islandmenuWhat /is does for a player who has no island yet. "menu" opens the window of presets, menus/island-create.conf. "create" makes the default preset at once. "help" lists the commands.
create-without-typemenuWhat /is create does when no preset is written after it. "menu" opens the window of presets, "default" makes the default preset at once.

presets.preview

A look at a kind before choosing it. A right click on a kind in the window, or Preview in a Bedrock player's form, shows its start island from above as a spectator for time, then puts the player back where they stood, as they were. Each kind's start island stands in a showroom of its own: the first at x and z, the next spacing blocks further along x, laid at height y, in world, the server's island world when left blank. Pick a corner no island reaches. A spectator who drifts radius blocks from the middle is put back over it, and cannot leave for another player. cooldown is the wait between two looks. A player hurt within calm, falling or on fire cannot look, so a look is no way out of a fight or a fall.

KeyDefaultWhat it does
enabledtrue
time20s
radius48
cooldown30s
calm10s
worldempty
x-1000000
z-1000000
y100
spacing1024

presets.paste

How a schematic is put down: a preset's island, a dimension's platform and /is schematic paste alike. A paste works each chunk on the thread that owns it, blocks-per-tick positions a tick, chunks-at-once chunks at a time, so a large island spreads over ticks rather than stopping one. paste-air false leaves standing whatever the schematic's air would clear. entities and biomes say whether those saved in the file are carried.

KeyDefaultWhat it does
blocks-per-tick2048
chunks-at-once4
paste-airfalse
entitiestrue
biomestrue
presets.entries.classic.display-name@presets.classic.name
presets.entries.classic.description@presets.classic.description
presets.entries.classic.iconOAK_SAPLING
presets.entries.classic.order10
presets.entries.classic.schematicschematics/classic.schem
presets.entries.classic.biomePLAINS
presets.entries.desert.display-name@presets.desert.name
presets.entries.desert.description@presets.desert.description
presets.entries.desert.iconSAND
presets.entries.desert.order20
presets.entries.desert.schematicschematics/desert.schem
presets.entries.desert.biomeDESERT
presets.entries.nether.display-name@presets.nether.name
presets.entries.nether.description@presets.nether.description
presets.entries.nether.iconNETHERRACK
presets.entries.nether.order30
presets.entries.nether.schematicschematics/nether.schem
presets.entries.nether.biomeNETHER_WASTES
presets.entries.cave.display-name@presets.cave.name
presets.entries.cave.description@presets.cave.description
presets.entries.cave.iconDEEPSLATE
presets.entries.cave.order40
presets.entries.cave.schematicschematics/cave.schem
presets.entries.cave.biomePLAINS
presets.entries.oneblock.display-name@presets.oneblock.name
presets.entries.oneblock.description@presets.oneblock.description
presets.entries.oneblock.iconGRASS_BLOCK
presets.entries.oneblock.order50
presets.entries.oneblock.schematicschematics/oneblock.schem
presets.entries.oneblock.biomePLAINS
presets.entries.oneblock.modeoneblock
presets.entries.oneblock.startuxm:oneblock
presets.entries.chunkblock.display-name@presets.chunkblock.name
presets.entries.chunkblock.description@presets.chunkblock.description
presets.entries.chunkblock.iconMOSS_BLOCK
presets.entries.chunkblock.order60
presets.entries.chunkblock.schematicschematics/chunkblock.schem
presets.entries.chunkblock.biomePLAINS
presets.entries.chunkblock.modechunkblock
presets.entries.chunkblock.startuxm:oneblock, uxm:chunkblockThe magic block, then the one chunk around it. The chunks beside it open with the level.

presets.entries.chunkblock.dimensions

The island's Nether and End each start as one chunk on a platform, a web of their own: their chunks open the way the overworld's do, priced by the same grades, and are walled and signed apart. Take a dimension out to keep a ChunkBlock island out of it.

presets.entries.chunkblock.dimensions.acid_island

KeyDefaultWhat it does
display-name@presets.acid_island.name
description@presets.acid_island.description
iconSLIME_BLOCK
order70
schematicschematics/acid_island.schem
biomePLAINS
modeacid_island
startuxm:platform, uxm:acid-seaThe starter platform, then the acid sea around it.
presets.entries.chunkblock.dimensions.caveblock.display-name@presets.caveblock.name
presets.entries.chunkblock.dimensions.caveblock.description@presets.caveblock.description
presets.entries.chunkblock.dimensions.caveblock.iconPOINTED_DRIPSTONE
presets.entries.chunkblock.dimensions.caveblock.order80
presets.entries.chunkblock.dimensions.caveblock.schematicschematics/caveblock.schem
presets.entries.chunkblock.dimensions.caveblock.biomePLAINS
presets.entries.chunkblock.dimensions.caveblock.modecaveblock
presets.entries.chunkblock.dimensions.caveblock.startuxm:platform, uxm:cavernThe starter platform, then the rock around it with the room it stands in carved out.

presets.entries.chunkblock.dimensions.caveblock.dimensions

In the Nether and the End the island is enclosed in that dimension's own rock.

presets.entries.chunkblock.dimensions.caveblock.dimensions.boxed

KeyDefaultWhat it does
display-name@presets.boxed.name
description@presets.boxed.description
iconCOMPOSTER
order90
schematicschematics/boxed.schem
biomePLAINS
modeboxed
worldboxedGenerated land, in a world the server makes the usual way. Make a world called boxed, or name the one you have.
startuxm:boxedNothing is built: the island is the land, inside a box advancements grow.

presets.entries.chunkblock.dimensions.caveblock.dimensions.boxed.dimensions

The Nether and the End stay closed to a Boxed island until a dimension is named here.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon

KeyDefaultWhat it does
display-name@presets.poseidon.name
description@presets.poseidon.description
iconPRISMARINE
order100
schematicschematics/poseidon.schem
biomeWARM_OCEAN
modeposeidon
startuxm:platform, uxm:ocean, uxm:shipwreckThe starter platform, the ocean over it, then a shipwreck on the sea floor.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions

The Nether of a Poseidon island is flooded.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin

KeyDefaultWhat it does
display-name@presets.poseidon_ruin.name
description@presets.poseidon_ruin.description
iconCRACKED_STONE_BRICKS
order110
schematicschematics/poseidon.schem
biomeWARM_OCEAN
modeposeidon
startuxm:platform, uxm:ocean, uxm:shipwreck, uxm:ruinAs poseidon, with one big ruin further out.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions

The Nether of a Poseidon island is flooded.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins

KeyDefaultWhat it does
display-name@presets.poseidon_ruins.name
description@presets.poseidon_ruins.description
iconMOSSY_STONE_BRICKS
order120
schematicschematics/poseidon.schem
biomeWARM_OCEAN
modeposeidon
startuxm:platform, uxm:ocean, uxm:shipwreck, uxm:ruinsAs poseidon, with a ring of small ruins further out.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions

The Nether of a Poseidon island is flooded.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument

KeyDefaultWhat it does
display-name@presets.poseidon_monument.name
description@presets.poseidon_monument.description
iconPRISMARINE_BRICKS
order125
schematicschematics/poseidon.schem
biomeDEEP_LUKEWARM_OCEAN
modeposeidon
startuxm:platform, uxm:ocean, uxm:monument, uxm:shipwreckAs poseidon, standing over a sunken temple: the monument group of modules/poseidon.conf, laid from schematics/monument.schem.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions

The Nether of a Poseidon island is flooded.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms

KeyDefaultWhat it does
display-name@presets.stranger_realms.name
description@presets.stranger_realms.description
iconCRYING_OBSIDIAN
order130
schematicschematics/stranger_realms.schem
biomePLAINS
modestranger_realms
worldrealmsA world of real land the server makes the usual way, as for Boxed. Make it, or name the one you have.
startuxm:upside-downNothing is built: the island is the land, and its Upside Down is mirrored from it.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions

The Upside Down takes the place of the Nether. The End is the End.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.parkour

KeyDefaultWhat it does
display-name@presets.parkour.name
description@presets.parkour.description
iconLIGHT_WEIGHTED_PRESSURE_PLATE
order140
schematicschematics/parkour.schem
biomePLAINS
modeparkour
startuxm:platform, uxm:courseThe starter platform with the course's start plate at its edge. The team builds on from it.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.parkour.dimensions

A course has no Nether and no End.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.brix

KeyDefaultWhat it does
display-name@presets.brix.name
description@presets.brix.description
iconBRICKS
order150
schematicschematics/brix.schem
biomePLAINS
modebrix
startuxm:plotFlat ground from modules/brix.conf, which the team builds on in creative.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.brix.dimensions

A plot has no Nether and no End.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.tradewinds

KeyDefaultWhat it does
display-name@presets.tradewinds.name
description@presets.tradewinds.description
iconOAK_BOAT
order160
schematicschematics/tradewinds.schem
biomeOCEAN
modetradewinds
startuxm:vesselA sea of its own with the vessel on it, players arriving on its deck.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.tradewinds.dimensions

A vessel has no Nether and no End: it sails between ports.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.skygrid

KeyDefaultWhat it does
display-name@presets.skygrid.name
description@presets.skygrid.description
iconGLASS
order170
schematicschematics/skygrid.schem
biomePLAINS
modeskygrid
startuxm:skygridA sparse grid of blocks, with players arriving on a safe block at its centre.

presets.entries.chunkblock.dimensions.caveblock.dimensions.poseidon.dimensions.poseidon_ruin.dimensions.poseidon_ruins.dimensions.poseidon_monument.dimensions.stranger_realms.dimensions.skygrid.dimensions

The Nether and the End are grids of their own blocks.