Tiki
docs/modpack-devs.md

For modpack makers

1542 words·~7 min read

Everything in Tiki is data: config, tags, a data map, worldgen entries, loot tables and a loot modifier. A datapack or KubeJS can change all of it.

Config

config/tiki-common.toml (all options in CONFIG.md). The ones packs usually touch:

optionwhat for
[islands] enabledno Tiki islands at all; existing ones stay
[islands] hutsislands without the hut and its chest
[islands] beachPalmsno palms on vanilla beaches
[islands] reefssand and rubble round the islands instead of living coral
[compat] overlaplessPreciseIslandswith Overlapless: judge island groups by their whole box, as for any structure

How often islands start and in which biomes is data, not config: see the structure set below.

Tags

tagholdsused for
#tiki:palm_logs (block, item)palm log, wood, stripped log, stripped woodthe palm planks recipe; leaves decay next to them
#c:logs/palm (item, block)#tiki:palm_logs (log, wood, stripped of both), and when present Regions Unexplored's, BWG's and Productive Trees' own palm log tagsTiki's statue, totem and lashed post (while [palm] useOtherModLogs is on); add your pack's palm logs here
#c:planks/palm (item, block)Tiki's palm planks and the same mods' palm planksTiki's statue, signpost, basin, fountain and handbook (the same switch)
#tiki:tiki_palm_logs, #tiki:tiki_palm_planks (item)Tiki's own palm and dark palm logs and planksthe same pieces while [palm] useOtherModLogs is off
#tiki:reef/coral_blocks, corals, coral_fans, coral_wall_fans, rock (block)the coral and reef rock the island reefs are built from, paired by position (the n-th coral block goes with the n-th coral and fan)swap the reef's look; keep the five lists the same length
#tiki:has_structure/tropical_island (biome)warm, lukewarm and deep lukewarm ocean, and #minecraft:has_structure/ocean_ruin_warmwhere island groups may start
#tiki:has_feature/beach_palm (biome)minecraft:beachwhere beach palms grow
#tiki:cocktail/lime, citrus, tropical, mint, cinnamon, nutmeg, allspice, anise, magic, vicious (item)each cocktail role gathered from the c: tags ATM10's mods use (cinnamon is spread over three tags, mint has none: Herbs and Harvest's and MineColonies' mint by id), every entry optionalthe Tide Bar's ingredient profiles and recipes; add your pack's mint or spices here
#tiki:vessels (item)the mugs, the coconut cup, the hurricane glass, the hollow pineapple, the volcano bowl and a glass bottlewhat the brewer's bowl pours into
#tiki:servable (item)the vessels (and, later, the drinks)what can be set down on a counter, four to a block
#tiki:garnishes, #tiki:bar_tools (item)what seals a drink (lime wheel, mint sprig, paper umbrella, cherry pick, pineapple wedge, spice dust, orange peel, the hibiscus); the shaker, bar spoon and swizzle stickthe brewer's bowl
#tiki:syrups (item)the ten bar syrupsrecipes that take any syrup
#tiki:rums (item)white, gold, dark and ember rumrecipes that take any of Tiki's rums
#tiki:rum_cask_heat (block)the magma blockwhat turns a rum cask's dark rum into ember rum, besides a lit campfire; add your pack's heaters
#c:crops/coconut, #c:fruits/coconut (item)Tiki's coconut, beside every other mod'sother mods' coconut recipes take Tiki's coconut (Pam's Piña Colada reads #c:crops/coconut)

To give islands to another biome, add it to the biome tag in a datapack:

// data/tiki/tags/worldgen/biome/has_structure/tropical_island.json
{ "replace": false, "values": ["mymod:coral_lagoon"] }

Data maps

data/neoforge/data_maps/item/compostables.json: Tiki's plants and the coconut compost like their vanilla counterparts (leaves 0.3, flowers, ferns and the coconut 0.65). A pack overrides an entry like any data map.

data/tiki/data_maps/item/mixer_profile.json: what one part of an item brings when it is poured into the Tide Bar's brewer's bowl. Keys are items or tags (#c:fruits/lime covers every mod's lime). The defaults cover vanilla, Tiki and about 70 c: tags ATM10's mods fill; a tag no mod fills matches nothing.

// data/mypack/data_maps/item/mixer_profile.json
{ "values": {
  "#c:fruits/yuzu": { "sour": 3, "spice": 1, "colour": "#f5e05a", "density": 1 },
  "mymod:void_berry": { "magic": 2, "vicious": 2, "colour": "#3a1a5a", "effect": "minecraft:levitation" }
} }
fieldrangemeaning
sour, sweet, strong, weak, spice, magic, vicious0 to 5, default 0the part's share of each role; the brewer's balance is "one of sour, two of sweet, three of strong, four of weak"
colour#rrggbb, requiredthe colour it pours, not the item's
density-5 to 5, default 0heavier (sugar) sinks, lighter (alcohol) floats: the order of layers
flammabledefault falsea float of it can be lit
effectan effect id, optionalwhat a House Special made with it leans towards; ignored when the effect isn't registered
prioritydefault 0where an item is in two profiled tags, the higher priority wins; an item's own entry always beats a tag. Tiki's broad tags (#c:foods/fruit at -2, #c:foods/berry and #c:drinks/juice at -1) yield to specific ones

Datapack registries and data files

whatidfile
Island structure, structure set (spacing 28, separation 12, 6 chunks clear of ocean monuments)tiki:tropical_islanddata/tiki/worldgen/structure/, structure_set/
The hut (jigsaw pool and template)tiki:island/huts, tiki:island/hut_smalldata/tiki/worldgen/template_pool/island/, data/tiki/structure/island/
The palm tree (trunk 7 to 12, crown, coconuts)tiki:palmdata/tiki/worldgen/configured_feature/palm.json
The black palm (the same shape, dark wood, black nuts)tiki:dark_palmdata/tiki/worldgen/configured_feature/dark_palm.json
Palm on sand, beach palmtiki:palm, tiki:beach_palmdata/tiki/worldgen/placed_feature/
Biome modifiers: beach palms (only while beachPalms is on), no vanilla ocean oaks in island biomestiki:add_beach_palms, tiki:remove_water_treesdata/tiki/neoforge/biome_modifier/
The hut chest's loot (2 or 3 codex pages among it)tiki:chests/island_hutdata/tiki/loot_table/chests/island_hut.json
Medici's appraisal of the bar's goods (rums, molasses, moonwater, syrups, bitters, limes; read only with Medici)—data/tiki/medici/appraisal/tiki.json; a pack's own file with the same keys overrides it (docs/MEDICI.md §2.5)
What Medici's Merchant asks for most: gold and dark rum#medici:merchant_wishes (item tag, merged)data/medici/tags/item/merchant_wishes.json
Create's recipes for the bar: heated mixing for molasses and the syrups, milling for crushed ice (only with Create)tiki:create/mixing/, tiki:create/milling/crushed_icedata/tiki/recipe/create/
A codex page naming a random drink of the pack (a loot function; leaves out the vicious shelf while it is off)tiki:random_codex_pageuse it on tiki:codex_page in any loot table
The advancement that unlocks a drink's entry in the Ink Codex (no display; granted when the drink is learned)tiki:codex/ (another namespace's drink: tiki:codex//)data/tiki/advancement/codex/
The Tiki rod's catches (swapped in for vanilla's fishing loot by the loot modifier)tiki:gameplay/fishing/tiki_rod (+ _fish, _treasure)data/tiki/loot_table/gameplay/fishing/
Loot modifier for the rodtiki:tiki_rod_fishingdata/tiki/loot_modifiers/tiki_rod_fishing.json

A palm trunk may grow to 12 logs at most (base_height + height_rand_a + height_rand_b): an island's box has room for no more, and a taller one is refused when the data pack loads. The coconut decorator's fruit must be a block with a hanging property (tiki:coconut_block, tiki:dark_palm_nut).

Copy a file from the jar into a datapack at the same path to change it. To stop beach palms without the config, override data/tiki/neoforge/biome_modifier/add_beach_palms.json with {"type": "neoforge:none"}.

Drinks (tiki:cocktail)

The Tide Bar's drinks are a datapack registry: data//tiki/cocktail/.json. A file may carry neoforge:conditions (neoforge:mod_loaded), so a drink that needs a mod's item loads only with that mod.

{
  "name": "cocktail.mypack.void_swizzle",
  "pours": [
    { "ingredient": { "tag": "tiki:rums" }, "parts": 1 },
    { "ingredient": { "item": "minecraft:ender_pearl" } },
    { "ingredient": { "tag": "tiki:cocktail/lime" } }
  ],
  "dashes": 0, "ice": "crushed", "method": "swizzle",
  "vessels": ["tiki:hurricane_glass", "tiki:squid_tiki_mug"],
  "seal": { "item": "tiki:mint_sprig" },
  "min_rum": 0, "colour": "#1d6b5b", "strength": 2,
  "effects": [
    { "id": "minecraft:slow_falling", "duration": 600 },
    { "id": "occultism:third_eye", "duration": 1200, "optional": true }
  ],
  "flags": { "vicious": true }, "codex": 40, "price": 20
}
fieldmeaning
namethe translation key of the drink's name
poursthe ingredients in the recipe's order (strong first, sweet after), each with its parts (default 1). A pour's item must fill one of these; every one must get at least one part
dashes, ice (none, cubes, crushed), method (build, stir, shake, swizzle)the rest of the build
floatan ingredient poured after the method
vesselsitems or a tag the drink belongs in
sealthe garnish
min_rumthe youngest rum it takes without losing quality: 1 white, 2 gold, 3 dark, 4 ember
colour, strengththe drink's colour; how strong (0 to 6)
effectsid, duration in ticks at quality 50 (half at 0, one and a half at 100), amplifier, optional (dropped when the effect isn't registered)
flagsvicious, night, punch (a punch also fits a volcano bowl, without listing it, and serves four there)
codex, priceits number in the Ink Codex; its price for bar orders

Recipes

All recipes are vanilla crafting types and can be replaced or removed by id (tiki:<item>) with a datapack or KubeJS's event.remove({ id: 'tiki:coconut_block' }). Create's saw recipes for Tiki's wood are Create's own, generated when it loads (create:runtime_generated/compat/tiki/…).