• 21.03.12> 1.3.0
  
  • Reduces clone generation, Increases historical hero generation
    
  • <The Gathering : Heroes> mod Steam guide(Korean, English)
• 21.03.11> 1.2.0
  
  • When "Dong Zhuo" assassinate incident occurred, "Li Jue" takes regime over
    
  • Reduces AI execution possibility
    
  • Auto-setting hero family relationships(currently 15 pairs)
    
  • Set named heroes' intimacy with favorite faction(ex: Jian Yong -> Liu Bei)
• 21.03.09> 1.0.0 - Mod Steam upload

[The Gathering : Heroes] is a mod that has the feature of gathering historical heroes to a 'favorite faction' according to the history. Increases the likelihood that players will encounter enemy troops of more historical, known famous/important heroes.

The heroes monitored within this mod is divided into "faction Leader", "named", and "Important", and a total of 374 vanilla heroes join to "faction of following hero" > "favorite faction"> "second-favorite faction"> "faction occupying place of birth".

Ex) 'Zhou Yun' -> "The faction which 'Liu Bei' belongs" > "'Liu Bei' faction" > "'Gongsun Zan' faction" > "The faction occupying Zhongshan"

TW:TK's engine adjusts the number of 'employed heroes' by calculating the propensity of the power, current financial status, estimated income, and the number of occupied areas. When forcing a hero into a faction from the outside, the AI selects and releases the surplus heroes. 'Yuan Shao' even releases/executes 'Yan Liang' and 'Wen Chou' (before the 'Fates Divided' DLC).

Here are some cases where AI hires new heroes.

1. Spawning through TW:TK event - These heroes can also be released immediately if they are not in the family of the faction leader. (E.g., Gan Ning, Zhou Yu, Pang Tong , etc.)
   
2. When capturing a new settlement
   
3. The expected income is sufficient and the propensity of the AI forces is expandable
   
4. When try to create armies proportional to the opponent's force

Here's how the TW:TK system maintains its recruitment pool.

1. For each faction that exists, engine fills the pool of recruitments as many as a set number in the TW:TK DB before the turn begins.
   
2. Each faction operates 2-3 heroes per occupied capital(city) and 1-2 heroes per settlement(resource). (There are differences depending on the propensity of each faction)
   
3. As each faction expands, the recruitment pool that has become scarce due to the recruited heroes randomly generates "historical heroes" and "clones" that can exist at a certain rate.(Depends on the TW:TK patch version)
   
4. Even if each faction cannot expand, heroes are hired to maintain the military power proportional to the military power of the high threat faction according to the determined tendency.

This mod is implemented as a key feature to move the heroes from the recruitment pool to the recruitment pool of the preferred/second-favorite faction. In other words, the core of this mod's gathering feature is that there are heroes in that faction recruitment pool that AI can hire when new hero is needed.
The TW:TK system retires (kills) "Heros who have not been recruited for more than 20-50 turns in the recruitment pool". For that reason, this mod assassinate 'clone', which is unnecessary for the faction, and replace it with an important hero.

With TW:TK's random recruitment pool system, the core heroes of each faction does not appear at the right time, so the core hereos of the expandable AI factions are joined according to the number of occupied settlements.

The case of 'Yuan Shao' faction is as follows.

1. Occupied 2 - Shen Pei, Tian Feng
   
2. Occupied 3 - Chunyu Qiong, Gao Lan(TUP)
   
3. Occupied 4 - Xin Ping, Pang Ji, Zhu Ling(TUP), Qu Yi(TUP)
   
4. Occupied 5 - Xun Chen(TUP)

Named heroes not on the map will pre-spawn as their gathering faction(including player faction) one year before they reach adulthood. These heroes will appear alongside the adult event and will not be visible in the "Court family" panel before that time.

AI occupy gathering and spawn minor hero features can be turned off/on through the configurations file.

The point of joining heroes to each faction requires constant observation.

In the case of the 'Ma Teng' faction, depending on the initial advance direction of 'Gong Du', it maintains two settlements, and loses one settlement to 'Gong Du'. If the occupied area of the 'Ma Teng' faction is reduced, if a hero such as "Ma Yunlu" is spawned by other mod, "Pang De" may be released or executed because all other members are family members.

In the case of the 'Liu Yan' faction, the faction tends to be defensive and could not prevent the advancing of Nanman from the early stage, which could lead to early extinction. In this mod, the surrounding blank "Yizhou, Hanjia" area is given to'Liu Yan', and 'Fa Zheng', 'Zhang Song' and 'Wang Fu' are joined.

In the case of 'Zhang Lu', who is killed by 'Gong Du' due to an unique armor bug, give him a good armor and a horse so he can escape as the 'Liu Yan'.

Family member setting, "Jia xu", "Wei Yan" and "Guo Jia" event bug fix, increase likelihood of the appearance of historical heroes, reduce AI execution ratio and etc.

After the release of the "Fates Divided" DLC, detailed adjustments will be made after continuous observation according to changes in each campaign and faction. I look forward to your reports and feedback.

• Fixing or adjustment of TW:TK events
  
  • 'Guo Jia' spawn event fix
    Fixed a failure due to an error even if an event was triggered because of an incorrect target setting
    
  • Adjustment 'Wei Yan' spawn event
    Event adjustment based on the relationship between 'Liu Bei and 'Liu Biao' in all campaigns
• Birth year adjustment
  
  • Huang Zhong(148), Xu Chu(170) in TW:TK 1.7.0 patch.
    
  • Cao Hong - Birth year 198 -> 168
• Reduces clone generation, Increases historical hero generation
  In the case of clones created by the TW:TK engine, they are not recruited from the recruitment pool and will be expelled after 8 turns to shorten the refresh cycle of the talent pool. When the engine fills the recruitment pool with new heroes, historical heroes will also be created, resulting in a higher percentage of historical heroes in the talent pool, resulting in fewer clones in the game.
  
• Reduces AI execution possibility
  Adjusted the DB number for the AI faction's execution probability of captive/fired heroes. I didn't completely block it.

• Parent-child relationship
  When a gathering hero is spawned, this mod breaks the parent-child relationship if the hero's parent exists (dead or alive) and is set through the engine API.
  
  Liu Bei = Liu Shan Guan Yu = Guan Ping, Guan Suo, Guan Yinping Cao Cao = Cao Ang, Cao Pi, Cao Zhang, Cao Zhi, Cao Chong Sun Jian = Sun Ce, Sun Ren Sun Ce = Sun Quan Ma Teng = Ma Chao, Ma Dai, Ma Yunlu(MTU) Lu Bu = Lu Ji Lu Kang = Lu Xun = Lu Hang = Lu Qi(tup) Cai Yong = Cai Yan Wang Lang = Wang Yuanji
  
  
• Named hero's faction intimacy
  Increase the familiarity of each faction's named heroes with their favorite faction. By setting it in the DB, the TW:TK engine sets the memory that will favor the hero's past memory.
  
  # example Liu Bei = Guan Yu, Zhang Fei, Zhao Yun, Jian Yong, Sun Qian, Mi Zhu, Chen Dao(TUP)

• Confiure gathering hero
  
  The gathering feature is a feature that moves the heroes waiting for appointment to a faction that matches the historical facts to be commissioned. You can set in advance what faction the hero will gather into.
  
  
  1. Following hero
     The following hero is the hero that the hero followed according to historical facts. This is the highest priority setting, and it is the relationship between 'Guan Yu' and 'Liu Bei'. Or, it could be a parent-child relationship or a relationship that follows a oath-sworn friend.
     
  2. Favorite faction
     If there is no following hero, or if there is no following hero on the map, the target hero is moved to "favorite faction". If there is no "Sun Ce", "Da Qiao" is transferred to "Sun Jian" faction's recruitment pool.
     
  3. Second-favorite faction
     It is the faction chosen when there are no following hero or not on map, and the favorite faction collapsed. If there is no "Han Fu" faction, "Zhang He" will be moved to the recruitment pool of "Cao Cao" faction.
     
  4. Birth region
     When neither a following nor a favorite faction can be found, gathering hero be moved to the recruitment pool of the faction occupying the hero's birth region. It is a setting that 'Diaochan' heading to "Luoyang" when there is no 'Lu Bu'.
     
  5. Birth year
     This is a setting that spawns in factions based on the priority of Following>Favorite>Second-Favorite preferences before the gathering hero reaches adulthood. If a birth year is not set, hero not be spawned.
  
  Here's how to set 'gathering hero' in the " $(game)/sandbox/heroes_config.txt " file.
  
  
  TheG.heroes.set.gathering, hero, follwing hero, favorite, second-favorite, birth region, birth year
  
  Gathering heroes can be vanilla heroes or heroes in other mods. The principle of setting 'gathering' setting' for hero is as follows.
  
  
  • If you set it for an existing gathering hero, it overrides the 'existing setting'.
    
  • If the hero is not an existing gathering hero, it will register a new one.
    
  • If there is no appropriate option, either the "," comma alone is used, or the "_" underscore character is used to indicate 'empty option'.
    
  • One of the following heroes and favorite faction must be specified.
    
  • Parameters after the favorite faction can be omitted.
  
  Some example inputs could be:
  
  
  TheG.heroes.set.gathering, Lu Ji, Lu Bu, Dong Zhou, _, Taiyuan, 205 TheG.heroes.set.gathering, Fan Chou, Dong Zhou TheG.heroes.set.gathering, Mao Jie, , Cao Cao, _, jiuzhen TheG.heroes.set.gathering, yang_ren, , zhang_lu
  
  
  • Lu Ji
    Lu Ji has set 'following hero' and 'favorite faction'. If the faction 'following hero' belongs is the same as 'fovorite faction', it is as if there is no favorite faction. If there are neither 'Lu Bu' nor' Dong Zhuo' faction, 'Lu Ji' is moved to the faction that occupy 'Taiyuan' region, the birthplace of 'Lu Bu'.

This mod uses the sandbox/heroes_config.txt file located under the game directory for mod settings.

If the above file does not exist, the default settings are used. If you want to alter the default setting, create "heroes_config.txt" in $(game)/sandbox directory. You may need to create 'sandbox' directory too.

The default settings for this mod are as follows:

# # Notification configurations # # To turn on/off (true/false) TheG.heroes.notify.gather, false # Turn off hero gathering notifications TheG.heroes.notify.spawn, false # Turn off hero spawn... TheG.heroes.notify.recruit, false # Turn off hero spawn... TheG.heroes.notify.resign, false # Turn off hero resign... TheG.heroes.notify.die, false # Turn off hero death... TheG.heroes.notify.clone, false # Turn off duplicate clones... TheG.heroes.notify.come_of_age, false # Turn off come of age notifications # Gathering settings TheG.heroes.gather.spawn, false # Prohibits minor heroes from spawning TheG.heroes.gather.occupy, false # Prohibits gathering the heroes when expanding # When the duplicate historical hero and clone is detected(No Sandbox or not configured) TheG.heroes.clone.duplicate_historical_hero, true # Banish it TheG.heroes.clone.duplicate_name_clone, true # Banish it # (Ex) Adding a new gathering info. TheG.heroes.set.gathering, ma_yunlu, ma_teng, ma_teng, _, wuwei, 205 # new gathering
• If there is a "#" character, it is not read after the "#" character. If you use a "#" character before a line, the line is ignored. And not case sensitive.
  
• You only need to put lines different from the defaults in the 'heroes_config.txt'.

• notify.gather
  Shows a notification when a hero is forcibly gathered by this mod. This is a notification that is displayed when joining a predefined hero in accordance with the timing of the AI faction expansion.
• notify.died
  Notifies when a gathering hero is dead.
  
• notify.resigned
  It is notified when a hired gathering hero comes out to recruitment pool.
  
• notify.comes_of_age
  Notified when the registered gathering hero has reached adulthood in AI faction. In the player faction, "Adult Event" occurs.
  
• notify.spawn
  Notified when gathering heroes spawn as their favorite faction 1-2 years before they reach adulthood. Heroes with an adult event are spawned with a high affinity for that faction.
  
• notify.duration
  Set the duration for which notifications are shown through the "adviser". The default is 6, and 2~10 can be set.

Detects duplicated historical heroes and clones, moves them to the 'Han Empire' faction, and kills them. When the duplicate historical hero and clone is detected. (No Sandbox or not configured)
TheG.heroes.clone.duplicate_historical_hero, true TheG.heroes.clone.duplicate_name_clone, true
• duplicated_historical_hero
  Detect duplicates of historical heroes in the TK database such as 'Guan Yu', 'Zhang Fei', and 'Ji Ben'. This is not clone, but a unique hero which is created by TW:TK event or other mod when the historical hero is already on the map. It will be moved to Han empire or such faction and killed at the end of the turn.
  
  
• duplicated_name_clone
  Detect clones who has the same name as the historical heroes in the TW:TK database, it will be killed at the end of the turn.

• gather.spawn
  Set whether to spawn registered gathering heroes as favorite factions. If you don't spawn a hero, the TW:TK engine will randomly generate that hero as a random faction talent pool, but it's also likely that it will not appear in your favorite faction's recruitement pool forever.
  
• gather.occupy
  When the AI faction expands, it turns on/off a function that gathers predetermined heroes.

If there is a file "$(game)/sandbox/log_heroes.txt", it will output the mod log. It is not necessary for ordinary users to view the log.