For modpack makers
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/ (all options in CONFIG.md). The ones packs usually touch:
| option | what for |
|---|---|
[islands] enabled | no Tiki islands at all; existing ones stay |
[islands] huts | islands without the hut and its chest |
[islands] beachPalms | no palms on vanilla beaches |
[islands] reefs | sand and rubble round the islands instead of living coral |
[compat] overlaplessPreciseIslands | with 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
| tag | holds | used for |
|---|---|---|
#tiki:palm_logs (block, item) | palm log, wood, stripped log, stripped wood | the palm planks recipe; leaves decay next to them |
#c:logs/ (item, block) | #tiki:palm_logs (log, wood, stripped of both), and when present Regions Unexplored's, BWG's and Productive Trees' own palm log tags | Tiki's statue, totem and lashed post (while [palm] useOtherModLogs is on); add your pack's palm logs here |
#c:planks/ (item, block) | Tiki's palm planks and the same mods' palm planks | Tiki'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 planks | the same pieces while [palm] useOtherModLogs is off |
#tiki:reef/, 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/ (biome) | warm, lukewarm and deep lukewarm ocean, and #minecraft:has_structure/ | where island groups may start |
#tiki:has_feature/ (biome) | minecraft:beach | where beach palms grow |
#tiki:cocktail/, 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 optional | the 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 bottle | what 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 stick | the brewer's bowl |
#tiki:syrups (item) | the ten bar syrups | recipes that take any syrup |
#tiki:rums (item) | white, gold, dark and ember rum | recipes that take any of Tiki's rums |
#tiki:rum_cask_heat (block) | the magma block | what turns a rum cask's dark rum into ember rum, besides a lit campfire; add your pack's heaters |
#c:crops/, #c:fruits/ (item) | Tiki's coconut, beside every other mod's | other mods' coconut recipes take Tiki's coconut (Pam's Piña Colada reads #c:crops/) |
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/: 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/: 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/ 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" }
} }
| field | range | meaning |
|---|---|---|
sour, sweet, strong, weak, spice, magic, vicious | 0 to 5, default 0 | the 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, required | the colour it pours, not the item's |
density | -5 to 5, default 0 | heavier (sugar) sinks, lighter (alcohol) floats: the order of layers |
flammable | default false | a float of it can be lit |
effect | an effect id, optional | what a House Special made with it leans towards; ignored when the effect isn't registered |
priority | default 0 | where 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/ at -2, #c:foods/ and #c:drinks/ at -1) yield to specific ones |
Datapack registries and data files
| what | id | file |
|---|---|---|
| Island structure, structure set (spacing 28, separation 12, 6 chunks clear of ocean monuments) | tiki:tropical_island | data/, structure_set/ |
| The hut (jigsaw pool and template) | tiki:island/, tiki:island/ | data/, data/ |
| The palm tree (trunk 7 to 12, crown, coconuts) | tiki:palm | data/ |
| The black palm (the same shape, dark wood, black nuts) | tiki:dark_palm | data/ |
| Palm on sand, beach palm | tiki:palm, tiki:beach_palm | data/ |
Biome modifiers: beach palms (only while beachPalms is on), no vanilla ocean oaks in island biomes | tiki:add_beach_palms, tiki:remove_water_trees | data/ |
| The hut chest's loot (2 or 3 codex pages among it) | tiki:chests/ | data/ |
| Medici's appraisal of the bar's goods (rums, molasses, moonwater, syrups, bitters, limes; read only with Medici) | — | data/; 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/ |
| Create's recipes for the bar: heated mixing for molasses and the syrups, milling for crushed ice (only with Create) | tiki:create/, tiki:create/ | data/ |
| 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_page | use it on 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/ |
| The Tiki rod's catches (swapped in for vanilla's fishing loot by the loot modifier) | tiki:gameplay/ (+ _fish, _treasure) | data/ |
| Loot modifier for the rod | tiki:tiki_rod_fishing | data/ |
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/ with {"type": "neoforge:none"}.
Drinks (
tiki:cocktail)
The Tide Bar's drinks are a datapack registry: data/. 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
}
| field | meaning |
|---|---|
name | the translation key of the drink's name |
pours | the 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 |
float | an ingredient poured after the method |
vessels | items or a tag the drink belongs in |
seal | the garnish |
min_rum | the youngest rum it takes without losing quality: 1 white, 2 gold, 3 dark, 4 ember |
colour, strength | the drink's colour; how strong (0 to 6) |
effects | id, duration in ticks at quality 50 (half at 0, one and a half at 100), amplifier, optional (dropped when the effect isn't registered) |
flags | vicious, night, punch (a punch also fits a volcano bowl, without listing it, and serves four there) |
codex, price | its 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/).