Skip to main content

faction_prop.ini

Overview

This file describes the attributes of the factions that you encounter in Freelancer, defining their pilot names, ships, costumes and some AI behaviors.

Syntax

There is no particular order for the parameters inside the blocks.

[FactionProps]

[FactionProps]
affiliation = STRING
legality = STRING
nickname_plurality = STRING
msg_id_prefix = STRING
jump_preference = STRING
npc_ship = STRING ;repeatable
voice = STRING ;repeatable
mc_costume = STRING
space_costume = STRING, STRING, ... ;repeatable
firstname_male = INT, INT
firstname_female = INT, INT ;optional
lastname = INT, INT
rank_desig = INT, INT, INT, INT, INT
formation_desig = INT, INT
large_ship_desig = INT ;optional
large_ship_names = INT, INT ;optional
scan_for_cargo = STRING, INT ;optional
scan_announce = BOOL ;optional
scan_chance = FLOAT ;optional
formation = STRING, STRING
ParameterInformation
affiliationThe nickname of the faction, that is defined below
legalityPossible values are lawful and unlawful. This is used to describe NPC ships to the player and NPC voices as e.g. normal escorts or pirate raiders (?)
nickname_pluralitySuspect this determines how a faction is referred to in a broadcast. (i.e. whether or not the name is pluralised.), but requires further testing.
msg_id_prefixWhen npcs talk about a faction they use this value to search for the correct sound files.
jump_preferencePossible values are jumpgate, jumphole or any.
npc_shipLists all ships from npcships.ini that are used by this faction.
voiceDifference voice files used by pilots of the faction. Voices differ between male and female. As soon as a male or female voice is present, the game will begin assigning these genders to NPCs.
mc_costumeThe costume used by the mission commission in missions for the faction.
space_costumeDefines the looks of an NPC when directly communicating with the player. The first value being a head, the second the body, and the third optionally being a head accessory. Depending on the set-up voices, these space costumes must include male or female variations, or NPCs will not be able to be hailed and never show up with their face to the player.
firstname_maleLists all male names for this faction. Uses a range of strings. Must be defined depending on the set-up voices, or Object Unknown is displayed as name.
firstname_femaleLists all female names for this faction. Uses a range of strings. Must be defined depending on the set-up voices, or Object Unknown is displayed as name.
lastnameLists all lastnames for this faction. When an npc is spawned, a firstname and a lastname will be chosen randomly. Uses a range of strings.
rank_desigLists all ranks for this faction. The last two integers define the level breakpoints for the npcs, e. g. all NPCs below the first level breakpoint will have the first rank, etc. There seems to be a hard limit of 3 ranks per faction.
formation_desigLists all possible formation designators for this faction, like Omega, Epsilon, etc. Uses a range of strings.
large_ship_desigPrefix for the names of large ships.
large_ship_namesLists all possible names for large ships of faction. Uses a range of strings.
scan_for_cargoLists the commodites the faction looks for. The integer seems to be a weight that has however no effect?
scan_announceWhether the npcs warn you before they scan your cargo or not.
scan_chancePercent changes for NPCs to cargo scan you.
formationConnects the formations from formations.ini with those asked by encounters. The first value defines the formation asked by the encounter file, the second defines actual formation from the formations.ini file.