[mod] Gender Metamorphosis · 蝶变之路 | CK3 Gender Overhaul Mod V1.2 1.2.0

📊 Overview

🚀 Major New Features

1. Hormone Therapy System Refactor

Impact: Core gameplay mechanics
Technical Implementation: Independent silent event system

New Files:

• events/ftm_hormone_popup_events.txt - FTM hormone therapy popup events (6 events)
• events/ftm_hormone_silent_events.txt - FTM hormone therapy silent event system
• events/gm_hormone_silent_events.txt - GM hormone therapy silent event system
• common/modifiers/ftm_hormone_modifiers.txt - FTM hormone therapy modifiers (8 stages)
• common/modifiers/gm_hormone_modifiers.txt - GM hormone therapy modifiers (9 stages)

Architecture Changes:

• Old Version: Monthly pulse event chain driving therapy progression
• New Version: Independent silent event system managing therapy stages
• Advantages: Better modularity, higher maintainability, improved performance

Stage Coverage:

• FTM Hormone Therapy: M1 → M2 → M4 → M6 → M8 → M12 → M18 (7 stages)
• GM Hormone Therapy: M1 → M2 → M4 → M6 → M8 → M12 → M18 → M24 (8 stages)

2. Social Reaction System

Impact: Character interactions, narrative experience
New File: events/pussyman_social_reactions.txt

Event Chain Coverage:

• E-1: Close family reaction (pussyman_transition.26)
• E-2: Court gossip (pussyman_transition.27)
• E-3: Faith response (pussyman_transition.28)
• E-5: Rival humiliation (pussyman_transition.30)
• E-7: Rumor spread (pussyman_transition.32/.33)
• E-8: Cultural echo (pussyman_transition.34)

Features:

• Dynamically generates reactions based on character relationships, faith, culture, and other factors
• Enhances immersion and realism of the game world

3. Castration Artifact System

Impact: Game economy, character development
New Files:

• common/modifiers/zzz_gm_artifact_modifiers.txt - Artifact modifier definitions
• common/scripted_effects/zzz_gm_castration_artifact_effects.txt - Artifact creation effects

Artifact Types:

1. Penis Casket (Castration Artifact Box)

   • 3 quality tiers: Common, Fine, Legendary
   • Provides Prestige, Dread, and other attribute bonuses

2. Semen Pouch (Castration Artifact Pouch)

   • 3 quality tiers
   • Provides Intrigue, Learning, and other attribute bonuses

Creation Mechanism:

• Determines quality based on castrated character's title rank, prowess, etc.
• Supports full set (Penis Casket + Semen Pouch) and penis-only modes

4. Visual Customization Enhancement

Impact: Character appearance, user interface
New Files:

• common/genes/zz_male_chest_slider.txt - Male chest size slider
• gfx/portraits/portrait_modifiers/zz_gm_female_penis_customization.txt - Female penis customization
• common/scripted_guis/zz_gm_cbo_barber.txt - Better Barbershop GUI extension

Features:

• Male Chest Slider: Supports smooth transition from flat to maximum, auto-shrinks when wearing clothes
• Female Penis Support: No trait required, can be toggled via barbershop interface
• Better Barbershop Integration: Shows male GUI options for transman and female characters with gm_female_penis variable

🔧 Improvements & Optimizations

1. Gene System Enhancement

Modified Files:

• common/genes/zz_gm_vagina_genes.txt (+1,155B)

  • Expanded from simple definitions to include detailed curve settings
  • Added smooth transition logic for vagina appearance and penis suppression
  • Supports gradual changes starting from DNA=0.5

• common/genes/zz_gm_genes_penis_size.txt (+1,248B)

  • Added female penis size and width gene definitions
  • Provides independent penis morphology control for female characters

2. Genital Display Optimization

Modified File: gfx/portraits/portrait_modifiers/zz_gm_genital_fix.txt (+1,365B)

Improvements:

• Added support for female penis (gm_female_penis variable)
• Added no_vagina_penis_owner entry to suppress vagina display for females with penis
• Added barbershop button to control penis state (erect/flaccid)
• Optimized penis state handling when clothed

3. Event System Expansion

Modified Files:

• events/pussyman_transition_events.txt (+5,152B)

  • Simplified pussyman_transition.10 event, removed monthly pulse logic
  • Added integrated calls to social reaction event chain
  • Modified base discovery risk probability (from 0.05 to 0.3)
  • Added new events (e.g., pussyman_transition.35 surgery reminder)

• events/pussyman_corrupt_events.txt (+1,597B)

  • Added "trick courtier into voluntary castration" option
  • Integrated castration artifact creation effects
  • Expanded trigger conditions to support more traits

4. Localization Support

New Files: 18 .yml localization files

• Covers all text content for new features
• Supports multi-language expansion

5. User Interface Enhancement

New Files:

• gfx/interface/illustrations/decisions/ - 19 AI-generated decision illustrations
• images/ - 6 mod showcase images (cover.jpg, fourlove.png, etc.)

🗑️ Removed Content

1. Development File Cleanup

Removed Files:

• transform_sex_animations.py - Python animation conversion script
• GDD_Gender_Metamorphosis_Systems_Design.md - Game design document
• __pycache__/ - Python compilation cache

Reason: Streamlined release version, only essential game files included

2. Backup File Cleanup

Removed Files: ~27 .bak backup files

• common/genes/*.bak4
• common/scripted_effects/carn_sex_scene_animation_lists.txt.bak*
• gfx/portraits/portrait_animations/sex_animations_combined.txt.bak*

Reason: Improved code cleanliness, reduced file clutter

3. Feature Disable

Modified File: events/zzz_pussyman_tribute_mission.txt → .txt.disabled

Impact: Disabled castration option in tribute missions
Reason: May be for game balance or conflict with other systems
Recovery Method: Rename to remove .disabled extension

📈 Performance Optimization

1. Animation System Streamlining

Modified File: gfx/portraits/portrait_animations/sex_animations_combined.txt (-12,538B)

Optimizations:

• Removed redundant animation definitions
• Optimized animation transition logic
• Reduced memory usage

2. Event Processing Optimization

Architecture Change: Changed from event chain driven to independent silent event system

Advantages:

• Reduces event queue congestion
• Improves processing efficiency
• Better modularity

🧪 Technical Details

1. New Gene Definitions

# Male chest slider gene
gene_bs_chest_size = {
    index = 0
    male = {
        min = 0.0
        max = 1.0
        # Supports smooth transition from flat to maximum
    }
}

2. Silent Event System Architecture

# FTM hormone therapy silent event
ftm_hormone.500 = {
    # Self-looping monthly pulse event
    # Manages therapy flags, modifiers, and discovery risk
}

3. Artifact Quality Judgment Logic

# Determine quality based on castrated character's identity
if = {
    limit = { has_title = title:e_byzantium }
    set_artifact_quality = 3  # Legendary quality
}

🎮 Game Balance Adjustments

1. Discovery Risk Adjustment

• Old Version: Base discovery probability 0.05 (5%)
• New Version: Base discovery probability 0.3 (30%)
• Impact: Increases game challenge, enhances strategic depth

2. Hormone Therapy Stages

• FTM Therapy: 7 stages, covering 18 months
• GM Therapy: 8 stages, covering 24 months
• Balance Point: Smoother stage transitions, more pronounced effects

3. Social Reaction Weights

• Dynamically adjusts reaction intensity based on character relationships
• Faith and culture factors influence reaction types
• Increases diversity in the game world

🐛 Known Issues

1. Compatibility Issues

• Old version saves may require console commands to fix hormone therapy state
• Recommend new game for full feature experience

2. Localization Gaps

• Some new content may lack translations
• English text is the default language

3. Performance Impact

• Large number of characters undergoing hormone therapy simultaneously may affect performance
• Recommend high-end configuration for full feature experience

📊 总览

🚀 主要新功能

1. 激素治疗系统重构

影响范围: 核心游戏机制
技术实现: 独立静默事件系统

新增文件:

• events/ftm_hormone_popup_events.txt - FTM激素治疗弹出事件（6个事件）
• events/ftm_hormone_silent_events.txt - FTM激素治疗静默事件系统
• events/gm_hormone_silent_events.txt - GM激素治疗静默事件系统
• common/modifiers/ftm_hormone_modifiers.txt - FTM激素治疗修饰符（8个阶段）
• common/modifiers/gm_hormone_modifiers.txt - GM激素治疗修饰符（9个阶段）

架构变化:

• 旧版本: 使用月度脉冲事件链驱动治疗进展
• 新版本: 独立的静默事件系统管理治疗阶段
• 优势: 模块化更强，可维护性更高，性能更好

阶段覆盖:

• FTM激素治疗: M1 → M2 → M4 → M6 → M8 → M12 → M18（7个阶段）
• GM激素治疗: M1 → M2 → M4 → M6 → M8 → M12 → M18 → M24（8个阶段）

2. 社交反应系统

影响范围: 角色互动、叙事体验
新增文件: events/pussyman_social_reactions.txt

事件链覆盖:

• E-1: 至亲反应（pussyman_transition.26）
• E-2: 宫廷流言（pussyman_transition.27）
• E-3: 信仰回应（pussyman_transition.28）
• E-5: 宿敌羞辱（pussyman_transition.30）
• E-7: 传闻扩散（pussyman_transition.32/.33）
• E-8: 文化回响（pussyman_transition.34）

特点:

• 根据角色关系、信仰、文化等因素动态生成反应
• 增加游戏世界的沉浸感和真实感

3. 阉割宝物系统

影响范围: 游戏经济、角色发展
新增文件:

• common/modifiers/zzz_gm_artifact_modifiers.txt - 宝物修饰符定义
• common/scripted_effects/zzz_gm_castration_artifact_effects.txt - 宝物创建效果

宝物类型:

1. 阳具宝匣 (Castration Artifact Box)

   • 3个品质等级：普通、精良、传奇
   • 提供威望、恐惧等属性加成

2. 子孙锦囊 (Castration Artifact Pouch)

   • 3个品质等级
   • 提供密谋、学习等属性加成

创建机制:

• 根据被阉者的头衔等级、武勇值等判断品质
• 支持全套（阳具宝匣+子孙锦囊）和仅阴宝两种模式

4. 视觉定制系统增强

影响范围: 角色外观、用户界面
新增文件:

• common/genes/zz_male_chest_slider.txt - 男性胸部大小滑块
• gfx/portraits/portrait_modifiers/zz_gm_female_penis_customization.txt - 女性阴茎自定义
• common/scripted_guis/zz_gm_cbo_barber.txt - Better Barbershop GUI扩展

功能特点:

• 男性胸部滑块: 支持从平坦到最大的平滑过渡，穿着衣服时自动收缩
• 女性阴茎支持: 无需特质，通过理发店界面即可切换
• Better Barbershop集成: 为transman和拥有gm_female_penis变量的女性角色显示男性GUI选项

🔧 改进与优化

1. 基因系统增强

修改文件:

• common/genes/zz_gm_vagina_genes.txt (+1,155B)

  • 从简单定义扩展为包含详细曲线设置
  • 增加阴道出现和阴茎抑制的平滑过渡逻辑
  • 支持从DNA=0.5开始的渐进式变化

• common/genes/zz_gm_genes_penis_size.txt (+1,248B)

  • 增加女性阴茎大小和宽度的基因定义
  • 为女性角色提供独立的阴茎形态控制

2. 生殖器显示优化

修改文件: gfx/portraits/portrait_modifiers/zz_gm_genital_fix.txt (+1,365B)

改进内容:

• 增加对女性阴茎的支持（gm_female_penis变量）
• 增加no_vagina_penis_owner条目，抑制拥有阴茎的女性的阴道显示
• 增加理发店按钮控制阴茎状态（勃起/疲软）的功能
• 优化穿衣时的阴茎状态处理

3. 事件系统扩展

修改文件:

• events/pussyman_transition_events.txt (+5,152B)

  • 简化pussyman_transition.10事件，移除月度脉冲逻辑
  • 增加社交反应事件链的集成调用
  • 修改发现风险的基础概率（从0.05增加到0.3）
  • 增加新事件（如pussyman_transition.35手术提醒）

• events/pussyman_corrupt_events.txt (+1,597B)

  • 增加"诱骗courtier自愿阉割"选项
  • 集成阉割宝物创建效果
  • 扩展触发条件，支持更多特质

4. 本地化支持

新增文件: 18个.yml本地化文件

• 覆盖新增功能的所有文本内容
• 支持多语言扩展

5. 用户界面增强

新增文件:

• gfx/interface/illustrations/decisions/ - 19个AI生成的决策插图
• images/ - 6个mod展示用图片（cover.jpg, fourlove.png等）

🗑️ 移除内容

1. 开发文件清理

移除文件:

• transform_sex_animations.py - Python动画转换脚本
• GDD_Gender_Metamorphosis_Systems_Design.md - 游戏设计文档
• __pycache__/ - Python编译缓存

原因: 发布版本精简，仅包含必要的游戏文件

2. 备份文件清理

移除文件: 约27个.bak备份文件

• common/genes/*.bak4
• common/scripted_effects/carn_sex_scene_animation_lists.txt.bak*
• gfx/portraits/portrait_animations/sex_animations_combined.txt.bak*

原因: 提高代码整洁度，减少文件混乱

3. 功能禁用

修改文件: events/zzz_pussyman_tribute_mission.txt → .txt.disabled

影响: 禁用了朝贡任务中的阉割选项
原因: 可能是为了平衡游戏性或与其他系统冲突
恢复方法: 重命名移除.disabled扩展名即可

📈 性能优化

1. 动画系统精简

修改文件: gfx/portraits/portrait_animations/sex_animations_combined.txt (-12,538B)

优化内容:

• 移除冗余动画定义
• 优化动画过渡逻辑
• 减少内存占用

2. 事件处理优化

架构变化: 从事件链驱动改为独立静默事件系统

优势:

• 减少事件队列拥堵
• 提高处理效率
• 更好的模块化

🧪 技术细节

1. 新增基因定义

# 男性胸部滑块基因
gene_bs_chest_size = {
    index = 0
    male = {
        min = 0.0
        max = 1.0
        # 支持从平坦到最大的平滑过渡
    }
}

2. 静默事件系统架构

# FTM激素治疗静默事件
ftm_hormone.500 = {
    # 自我循环的每月脉冲事件
    # 管理治疗标志、修饰符和发现风险
}

3. 宝物品质判断逻辑

# 根据被阉者身份判断品质
if = {
    limit = { has_title = title:e_byzantium }
    set_artifact_quality = 3  # 传奇品质
}

🎮 游戏平衡性调整

1. 发现风险调整

• 旧版本: 基础发现概率 0.05 (5%)
• 新版本: 基础发现概率 0.3 (30%)
• 影响: 增加游戏挑战性，提高策略深度

2. 激素治疗阶段

• FTM治疗: 7个阶段，覆盖18个月
• GM治疗: 8个阶段，覆盖24个月
• 平衡点: 阶段过渡更加平滑，效果更加显著

3. 社交反应权重

• 根据角色关系动态调整反应强度
• 信仰和文化因素影响反应类型
• 增加游戏世界的多样性