Table of Contents

TribeData

tribeData lists the tribes: their color, city names, start, abilities, skins and the tribe-specific versions of techs, units and improvements.

The example uses Cymanti (values from game logic data version 28):

"cymanti": {
	"color": 12778752,
	"style": 16,
	"climate": 16,
	"skins": [
		"Cute"
	],
	"language": "cy,zi,phy,dio,bio,tic,sy,ca,ly,um,sis,ci,hex,pod,ea,rhi,the,exo,neo,ner,seg,ho,lo,chy,ia,ce,li,co,ta,my,aph,ich,zo,di,bo",
	"unitOverrides": {
		"rider": "hexapod",
		"giant": "centipede",
		"knight": "doomux",
		"archer": "phychi",
		"swordsman": "mantis",
		"catapult": "exida",
		"defender": "kiton",
		"mindbender": "shaman",
		"cloak": "moth",
		"dagger": "bugegg",
		"pirate": "bugegg",
		"rammership": "boomchi",
		"scoutship": "raychi",
		"bombership": "island"
	},
	"techOverrides": {
		"construction": "recycling",
		"chivalry": "shock",
		"meditation": "rituals",
		"philosophy": "mysticism"
	},
	"startingTech": [
		"basic",
		"farming"
	],
	"startingResource": [
		"spores",
		"spores"
	],
	"improvementOverrides": {
		"market": "clathrus",
		"farm": "fungi",
		"port": "algae",
		"road": "mycelium",
		"bridge": "none"
	},
	"priceTier": 2,
	"category": 2,
	"bonus": 0,
	"startingUnit": "shaman",
	"tribeAbilities": [
		"poisonresist"
	],
	"idx": 17,
	"terrainModifier": {
		"mountain": 1.2
	},
	"resourceModifier": {
		"spores": 0.3,
		"crop": 0
	}
}

Fields

Field Type Default Description
idx integer — The number of the tribe. -1 for a new tribe.
color integer 0 The tribe color.
language string — The syllables for city names.
startingStars integer 5 The stars at the start of a game.
bonus enum number 0 A special bonus at the start of a game.
startingUnit unit id — The unit in the capital at the start.
category enum number 0 Where the tribe shows in tribe selection.
priceTier enum number 0 The store price tier of the tribe.
skins list of skin names [] The skins of the tribe.
terrainModifier terrain id map {} Multipliers for terrain generation.
resourceModifier resource id map {} Multipliers for resource generation.
startingTech tech id list [] The techs that the tribe has at the start.
startingResource resource id list [] Resources placed near the capital at the start.
tribeAbilities tribe ability id list [] Special rules of the tribe.
techOverrides tech id→id map {} Tribe versions of techs.
unitOverrides unit id→id map {} Tribe versions of units.
improvementOverrides improvement id→id map {} Tribe versions of improvements.
preview array — PolyMod. Changes to the tribe preview map.

The name of a tribe is the localization key tribes.<id>, and its description is tribes.<id>.info.

Vanilla tribes

Id idx Id idx
none 0 luxidoor 9
nature 1 oumaji 10
aimo 2 quetzali 11
aquarion 3 vengir 12
bardur 4 xinxi 13
elyrion 5 yadakk 14
hoodrick 6 zebasi 15
imperius 7 polaris 16
kickoo 8 cymanti 17

none and nature are not playable tribes.

idx

The number of the tribe in the TribeType enum. Use -1 for a new tribe; see Adding new content.

color

The tribe color as an RGB number: red × 65536 + green × 256 + blue. For example, 12778752 is 0xC2FD00. A skin with a color above 0 replaces it. If two players in a game would have the same color, the game gives one of them the unused color of another tribe.

language

The syllables that the game combines into names, separated by commas. The game uses them for city names and for the names of AI players. It joins random syllables until the name has about 3 to 6 characters, and capitalizes the first letter (except for Elyrion). A skin can have its own syllables.

startingStars

The stars that the player has at the start of a game. Default 5. (In the tutorial, the game uses 0.)

bonus

A special rule at the start of a game. The value is a number, or the name as a string:

Value Name Effect
0 None No bonus.
1 CityLevel3 The capital starts at level 3. Luxidoor uses it.
2 Spores Places a fungi improvement on the first field tile next to the capital. Not used by vanilla tribes.

startingUnit

The id of the unit that the game puts in the capital at the start of a game. It can move and attack in the first turn. The game uses this unit as it is: unitOverrides do not apply to it.

category

Where the tribe shows in the tribe selection. A number, or the name as a string:

Value Name Meaning
0 Hidden Not shown in the tribe selection.
1 Human Shown with the regular tribes.
2 Special Shown with the special tribes.

The category only changes the tribe selection screen. Random tribes and AI players can still be any tribe, also a Hidden one.

priceTier

The store price tier: 0 (Tier0) to 3 (Tier3). The game reads this field, but no game code uses it. PolyMod unlocks all custom tribes anyway.

skins

The skins that players can choose for this tribe, by skin name, for example ["Baerion"]. Vanilla skin names are not case-sensitive here. A name that is not a vanilla skin creates a new skin; see New skins. The skin ids are listed in SkinData.

In a patch, a plain string in skins adds the skin, and "-name" removes it. See Merge rules.

terrainModifier

Multipliers for the terrain that map generation makes on the land of this tribe. The keys are terrain ids and the values are numbers: 1 is normal, 1.2 is 20% more, 0 is none.

Map generation divides the land of a tribe between field, forest and mountain in proportion to their weights (base weights 0.5, 0.4 and 0.15). Only these three keys have a visible effect. water is only used when its value is above 1, and ocean, ice, wetland and mangrove have no effect found in the map generator.

resourceModifier

Chances for the resources that map generation places on the land of this tribe. The keys are resource ids and the values are numbers.

  • For a resource with a base chance above 0, the value is a multiplier: 1 is normal, 0 is none. The base chances are 0.5 for crop, fish, fruit and game, 0.8 for metal and 0.3 for aquacrop.
  • For a resource with a base chance of 0 (whale and spores), the value is the chance. So "spores": 0.2 gives spores a chance of 0.2.
  • starfish is not placed by map generation, whatever the value.
  • New resources have a base chance of 0, so their value is their chance.

A resource can only be placed on the terrains in its resourceTerrainRequirements.

startingTech

The techs that the tribe gets for free at the start of a game. Every vanilla tribe has basic, which is the root of the tech tree.

startingResource

Resources that the game guarantees on the 8 tiles around the capital. Each entry gives one tile, so list a resource twice to get two. Resources that are already there count. If no tile has a fitting terrain, the game changes the terrain of a tile to one that the resource needs.

If the list is empty, the game uses the resource that the first improvement of the starting techs needs.

tribeAbilities

Special rules of the tribe, by tribe ability id:

Id Number Effect
none 0 No effect.
rainbowvision 1 Only visual: ruins show a rainbow fire for the player. Elyrion.
alienclimate 2 Map generation: the land of the tribe does not get the usual climate growth. For Polaris, water next to the capital becomes ice.
spread 3 When the tribe captures a city or its borders grow, the climate of the city area changes to the tribe's climate (for Polaris: the tiles freeze). Other tribes change these tiles back.
freeze 4 No effect in game logic; only an achievement checks it. The freezing of Polaris is tied to the tribe, not to this ability.
poisonresist 5 Units are not poisoned by improvements with the poison ability. Cymanti.
flooded 6 Map generation floods the field and forest tiles of the tribe; captured cities are flooded; ruins on water become cities for the tribe. Aquarion.

Some Polaris behavior is tied to the tribe polaris itself, not to its abilities. New tribe abilities can be added with the PolyMod section tribeAbility; see New abilities and weapons.

Overrides

techOverrides, unitOverrides and improvementOverrides replace vanilla content with the tribe's own version. Each key is the id of the original content, and each value is the id of the tribe version:

"unitOverrides": {
	"rider": "hexapod"
}

The game applies overrides when it builds the tech tree of the tribe, lists the units that it can train, and lists the improvements that it can build. So where other tribes get a rider, this tribe gets a hexapod. Overrides do not apply to the startingUnit, to the improvements of tasks (monuments), to embark boats, or to unit growth.

To take an improvement away from a tribe, use "none" as the value, as Cymanti do with "bridge": "none". The improvement then disappears from that tribe's build menu. This only works well for improvements:

  • for units, "none" seems to crash the training list (found by reading the code, not tested);
  • for techs, "none" is not a valid id and makes the game fail while it reads the GLD.

preview

PolyMod. Changes the tiles of the preview map in tribe selection. See Tribe previews.

style and climate

Older GLD versions had the fields style and climate. The game no longer reads them. PolyMod sets them for new tribes; you do not need to.