pcam-24/pcam_standard_v1.yaml at main · GreyforgeLabs/pcam-24 · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
# PCAM-24 Data Standard v2.0
# Phase-Centric Action Model - Deterministic Interaction Schema

# =============================================================================
# SECTION 1: CORE PRECEDENCE MATRIX
# =============================================================================
# Resolves simultaneous property overlaps in a single phase.

precedence_matrix:
  tiers:
    1: "VOID"      # Invulnerability
    2: "COUNTER"   # Parry / Deflect
    3: "MITIGATE"  # Armor / Block
    4: "IMPACT"    # Active Damage
    5: "NEUTRAL"   # No active properties

# =============================================================================
# SECTION 2: WRAP BEHAVIORS
# =============================================================================
# Defines what happens when an action reaches phase 23.

wrap_behaviors:
  TERMINATE: "Action ends; character returns to IDLE state."
  LOOP: "Action returns to phase 0 (e.g., Sprint, Block)."
  NEST: "Action enters a sub-cycle (e.g., Charged Attack loop)."

# =============================================================================
# SECTION 3: EXAMPLE ACTIONS
# =============================================================================

example_actions:
  # ---------------------------------------------------------------------------
  # HEAVY PUNCH: High impact, armored startup.
  # ---------------------------------------------------------------------------
  - metadata:
      id: "ATK_HEAVY_V2"
      name: "Armored Heavy Punch"
      version: "2.0"

    phase_map:
      - id: "ANTICIPATION"
        start: 0
        end: 5
        properties: [CANCELABLE]

      - id: "ARMORED_COMMIT"
        start: 6
        end: 9
        tier: 3 # MITIGATE (Armor)

      - id: "ACTIVE_IMPACT"
        start: 10
        end: 13
        tier: 4 # IMPACT
        elasticity:
          stall_on_hit: 8 # Significant hit-stop

      - id: "RECOVERY"
        start: 14
        end: 23

    progression:
      on_wrap: "TERMINATE"

  # ---------------------------------------------------------------------------
  # LIGHT JAB: Quick, no armor, fast recovery.
  # ---------------------------------------------------------------------------
  - metadata:
      id: "ATK_LIGHT_JAB"
      name: "Light Jab"
      version: "2.0"

    phase_map:
      - id: "STARTUP"
        start: 0
        end: 3
        properties: [CANCELABLE]

      - id: "ACTIVE"
        start: 4
        end: 6
        tier: 4 # IMPACT
        elasticity:
          stall_on_hit: 2 # Light hit-stop

      - id: "RECOVERY"
        start: 7
        end: 15

      - id: "BUFFER_WINDOW"
        start: 16
        end: 23
        properties: [COMBO_READY]

    progression:
      on_wrap: "TERMINATE"

# =============================================================================
# SCHEMA VALIDATION RULES
# =============================================================================
# 1. TOTAL COVERAGE: phase_map entries must cover 0-23 without gaps.
# 2. DISCRETE VALUES: All phase indices must be integers.
# 3. DETERMINISTIC WRAP: All actions must define an on_wrap behavior.
# 4. PRECEDENCE: Overlapping windows resolve via the matrix tiers.

# Autonomy, Engineered.