Skip to content
Cataclysm: Bright Nights
GitHubDiscord

File descriptions

Here’s a quick summary of what each of the JSON files contain, broken down by folder. This list is not comprehensive, but covers the broad strokes.

data/json/

FilenameDescription
achievements.jsonachievements
anatomy.jsona listing of player body parts - do not edit
ascii_arts.jsonascii arts for item descriptions
bionics.jsonbionics, does NOT include bionic effects
body_parts.jsonan expansion of anatomy.json - do not edit
clothing_mods.jsondefinition of clothing mods
construction.jsondefinition of construction menu tasks
default_blacklist.jsona standard blacklist of joke monsters
doll_speech.jsontalk doll speech messages
dreams.jsondream text and linked mutation categories
disease.jsondisease definitions
effects.jsoncommon effects and their effects
emit.jsonsmoke and gas emissions
flags.jsoncommon flags and their descriptions
furniture.jsonfurniture, and features treated like furniture
game_balance.jsonvarious options to tweak game balance
gates.jsongate terrain definitions
harvest.jsonitem drops for butchering corpses
health_msgs.jsonmessages displayed when the player wakes
item_actions.jsondescriptions of standard item actions
item_category.jsonitem categories and their default sort
item_groups.jsonitem spawn groups
lab_notes.jsonlab computer messages
martialarts.jsonmartial arts styles and buffs
materials.jsonmaterial types
monster_attacks.jsonmonster attacks
monster_drops.jsonmonster item drops on death
monster_factions.jsonmonster factions
monstergroups.jsonmonster spawn groups
monstergroups_egg.jsonmonster spawn groups from eggs
monsters.jsonmonster descriptions, mostly zombies
morale_types.jsonmorale modifier messages
mutation_category.jsonmessages for mutation categories
mutation_ordering.jsondraw order for mutation and CBM overlays in tiles mode
mutations.jsontraits/mutations
names.jsonnames used for NPC/player name generation
overmap_connections.jsonconnections for roads and tunnels in the overmap
overmap_terrain.jsonovermap terrain
player_activities.jsonplayer activities
professions.jsonprofession definitions
recipes.jsoncrafting/disassembly recipes
regional_map_settings.jsonsettings for the entire map generation
road_vehicles.jsonvehicle spawn information for roads
rotatable_symbols.jsonrotatable symbols - do not edit
scent_types.jsontype of scent available
scores.jsonscores
skills.jsonskill descriptions and ID’s
snippets.jsonflier/poster descriptions
species.jsonmonster species
speech.jsonmonster vocalizations
statistics.jsonstatistics and transformations used to define scores and achievements
start_locations.jsonstarting locations for scenarios
techniques.jsongeneric for items and martial arts
terrain.jsonterrain types and definitions
test_regions.jsontest regions
tips.jsontips of the day
tool_qualities.jsonstandard tool qualities and their actions
traps.jsonstandard traps
tutorial.jsonmessages for the tutorial (that is out of date)
vehicle_groups.jsonvehicle spawn groups
vehicle_parts.jsonvehicle parts, does NOT affect flag effects
vitamin.jsonvitamins and their deficiencies

selected subfolders

data/json/items/

See below for specifics on the various items

FilenameDescription
ammo.jsoncommon base components like batteries and marbles
ammo_types.jsonstandard ammo types by gun
archery.jsonbows and arrows
armor.jsonarmor and clothing
bionics.jsonCompact Bionic Modules (CBMs)
biosignatures.jsonanimal waste
books.jsonbooks
chemicals_and_resources.jsonchemical precursors
comestibles.jsonfood/drinks
containers.jsoncontainers
crossbows.jsoncrossbows and bolts
fake.jsonfake items for bionics or mutations
fuel.jsonliquid fuels
grenades.jsongrenades and throwable explosives
handloaded_bullets.jsonrandom ammo
melee.jsonanything that doesn’t go in the other item jsons, melee weapons
migration.jsonconversions of non-existent items from save games to current items
newspaper.jsonflyers, newspapers, and survivor notes. snippets.json for messages
obsolete.jsonitems being removed from the game
ranged.jsonguns
software.jsonsoftware for SD-cards and USB sticks
tool_armor.jsonclothes and armor that can be (a)ctivated
toolmod.jsonmodifications of tools
tools.jsontools and items that can be (a)ctivated
vehicle_parts.jsoncomponents of vehicles when they aren’t on the vehicle

data/json/items/comestibles

data/json/requirements/

Standard components and tools for crafting

FilenameDescription
ammo.jsonammo components
cooking_components.jsoncommon ingredient sets
cooking_requirements.jsoncooking tools and heat sources
materials.jsonthread, fabric, and other basic materials
toolsets.jsonsets of tools commonly used together
uncraft.jsoncommon results of taking stuff apart
vehicle.jsontools to work on vehicles

data/json/vehicles/

Groups of vehicle definitions with self-explanatory names of files:

Filename
bikes.json
boats.json
cars.json
carts.json
custom_vehicles.json
emergency.json
farm.json
helicopters.json
military.json
trains.json
trucks.json
utility.json
vans_busses.json
vehicles.json