X4: Foundations

File information

Last updated

Original upload

Created by

kuertee

Uploaded by

kuertee

Virus scan

Safe to use

Tags for this mod

About this mod

Removes the passive acquirement of friendly, and alliance licences by requiring citizenships with the faction. Citizenship is acquired by building stations in the faction's space. Poor Social Standing limits citizenship status.

Requirements
Permissions and credits
Changelogs
Donations
Social standings and citizenships
https://www.nexusmods.com/x4foundations/mods/804
by kuertee

Updates
v6.2.011, 18 Feb 2024:
-Bug-fix: Resetting social standings and citizenships were not resetting to 0 properly. E.g. They are reset when a new character (e.g. a descendant) is created for the player after their death in my Alternatives to death mod.





Mod effects
Removes the passive acquirement of friendly, and alliance licences by requiring citizenships with the faction.
Citizenship is acquired by building stations in the faction's space.
Poor Social Standing limits citizenship status.

Requirements
-SirNukes Mod Support APIs mod (https://www.nexusmods.com/x4foundations/mods/503)
-Kuertee's UI Extensions mod (https://www.nexusmods.com/x4foundations/mods/552)

Recommended companion mods
Reputations and Professions (https://www.nexusmods.com/x4foundations/mods/636): role-playing mod that adds 4 Reputations (Defender, Vigilante, Mercenary, Pirate), and 8 Professions (Courier, Engineer, Miner, Saboteur, Spy, Trader, Builder, Shipwright).
Crime has consequences (https://www.nexusmods.com/x4foundations/mods/566): ships are fined, then impounded, then forfeited. Pay fines at the Fines and Forfeiture office to reacquire ships before their forfeiture.





Note that "relationship" refers to the base game's Relationship Points.

Citizenships
There are several immigration status: Undocumented, Migrant, Resident, Citizen, and Militia.

The friendly relationship is limited to players with the Resident Immigration Status.
The alliance relationship is limited to players with the Citizen Immigration Status.
And the capital ship licence is limited to players with the Militia Immigration Status.

Relationship points with factions continue to accrue with your AI traders - as in the base game.
But, regardless of the relationship points, the friendly, and alliance licences nor licences that require them are not awarded until the required immigration status is achieved.

Note that the mod will never remove the Outer Core Access, nor the Inner Core Access IF you have them when you first install the mod.

Undocumented
No contact with the faction.

Visitor
Applied when you're have the Explorer Social Standing and you're not yet a Migrant.

Migrant
Established contact with the faction.

Resident requirements
1 station in any of the faction's space
500,000 transactions (sales, and purchases) between the faction and your stations

Citizen
2 additional stations in any of the faction's space
2,500,000 transactions between the faction and your stations

Militia
1 defense station in any of the faction's frontiers (i.e. contested space)





Social standings
There are several social standings: Traitor, Outcast, Criminal, Scoundrel, Alien, Explorer, Entrepreneur, Ranger

Note that the Criminal Social Standing requires my other mod, Crime Has Consequences (CHC).
Without CHC, the Criminal Social Standing is never applied.

Traitors, Outcasts, and Criminals are not permitted to hold licences that come with the Citizenships.
And only Ranger activities can reverse the Traitor, Outcast, and Scoundrel Social Standings.
Paying the criminal fines will remove the Criminal Social Standing.

Traitor
Relationship deteriorates to the Pirate Relationship while a Resident, Citizen, or Militia.
Further relationship drops develop the Traitor Social Standing further.

Outcast
Relationship deteriorates to the Pirate Relationship while not a Resident, Citizen, or Militia.
Further relationship drops develop the Outcast Social Standing further.

Criminal
Criminal fines exist.
Requires my other mod, Crime Has Consequences.

Scoundrel
Has a negative Social Standing but is not a Traitor, an Outcast, or a Criminal.
Further relationship drops develop the Scoundrel Social Standing further.
The Scoundrel Social Standing may deteriorate to Outcast or Traitor.

Alien
No contact with the faction.

Explorer
No outstanding activities with the faction.

Entrepreneur
More non-combat-focused interactions with the faction.
With Reputations and Professions installed, the Courier, Engineer, Miner, Trader, Builder and Shipwright activities count toward the Entrepreneur Social Standing.
Without, only player-trading activities do.

Ranger
More combat-focused interactions with the faction.
With Reputations and Professions installed, the Defender, Vigilante, and Mercenary activities count toward the Ranger Social Standing.
Without, only kills in the faction's space do.
Perform Ranger activities to clear the Traitor, Outcast, and Scoundrel Social Standings.





Troubleshooting
If you think that you're missing licences or that you have licences that you shouldn't, you can force a recalculation of the licence requirements by:
1. Open the mod's Extension Options menu
2. Change one setting, then change it back WITHOUT exiting the Extension Options menu. This change (even it was changed back) will be detected by the mod to force a recalculation of the licence requirements.
3. Return to the game.

Install
-Unzip to 'X4 Foundations/extensions/kuertee_social_standings_and_citizenships/'.
-Make sure the sub-folders, and files are in 'X4 Foundations/extensions/kuertee_social_standings_and_citizenships/', and not in 'X4 Foundations/extensions/kuertee_social_standings_and_citizenships/kuertee_social_standings_and_citizenships/'.

Uninstall
-Delete the mod folder.

Troubleshooting
(1) Do not change the file structure of the mod. If you do, you'll need to troubleshoot problems you encounter yourself.
(2) Allow the game to log events to a text file by adding "-debug all -logfile debug.log" to its launch parameters.
(3) Enable the mod-specific Debug Log in the mod's Extension Options.
(4) Play for long enough for the mod to log its events.
(5) Send me (at [email protected]) the log found in My Documents\Egosoft\X4\(your player-specific number)\debug.log.

Credits
By kuertee.
Chinese localisation by Tiomer.
German localisation by LeLeon.

History
v6.2.0093, 25 Dec 2023:
-Tweak: Promotions will now be recorded so that future re-promotions will be instant. Saves the trip back to the faction representative.

v6.2.007, 4 Dec 2023:
-Bug-fix: Prevent notification spam of citizenship status when you already have promotion mission that you've not yet completed.
-Bug-fix: The "is in frontier" status of your stations are now saved and re-used if the sector they are located changes. I.e. you shouldn't lose your Militia standing just because a sector loses its frontier status.

v6.2.006, 21 Oct 2023:
-Bug-fix: Prevent notification spam of citizenship status when you don't have the capital ship licence but are eligble for it.

v6.2.005, 16 Oct 2023:
-Bug-fix: Prevent notification spam of citizenship status. The last version didn't actually fix the bug. This one definitely does.

v6.2.004, 22 Sep 2023:
-Bug-fix: Prevent militia notification and log entries at every trade - after you've achived militia.

v6.2.003, 17 Sep 2023:
-Bug-fix: Prevet "too many recursive error" introduced in the last patch.
-Bug-fix: Set Social Standing (SS) to Visitor when there are Entrepreneur or Ranger points but has not yet been established as either. Previously, SS was "Alien" even when there are Entrepreneur or Ranger points but has not enough to be established as either.

v6.2.002, 15 Sep 2023:
-Bug-fix: Promotion mission for +20 Relationship and Citizen/Militia Immigration Status wasn't working.

v6.2.001, 10 Sep 2023:
-Bug-fix: Acquiring licences was buggy in that it would award them even without their qualifications. This is a cleaner implementation of this feature in that it uses more of the base game's code to apply/remove the licences. Previously this mod had its own addition and removal system.
-Tweak: The promotion invite system is reverted back to the base game's system in that instant promotion only occurs when the base game does it.

v6.0.002, 14 Apr 2023:
-Bug-fix: Migrant immigration status wasn't getting set unless you lose Resident, Citizen or Militia statuses. In this version, once you have sufficient Entrepreneur and Ranger points, you'll be a Migrant.

v6.0.001, 5 Apr 2023:
-Bug-fix: Transactions with your stations were not getting counted towards your Citizenship points if you were anywhere in the station - even on a ship docked at the station.
-Tweak: Transactions are counted towards the player's Entrepreneur points when the player is in the ship or on the station conducting the transaction. I.e. The player doesn't need to be in control of the ship. And in extension can be standing anywhere on the station.
-Note: This is compatible with both 5.1 and 6.x of the base game.

v6.0.0007, 1 Apr 2023:
-Bug-fix: Factions that claim no sectors (i.e. ALI, MIN, FAF, MIN, SCA, YAK) have no Immigration Policies and so do not need Citizenship status for their licences.

v6.0.0004, 18 Feb 2023:
-Bug-fix: The long-standing bug of the Extension Options getting reset is fixed! :D ... hopefully. :)
-Bug-fix: "Crime has consequences" mod compatibility: sometimes paying a fine doesn't remove the Criminal Social Standing.
-Note: This version should work with 5.x base game.

v5.1.03141, 07 Dec 2022:
-Bug-fix: Settings in the Extensions Options may not be sticking.

v5.1.0314, 06 Dec 2022:
-Bug-fix: Player defense stations in sectors owned by the player that the other faction occupies but is not contesting it (i.e. the other faction has no defense station in the sector) were not getting counted as the other faction's frontier - when it should.

v5.1.0313, 31 Oct 2022:
-Tweak: Renamed the requirements for the Terran faction to elevate them without changing the actual requirements. "Resident" to "Settler". "Citizen" to "Colonist". "Militia" to "Base commander".
-Bug-fix: Better handling of data on station destruction.

v5.1.0303, 1 Sep 2022:
-Bug-fix: Better handling of your stations that are destroyed.

v5.1.0302, 24 Jul 2021:
-Bug-fix: The Social Standing UI in the Factions Menu (and Reputations and Professions Menu) was reporting Resident (or Citizenship) status even if your Social Standing is not yet Entrepreneur or Ranger.
-Tweak: The Immigration Status mouseover now reports the required Social Standing if you don't have it.

v5.1.0301, 17 Jul 2022:
-Bug-fix: The requirement options in the Extension Options wasn't sticking across saved games.
-Tweak: Sectors adjacent to unowned sectors are now considered frontiers. The previous version required you to build defend stations in relatively dangerous frontiers.

v5.1.00092, 12 Jun 2022:
-Bug-fix: Changes to Extension Options were still not sticking.

v5.1.00091, 27 May 2022:
-Bug-fix: Changes to some of the Extension Options were not sticking.

v5.1.0009, 25 May 2022:
-Bug-fix: The percentages of Social Standing scores were getting rounded down to the whole number incorrectly.
-Tweak: Bounty hunter events from Reputations and Professions counted as Ranger events.
-Bug-fix: Destroyed stations were not getting removed from the faction data.
-Tweak: On Crime Has Consequences events, do not add piracy points to not double-up the relationship penalty caused by the crime.
-Bug-fix: Calc get best and next best.
-Bug-fix: Trade data for player entrepreneur points and trade data for player-owned stations.

v5.0.0013, 30 Mar 2022:
-Tweak: New Migrant Immigration Status determination: Ranger and Entrepreneur ratings need to be more than 10% of all Social Standing scores.
-New feature: The mod will never remove the Outer Core Access, nor the Inner Core Access IF you have them when you first install the mod.

v5.0.0011, 19 Mar 2022:
-Bug-fix: Milita Citzienship was getting awarded even if you had no defense stations in the faction's frontiers.
-Bug-fix: Silenced debugging logs.

v5.0.001, 18 Mar 2022:
-Bug-fix: Calculation of Social Standings was preventing the Scoundrel SS if you had already established a Ranger SS.
-Bug-fix: Station built/destroy events were not getting identified in some cases.
-New feature: Alternatives to death (ATD) support: Allow resetting of Social Standings and recalculation of Citizenships from ATD.
-Tweak: Trades with any factions are counted at player-owned stations. Previously, only factions that have stations in the sector (i.e. a contesting faction) are counted. These trades do not count to the player's stats UNTIL that faction establishes a presence (i.e. as a contesting faction) in the sector.
-Tweak: Professions and Reputations (RAP) support: Only Defender Reputation, from RAP, actions are counted towards the Ranger SS. Previously Vigilante and Mercenary actions were counted also.

v4.2.0805, 08 Feb 2022:
-Bug-fix: For factions that do not claim space (e.g. Alliance), build your stations on sectors they have defence stations to increase your Immigration Status. Shipyards, wharves, equipment docks and pirate bases are defence stations.

v4.2.0804, 27 Jan 2022:
-New feature: Visitor Immigration Status: Applied when you're have the Explorer Social Standing and you're not yet a Migrant.
-Bug-fix: Regaining relationship points after loss of relationship points was still not reassigning some licences.
-Tweak: How to force a recalculation of your licences - if you think that they are not correct. Read the Troubleshooting section below.
-Tweak: Terran's Outer Core and Inner Core licences are not dependent on the Friend and the Ally licences. You gain the Outer Core and Inner Core licences purely based on your relationship points. I.e. Losing the Friend or Ally licences will not remove your Outer Core or Inner Core licences.
-Bug-fix: Stations that you previously owned but not anymore are not counted to the Immigration status.

v4.2.0803, 25 Jan 2022:
-Bug-fix: After losing a status (e.g. from a crime), then regain it (e.g. by paying the fine), some "ceremony" licences are not restored because the mod had missed saving that it was previously attained. This version ensures that these ceremony licences are saved at the install of this version.
-Bug-fix: Losing some reputation that causes the loss of ceremony licences THEN reattaing it will skip the mod's requirement checks. E.g. You have a +20 Relationship but only a Resident status. You lose that relationship (and the status) because of a temporary loss of Relationship Points. When you reattain those Relatinoship points that make you eligible for +20 "ceremony ally" again, the mod will skip that checks that "ceremony ally" requirest Citzenship status.
-Tweak: Renamed the "Bounty Hunter" social standing label to "Ranger". I need the Bounty Hunter label for a planned Bounty Hunter Profession in my Relationship And Professions.

v4.2.08, 20 Jan 2022:
-Tweak: Detect Builder and Shipwright activities from Reputations and Professions mod - now that they've been enabled.
-Tweak: UI: exapanded Immigration status: Stations in frontier space are now marked.
-Bug-fix: UI: Listing destroyed stations would prevent the menu from getting opened.
-Bug-fix: UI: If you were a criminal and had no other points to any other Social Standings, and you paid, your status reverted back to Undocumented Immigration status Alien Social Standing. In this version it'll retain the Migrant Immigration Status and revert your Social Standing to Explorer.
-Bug-fix: UI: Social Standing percentages were reverting back to points at 29.99. Once they total to 30 (i.e. 10 for each Social Standing), they should always be percentages.

v4.2.061, 31 Dec 2021:
-Bug-fix: Paying all your fines at one time in the Crime has Consequences mod was not detected by this Social Standings and Citizenships mod.

v4.2.06, 30 Dec 2021:
-Tweak: UI tweaks: many.
-Tweak: Outlaw renamed to Outcast.
-Bug-fix: UI would freeze when click-spamming between the left-side menu item.

v4.2.05, 27 Dec 2021:
-Bug-fix: When social standing scores are return to "balance" (i.e. neither Bounty Hunter and Entrepreneur are dominant - i.e. 150% more than the other), after having one was dominant, the score will recalculate it incorrect back to Explorer. This bug-fix will instead keep the last dominant social standing. This bug will also kill the UI if the list for that social standing scores is expanded.
-Tweak: The stations list for immigration status is ordered by descending transactions.

v4.2.03, 22 Dec 2021:
-Bug-fix: The previous version prevent you from attaining any Immigration Status except for Resident.
-Bug-fix: Ceremony missions were being skipped in the previous version.
-Note on the bug-fixes: From v1.0.0, the mod recalculates your licences when you load a game. Any Immigration Status that are permitted will be awarded. Note that this bug-fix clears the mod's list of ceremonies you attended. The previous version skipped all ceremonies, anyway. But in this version, any new licences you receive will trigger the ceremony e-mail and mission THE FIRST TIME you achieve the requirements for the licence. But (as intended in previous version of the mod) if you lose a licence and re-attain it, you won't be required to attend the ceremony a second time. The licences will just be awarded to you automatically.
-Tweak: Terran's Inner Core Access licence now require Citizen status.

v4.2.02, 16 Dec 2021:
-Bug-fix: You will never lose your Resident, Citizen, or Militia Immigration Status - except when you have a poor Social Standing. Previously, e.g. if the sector changes ownership or classification, your Immigration Status will change.
-New feature: UI: go to map button available for each station in the station list.
-Tweak: Classification of sectors with adjacent enemy sectors as frontiers. Previously, the sector needed to be "contested" to be classified as a frontier. In this version, even home and safe, territory sectors can be frontiers.

v4.2.0, 10 Dec 2021:
-Initial release.