Skip to content

Reference

Key-by-key documentation for every Lost Cities asset type, read against 7.4.12, Minecraft 1.20.1. code review

Every type except the Profile is datapack JSON living at data/<namespace>/lostcities/<type>/<name>.json. The Profile is config, at config/lostcities/profiles/<name>.json. See Namespaces if that path looks wrong. game test

The chain

The Profile sits outside the datapack system and names a world style. The six datapack types below it compose from the top down, each naming the next. The Content Model walks the same chain with a worked example. code review

# Page code review Folder What it decides
0 Profile (config) Which world style a dimension uses, plus 131 generation settings
1 World Style worldstyles/ Which city styles appear, and where
2 City Style citystyles/ The theme: palettes, building, street and park settings, and which buildings exist
3 Style styles/ Which palettes are merged, rolled per slot
4 Building buildings/ Which parts stack, per floor and per cellar
5 Building Part parts/ The block grid itself, 16 by 16 by 6
6 Palette palettes/ What each character means

Break a link in that chain and the failure throws rather than passing quietly, though where it surfaces depends on which link broke. Namespaces has the three cases. game test

When a key appears to do nothing

Key Interactions collects the cases where one key is gated, overridden or outranked by another. A correctly set key that produces no change is usually one of those rather than a mistake in the file. code review

Supporting types

Optional, and worth reaching for once the chain above works.

Page code review Folder What it is for
Variant variants/ A reusable weighted block list, named from a palette
Condition conditions/ A weighted table that picks a value based on where you are
Multi-Building multibuildings/ One structure spanning several chunks
Scattered Building scattered/ Standalone structures out in the wilderness
Stuff Object stuff/ Small decorative extras placed by scanning columns
Predefined City and Sphere predefinedcities/, predefinedspheres/ Pin a city or sphere to exact coordinates

Together the two tables cover all 13 registries the mod creates, so no asset type is missing from this reference. code review

Reading these pages

Each page opens with a TL;DR, then a key table, then the behaviour the keys alone do not tell you.

No number in any of these files is validated

Nothing in the mod range-checks a value, in an asset or in a profile. Every range these pages document is the window the mod was designed around, not a rule it enforces, and an out-of-range value loads silently and is used as written. code review

validate.py checks the rules that can be checked outside the game.

Three pages carry most of the traps and are worth reading before writing anything:

See also