docs/CONFIG.md

Config (config/tinfoil-common.toml)

284 words · ~1 min read

One common file, one section per system.

[statues] — Founders' colossi (concept §4.7)

keydefault
players_bk, schnopsamuel, CrackedSkeletonX, HakeemVelasquez, rusharoothe Founders: player names statues are made of
scale1blocks per skin pixel (1 → 32 tall, 2 → 64, 3 → 96)
ruinedChance0.5chance a generated statue is ruined
defaultSchemetinfoil:atlantean_marblematerial scheme (data/<ns>/tinfoil/statue_schemes/*.json)
fetchSkinstruelook skins up online; cached in <world>/tinfoil/skins/
blocksPerTick4096statue placement speed

Further sections are added by their issues (legacy remap, folds, anomalies, mystery).

Legacy id remapper

On by default; aliases come from mod/src/main/resources/tinfoil/legacy_ids.json (porter legacy). It has to be active while registries are built, before configs load, so it is switched off with a JVM flag instead of a config key: -Dtinfoil.legacyRemap.disabled=true (only after /tinfoil scan is clean and every imported chunk has been re-saved).

[folds], [islands], [anomalies]

sectionkeydefault
foldsbandWidth32blocks around a mask the fold may reshape
foldsfallsPer100Blocks1.5waterfalls per 100 blocks of cliff edge
foldsovergrowth1.0vines, moss, signal moss, plants density
foldsruinSpacing40blocks between ruin pieces (0 = none)
foldschunksPerTick2fold job speed
islandsenabledfalseAncient Islands in new overworld chunks (set true on our server). They need structure generation on in the world (generate_features); /tinfoil islands explains what blocks them
anomaliesflybys / flybyChancetrue / 0.01saucer lights at night, per player per 10 s
anomaliescropCircles / cropCircleChancetrue / 0.15crop circle near a player at dawn
anomaliescropCirclesInFarmsfalseallow flattening farmland and crops
anomaliesbermudaCompasstruecompasses spin near Bermuda stone (client)