Modding Data Parser Schema Matrix

From Cyber Knights: Flashpoint Wiki

References Links for Data Parser Schema

Modding Data Parser Schema Intro/Matrix

Matrix[edit | edit source]

Cyberdeck[edit | edit source]

A Cyberdeck is the hardware platform used by Hackers and Wireghosts to operate in the Matrix. It determines matrix action points, armor, IO speed, active memory, and program capacity. Cyberdecks can be purchased through services and are equipped like other gear.

Fields

Field Type Default Notes
CyberdeckId INTEGER required

Hand-authored primary key for this cyberdeck.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The deck classification controlling which job types can use it.
SQL column: DeckClass

Rarity INTEGER 0

The rarity tier of this deck.

PowerLevel INTEGER 0

The power level of this deck.

Cost INTEGER 0

Credit cost when purchased.

Service INTEGER 0

The ContactService that sells this deck.
SQL column: ServiceOptionId

Rating INTEGER 0

The deck's overall rating, used in power calculations.
SQL column: DeckRating

AP INTEGER 0

Matrix action points bonus granted by this deck.
SQL column: ApBonus

Armor INTEGER 0

Cyberdeck armor points.

IO INTEGER 0

IO speed provided by this deck.
SQL column: IOSpeed

Mem INTEGER 0

Active memory capacity for loaded programs.
SQL column: ActiveMem

MaxProg INTEGER 0

Maximum number of programs that can be loaded.
SQL column: MaxProgram

DeckIcon INTEGER 0

Icon ID for this deck's UI representation.

Icon TEXT ""

Asset path for this deck's icon.
SQL column: IconPng

Name TEXT ""

The deck's display name.
Written to localization JSON as Cyberdeck.Name.{CyberdeckId}.
JSON output only — not written to SQL.

Desc TEXT ""

The deck's description.
Written to localization JSON as Cyberdeck.Desc.{CyberdeckId}.
JSON output only — not written to SQL.


CyberdeckProgram[edit | edit source]

A CyberdeckProgram is a software program loaded into a cyberdeck for use in Matrix combat. Programs can deal damage, apply effects, create spectral tokens, or provide utility. Each program has a size that consumes active memory and a rating that affects its power.

Fields

Field Type Default Notes
CyberdeckProgramId INTEGER required

Hand-authored primary key for this program.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The program classification controlling its category and behavior.
SQL column: ProgramClass

Cost INTEGER 0

Credit cost when purchased.

Service INTEGER 0

The ContactService that sells this program.
SQL column: ServiceOptionId

Rarity INTEGER 0

The rarity tier of this program.
See Value Mappings: Rarity.

PowerLevel INTEGER 0

The power level of this program.

Temp INTEGER 0

If set, this program is temporary and expires after a set number of uses.
SQL column: TempProgram

Multiplier INTEGER 0

A code strength multiplier applied to this program's effects.
SQL column: CodeMultiplier

Size INTEGER 0

Memory units consumed when this program is loaded.
SQL column: ProgramSize

Talent INTEGER 0

A talent granted or triggered by this program.
SQL column: TalentId

Rating INTEGER 0

The program's rating, affecting its effectiveness.
SQL column: ProgramRating

Unload INTEGER 0

Priority order when programs are automatically unloaded due to memory constraints.
SQL column: UnloadPriority

Uses INTEGER 0

Maximum number of times this program can be used before expiring.
SQL column: MaxUses

Type INTEGER 0

The program type controlling its specific matrix action.
SQL column: ProgramType

Effect INTEGER 0

A MatrixEffect applied by this program.
SQL column: MatrixEffectId

Duration INTEGER 0

Duration of the applied MatrixEffect.
SQL column: MatrixDuration

Icon TEXT ""

Asset path for this program's icon.
SQL column: IconPng

Name TEXT ""

The program's display name.
Written to localization JSON as Program.Name.{CyberdeckProgramId}.
JSON output only — not written to SQL.

Value Mappings

Rarity[edit | edit source]

The rarity tier of this program.

Authored Value SQL Value Meaning
Common 1 Common — lowest tier
Rare 2 Rare — second tier
Epic 3 Epic — third tier
Legendary 4 Legendary — highest tier

MatrixDeckCard[edit | edit source]

A MatrixDeckCard defines a single card in a Matrix security deck. Cards control how the Matrix security system responds to intrusions — spawning IC, escalating security, or triggering countermeasures. Cards are weighted and filtered by alarm level and power level.

Fields

Field Type Default Notes
MatrixDeckCardId INTEGER required

Hand-authored primary key for this deck card.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Deck INTEGER 0

The MatrixDeck this card belongs to.
SQL column: MatrixDeckId

Weight INTEGER 0

Selection weight for this card within its deck.
SQL column: CardWeight

Type INTEGER 0

The card type, controlling its general behavior category.
SQL column: CardTypeId

Response INTEGER 0

The response action this card triggers.
SQL column: ResponseActionId

IC INTEGER 0

The IC type spawned by this card, if applicable.
SQL column: IcTypeId

SpawnOption INTEGER 0

The spawn placement option for IC spawned by this card.
SQL column: IcSpawnOption

HostAffinity INTEGER 0

IC host node affinity for spawning.
SQL column: IcHostAffinity

NodeAffinity INTEGER 0

Node type affinity for placement.
SQL column: NodeTypeAffinity

MinPower INTEGER 0

Minimum power level required for this card to be drawn.
SQL column: MinPowerLevel

MinResponse INTEGER 0

Minimum response level required.
SQL column: MinResponseLevel

MinSecurity INTEGER 0

Minimum security level required.
SQL column: MinSecurityLevel

MinAlarm INTEGER 0

Minimum alarm level at which this card can be drawn.
SQL column: MinAlarmLevel

MaxAlarm INTEGER 0

Maximum alarm level at which this card can be drawn.
SQL column: MaxAlarmLevel

Name TEXT ""

The card's display name.
Written to localization JSON as MatrixCard.Name.{MatrixDeckCardId}.
JSON output only — not written to SQL.

Desc TEXT ""

The card's description.
Written to localization JSON as MatrixCard.Desc.{MatrixDeckCardId}.
JSON output only — not written to SQL.


MatrixEffect[edit | edit source]

A MatrixEffect defines a status effect that exists within the Matrix layer of gameplay. Matrix effects can alter IO speed, memory, spectral tokens, security tally, and other digital combat parameters. They are applied by IC, programs, and Wireghost talents.

Fields

Field Type Default Notes
MatrixEffectId INTEGER required

Hand-authored primary key for this matrix effect.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The classification of this effect, controlling how it is categorized and displayed.
SQL column: EffectClassification

Group INTEGER 0

A grouping ID for related matrix effects.
SQL column: EffectGroupId

SkipTurn INTEGER 0

If set, the affected unit loses its next turn.

Instant INTEGER 0

If set, this effect is applied and resolved immediately rather than persisting.

InitBonus INTEGER 0

Initiative bonus or penalty applied by this effect.

ActionPoints INTEGER 0

Matrix action point modification.

IO INTEGER 0

IO speed boost applied by this effect.
SQL column: IoBoost

IOPct INTEGER 0

IO speed boost as a percentage.
SQL column: IoPercent

Invulnerable INTEGER 0

If set, the target cannot be damaged while this effect is active.

DumpShockRes INTEGER 0

Dump shock resistance granted by this effect.

DamageBoost INTEGER 0

Damage boost applied to the target's matrix attacks.

BurnDamage INTEGER 0

Burn damage applied each turn this effect is active.

ConnectionBurnDamage INTEGER 0

Burn damage applied to the target's connection each turn.

HealConnection INTEGER 0

Connection points healed each turn this effect is active.

DeckArmor INTEGER 0

Cyberdeck armor points granted.

DeckShield INTEGER 0

Cyberdeck shield points granted.

PrePostBlocked INTEGER 0

If set, pre/post actions are blocked while this effect is active.

ActiveMem INTEGER 0

Active memory modification.

SpectralTokens INTEGER 0

Spectral token count modification.

SecEscBlock INTEGER 0

If set, security escalation is blocked.
SQL column: SecurityEscalateBlock

SecBlock INTEGER 0

If set, security tally accumulation is blocked.
SQL column: SecurityTallyBlock

SecHeal INTEGER 0

Security tally healed per turn.
SQL column: SecurityTallyHeal

SecTally INTEGER 0

Security tally modification.
SQL column: SecurityTally

SCU INTEGER 0

SCU duration modification.
SQL column: SCUTurns

SpecialCode INTEGER 0

A special behavior code applied by this effect.

SpecialValue INTEGER 0

The value parameter for the special behavior.

SpecialMerge INTEGER 0

Controls how this effect merges with existing effects of the same type.

ClearType INTEGER 0

Controls when and how this effect is cleared.
SQL column: EffectClearType

PurgeType INTEGER 0

Controls when and how this effect is purged.
SQL column: EffectPurgeType

IconAsset TEXT ""

Asset path for the effect's UI icon.

VFX TEXT ""

Asset path for the effect's visual effect.

Name TEXT ""

The effect's display name.
Written to localization JSON as MatrixEffect.Name.{MatrixEffectId}.
JSON output only — not written to SQL.


MatrixFile[edit | edit source]

A MatrixFile is a digital file that exists within the Matrix. Files can be hacked, stolen, or used as mission objectives. They have influence scores, size, and price, and may be associated with sets defined in MatrixFileSet.

Fields

Field Type Default Notes
MatrixFileId INTEGER required

Hand-authored primary key for this matrix file.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Type INTEGER 0

The file type, controlling how it behaves when hacked.
SQL column: FileTypeId

Group INTEGER 0

A grouping ID for related files.
SQL column: FileGroupId

ActionType INTEGER 0

The action performed when this file is accessed.
SQL column: FileActionTypeId

ActionResult INTEGER 0

The result type of the file action.
SQL column: FileActionResultId

CreatedBy INTEGER 0

The set of entities that can create this file during proc-gen.
SQL column: CreatedBySet

UsedBy INTEGER 0

The set of entities that use this file.
SQL column: UsedBySet

Influence INTEGER 0

Influence score gained when this file is stolen.

MinPower INTEGER 0

Minimum power level required to access this file.
SQL column: MinimumPowerLevel

Size INTEGER 0

The file size in matrix storage units.
SQL column: FileSize

Price INTEGER 0

Credit value of this file.
SQL column: FilePrice

Name TEXT ""

The file's display name.
Written to localization JSON as MatrixFile.Name.{MatrixFileId}.
JSON output only — not written to SQL.

Desc TEXT ""

The file's description.
Written to localization JSON as MatrixFile.Desc.{MatrixFileId}.
JSON output only — not written to SQL.


MatrixFileSet[edit | edit source]

A MatrixFileSet groups up to five individual MatrixFile records into a collection that can be assigned to missions or contacts as a bundle. Sets have a faction, rarity, level, and a class controlling their behavior.

Fields

Field Type Default Notes
MatrixFileSetId INTEGER required

Hand-authored primary key for this file set.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The set class controlling how this file set is used.
SQL column: FileSetClass

Output INTEGER 0

The output item or result produced when this set is completed.
SQL column: FileOutputId

Faction INTEGER 0

The faction this file set is associated with.
SQL column: SetFaction

MinRarity INTEGER 0

Minimum rarity for the files included in this set.
See Value Mappings: MinRarity.
SQL column: SetRarityMin

File1 INTEGER 0

First MatrixFileId in the set.
SQL column: MatrixFileId1

File2 INTEGER 0

Second MatrixFileId.
SQL column: MatrixFileId2

File3 INTEGER 0

Third MatrixFileId.
SQL column: MatrixFileId3

File4 INTEGER 0

Fourth MatrixFileId.
SQL column: MatrixFileId4

File5 INTEGER 0

Fifth MatrixFileId.
SQL column: MatrixFileId5

Level INTEGER 0

The set level controlling availability and power scaling.
SQL column: SetLevel

Name TEXT ""

The set's display name.
Written to localization JSON as MatrixFileSet.Name.{MatrixFileSetId}.
JSON output only — not written to SQL.

Desc TEXT ""

The set's description.
Written to localization JSON as MatrixFileSet.Desc.{MatrixFileSetId}.
JSON output only — not written to SQL.

Value Mappings

MinRarity[edit | edit source]

Minimum rarity filter for files in this set.

Authored Value SQL Value Meaning
Common 1 Common — lowest tier
Rare 2 Rare — second tier
Epic 3 Epic — third tier
Legendary 4 Legendary — highest tier

MatrixIC[edit | edit source]

A MatrixIC defines an Intrusion Countermeasure — an AI security entity that patrols and defends nodes in the Matrix. IC has health, actions, passive auras, and can apply Matrix effects. Wireghosts and Hackers must evade, destroy, or manipulate IC to complete matrix objectives.

Fields

Field Type Default Notes
IcTypeId INTEGER required

Hand-authored primary key for this IC type.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The IC classification controlling its general behavior.
SQL column: IcClass

MinPower INTEGER 0

Minimum power level at which this IC appears.
SQL column: MinPowerLevel

HP INTEGER 0

Maximum hit points of this IC.
SQL column: MaxHealth

Action1 INTEGER 0

The primary action type this IC performs.
SQL column: ActionType1

Power1 INTEGER 0

The power level of Action1.
SQL column: ActionPower1

Action2 INTEGER 0

A secondary action type.
SQL column: ActionType2

Power2 INTEGER 0

The power level of Action2.
SQL column: ActionPower2

Aura INTEGER 0

A passive aura effect active while this IC is alive.
SQL column: PassiveAura

AuraPower INTEGER 0

The power level of the passive aura.
SQL column: PassiveAuraPower

Effect INTEGER 0

A MatrixEffect applied by this IC's actions.
SQL column: MatrixEffectId

EffectDuration INTEGER 0

Duration of the applied MatrixEffect.
SQL column: MatrixEffectDuration

EffectChance INTEGER 0

Chance (0–100) that the effect is applied on action.
SQL column: MatrixEffectChance

Trap INTEGER 0

A trap action type triggered when this IC is approached.
SQL column: TrapActionType

Destroy INTEGER 0

Security tally added when this IC is destroyed.
SQL column: DestroyTally

Security INTEGER 0

Security tally modification per turn this IC is active.
SQL column: SecurityTally

Icon TEXT ""

Asset path for this IC's icon.
SQL column: IconPng

Name TEXT ""

The IC's display name.
Written to localization JSON as MatrixIC.Name.{IcTypeId}.
JSON output only — not written to SQL.

Desc TEXT ""

The IC's description.
Written to localization JSON as MatrixIC.Desc.{IcTypeId}.
JSON output only — not written to SQL.


MatrixNodeType[edit | edit source]

A MatrixNodeType defines a node category in the Matrix map. Each node type has a class, IC capacity, automatic effects, and AP costs. Nodes serve as the terrain of Matrix combat — controlling movement, security, and objectives.

Fields

Field Type Default Notes
NodeTypeId INTEGER required

Hand-authored primary key for this node type.
Hand-authored primary key. Used as the WHERE key for UPDATE/DELETE.

Class INTEGER 0

The node classification controlling its role in the matrix.
SQL column: NodeClass

SubClass INTEGER 0

Sub-classification for more specific node behavior.
SQL column: NodeSubClass

MaxIC INTEGER 0

Maximum number of IC units that can occupy this node.

AutoDump INTEGER 0

If set, a Wireghost or Hacker entering this node is automatically dump-shocked.

SpecialRule INTEGER 0

A special behavior rule applied to this node.

AutoEffect INTEGER 0

A MatrixEffect automatically applied to units on this node.
SQL column: AutoEffectId

AutoDuration INTEGER 0

Duration of the auto-applied MatrixEffect.
SQL column: AutoEffectDuration

AP INTEGER 0

Action point cost to move through this node.
SQL column: ApCost

Icon TEXT ""

Asset path for this node type's icon.
SQL column: IconPng

Name TEXT ""

The node type's display name.
Written to localization JSON as MatrixNode.Name.{NodeTypeId}.
JSON output only — not written to SQL.

Desc TEXT ""

The node type's description.
Written to localization JSON as MatrixNode.Desc.{NodeTypeId}.
JSON output only — not written to SQL.



Modding: Home · Quick Start Guide · Modkit Uploader · Example Project · Data Modding · Data Parser Schema · Use Cases · Download Modding Resources