Tiki
docs/CONFIG.md

Config

1220 words·~6 min read

Tiki has three config files:

  • config/tiki-common.toml: one per installation, read when the game starts, so a change needs a restart. It holds the island worldgen and how Tiki behaves next to other mods. Pack makers ship it in config/.
  • world/serverconfig/tiki-server.toml: one per world, sent to every player who joins. It holds the Tide Bar's rules. Pack makers ship defaults in defaultconfigs/.
  • config/tiki-client.toml: each player's own. What one player sees.

All three can be edited in game: Mods → Tiki → Config.

Common: [islands]

Tropical islands and island groups. A change applies to islands that start after it; islands already saved keep the shape they were saved with.

How often islands start is not a config key: it is the structure set, which a datapack can override. Copy data/tiki/worldgen/structure_set/tropical_island.json from the jar into a datapack and change spacing (28: one try per 28 × 28 chunks), separation (12: two starts at least 12 chunks apart; keep it 10 or more, a group's box is up to 10 chunks wide) or the exclusion_zone (no island within 6 chunks of an ocean monument). Where they may start is the biome tag tiki:has_structure/tropical_island (warm, lukewarm and deep lukewarm ocean, and every biome in #minecraft:has_structure/ocean_ruin_warm). The biome modifier tiki:remove_water_trees keeps vanilla's ocean oaks off the islands. Change these before the world is made: chunks that already exist keep their islands, new chunks follow the new numbers.

keydefaultwhat
enabledtruetropical islands in warm and lukewarm oceans; off, none start and existing ones stay
hutstruea tiki hut on each new island (on the main island of a group)
decorationstrueplants on the islands: hibiscus, plumeria, bird of paradise, palm fronds, ferns and fallen coconuts, and the totem pole or carved stone head on some hills; off, palms only (the coconuts hanging in them are part of the tree)
seashellstrueseashells along the island beaches by the waterline (needs decorations); read when an island group starts
reefGlowtrueglow anemones on the reef and jellies over its wall (needs reefs); read when an island group starts
pineapplestruewild pineapples on the islands' grass now and then (needs decorations); read when an island group starts
treasuretruea chest buried on each group's main island and messages in bottles on the beaches; read when an island group starts
darkPalmstrueabout 1 palm in 5 on a new island is a black palm; off, coconut palms only. Saved with each island, so a change applies to new ones
beachBandWidth3sand beach width in blocks; a group narrows it if the smallest main island would have no room for its hill
palmsPerIsland12palms on an island of radius 12; a group scales each island by area (radius 22: 40, radius 4: 1)
groupstruea group per start: a main island with a hill and the hut, plus islets across channels; off, one island from the three keys below
minRadius, maxRadius8, 16single islands only (groups = false): radius in blocks
peakHeight8single islands only: top in blocks above the sea (small islands stay lower)
mainMinRadius, mainMaxRadius16, 22main island radius in blocks; below 16 the hill steps 3
mainMinPeak, mainMaxPeak8, 10the hill's top in blocks above the sea; lowered (never under the min) so no step is over 2
shoulderHeight3the main island's shoulder and the hut's pad, in blocks above the sea; kept under mainMinPeak
minIslets, maxIslets1, 4islets around the main island
isletMinRadius, isletMaxRadius4, 10islet radius in blocks; kept under mainMinRadius
isletMinPeak, isletMaxPeak1, 4islet top in blocks above the sea (small islets stay lower)
minChannel, maxChannel3, 8water between islands, coast to coast, in blocks
reefFlatstruejoin neighboring islands by reef flats (sand bars a block under the water, walked across) or channels (2 to 3 deep, swum); off, only the islands' own shallows
flatChance0.4share of neighboring islands joined by a reef flat; the main island's nearest neighbor always is, and gaps under 4.5 blocks are too narrow for a channel
reefstruea coral reef round each group: coral on the reef's crest and spurs, reef rock down its wall, heads, fans and sea pickles; off, sand, gravel and rubble only
beachPalmstruepalms on vanilla beaches too (biome tag tiki:has_feature/beach_palm, vanilla's beach): on sand within 3 blocks of water, about one try in 4 chunks; read when a world loads, off keeps existing palms

Common: [palm]

keydefaultwhat
useOtherModLogstrueTiki's own pieces (statue, totem, signpost, water basin, fountain, lashed palm post, handbook) take any mod's palm planks and logs through #c:planks/palm and #c:logs/palm; off, Tiki's own palm and dark palm wood only (#tiki:tiki_palm_planks, #tiki:tiki_palm_logs; recipes tiki:<name>_tiki_palm). The palm wood set (stairs, slabs, doors…) always takes Tiki planks so it never clashes with the palm mods' own recipes. Read when data packs load (world start, /reload)

Common: [compat]

keydefaultwhat
overlaplessPreciseIslandstruewith Overlapless: a group is skipped only if an earlier structure reaches its land or shallows, and later structures are kept off its land and shallows only; off, Overlapless decides by the group's whole box

Server: [cocktails]

The Tide Bar's drinks (docs/plans/tide-bar.md §6).

keydefaultrangewhat it does
dailyStrongDrinks20 to 20strong drinks (strength 2 or more) a player may have in a Minecraft day; the next brings a 60 s hangover ("the Pufferfish's due"). 0 turns the rule off
viciousDrinkstrue—the vicious shelf (pufferfish, wither roses, ender pearls and worse): a strong drink now, a bill of effects a minute or two later, never lethal. Off: these drinks can't be mixed, vicious ingredients give a House Special no effect, and no codex page names them
hideUnknownRecipesfalse—recipe viewers (JEI) show a drink's ingredients only once the player knows it (from a codex page or by mixing it). Read by the JEI plugin; off by default, so nobody who looks recipes up is punished

Server: [bar]

The order rail. With Medici it pays from Tiki's purse tiki:bar and never mints.

keydefaultrangewhat it does
orderstrue—the order rail posts orders. Off: it hangs there quietly
ordersPerDay31 to 6tickets a rail posts each day: the decree's day with Medici (turning at 06:00 server time), a Minecraft day without
orderPayScale1.00 to 10scales what a filled ticket pays, price × count × quality / 100 × this, in pennies. With Medici the street pool still caps it; without, it scales the XP
hintPrice80 to 10000pennies a codex hint costs at the rail, charged into Tiki's purse. Without Medici a hint costs one level of experience. 0 makes hints free

Client: [cocktails]

keydefaultwhat it does
tipsySwaytrueat Tipsy III and above the camera sways a little. Turn it off if moving cameras make you feel unwell; Tipsy's luck and steadiness stay