DUXPLIMA Documentation

Configuration

Every file the plugin writes, reloading, and what an update does to your files.

Every file is HOCON: key = value, blocks in braces, # comments. Each file explains itself in its comments; these pages list every key with its shipped default.

Reloading and updating

/is reload reads the theme, the language files, the menus and the OneBlock phases again. Everything else is read at start: change it and restart.

Each start adds to every file the keys a new release brought, and changes no value you wrote. The file as it was is kept beside it as <file>.bak, and the last five copies under backups/. A key you deleted stays deleted. To turn something off, use its switch rather than deleting it.

The files

PageFile
config.confThis server, the grid, language, storage, player state, notifications, roles, homes, the REST API, backups, the leaderboard, menu sounds
modules.confWhich parts of the plugin run
commands.confThe words of /island and /isadmin
text-input.confHow a menu asks a player to write something
theme.confColours, glyphs and small capitals
Messagesmessages/messages_<language>.conf
LanguagesThe seven languages and how a player's language is chosen
Menu filesmenus/*.conf
OneBlock phasesoneblock/phases/*.conf
Loot tablesloot/*.conf

Module files

PageWhat it sets
acidisland.confAcidIsland: the acid sea, acid rain, clean water and the vent
alliances.confAllied islands: visits, chat and how many allies an island keeps
anti_abuse.confStarter item farming: new islands and second accounts
bank.confThe island bank: currencies, interest, refunds and upkeep
biomes.confWhich biomes an island may take, and what it must reach first
boosters.confTimed boosts to spawners, crops, the generator, drops and experience
boxed.confBoxed: the box, its growth, its side and what growth costs
brix.confBrix: creative plots, the plot sky and build contests
caveblock.confCaveBlock: the rock, the room and its tunnels
chat.confIsland chat, ally chat and who may listen in
chunkblock.confChunkBlock: the magic block, the unlock ladder and chunk prices
dimensions.confThe Nether and the End of an island: own, shared or none
discord.confDiscord webhooks for milestones, boards, alliances and staff actions
effects.confWhat every interaction fires: sounds, particles, titles and lines
fly.confFlight on a player's own island
generators.confWhat the cobblestone generator makes at each tier
inactivity.confArchiving and deleting islands whose team stopped playing
interactables.confWhich blocks count as doors, switches, containers and workstations
island-effects.confThe potion effects upgrades put on players on the island
levels.confIsland worth and level: block values and the level curve
lifecycle.confResets, deletion and recycling of islands
limits.confThe most of each costly block and creature one island holds
missions.confIsland missions: daily, weekly and challenges, and their pay
oneblock.confOneBlock: the block, its phases, the progress bar and branches
parkour.confParkour: courses, runs, checks, ghosts, ratings and seasons
performance.confHow fast islands are cleared and put back
player-state.confWhat a player carries in each kind of world
poseidon.confPoseidon: the sea floor island, breath, lore and the deep boss
presets.confThe islands a player may start, and what each starts with
protection.confRules that keep players from losing what they cannot get back
rewards.confThe reward inbox for rewards a player could not be handed
seasons.confSeasons: length, boards and season rewards
settings.confThe island edge and islands with no member online
shop.confThe island shop: items, prices and how prices move
skygrid.confSkyGrid: the grid of lone blocks and its chests
social.confRatings and the guestbook
stacking.confStacked blocks and how they count
strangerrealms.confStrangerRealms: real land with an Upside Down
temporary-access.confTrust: letting a visitor build for a while
trade.confTrading between players in one window
tradewinds.confTradeWinds: the vessel, ports, markets, contracts and piracy
upgrades.confIsland upgrades: every upgrade, its tiers and their prices
vault.confThe shared island vault and its pages
visitors.confWhat visitors may do, and the visit fee
walls.confThe walls between islands
warps.confIsland warps: how many, categories and who may open them
webmap.confIslands drawn on a web map
world.confThe island world: spawn height, the spawn and starter structures