Index

Cross-Reference Index

This index provides quick lookup for all documented systems, tables, types, and concepts across the Civ VII Modding API documentation.

Quick Navigation

• By Topic
• Database Tables
• Type Kinds
• Effect Types
• Collection Types
• Requirement Types
• Common Modding Tasks

---

By Topic

Civilizations & Leaders

Topic	Primary Doc	Related Docs
Civilization definition	Civilizations	Types
Leader definition	Leaders	Civilizations
Unique abilities	Civilizations, Leaders	Modifiers
Starting bias	Starting Bias	Map-Terrain
AI behavior/agendas	AI Behavior	Leaders
Civilization colors	Art Assets	Civilizations

Units & Combat

Topic	Primary Doc	Related Docs
Unit creation	Units	Types
Unit abilities	Units	Modifiers
Promotions	Promotions	Units
Great People	Great People	Units
Combat stats	Units	Promotions
Spy units	Espionage	Units

Buildings & Districts

Topic	Primary Doc	Related Docs
Building creation	Buildings	Types
Building yields	Buildings	Modifiers
District placement	Buildings	Map-Terrain
Wonders	Buildings	Victory

Technology & Civics

Topic	Primary Doc	Related Docs
Technology tree	Technology Trees	Types
Adding technologies	Technology Trees	Modifiers
Civic tree	Civic Trees	Types
Traditions (policies)	Civic Trees	Modifiers
Governments	Governments	Golden Ages
Tech boosts	Technology Trees	Modifiers

Victory & Legacy

Topic	Primary Doc	Related Docs
Victory conditions	Victory Conditions	Legacy Paths
Legacy paths	Legacy Paths	Victory
Age transitions	Legacy Paths	Era Score
Legacy points	Era Score	Legacy Paths
Golden ages	Era Score	Governments
Dark ages	Era Score	Legacy Paths

Maps & Resources

Topic	Primary Doc	Related Docs
Map scripts	Maps & Resources	JavaScript
Terrain types	Map-Terrain	Starting Bias
Features	Map-Terrain	Maps
Natural wonders	Map-Terrain	Maps
Resources	Maps & Resources	Modifiers
Climate/biomes	Maps & Resources	Map-Terrain

Religion

Topic	Primary Doc	Related Docs
Religion system	Religion	Modifiers
Beliefs	Religion	Effect Types
Pantheons	Religion	Buildings

Diplomacy & Espionage

Topic	Primary Doc	Related Docs
Diplomacy actions	Diplomacy	Modifiers
Relationships	Diplomacy	AI Behavior
Favor/grievances	Diplomacy	Effect Types
Espionage operations	Espionage	Diplomacy
Spy promotions	Espionage	Promotions

Independents

Topic	Primary Doc	Related Docs
City-states	Independents	Diplomacy
Tribes	Independents	Units
Barbarians	Independents	Units

Events & Narrative

Topic	Primary Doc	Related Docs
Narrative events	Narrative	JavaScript
Event triggers	Narrative	Requirements
Event choices	Narrative	Modifiers

Technical

Topic	Primary Doc	Related Docs
Modifier system	Modifiers Overview	All gameplay docs
Effect types	Effect Types	Modifiers
Collections	Collection Types	Modifiers
Requirements	Requirement Types	Modifiers
JavaScript API	JavaScript	Narrative
Localization	Localization	All content docs
Art assets	Art Assets	Units, Buildings
ModInfo	ModInfo Files	Getting Started
Types & Kinds	Types and Kinds	All database docs

---

Database Tables

Core Tables

Table	Purpose	Documentation
Types	Register all game entities	Types and Kinds
Kinds	Define entity categories	Types and Kinds

Civilization Tables

Table	Purpose	Documentation
Civilizations	Define civilizations	Civilizations
CivilizationTraits	Link civs to abilities	Civilizations
Leaders	Define leaders	Leaders
LeaderTraits	Link leaders to abilities	Leaders
CivilizationLeaders	Link leaders to civs	Leaders
StartBiases	Terrain preferences	Starting Bias

Unit Tables

Table	Purpose	Documentation
Units	Define units	Units
Unit_Abilities	Link abilities	Units
UnitPromotions	Define promotions	Promotions
UnitPromotionClasses	Promotion trees	Promotions
GreatPersonClasses	Great person types	Great People
GreatPersonIndividuals	Specific great people	Great People

Building Tables

Table	Purpose	Documentation
Buildings	Define buildings	Buildings
Building_YieldChanges	Building yields	Buildings
Districts	Define districts	Buildings

Technology & Civic Tables

Table	Purpose	Documentation
Technologies	Define techs	Technology Trees
TechnologyPrereqs	Tech prerequisites	Technology Trees
Civics	Define civics	Civic Trees
Traditions	Define policies	Civic Trees
Governments	Define governments	Governments
GoldenAges	Golden age bonuses	Era Score

Map Tables

Table	Purpose	Documentation
Terrains	Terrain types	Map-Terrain
Features	Map features	Map-Terrain
Resources	Resource types	Maps & Resources
NaturalWonders	Natural wonders	Map-Terrain

Religion Tables

Table	Purpose	Documentation
Religions	Define religions	Religion
BeliefClasses	Belief categories	Religion
Beliefs	Define beliefs	Religion
BeliefModifiers	Belief effects	Religion

Diplomacy Tables

Table	Purpose	Documentation
DiplomacyActions	Diplomatic actions	Diplomacy
DiplomacyActionGroups	Action categories	Diplomacy
DiplomacyRelationships	Relationship levels	Diplomacy
DiplomacyFavorEvents	Favor sources	Diplomacy
DiplomacyGrievanceEvents	Grievance sources	Diplomacy

Victory & Legacy Tables

Table	Purpose	Documentation
Victories	Victory conditions	Victory Conditions
AgeProgressions	Legacy paths	Legacy Paths
AgeProgressionMilestones	Milestone thresholds	Legacy Paths
AgeProgressionRewards	Milestone rewards	Legacy Paths

Modifier Tables

Table	Purpose	Documentation
Modifiers	XML modifier definitions	Modifiers
ModifierArguments	Modifier parameters	Modifiers
Requirements	Condition definitions	Requirements
RequirementSets	Grouped requirements	Requirements

Art & Localization Tables

Table	Purpose	Documentation
LocalizedText	Translated strings	Localization
IconTextureAtlases	Icon atlases	Art Assets
IconDefinitions	Icon mappings	Art Assets

---

Type Kinds

Kind	Usage	Documentation
KIND_CIVILIZATION	Civilizations	Civilizations
KIND_LEADER	Leaders	Leaders
KIND_TRAIT	Abilities/traits	Civilizations
KIND_UNIT	Units	Units
KIND_BUILDING	Buildings	Buildings
KIND_DISTRICT	Districts	Buildings
KIND_TECHNOLOGY	Technologies	Technology Trees
KIND_CIVIC	Civics	Civic Trees
KIND_TRADITION	Policies	Civic Trees
KIND_GOVERNMENT	Governments	Governments
KIND_GOLDEN_AGE	Golden ages	Era Score
KIND_RESOURCE	Resources	Maps & Resources
KIND_TERRAIN	Terrains	Map-Terrain
KIND_FEATURE	Features	Map-Terrain
KIND_RELIGION	Religions	Religion
KIND_BELIEF	Beliefs	Religion
KIND_BELIEF_CLASS	Belief categories	Religion
KIND_PROMOTION	Unit promotions	Promotions
KIND_GREAT_PERSON_CLASS	Great person types	Great People
KIND_GREAT_PERSON_INDIVIDUAL	Specific great people	Great People
KIND_DIPLOMACY_ACTION	Diplomatic actions	Diplomacy
KIND_DIPLOMACY_ACTION_GROUP	Action groups	Diplomacy
KIND_VICTORY	Victory conditions	Victory Conditions
KIND_AGE_PROGRESSION	Legacy paths	Legacy Paths
KIND_INDEPENDENT	Independents	Independents

---

Effect Types

Yield Effects

Effect	Description	Documentation
EFFECT_CITY_ADJUST_YIELD	City yield bonus	Effect Types
EFFECT_PLOT_ADJUST_YIELD	Plot yield bonus	Effect Types
EFFECT_PLAYER_GRANT_YIELD	One-time yield	Effect Types
EFFECT_TRADE_ROUTE_ADJUST_YIELD	Trade route yields	Effect Types

Unit Effects

Effect	Description	Documentation
EFFECT_ADJUST_UNIT_COMBAT_STRENGTH	Combat bonus	Effect Types
EFFECT_ADJUST_UNIT_MOVEMENT	Movement bonus	Effect Types
EFFECT_GRANT_ABILITY	Grant ability	Effect Types
EFFECT_ADJUST_UNIT_EXPERIENCE	XP modifier	Effect Types

Production Effects

Effect	Description	Documentation
EFFECT_CITY_ADJUST_WONDER_PRODUCTION	Wonder bonus	Effect Types
EFFECT_CITY_ADJUST_UNIT_PRODUCTION	Unit production	Effect Types
EFFECT_CITY_ADJUST_BUILDING_PRODUCTION	Building production	Effect Types

Diplomacy Effects

Effect	Description	Documentation
EFFECT_ADJUST_PLAYER_DIPLOMACY_FAVOR	Modify favor	Diplomacy
EFFECT_GRANT_DIPLOMATIC_VISIBILITY	Grant visibility	Espionage

See Effect Types for complete list.

---

Collection Types

Collection	Target	Documentation
COLLECTION_PLAYER_CITIES	All player cities	Collection Types
COLLECTION_PLAYER_UNITS	All player units	Collection Types
COLLECTION_CITY_BUILDINGS	Buildings in city	Collection Types
COLLECTION_OWNER	Owning player	Collection Types
COLLECTION_PLAYER_PLOT_YIELDS	All plot yields	Collection Types
COLLECTION_ALL_PLAYERS	All players	Collection Types

See Collection Types for complete list.

---

Requirement Types

Requirement	Check	Documentation
REQUIREMENT_CITY_HAS_BUILDING	Building in city	Requirement Types
REQUIREMENT_PLAYER_HAS_TECHNOLOGY	Tech researched	Requirement Types
REQUIREMENT_PLOT_TERRAIN_TYPE_MATCHES	Terrain match	Requirement Types
REQUIREMENT_UNIT_TAG_MATCHES	Unit tag check	Requirement Types
REQUIREMENT_PLAYER_IS_RELIGION_FOUNDER	Religion founder	Religion

See Requirement Types for complete list.

---

Common Modding Tasks

"I want to create a..."

Task	Primary Docs	Key Steps
New civilization	Civilizations, Leaders	1. Register types 2. Define civ 3. Add leader 4. Create traits
New unit	Units, Art Assets	1. Register type 2. Define stats 3. Add abilities 4. Set icon
New building	Buildings	1. Register type 2. Define building 3. Add yields 4. Set prereqs
New technology	Technology Trees	1. Register type 2. Define tech 3. Set prerequisites 4. Add unlocks
New civic	Civic Trees	1. Register type 2. Define civic 3. Set prerequisites
New policy/tradition	Civic Trees	1. Register type 2. Define tradition 3. Add modifiers
New government	Governments	1. Register type 2. Define government 3. Add golden ages
New resource	Maps & Resources	1. Register type 2. Define resource 3. Set placement 4. Add icon
New belief	Religion	1. Register type 2. Define belief 3. Link modifiers
Custom modifier	Modifiers	1. Choose effect 2. Choose collection 3. Add requirements 4. Set arguments
New narrative event	Narrative	1. Define event 2. Add triggers 3. Create choices 4. Set outcomes

"How do I..."

Question	Answer Location
Add yields to a building?	Buildings - Building_YieldChanges
Make something unlock with a tech?	Technology Trees - TechnologyUnlocks
Create a conditional bonus?	Modifiers - SubjectRequirements
Add localized text?	Localization - LocalizedText table
Create icons for my content?	Art Assets - Icon atlas system
Package my mod?	ModInfo Files - Mod structure
Make AI prefer something?	AI Behavior - AI lists
Add a starting bias?	Starting Bias - StartBiases

---

File Types Quick Reference

Extension	Purpose	Documentation
.xml	Database definitions	Types and Kinds
.sql	SQL database queries	Types and Kinds
.js	JavaScript gameplay scripts	JavaScript
.modinfo	Mod packaging	ModInfo Files
.dds	Texture/icon images	Art Assets
.gr2	3D models	Art Assets

---

See Also

• Getting Started - Initial setup
• ModInfo Files - Mod packaging
• Types and Kinds - Type system fundamentals
• Modifiers Overview - Gameplay effect system