Skip to content

Framework Object & File Database

Jump to bottom
udkudk edited this page Jun 20, 2026 · 19 revisions

Table of Contents

This Wiki page was last updated for $$\textcolor{aqua}{Stellaris}$$ version v4.4.*

You can see The Name Convention for these Files and Objects in Framework Name Convention for Objects and Files wiki page.

1. Vanilla Overwrites, Engine Adjustments & Defs (OVERWRITE)

  • Paradox Target Directories: common/defines/ or direct filename targeting in structural folders
  • Rule Reminder: Modifying core system defines alters baseline values like calculations, ship commands, or path tracking limits globally. Defs adjustments load via FIOS rules; naming your override file with a top-priority alphabetical sorting token (e.g., !_DEBCF_defines.txt) ensures the parser applies your framework settings cleanly over default parameters.

Warning

Overwrites can't use our Naming Convention in Framework Name Convention for Objects and Files wiki page. Use the Vanilla Object/File name exactly.

Important

Entry Fields:

  • EXACT_FILE_DEFINE_ETC_NAME
    Target File / Folder: common/defines/ or targeted vanilla filename
    Override Mode: Variable Injection Engine Override Block
    Target Scope: Global Game Mechanics Core System Engine
    Persistence: Complete app runtime state memory registry footprint
    Details: Explicit variable resets that modify hardcoded rules, such as maximum fleet speed caps, background ticking thread thresholds, AI evaluation multipliers, or base pathing parameters.

Tip

Template For New Entries

* `EXACT_FILE_DEFINE_ETC_NAME`
   |  |  |
   | :--- | :--- |
   | Target File / Folder: | [Specify target directory path and the specific filename being modified] |
   | Override Mode: | [Define class: Native NDef override block adjustment / Structural file replacement] |
   | Target Scope: | [Specify impacted component context layer: e.g., NGameplay, NEconomy, NShip] |
   | Persistence: | Complete app runtime state memory registry footprint |
   | Details: | [Log precise default variables changed, modified values used, performance thread impact notes, and script dependency paths.] |

2. Architectural Layer: Omnipresent Runtime Hooks & Memory States

This foundational infrastructure holds global engine pointers, mathematical script constraints, and systemic memory registries accessible across all scopes.

2.1. Scripted Global Variable Constants (GVAR)

  • Paradox Target Directory: common/scripted_variables/
  • Rule Reminder: Loaded via FIOS rules. Must be prefixed with @ inside scripts. The trailing custom purpose string block must stay strictly lowercase and under 20 characters to preserve parsing memory footprints.

Important

Entry Fields:

  • DEBCF_GVAR_NOSCOPE_<purpose>
    File Path: common/scripted_variables/!_DEBCF_core_variables.txt
    Calling Reference Format: @DEBCF_GVAR_NOSCOPE_<purpose>
    Target Scope: Global script compilation layer
    Persistence: Static baseline compile register
    Details: Hardcoded float or integer constants evaluated globally during script loading routines to override game engine behaviors dynamically.

Tip

Template For New Entries

* `DEBCF_GVAR_NOSCOPE_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/scripted_variables/!_DEBCF_core_variables.txt` |
   | Calling Reference Format: | `@DEBCF_GVAR_NOSCOPE_<purpose>` |
   | Target Scope: | Global script compilation layer |
   | Persistence: | Static baseline compile register |
   | Details: | [Log the fixed mathematical float value, integer constant, or static mod check parameter defined for global file parsing usage.] |
  • DEBCF_GVAR_NOSCOPE_has_debcf_mod = 1
    File Path: common/scripted_variables/00_DEBCF_core_scripted_variables.txt
    Calling Reference Format: @DEBCF_GVAR_NOSCOPE_has_debcf_mod
    Target Scope: Global script compilation layer
    Persistence: Static baseline compile register
    Details: This Mod Compatibility Variable is saved in the Stellaris Modding Den discord, Spreadsheet of mod compatibility variables file.

    The reason we use global scripted variables is because they are loaded during Game Engine Launch.

    Together with usage of Inline Scripts, you can configure normally unmodifiable files (such as buildings, districts etc...) to customise themselves according to existence of other mods.

2.2. Scripted Local Variable Macros (LVAR)

  • Rule Reminder: Local macros are file-bound string block replacements parsed dynamically during scope setup routines.

Important

Entry Fields:

  • DEBCF_LVAR_<SCOPE>_<purpose>
    File Path: Dynamic context path placement
    Calling Reference Format: @DEBCF_LVAR_<SCOPE>_<purpose>
    Target Scope: Local system compilation block boundary
    Persistence: Volatile baseline script compilation layer
    Details: Macro replacements handled instantly by the parser logic rules to optimize complex scripted triggers or effects within a single document layout.

Tip

Template For New Entries

* `DEBCF_LVAR_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | [Insert calling component file path context here] |
   | Calling Reference Format: | `@DEBCF_LVAR_<SCOPE>_<purpose>` |
   | Target Scope: | Local system compilation block boundary |
   | Persistence: | Volatile baseline script compilation layer |
   | Details: | [Document the local macro string substitution logic, math overrides, or conditional inline case blocks bounded to this entry.] |

2.3. Dynamic Scope Saved Variables (SVAR)

  • Rule Reminder: Clear out runtime SVAR inputs systematically before execution leaves a scope block to protect stability. Keep purpose under 20 characters to respect the 64-character limit.

Important

Entry Fields:

  • DEBCF_SVAR_<SCOPE>_<purpose>
    File Path: Internal game save state memory registry
    Calling Reference Format: check_variable / set_variable / change_variable
    Target Scope: Contextual pointer scope block (e.g., country, planet, fleet)
    Persistence: Persistent runtime save game matrix
    Details: Numerical trackers used in background event checks or economic equations. Truncated layout mechanics apply if the total signature string spills past 64 characters.

Tip

Template For New Entries

* `DEBCF_SVAR_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | Internal game save state memory registry |
   | Calling Reference Format: | `check_variable` / `set_variable` / `change_variable` |
   | Target Scope: | [Specify target object block: country, planet, fleet, etc.] |
   | Persistence: | Persistent runtime save game matrix |
   | Details: | [Specify runtime persistence details, what scripts modify this value, and scope context rules needed to fetch this parameter accurately.] |

2.4. Galaxy Game-State Switches (GFLAG)

  • Rule Reminder: Global flags persist engine-wide. Overuse impacts memory lookup indexes; ensure unique naming formats to prevent naming collisions with other mods.

Important

Entry Fields:

  • DEBCF_GFLAG_<purpose>
    File Path: Global game state condition manager
    Calling Reference Format: set_global_flag / has_global_flag
    Target Scope: Root engine layer
    Persistence: Complete save data lifecycle profile
    Details: Boolean game state switches evaluating galactic events, crisis initialization setups, or framework backend diagnostic tracking boots engine-wide.

Tip

Template For New Entries

* `DEBCF_GFLAG_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | Global game state condition manager |
   | Calling Reference Format: | `set_global_flag` / `has_global_flag` |
   | Target Scope: | Root engine layer |
   | Persistence: | Complete save data lifecycle profile |
   | Details: | [Outline global runtime parameters, startup states, and subsystem compilation toggles mapped to this flag.] |

2.5. Scoped Entity Operational Flags (SFLAG)

  • Rule Reminder: Flags tied to specific entities clear automatically if the parent object is destroyed or annexed by script instructions.

Important

Entry Fields:

  • DEBCF_SFLAG_<SCOPE>_<purpose>
    File Path: Entity data structure allocation bounds
    Calling Reference Format: set_country_flag / set_planet_flag / has_fleet_flag
    Target Scope: Bound to the precise calling component scope context
    Persistence: Object runtime persistence loop lifespan
    Details: Binary data targets processing system permissions, AI evaluation adjustments, or quest block stages tracking on targeted game entities.

Tip

Template For New Entries

* `DEBCF_SFLAG_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | Entity data structure allocation bounds |
   | Calling Reference Format: | `set_<scope>_flag` / `has_<scope>_flag` |
   | Target Scope: | [Specify scope anchor target: country, planet, leader, fleet] |
   | Persistence: | Object runtime persistence loop lifespan |
   | Details: | [Detail boolean behavior, condition requirements, lifetime limits, and modification scopes.] |

2.6. Persistent Global Event Targets (GTARGET)

  • Rule Reminder: Target references remain valid until explicitly overridden or wiped out via background clean script loops.

Important

Entry Fields:

  • DEBCF_GTARGET_<purpose>
    File Path: Asynchronous engine global target cache
    Calling Reference Format: save_global_event_target_as / event_target:
    Target Scope: Root execution pointer bridge logic
    Persistence: Persistent runtime execution context memory
    Details: Saves real-time object coordinates pointing to explicit anomalies, systems, or countries to route logic cleanly across different event documents.

Tip

Template For New Entries

* `DEBCF_GTARGET_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | Asynchronous engine global target cache |
   | Calling Reference Format: | `save_global_event_target_as` / `event_target:` |
   | Target Scope: | Root execution pointer bridge logic |
   | Persistence: | Persistent runtime execution context memory |
   | Details: | [Document object target references managed by this variable to pass specific targets directly to distant events.] |

2.7. Volatile Scoped Event Targets (TTARGET)

  • Rule Reminder: Wiping local targets before events or script triggers finish running prevents severe engine object leak loops.

Important

Entry Fields:

  • DEBCF_TTARGET_<purpose>
    File Path: Active execution block volatile buffer registers
    Calling Reference Format: save_event_target_as / event_target:
    Target Scope: Local event context runtime bubble
    Persistence: Erased automatically when script processing block terminates
    Details: Fleet target filters, pop sorting setups, or sector checks cached briefly to execute complex multi-line conditions inside script files.

Tip

Template For New Entries

* `DEBCF_TTARGET_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | Active execution block volatile buffer registers |
   | Calling Reference Format: | `save_event_target_as` / `event_target:` |
   | Target Scope: | Local event context runtime bubble |
   | Persistence: | Erased automatically when script processing block terminates |
   | Details: | [Detail brief usage patterns, sorting criteria, and immediate target validation scopes.] |

3. Architectural Layer: Core Logic & Scripting Engines

This layer houses the foundational execution files, triggers, macros, diagnostic outputs, and text compilation mechanics that process the calculations of the framework.

3.1. Asynchronous Logic Routines (EVENT)

  • Paradox Target Directory: events/
  • Rule Reminder: Every event file must declare an all-uppercase namespace matching its prefix.

Important

Entry Fields:

  • DEBCF_EVENT_<SCOPE>_<purpose>
    File Path: events/DEBCF_EVENT_<SCOPE>_<purpose>.txt
    Declared Namespace: DEBCF_EVENT_<SCOPE>
    Target Scope: Contextual focus pointer arrays
    Linked Hooks: common/on_actions/ pulses or immediate triggers
    Details: Controls game ticks, crisis story progression systems, or pop calculation matrices. Modulates empire structures via target modifications.

Tip

Template For New Entries

* `DEBCF_EVENT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `events/DEBCF_EVENT_<SCOPE>_<purpose>.txt` |
   | Declared Namespace: | `DEBCF_EVENT_<SCOPE>` |
   | Target Scope: | [Specify scope block: country, planet, fleet, system, etc.] |
   | Linked Hooks: | [Specify on_action calling triggers or dependent event chains] |
   | Details: | [Provide a detailed description outlining why this event fires, what triggers it, and the performance footprint it introduces to the monthly game tick.] |

3.2. Engine Pulse & Lifecycle Hooks (ACTION)

  • Paradox Target Directory: common/on_actions/

Important

Entry Fields:

  • DEBCF_ACTION_<SCOPE>_<purpose>
    File Path: common/on_actions/DEBCF_ACTION_<SCOPE>_<purpose>.txt
    Vanilla Anchors: On-pulse matrices or condition overrides
    Execution Target: Injected array logic loops
    Overwrite Model: Appends safely without direct code adjustments
    Details: Extends base engine timeline cycles (monthly pulses, ship tracking events, combat loops) to inject framework configurations cleanly into processing pools.

Tip

Template For New Entries

* `DEBCF_ACTION_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/on_actions/DEBCF_ACTION_<SCOPE>_<purpose>.txt` |
   | Vanilla Anchors: | [Specify vanilla hook targets: e.g., on_monthly_pulse, on_entering_system] |
   | Execution Target: | [List calling events or scripted effects triggered by this hook] |
   | Overwrite Model: | [Safe append script inject layout / Full vanilla replacement loop] |
   | Details: | [Insert description of the engine hook being utilized, what event arrays it executes, and whether it overwrites or appends to vanilla core game loops.] |

3.3. Structural Snippet Replicators (INLINE)

  • Paradox Target Directory: common/inline_scripts/

Important

Entry Fields:

  • DEBCF_INLINE_<SCOPE>_<purpose>
    File Path: common/inline_scripts/DEBCF_INLINE_<SCOPE>_<purpose>.txt
    Parameter Inputs: Defined script variables passed via insertion codes
    Context Target: Inline parsing block replacement fields
    Overwrite Model: Dynamic compiler macro deployment
    Details: Standardizes math checks or blocker sweeping parameters, replacing copy-paste code segments to keep documents scannable.

Tip

Template For New Entries

* `DEBCF_INLINE_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/inline_scripts/DEBCF_INLINE_<SCOPE>_<purpose>.txt` |
   | Parameter Inputs: | [List parameters required by this snippet: e.g., COST_MULTIPLIER] |
   | Context Target: | [Specify valid compilation targets: country script block, planet script, etc.] |
   | Overwrite Model: | Dynamic compiler macro deployment |
   | Details: | [Detail the repetitive structural logic chunk contained inside this inline file. Note down explicit variable requirements needed before inserting this inline block into script files.] |

3.4. Parametric Command Blocks (SEFFECT)

  • Paradox Target Directory: common/scripted_effects/
  • Rule Reminder: Every custom effect script manipulating economic balances or moving fleets must be wrapped in an explicit trigger validation layer to secure engine threads.

Important

Entry Fields:

  • DEBCF_SEFFECT_<SCOPE>_<purpose>
    File Path: common/scripted_effects/DEBCF_SEFFECT_<SCOPE>_<purpose>.txt
    Variable Dependencies: Intercepted parameters or active tracking integers
    Execution Scope: Enforced logic target expectations
    Overwrite Model: Safe non-destructive injection behavior
    Details: Reusable multi-line effect paths executing structural adjustments (e.g., resource modifiers, population reallocation) inside active event branches.

Tip

Template For New Entries

* `DEBCF_SEFFECT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/scripted_effects/DEBCF_SEFFECT_<SCOPE>_<purpose>.txt` |
   | Variable Dependencies: | [List expected metrics passed or queried inside the script path] |
   | Execution Scope: | [Specify scope constraints: e.g., this = country, from = planet] |
   | Overwrite Model: | Safe non-destructive injection behavior |
   | Details: | [Provide a breakdown of the inputs required, the logic math applied, and validation targets to prevent unexpected null pointer crashes.] |

3.5. Conditional Engine Evaluators (STRIGGER)

  • Paradox Target Directory: common/scripted_triggers/
  • Rule Reminder: Triggers load using LIOS (Last In Only Served) rules. Duplicate file entries completely overwrite earlier definitions.

Important

Entry Fields:

  • DEBCF_STRIGGER_<SCOPE>_<purpose>
    File Path: common/scripted_triggers/DEBCF_STRIGGER_<SCOPE>_<purpose>.txt
    Boolean Outputs: True/False evaluation signatures
    Scope Alignment: Explicit compiler validation layers
    Overwrite Model: Full configuration overrides (LIOS framework)
    Details: Groups multiple logic conditions into single boolean checks. Speeds up technology tree validation rules or fleet design asset updates.

Tip

Template For New Entries

* `DEBCF_STRIGGER_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/scripted_triggers/DEBCF_STRIGGER_<SCOPE>_<purpose>.txt` |
   | Boolean Outputs: | True/False evaluation signatures |
   | Scope Alignment: | [Specify structural bounds needed to pass validation checks safely] |
   | Overwrite Model: | Full configuration overrides (LIOS framework) |
   | Details: | [Provide a complete technical structural breakdown of the checks performed and parameters evaluated.] |

3.6. Diagnostic Failure Output Codes (ERROR)

  • Rule Reminder: Explicitly called via the native log_error effect block mechanism. Helps debug state breaks safely across the engineering team.

Important

Entry Fields:

  • DEBCF_ERROR_<SCOPE>_<purpose>
    Calling Interface: Native log_error runtime parsing block
    Logging Context: Disk storage logs directory output entries
    Execution Target: Diagnostic engine telemetry loop
    Overwrite Model: Appends lines tracking script execution path breaks
    Details: Triggers unique identifier alerts if background queries loop on null pointer data traps while scanning starbase layout contexts.

Tip

Template For New Entries

* `DEBCF_ERROR_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | Calling Interface: | Native `log_error = "DEBCF_ERROR_<SCOPE>_<purpose> [State Details]"` |
   | Logging Context: | Disk storage logs directory output entries |
   | Execution Target: | Diagnostic engine telemetry loop |
   | Overwrite Model: | Appends lines tracking script execution path breaks |
   | Details: | [Log the fallback warning format, script break trap coordinates, or corrupted index registry information tied to this alert hook.] |

4. Architectural Layer: Graphic Assets & Interface Systems

This layer handles the visual representation, rendering setups, clickable canvas blocks, and multi-lingual translation arrays.

4.1. Low-Level Texture Mapping Indexes (GFX)

  • Paradox Target Directory: interface/ (.gfx maps)
  • Rule Reminder: Loaded via FIOS rules. Filenames and scripts must adhere to standard lowercase file extensions to pass strict cross-platform filesystem validation checks.

Important

Entry Fields:

  • DEBCF_GFX_<SCOPE>_<purpose>
    File Path: interface/DEBCF_assets.gfx
    Raw Media Target: .dds texture coordinates asset configurations
    UI Hook Interface: Sprite type dictionary assignments
    Extension Format: Lowercase validation bounds configurations
    Details: Maps sprite coordinates to standard user interface templates to display diagnostic status meters on system map overlays.

Tip

Template For New Entries

* `DEBCF_GFX_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `interface/DEBCF_assets.gfx` |
   | Raw Media Target: | [Specify raw media file destination pathing matrix: e.g., gfx/interface/icons/asset.dds] |
   | UI Hook Interface: | Sprite type dictionary assignments |
   | Extension Format: | Lowercase validation bounds configurations |
   | Details: | [Detail raw asset pathways, frame sub-divisions, and orientation rules used to pass to visual menus.] |

4.2. Sound Environment Matrices (SOUND)

  • Paradox Target Directory: sound/
  • Rule Reminder: Loaded via FIOS rules. File tracks must retain standard case precision inside scripts to pass Linux filesystem checks.

Important

Entry Fields:

  • DEBCF_SOUND_<SCOPE>_<purpose>
    File Path: sound/DEBCF_audio_registry.sfx
    Raw Media Target: Spatial attenuation .wav / .ogg master assets
    Track Allocation: Category mixing definitions thresholds
    Path Check Mode: Strict uppercase/lowercase filesystem tracking
    Details: Manages track playback volume loops and alert notifications when engine conditions cross warning levels.

Tip

Template For New Entries

* `DEBCF_SOUND_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `sound/DEBCF_audio_registry.sfx` |
   | Raw Media Target: | [Specify master audio track storage destination pathing: e.g., sound/alerts/file.wav] |
   | Track Allocation: | Category mixing definitions thresholds |
   | Path Check Mode: | Strict uppercase/lowercase filesystem tracking |
   | Details: | [Log sound registry IDs, track mixing parameters, volume thresholds, and attenuation falloff patterns.] |

4.3. Window Canvas Container Forms (GUI)

  • Paradox Target Directory: interface/
  • Rule Reminder: Interface configuration files load using FIOS rules. Duplicate visual components or variables loaded later are skipped by the parser.

Important

Entry Fields:

  • DEBCF_GUI_<SCOPE>_<purpose>
    File Path: interface/DEBCF_GUI_<SCOPE>_<purpose>.gui
    Anchor Parameters: Positional resolution tracking coordinates
    Texture Pointers: GFX element layout background assets
    Processing Logic: Structural UI display box formatting definitions
    Details: Defines interface boxes, positioning offsets, and screen configurations for responsive administrative layouts.

Tip

Template For New Entries

* `DEBCF_GUI_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `interface/DEBCF_GUI_<SCOPE>_<purpose>.gui` |
   | Anchor Parameters: | [Define base grid locations: e.g., center, top_right, X/Y offsets] |
   | Texture Pointers: | [Reference GFX components utilized by this sheet box container layer] |
   | Processing Logic: | Structural UI display box formatting definitions |
   | Details: | [Detail component coordinates, scaling rules for ultra-wide setups, and responsive design properties.] |

4.4. Clickable Interface Triggers (BUTTON)

  • Paradox Target Directory: interface/

Important

Entry Fields:

  • DEBCF_BUTTON_<SCOPE>_<purpose>
    File Path: interface/DEBCF_GUI_<SCOPE>_<purpose>.gui (Embedded target)
    Visual State: Cursor collision graphics tracking textures
    Trigger Commands: Event execution commands mapping scripts
    Sound Assignments: Dynamic click audio execution links
    Details: Builds functional regions on GUI windows to clear memory arrays or run specific framework commands manually.

Tip

Template For New Entries

* `DEBCF_BUTTON_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `interface/DEBCF_GUI_<SCOPE>_<purpose>.gui` (Embedded target) |
   | Visual State: | [Reference GFX maps configured for default, mouseover, and clicking states] |
   | Trigger Commands: | [List event call bindings or custom effect sequences fired by this area] |
   | Sound Assignments: | [List SFX index records tracking interaction signals] |
   | Details: | [Outline precise trigger box boundaries, cursor states, sound triggers, and calling script connections.] |

4.5. Direct Text Entry Strings (LOCKEY)

  • Paradox Target Directory: localisation/english/
  • Rule Reminder: Every file MUST use UTF-8 with BOM file encoding patterns to protect multi-language setups from breaking Linux execution pipelines. Alterations targeting base game text keys must reside in localisation/replace/english/ subfolders to activate the engine's LIOS structural replacement routine.

Important

Entry Fields:

  • DEBCF_LOCKEY_<SCOPE>_<purpose>
    File Path: localisation/english/DEBCF_l_english.yml
    Encoding Class: UTF-8 with BOM file structure constraints
    Namespace Suffix: Integrated text target expansions (_name / _desc)
    Engine Target: Human-readable game tooltip blocks
    Details: Pairs event logs, technology paths, or error messages with translation lines across active UI windows.

Tip

Template For New Entries

* `DEBCF_LOCKEY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `localisation/english/DEBCF_l_english.yml` |
   | Encoding Class: | UTF-8 with BOM file structure constraints |
   | Namespace Suffix: | [List active standard suffix combinations: e.g., _name, _desc, _tooltip, _error] |
   | Engine Target: | Human-readable game tooltip blocks |
   | Details: | [Track raw text configurations and nested fallback formatting code entries inside localization maps.] |

4.6. Dynamic Script-Driven Translation Tables (SLOCKEY)

  • Paradox Target Directory: common/scripted_localisation/
  • Rule Reminder: Loaded via FIOS rules.

Important

Entry Fields:

  • DEBCF_SLOCKEY_<SCOPE>_<purpose>
    File Path: common/scripted_localisation/DEBCF_SLOCKEY_<SCOPE>_<purpose>.txt
    Trigger Routines: Component condition verification triggers
    Value Return Type: Context-specific localization entry references
    Overwrite Model: Engine layer parameter adjustments (FIOS format)
    Details: Changes pop prompts or dialog boxes dynamically by running trigger scripts on target leaders or planets.

Tip

Template For New Entries

* `DEBCF_SLOCKEY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/scripted_localisation/DEBCF_SLOCKEY_<SCOPE>_<purpose>.txt` |
   | Trigger Routines: | [List internal conditional validation checkpoints evaluated for text switches] |
   | Value Return Type: | [Specify output keys returned: e.g., active localization entry names] |
   | Overwrite Model: | Engine layer parameter adjustments (FIOS format) |
   | Details: | [Detail logic arrays evaluating data conditions to output translated keywords on the fly based on current target status.] |

5. Architectural Layer: Core Economy Infrastructure & Space Colony Matrices

This layer houses the structural database entry types that define policies, build limits, dynamic resource pop consumption filters, and economic scale parameters.

5.1. Government Operating Policies (POLICY)

  • Paradox Target Directory: common/policies/
  • Rule Reminder: Safely handles multi-mod scaling non-destructively through standard Object Merging behaviors. Duplicate specific policy option components will overwrite structural arrays using index execution order rules.

Important

Entry Fields:

  • DEBCF_POLICY_<SCOPE>_<purpose>
    File Path: common/policies/DEBCF_POLICY_<SCOPE>_<purpose>.txt
    AI Weight Tier: Dynamic weight configurations scaling module selectors
    Modifier Context: Empire-wide modifier arrays and variable scaling limits
    Overwrite Model: Safe non-destructive injection layer
    Details: Manages administrative empire laws that dynamically toggle resource outputs, pop growth weights, and country-scope production metrics.

Tip

Template For New Entries

* `DEBCF_POLICY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/policies/DEBCF_POLICY_<SCOPE>_<purpose>.txt` |
   | AI Weight Tier: | [Define base weight parameter thresholds: e.g., base = 1, modifier weights] |
   | Modifier Context: | [List country-scope modifiers injected upon state validation rules] |
   | Overwrite Model: | Safe non-destructive injection layer |
   | Details: | [Detail the policy options, prerequisites, valid activation condition blocks, and empire metrics changed.] |

5.2. Planetary Infrastructure Structures (BUILDING)

  • Paradox Target Directory: common/buildings/
  • Rule Reminder: Checked via background planet tile sweeps. Ensure custom building destruction modifiers pass dynamic trigger filters cleanly during system annex events to eliminate layout exceptions.

Important

Entry Fields:

  • DEBCF_BUILDING_<SCOPE>_<purpose>
    File Path: common/buildings/DEBCF_BUILDING_<SCOPE>_<purpose>.txt
    Economic Block: Upkeep inputs, resource creation rates, and cost data vectors
    Pop Job Spawns: Triggered labor type allocation slots
    Build Limit Type: Colony-wide boundary caps or system configuration constraints
    Details: Planet-side assembly configurations transforming base minerals or strategic resources into high-level framework metrics and defense parameters.

Tip

Template For New Entries

* `DEBCF_BUILDING_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/buildings/DEBCF_BUILDING_<SCOPE>_<purpose>.txt` |
   | Economic Block: | [List production costs, upkeeps, and direct modifier yields] |
   | Pop Job Spawns: | [Specify jobs generated: e.g., soldier = 2, clerk = 1] |
   | Build Limit Type: | [Define construction rule caps: planet execution maximums or capital requirements] |
   | Details: | [Log construction timelines, planetary requirement condition statements, and structural functionality updates.] |

6. Structural Databases: Progress, Unlocks & Galactic Leadership Matrix

This layer governs the structural object types handling government form choices, tree pathways, technology gating indices, and galactic character traits.

6.1. Government Authority Civics (CIVIC)

  • Paradox Target Directory: common/governments/civics/
  • Rule Reminder: Checked at empire validation boundaries. Swapping custom civics mid-game requires variable cleanup sequences to prevent empire modifier caching errors.

Important

Entry Fields:

  • DEBCF_CIVIC_<SCOPE>_<purpose>
    File Path: common/governments/civics/DEBCF_civics.txt
    Pick Requirement: Authority checks and trait condition blocks
    Empire Modifier: Modifiers yielding unity bonuses or assembly scales
    AI Pick Weight: Value sorting parameters guiding AI choices
    Details: Cultural or political trait signatures applied at empire construction or reform screens to alter system logic.

Tip

Template For New Entries

* `DEBCF_CIVIC_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/governments/civics/DEBCF_civics.txt` |
   | Pick Requirement: | [List ethics or authority limits needed to validate availability] |
   | Empire Modifier: | [Specify scalar bonuses added globally to the country scope] |
   | AI Pick Weight: | [Define base weight rules adjusted by current ethics conditions] |
   | Details: | [Detail localized resource outputs change matrices, custom government types unlocked, and mechanic switches.] |

6.2. Scientific Tree Advancements (TECHNOLOGY)

  • Paradox Target Directory: common/technology/
  • Rule Reminder: Uses objective tree configurations. Assigning deep tier flags without configuring weight modifiers will cause technology alternative selection arrays to freeze.

Important

Entry Fields:

  • DEBCF_TECHNOLOGY_<SCOPE>_<purpose>
    File Path: common/technology/DEBCF_tech.txt
    Tech Area Tier: Physics / Society / Engineering tier level categories
    Research Price: Foundational point requirement baseline factors
    Feature Unlock: Buildings, space modules, or system traits gated by completion
    Details: Structural research nodes mapped directly to weight-based selection pools that control empire tech progress pacing.

Tip

Template For New Entries

* `DEBCF_TECHNOLOGY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/technology/DEBCF_tech.txt` |
   | Tech Area Tier: | [Specify area and tier index numerical constraints: e.g., engineering, tier = 3] |
   | Research Price: | [Define baseline research cost scalar requirements] |
   | Feature Unlock: | [List building keys or component templates unlocked by this node] |
   | Details: | [Document background weight factors, prerequisite dependencies tree logic, and feature flags enabled.] |

6.3. Ideological Trait Progression Trees (TRADITION)

  • Paradox Target Directory: common/traditions/

Important

Entry Fields:

  • DEBCF_TRADITION_<SCOPE>_<purpose>
    File Path: common/traditions/DEBCF_traditions.txt
    Category Block: Associated tree grouping matrix anchors
    Node Grid Vector: Positional rendering index variables inside layouts
    Modifier Yield: Node validation rewards applied upon purchase checks
    Details: Sequential unlock slots grouped inside structural ideological categories that shape mid-game economy and defense specializations.

Tip

Template For New Entries

* `DEBCF_TRADITION_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/traditions/DEBCF_traditions.txt` |
   | Category Block: | [Reference matching parent tree template structure identifiers] |
   | Node Grid Vector: | [Define UI interface display coordinates inside the tree grid context] |
   | Modifier Yield: | [List bonuses enabled once purchased via internal code effects] |
   | Details: | [Outline tree structure connectivity limits, completion condition blocks, and specific asset hooks.] |

6.4. Ultimate Evolutionary Achievements (PERK)

  • Paradox Target Directory: common/ascension_perks/
  • Rule Reminder: Tradition completion limits must validate safely before the engine clears an slot for selection parameters.

Important

Entry Fields:

  • DEBCF_PERK_<SCOPE>_<purpose>
    File Path: common/ascension_perks/DEBCF_perks.txt
    Prerequisite Tech: Technology gating items checked for validation
    Dynamic AI Choice: Weight adjustments scoring current interstellar threats
    Global Shift Mod: High-level modifier blocks tracking empire mechanics
    Details: Strategic choices that grant sweeping empire modifiers, reveal custom mega-infrastructure options, or reshape species biology models.

Tip

Template For New Entries

* `DEBCF_PERK_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/ascension_perks/DEBCF_perks.txt` |
   | Prerequisite Tech: | [List technology object signatures checked prior to option boots] |
   | Dynamic AI Choice: | [Define value modifiers steering AI choices towards this target] |
   | Global Shift Mod: | [Specify high-level country parameters altered globally] |
   | Details: | [Document path adjustments tracking species changes, diplomatic option modifications, and logic unlocks.] |

6.5. Generational Civilization Origins (ORIGIN)

  • Paradox Target Directory: common/governments/origins/
  • Rule Reminder: Hardcoded starting parameters restrict empires to exactly one single origin slot. Duplicate selections generate immediate game startup crashes.

Important

Entry Fields:

  • DEBCF_ORIGIN_<SCOPE>_<purpose>
    File Path: common/governments/origins/DEBCF_origins.txt
    System Generation: Linked system initializer map blueprints
    Species Alteration: Hardcoded trait combinations forced upon startup traits
    Mod Description Key: Localization pointers routing intro screen summaries
    Details: Foundational world-history settings that build starting planet matrices, map stellar neighborhoods, and configure early game story elements.

Tip

Template For New Entries

* `DEBCF_ORIGIN_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/governments/origins/DEBCF_origins.txt` |
   | System Generation: | [Reference valid system initializer target IDs used for home mapping] |
   | Species Alteration: | [List forced trait records locked during nation setup screens] |
   | Mod Description Key: | [Link localization keys storing introduction interface text strings] |
   | Details: | [Outline starting modifier changes, AI country layout limits, and initial story event routines.] |

6.6. Exotic Historical Treasures (RELIC)

  • Paradox Target Directory: common/relics/

Important

Entry Fields:

  • DEBCF_RELIC_<SCOPE>_<purpose>
    File Path: common/relics/DEBCF_relics.txt
    Passive Modifier: Ongoing country bonus values activated permanently
    Triumph Upkeep Cost: Material investment consumed during manual activations
    Triumph Benefit: Instant temporary boost logic sequences or resource gains
    Details: Rare artifacts tracked via custom collection menus, offering continuous passive bonuses and powerful short-term effects when manually activated.

Tip

Template For New Entries

* `DEBCF_RELIC_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/relics/DEBCF_relics.txt` |
   | Passive Modifier: | [List permanent bonus changes applied upon addition to item cache] |
   | Triumph Upkeep Cost: | [Specify cooldown price: e.g., unity = 500, minor_artifacts = 50] |
   | Triumph Benefit: | [Detail the short-term event logic or stockpile updates executed] |
   | Details: | [Document dynamic background collection counts constraints, asset illustration maps, and unlock sites.] |

6.7. Imperial Ministry Objectives (CAGENDA)

  • Paradox Target Directory: common/council_agendas/
  • Rule Reminder: Agendas run on a multi-year preparation timeline. Setting excessive progress cost thresholds without balancing agenda speed modifiers will cause the AI to stall its government pacing.

Important

Entry Fields:

  • DEBCF_CAGENDA_<SCOPE>_<purpose>
    File Path: common/council_agendas/DEBCF_agendas.txt
    Preparation Weight: Base progress requirement modifier constants
    Active Modifier: Mid-term country bonuses applied during execution
    Finish Effect: Permanent modifier scales or immediate resource dumps
    Details: Long-term legislative objectives selected within the government council menu, altering empire performance dynamics over a fixed cycle.

Tip

Template For New Entries

* `DEBCF_CAGENDA_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/council_agendas/DEBCF_agendas.txt` |
   | Preparation Weight: | [Define base activation cost factor adjustments] |
   | Active Modifier: | [List temporary scalar bonuses active while agenda is rolling] |
   | Finish Effect: | [Detail specific code blocks or resource updates triggered on unlock] |
   | Details: | [Outline selection prerequisites, AI priority criteria, and tracking localization logs.] |

6.8. Ruler Election Platforms (MANDATE)

  • Paradox Target Directory: common/mandates/

Important

Entry Fields:

  • DEBCF_MANDATE_<SCOPE>_<purpose>
    File Path: common/mandates/DEBCF_mandates.txt
    Verification Script: Condition triggers evaluated at election cycle ends
    Success Payout: Unity metrics or resource stockpile awards
    Government Restriction: Democratic or electoral authority constraint filters
    Details: Societal promises generated by elected state leaders, rewarding the empire upon successful completion of specified infrastructure or system criteria.

Tip

Template For New Entries

* `DEBCF_MANDATE_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/mandates/DEBCF_mandates.txt` |
   | Verification Script: | [Specify trigger metrics checked: e.g., building_count >= 4] |
   | Success Payout: | [Define resource block modifications rewarded upon resolution checks] |
   | Government Restriction: | [Set matching political authority profile tracking tokens] |
   | Details: | [Document setup configurations, tracking flags, and failure penalties.] |

6.9. Strategic Cabinet Seating (CPOSITION)

  • Paradox Target Directory: common/councilor_positions/
  • Rule Reminder: Council positions scale their bonuses directly based on the assigned leader's raw skill level. Ensure fallback traits are specified to prevent blank fields on UI panels.

Important

Entry Fields:

  • DEBCF_CPOSITION_<SCOPE>_<purpose>
    File Path: common/councilor_positions/DEBCF_positions.txt
    Cabinet Class: Civic-dependent or authority-dependent visibility triggers
    Base Modifier: Flat empire enhancements active while chair is filled
    Scale Modifier: Multiplier values calculation per leader level point
    Details: Ministerial chairs inside the government interface, granting scaling bonuses determined by the traits and levels of assigned leaders.

Tip

Template For New Entries

* `DEBCF_CPOSITION_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/councilor_positions/DEBCF_positions.txt` |
   | Cabinet Class: | [Define structural requirements: e.g., unlocked by specific civic] |
   | Base Modifier: | [List flat static bonuses active upon assignment completion] |
   | Scale Modifier: | [Specify character level scale factors: e.g., modifier * councilor_level] |
   | Details: | [Outline fallback character assignment options, replacement cooldown boundaries, and localization setups.] |

6.10. Dynamic Narrative Progression Escalations (SITUATION)

  • Paradox Target Directory: common/situations/
  • Rule Reminder: Situations run on monthly ticking logic steps using progression intervals. Ensure all intermediate approach blocks map valid modifiers to prevent thread stalls when an empire changes its situational strategy mid-cycle.

Important

Entry Fields:

  • DEBCF_SITUATION_<SCOPE>_<purpose>
    File Path: common/situations/DEBCF_situations.txt
    Startup Trigger: Target condition statements initializing the event window
    Stage Stages Array: Progression point intervals tracking escalation milestones
    Active Approach Block: Selectable operational methods mapping resource impacts
    Details: Dynamic country or planetary crisis trackers tracking ticking progression speeds, triggering interactive choices, and applying escalatory modifiers.

Tip

Template For New Entries

* `DEBCF_SITUATION_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/situations/DEBCF_situations.txt` |
   | Startup Trigger: | [List prerequisites or event flags spawning this scenario] |
   | Stage Stages Array: | [Define numerical break thresholds tracking milestone point steps] |
   | Active Approach Block: | [List policy choices or cost upkeeps tied to alternative methods] |
   | Details: | [Document passive ticker scaling rates, monthly point calculations, and resolution loops.] |

6.11. Narrative Escalation Modifiers (SITUATIONMOD)

  • Paradox Target Directory: common/situation_modifiers/ or embedded in category lists

Important

Entry Fields:

  • DEBCF_SITUATIONMOD_<SCOPE>_<purpose>
    File Path: common/situation_modifiers/DEBCF_situation_modifiers.txt
    Scale Multiplier: Progression-dependent value scaling parameters
    Modifier Target: Specific entity metrics changed (e.g., stability, output)
    Details: Specialized component modifiers that dynamically amplify or decrease their output scales based on the current stage of an active situation.

Tip

Template For New Entries

* `DEBCF_SITUATIONMOD_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/situation_modifiers/DEBCF_situation_modifiers.txt` |
   | Scale Multiplier: | [Specify math curves multiplying baseline stats per progression step] |
   | Modifier Target: | [List targeted modifiers altered: e.g., planet_stability_add] |
   | Details: | [Log value parameters, situational condition tracking locks, and fallback behaviors.] |

7. Structural Databases: Character Profiles, Tactical Modules & Warfare Matrix

This final infrastructure database layer handles character behaviors, operational espionage trees, space combat mechanics, anomalies, and galaxy features.

7.1. Dynamic Character Functions (LEADERROLE)

  • Paradox Target Directory: common/leader_roles/

Important

Entry Fields:

  • DEBCF_LEADERROLE_<SCOPE>_<purpose>
    File Path: common/leader_roles/DEBCF_roles.txt
    Valid Assignment: Entity task destinations limits (Fleets / Sectors / Science)
    UI Frame Anchor: Texture coordinate offsets inside portrait windows
    Core Target Group: Base level trait selection bucket index allocations
    Details: Behavioral role frameworks assigning specialized traits, positioning filters, and core responsibilities to recruited characters.

Tip

Template For New Entries

* `DEBCF_LEADERROLE_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/leader_roles/DEBCF_roles.txt` |
   | Valid Assignment: | [Specify permitted assignments: e.g., ship commands, planet oversight] |
   | UI Frame Anchor: | [Link interface GFX layout background asset coordinates] |
   | Core Target Group: | [Set initial selection priority tags matching baseline lists] |
   | Details: | [Detail role-change logic loops, custom assignment criteria, and death replacement checks.] |

7.2. Specialized Character Archetypes (LEADERCLASS)

  • Paradox Target Directory: common/leader_classes/
  • Rule Reminder: Standardizing custom classes requires explicit configuration of associated background profiles, otherwise level up trait loops will generate background errors.

Important

Entry Fields:

  • DEBCF_LEADERCLASS_<SCOPE>_<purpose>
    File Path: common/leader_classes/DEBCF_classes.txt
    Base Level Matrix: Experience thresholds tracking generation curves
    Trait Selection Box: Branch choice layouts parsing skill distribution pathways
    Recruitment Pool: Fleet academy pricing parameters and replenishment metrics
    Details: Archetype classification modules (e.g., Commander, Scientist, Official) determining leader trait cards, leveling speeds, and recruitment limits.

Tip

Template For New Entries

* `DEBCF_LEADERCLASS_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/leader_classes/DEBCF_classes.txt` |
   | Base Level Matrix: | [Define level up scaling factors and mathematical curve caps] |
   | Trait Selection Box: | [Reference database indices filtering trait card drops] |
   | Recruitment Pool: | [Set core cost calculations: e.g., initial energy, monthly change ticks] |
   | Details: | [Log specialized UI menu hooks, level up triggers, and custom death fallback scripts.] |

7.3. Biographical Character Histories (LEADERBACK)

  • Paradox Target Directory: common/leader_backgrounds/

Important

Entry Fields:

  • DEBCF_LEADERBACK_<SCOPE>_<purpose>
    File Path: common/leader_backgrounds/DEBCF_backgrounds.txt
    Starting Trait: Flat starting bonus traits applied during origin setup steps
    Spawning Filter: Nation type checklist constraints sorting options
    Exclusivity Lock: Origin constraints validation variables
    Details: Historic origin settings for generated leaders that inject custom starter traits, ethics tendencies, and distinct localization descriptions.

Tip

Template For New Entries

* `DEBCF_LEADERBACK_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/leader_backgrounds/DEBCF_backgrounds.txt` |
   | Starting Trait: | [Specify initial trait keys added to newly spawned characters] |
   | Spawning Filter: | [List country conditions required to permit background entry drops] |
   | Exclusivity Lock: | [Map to specific origin IDs to create unique selection pools] |
   | Details: | [Log localized interface story blocks, personality adjustments, and dialog modifiers.] |

7.4. Empire AI Disposition Vectors (PERSONALITY)

  • Paradox Target Directory: common/leader_personalities/

Important

Entry Fields:

  • DEBCF_PERSONALITY_<purpose>
    File Path: common/leader_personalities/DEBCF_personalities.txt
    Aggression Scalar: War declaration probability values calculation parameters
    Trade Willingness: Exchange threshold criteria scaling diplomacy matrices
    Alliance Multiplier: Federation interest calculation scoring trends
    Details: AI behavior modules parsing sector priorities, military threat levels, fleet sizing configurations, and diplomatic responses to adjust empire strategies.

Tip

Template For New Entries

* `DEBCF_PERSONALITY_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/leader_personalities/DEBCF_personalities.txt` |
   | Aggression Scalar: | [Set willingness tracking variable metrics: values from 0.0 to 3.0] |
   | Trade Willingness: | [Define deal acceptance offsets modifying raw trade calculations] |
   | Alliance Multiplier: | [Set diplomatic validation parameters steering federation weights] |
   | Details: | [Outline sector development weights, fleet composition behaviors, and peace agreement logic filters.] |

7.5. Character Modifier Qualities (TRAIT)

  • Paradox Target Directory: common/traits/
  • Rule Reminder: Trait modifier tracking values append smoothly via character scopes. Passing an incorrect scope context into a trait modification block will break character level calculations.

Important

Entry Fields:

  • DEBCF_TRAIT_<SCOPE>_<purpose>
    File Path: common/traits/DEBCF_traits.txt
    Component Modifier: Direct attribute changes applied while context is active
    Councilor Bonus: Special council matrix modifier fields tracking seats
    Cost Evaluation: Trait point allocations checked at generation steps
    Details: Core character modifiers that alter fleet combat stats, planetary economy throughputs, research speeds, or council agenda progress rates.

Tip

Template For New Entries

* `DEBCF_TRAIT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/traits/DEBCF_traits.txt` |
   | Component Modifier: | [List standard local bonuses added via this skill signature] |
   | Councilor Bonus: | [List global country bonuses active while seated on the council] |
   | Cost Evaluation: | [Define point costs or tier level designations: e.g., tier = leader_trait_tier_1] |
   | Details: | [Log trait exclusions lists, level ascension prerequisites, and custom unlock event triggers.] |

7.6. Covert Subversion Operations (SPYOPERATION)

  • Paradox Target Directory: common/espionage_operation_types/

Important

Entry Fields:

  • DEBCF_SPYOPERATION_<SCOPE>_<purpose>
    File Path: common/espionage_operation_types/DEBCF_espionage.txt
    Infiltration Gate: Spy network power levels checks required to boot
    Progression Pacing: Difficulty parameters scaling cycle phase loops
    Outcome Event: Termination script routing targeted fallout results
    Details: Infiltration quest tracks requiring active asset allocations, driving secret ops like stealing tech data or dropping local infrastructure health.

Tip

Template For New Entries

* `DEBCF_SPYOPERATION_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/espionage_operation_types/DEBCF_espionage.txt` |
   | Infiltration Gate: | [Specify minimum network level required to trigger the project] |
   | Progression Pacing: | [Define difficulty steps and dynamic asset risk modifiers] |
   | Outcome Event: | [Link to the final logic event handling success/failure states] |
   | Details: | [Document text stage maps, network maintenance cost values, and counter-intel profiles.] |

7.7. Dimensional Convergence Portals (ASTRALRIFT)

  • Paradox Target Directory: common/astral_rifts/

Important

Entry Fields:

  • DEBCF_ASTRALRIFT_<SCOPE>_<purpose>
    File Path: common/astral_rifts/DEBCF_rifts.txt
    Difficulty Scalar: Science unit skill check requirement baseline levels
    Layer Script Sequence: Multi-stage dialog logic steering choices
    Artifact Generation: Loot drop tables sorting reward assets
    Details: Spatially isolated anomalies requiring specialized survey ship operations, unfolding interactive choice menus that yield rare resources or unique items.

Tip

Template For New Entries

* `DEBCF_ASTRALRIFT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/astral_rifts/DEBCF_rifts.txt` |
   | Difficulty Scalar: | [Define baseline difficulty integers and tracking hazard levels] |
   | Layer Script Sequence: | [Link the sequence of event file IDs handling interactive stages] |
   | Artifact Generation: | [Reference item drop parameters unlocked upon site termination] |
   | Details: | [Outline star system spawning dependencies, interface graphic maps, and exploration text strings.] |

7.8. Extra-Dimensional Entity Registries (RIFTINHABIT)

  • Paradox Target Directory: common/rift_inhabitants/

Important

Entry Fields:

  • DEBCF_RIFTINHABIT_<SCOPE>_<purpose>
    File Path: common/rift_inhabitants/DEBCF_inhabitants.txt
    Communication Key: Diplomatic interaction screen interface panel links
    Trading Stock Matrix: Item stock profiles listing available exchanges
    Combat Hull Matrix: Unique ship assembly blueprint records
    Details: Entity profiles for entities found past portal boundaries, controlling their dialog windows, trading setups, and fleet layout metrics.

Tip

Template For New Entries

* `DEBCF_RIFTINHABIT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/rift_inhabitants/DEBCF_inhabitants.txt` |
   | Communication Key: | [Reference interface file keys loading custom dialogue trees] |
   | Trading Stock Matrix: | [List available resource exchange conversion rules] |
   | Combat Hull Matrix: | [Link ship layout templates used if conflict logic initializes] |
   | Details: | [Log entity opinion scale tracks, special event alert links, and fallback behavior script matrices.] |

7.9. Local Celestial Unconformities (ANOMALY)

  • Paradox Target Directory: common/anomalies/
  • Rule Reminder: Custom anomaly drop weights must register within matching category links, or the engine map generator will fail to distribute points on system boots.

Important

Entry Fields:

  • DEBCF_ANOMALY_<SCOPE>_<purpose>
    File Path: common/anomalies/DEBCF_anomalies.txt
    Category Pointer: System category reference sorting items
    Scanning Baseline: Survey time metrics scaling calculation blocks
    Resolution Script: Phase loop termination routing event entries
    Details: Volatile planet features detected during sector survey cycles, locking the target entity until resolved by a science fleet.

Tip

Template For New Entries

* `DEBCF_ANOMALY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/anomalies/DEBCF_anomalies.txt` |
   | Category Pointer: | [Link to explicit anomaly category grouping signatures: e.g., de_space_anomaly_cat] |
   | Scanning Baseline: | [Set base processing time factors and skill floor restrictions] |
   | Resolution Script: | [Link to the event structure processing discovery rewards] |
   | Details: | [Document spawning biome limit parameters, tracking localization chains, and failure risk models.] |

7.10. Planetary Subsurface Ruins (ARCHAEOLOGY)

  • Paradox Target Directory: common/archaeological_sites/

Important

Entry Fields:

  • DEBCF_ARCHAEOLOGY_<SCOPE>_<purpose>
    File Path: common/archaeological_sites/DEBCF_sites.txt
    Layer Page Count: Dig phase milestone counts tracking chapters
    Difficulty Factor: Iterative roll constraints modifying progression
    Exhumation Loot: Stockpile reward references matching termination states
    Details: Multi-chapter survey structures tied to surface locations, tracking excavation rolls to advance historical storylines and unlock rewards.

Tip

Template For New Entries

* `DEBCF_ARCHAEOLOGY_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/archaeological_sites/DEBCF_sites.txt` |
   | Layer Page Count: | [Specify the number of sequential layout chapters required] |
   | Difficulty Factor: | [Define target roll check thresholds: values from 1 to 10] |
   | Exhumation Loot: | [Link to completion rewards, custom relic IDs, or global modifiers] |
   | Details: | [Document page text localization lookups, event branch intercept structures, and coordinate mappings.] |

7.11. Focused Research Ventures (SPECIALPROJ)

  • Paradox Target Directory: common/special_projects/

Important

Entry Fields:

  • DEBCF_SPECIALPROJ_<SCOPE>_<purpose>
    File Path: common/special_projects/DEBCF_projects.txt
    Allocation Price: Required research resource points cost fields
    Fleet Asset Need: Science ship presence validation checklist items
    Expiration Timer: Calendar date limit trackers routing fallbacks
    Details: High-priority tracking actions triggered via event logs, locking active research production pipelines or ship movements until completed.

Tip

Template For New Entries

* `DEBCF_SPECIALPROJ_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/special_projects/DEBCF_projects.txt` |
   | Allocation Price: | [List engineering/physics/society point expenditure pools needed] |
   | Fleet Asset Need: | [Toggle requirements: science ship needed at coordinate location / global project] |
   | Expiration Timer: | [Define standard lifetime limits in days before auto-abortion occurs] |
   | Details: | [Log script finish triggers, tracking map pinning markers, and abort cleanup handlers.] |

7.12. Spatial Grid Phenoms (WEATHER)

  • Paradox Target Directory: common/cosmic_storms/

Important

Entry Fields:

  • DEBCF_WEATHER_<purpose>
    File Path: common/cosmic_storms/DEBCF_storms.txt
    System Radius Area: Hyperlink jump connection footprint limits
    Penalty Modifiers: Shield health dampening and tracking speed cuts
    Move Vector Rules: Galactic grid step calculation vectors
    Details: Moving system phenomena that travel across hyperlanes, introducing severe ship combat penalties and planetary performance modifiers.

Tip

Template For New Entries

* `DEBCF_WEATHER_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/cosmic_storms/DEBCF_storms.txt` |
   | System Radius Area: | [Define spatial scale: e.g., system context / 3-jump radius footprint] |
   | Penalty Modifiers: | [List localized environmental modifier shifts applied inside the perimeter] |
   | Move Vector Rules: | [Specify pacing parameters and directional routing logic arrays] |
   | Details: | [Outline spawning criteria coefficients, interface layer texture maps, and dissipation rules.] |

7.13. Tactical Offense Hardware (WEAPONCOMP)

  • Paradox Target Directory: common/component_templates/

Important

Entry Fields:

  • DEBCF_WEAPONCOMP_<purpose>
    File Path: common/component_templates/DEBCF_weapons.txt
    Damage Yield Calc: Hull damage scaling integers and shield penetration indexes
    Fire Rate Timing: Cooldown frame calculation variables
    Power Grid Draw: Core ship layout consumption parameters
    Details: Offensive module specifications matching ship designer slots, defining damage calculations, firing speeds, power draws, and custom status modifiers.

Tip

Template For New Entries

* `DEBCF_WEAPONCOMP_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/component_templates/DEBCF_weapons.txt` |
   | Damage Yield Calc: | [Specify damage bounds, hit accuracy base percentages, and type damage bonuses] |
   | Fire Rate Timing: | [Set execution timing speed frames tracking volley spacing] |
   | Power Grid Draw: | [Define reactor consumption costs matching hull validation rules] |
   | Details: | [Log slot size classification requirements, visual particle beam path maps, and technology gating keys.] |

7.14. Defensive Utility Hardening (UTILITYCOMP)

  • Paradox Target Directory: common/component_templates/

Important

Entry Fields:

  • DEBCF_UTILITYCOMP_<purpose>
    File Path: common/component_templates/DEBCF_utilities.txt
    Shield Capacity: Static layer replenishment threshold metrics
    Armor Hardening: Flat damage deduction reduction variables
    Assembly Cost: Material mineral data inputs and alloy price matrix tracking
    Details: Defensive hull enhancements (shields, armor, auxiliary tracking blocks) installed via the ship designer to optimize fleet health pools.

Tip

Template For New Entries

* `DEBCF_UTILITYCOMP_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/component_templates/DEBCF_utilities.txt` |
   | Shield Capacity: | [Define structural points added or passive recharge rates calculations] |
   | Armor Hardening: | [Specify absolute health extensions or penetration mitigation scales] |
   | Assembly Cost: | [List production materials required per unit deployment] |
   | Details: | [Document equipment size limits, custom background energy shifts, and tech requirements.] |

7.15. Component Category Groups (COMPONENTSET)

  • Paradox Target Directory: common/component_sets/

Important

Entry Fields:

  • DEBCF_COMPONENTSET_<purpose>
    File Path: common/component_sets/DEBCF_component_sets.txt
    Base Component Tag: Core grouping index identifiers
    Upgrade Pathway: Technology index tracking linear progression lines
    Icon Atlas Mapping: Interface file display coordinates references
    Details: Groups individual component levels into single upgrade pathways, enabling the ship auto-upgrade routine to update components smoothly.

Tip

Template For New Entries

* `DEBCF_COMPONENTSET_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/component_sets/DEBCF_component_sets.txt` |
   | Base Component Tag: | [Define baseline categorization anchor key for reference tracking] |
   | Upgrade Pathway: | [List tier sequencing tracking indicators guiding automatic changes] |
   | Icon Atlas Mapping: | [Link to matching interface display coordinates maps] |
   | Details: | [Outline component type exclusions laws, AI parsing behaviors, and display categorization switches.] |

7.16. Hull Signature Dampening (CLOAKING)

  • Paradox Target Directory: common/component_templates/

Important

Entry Fields:

  • DEBCF_CLOAKING_<purpose>
    File Path: common/component_templates/DEBCF_cloaking.txt
    Stealth Level Stat: Operational cloaking tracking threshold integers
    Upkeep Fuel Draw: Special dark matter or liquid fuel resource upkeeps
    Speed Decay Factor: Fleet map movement velocity deduction parameters
    Details: Specialized utility drives that hide fleet positions on the galaxy map, bypassing starbase scanners until countered by detection structures.

Tip

Template For New Entries

* `DEBCF_CLOAKING_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/component_templates/DEBCF_cloaking.txt` |
   | Stealth Level Stat: | [Set integer factor checking scanning counters: values from 1 to 10] |
   | Upkeep Fuel Draw: | [List running resource deductions active during toggle states] |
   | Speed Decay Factor: | [Specify travel speed penalty percentage scales applied to the fleet] |
   | Details: | [Log tactical decloak weapon boost event parameters, visibility script overrides, and tech locks.] |

7.17. Mega-Infrastructure Projects (MEGABUILD)

  • Paradox Target Directory: common/megastructures/
  • Rule Reminder: Build locations use coordinate system parameters. Attempting to build inside a binary star mesh without valid coordinate parameters will freeze visual rendering loops.

Important

Entry Fields:

  • DEBCF_MEGABUILD_<SCOPE>_<purpose>
    File Path: common/megastructures/DEBCF_megastructures.txt
    Stage Build Steps: Progression construction milestone block indexes
    Turn Investment: Engineering point requirements and alloy expenditure levels
    System Lock Rule: Placement conditions checking celestial body types
    Details: Multi-stage mega-projects (e.g., Dyson Spheres, Ringworlds) that grant massive economic resource packages, research yields, or strategic fleet command scales.

Tip

Template For New Entries

* `DEBCF_MEGABUILD_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/megastructures/DEBCF_megastructures.txt` |
   | Stage Build Steps: | [Specify total construction chapters and structural intermediate state IDs] |
   | Turn Investment: | [List cost calculations per phase: e.g., step_alloys = 5000, step_days = 3600] |
   | System Lock Rule: | [Define validation constraints checking astronomical body criteria matches] |
   | Details: | [Document final bonus updates tracking tables, spatial asset models orientation paths, and background events triggers.] |

7.18. Political Special Interest Groups (FACTION)

  • Paradox Target Directory: common/pop_factions/

Important

Entry Fields:

  • DEBCF_FACTION_<purpose>
    File Path: common/pop_factions/DEBCF_factions.txt
    Approval Multiplier: Policy checklist condition parameters tracking happiness
    Attraction Weight: Species trait alignments scoring calculation criteria
    Production Reward: Influence income yields scaling on approval rates
    Details: Ideological political bodies formed by pops, tracking faction approval to generate state influence currencies or shift stability metrics.

Tip

Template For New Entries

* `DEBCF_FACTION_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/pop_factions/DEBCF_factions.txt` |
   | Approval Multiplier: | [List conditions driving support: e.g., tracking active policy settings true/false] |
   | Attraction Weight: | [Define environmental modifiers pulling citizen pops into this party group] |
   | Production Reward: | [Specify maximum political currencies granted when satisfaction scores hit peak values] |
   | Details: | [Log localized interface name lines, rebellion trigger threshold parameters, and dynamic drift rules.] |

7.19. Inter-Empire Bilateral Treaties (AGREEMENT)

  • Paradox Target Directory: common/agreements/

Important

Entry Fields:

  • DEBCF_AGREEMENT_<SCOPE>_<purpose>
    File Path: common/agreements/DEBCF_agreements.txt
    Resource Taxation: Subject resource deduction contribution rules
    Loyalty Variance: Monthly relationship trust trend parameters
    Overwrite Model: Safe non-destructive modification layout
    Details: Subjugation and alliance treaty profiles, managing resource taxes, dynamic loyalty tracking, military assistance pacts, and research share metrics.

Tip

Template For New Entries

* `DEBCF_AGREEMENT_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/agreements/DEBCF_agreements.txt` |
   | Resource Taxation: | [Define material percentage lines pulled from secondary state markets] |
   | Loyalty Variance: | [Specify tracking variables adjusting target alignment scores monthly] |
   | Overwrite Model: | Safe non-destructive modification layout |
   | Details: | [Log interaction validation prerequisites check formulas, contract renegotiation cooldown timings, and diplomatic limits.] |

7.20. Mercenary Outpost Exchanges (BAZAAR)

  • Paradox Target Directory: common/bazaars/ or specialized salvage paths

Important

Entry Fields:

  • DEBCF_BAZAAR_<SCOPE>_<purpose>
    File Path: common/bazaars/DEBCF_bazaars.txt
    Transaction Ledger: Localized currency conversion formulas and commission tax matrices
    Availability Filters: System access triggers checking diplomatic relations or distance
    Commodity Allocation: Rare planetary bodies, fleets, or strategic elements up for exchange
    Details: Asynchronous planetary commerce interfaces or systemic black markets where independent factions exchange military and infrastructural assets dynamically.

Tip

Template For New Entries

* `DEBCF_BAZAAR_<SCOPE>_<purpose>`
   |  |  |
   | :--- | :--- |
   | File Path: | `common/bazaars/DEBCF_bazaars.txt` |
   | Transaction Ledger: | [Specify active pricing variables, inflation step multipliers, and transaction fees] |
   | Availability Filters: | [List prerequisites, sensor range checks, or diplomatic validation statements] |
   | Commodity Allocation: | [Define dynamic lists of trade inventory items: e.g., slave pops, auxiliary cruisers] |
   | Details: | [Document AI trading decision weights, local warehouse inventory restock ticks, and closure triggers.] |

Note

This is a Markdown file and is formatted for viewing in $$\textcolor{Gold}{Github}$$ only. VS Code Markdown Viewer Extensions gives some errors.

You can read the Markdown Wiki to learn how to use and modify these types of files.

This Documentation is for $$\textcolor{aqua}{Stellaris}$$ game. Pay attention to last time the Wiki page got updated.

Introduction & Using the Framework

Framework Modding (for Contributors)

Stellaris Modding & Gaming

Paradox Games Modding & Gaming

Generic Modding & Gaming

Git & Github Management

Other

Clone this wiki locally