1    # 062026 — Design & Unit-Creation Guide
2   
3   > **Working title** (`062026`, the month it started). Rename once we land a real one.
4   >
5   > **This is a side project.** Its purpose is to give me something to design and build
6   > *in the gaps* — to work on alongside **Mini Looper** while the agent is busy with
7   > Mini Looper's tasks. Keep it cheap and incremental; it is explicitly **not** allowed to
8   > balloon into a second main project. The honest gate (Section 6) is to grey-box one
9   > playable class and confirm the loop is fun before scaling to a full roster.
10  
11  ---
12  
13  ## 1. What the game is
14  
15  A **build-heavy action roguelite** in the SNKRX / Risk of Rain lineage. You pick one
16  **class**, pilot it in real time, fight waves, and assemble a synergistic **build** out of
17  **gems** you socket into its abilities. The fantasy is the build-heavy one: a simple
18  starting kit compounds into a screen-clearing power fantasy.
19  
20  - **Control:** active-aim — you aim and trigger abilities yourself (RoR / Hades feel), not
21    an auto-battler.
22  - **Kit:** every class has a fixed kit of **Passive + Primary + Secondary + Mobility +
23    Ultimate** (4 actives + 1 passive).
24  - **Roster:** the ~55 **SNKRX units**, each reimagined as a solo playable class with its own
25    kit and gem progression. Source is `E:/a327ex/SNKRX/` — grep `player.lua` (attack
26    dispatch) and `main.lua` (`character_descriptions` / `character_classes` /
27    `character_effect_names`) for a unit's real mechanic before designing it.
28  - **Progression:** the **Linked Sockets** system (Section 2) — build the class by socketing
29    gems into its abilities.
30  - **Low randomness:** builds are *authored*, not gambled — you choose from the full, known
... [214 more lines]

=== 062026 contents ===
total 24
drwxr-xr-x 1 adn 197121     0 Jun  5 01:25 ./
drwxr-xr-x 1 adn 197121     0 Jun  5 01:23 ../
-rw-r--r-- 1 adn 197121 14287 Jun  5 01:25 design.md
=== snkrx-template top-level ===
total 4201
drwxr-xr-x 1 adn 197121       0 May 31 17:15 ./
drwxr-xr-x 1 adn 197121       0 Jun  5 01:23 ../
drwxr-xr-x 1 adn 197121       0 May 31 17:15 .claude/
drwxr-xr-x 1 adn 197121       0 May 31 17:21 .git/
-rw-r--r-- 1 adn 197121    5214 May 31 17:15 README.md
drwxr-xr-x 1 adn 197121       0 May 17 22:24 anchor/
-rwxr-xr-x 1 adn 197121 4185088 May 31 12:02 anchor.exe*
drwxr-xr-x 1 adn 197121       0 May 31 12:19 assets/
-rw-r--r-- 1 adn 197121   16730 May 31 16:56 main.lua
-rw-r--r-- 1 adn 197121   28688 May 25 02:05 main_old.lua
-rw-r--r-- 1 adn 197121   18873 May 31 16:56 main_scaffold.lua
-rw-r--r-- 1 adn 197121     365 May 31 16:46 run.bat
drwxr-xr-x 1 adn 197121       0 May 31 15:25 snkrx/
=== snkrx-template/snkrx ===
total 324
drwxr-xr-x 1 adn 197121     0 May 31 15:25 ./
drwxr-xr-x 1 adn 197121     0 May 31 17:15 ../
-rw-r--r-- 1 adn 197121  4246 May 20 21:04 airborne.lua
-rw-r--r-- 1 adn 197121 19838 May 31 12:24 area.lua
-rw-r--r-- 1 adn 197121 21370 May 31 12:25 beam.lua
-rw-r--r-- 1 adn 197121 25942 May 31 12:20 effect.lua
-rw-r--r-- 1 adn 197121 10220 May 31 13:41 effect_lab.lua
-rw-r--r-- 1 adn 197121 43365 May 25 02:05 findings.md
... [14 more lines]

1    --[[
2     snkrx-template / main.lua — clean reference scene.
3   
4     This is your file. It is a complete, minimal scene: a player you can
5     move (WASD / arrows), the five-layer render stack, a camera, physics,
6     the update / draw skeleton, AND the UI render pipeline — all wired
7     and ready, but firing no attacks and drawing no UI widgets. Read it
8     top to bottom; it is the contract you build on.
9   
10    TWO TOOLKITS, ONE REQUIRE.  `require('snkrx')` pulls in BOTH:
11  
12      snkrx/<carrier>.lua     attack toolkit — projectile / area / beam
13                              / flicker / prop, the effect draw-shader
14                              stack, fx, sounds, example entities.
15      snkrx/ui/<module>.lua   UI toolkit — panel / button / slot / bar /
16                              tabs / checkbox / radio / slider /
17                              list_row / card / text_input / modal /
18                              bracket_tag / stat_chip / pips / ...
19  
20    Both are plain, readable Lua, not opaque modules — open the files.
21  
22    ADDING AN ATTACK.  Every carrier already has its object list and its
23    update / draw loop wired below. To add an attack:
24      1. bind a key in the INPUT section,
25      2. call the carrier's spawn_* helper on that press inside update()
26         — see the ATTACKS comment block there.
27    Nothing else: no new list, no new loop.
28  
29    DRAWING UI.  The UI toolkit is immediate-mode: call widget functions
30    in update() and they queue draws onto `ui_layer`. The render pipeline
... [354 more lines]

1    --[[
2     snkrx-template / main_scaffold.lua — the full demo scaffold.
3   
4     This is the runnable "see everything work" scene used to build and
5     test the toolkit. It is NOT the clean fork target — main.lua is. To
6     run THIS instead, copy its contents over main.lua (the engine's entry
7     point is always main.lua, whatever the folder is named).
8   
9     WHAT IT ADDS over the clean main.lua (everything else is identical —
10    same physics matrix, layers, carrier update/draw loops, collision
11    handlers, and UI render pipeline):
12      • 6 seekers + a wall as test targets,
13      • all five carriers on keys (mouse 1/2/3 = projectile / area /
14        beam, F = flicker chain-strike, R = lob a rock),
15      • the F4 widget gallery (snkrx/ui/gallery.lua),
16      • the F5 effect inspector (snkrx/effect_lab.lua).
17    Strip those three additions (spawns, the attack-firing block, the
18    gallery/lab hooks) and you have main.lua.
19  
20    KEYS
21      WASD / arrows    move the player (mouse aims it)
22      mouse 1 / 2 / 3  fire projectile / area / beam
23      F / R            flicker chain-strike / lob a rock
24      F2               collider debug overlay
25      F3               per-sound DSP tuner
26      F4               widget gallery  ([ / ] page · B body font ·
27                                        O color recipe · U/P dither ·
28                                        K/L breathe density)
29      F5               effect inspector (click a shape, edit its spec)
30  
... [398 more lines]

1    --[[
2     area.lua — area-of-effect attack carrier.
3   
4     Three base shapes with an orthogonal `jagged` flag:
5       'circle'  + jagged=false:  filled disc + orbiting arc segments
6       'circle'  + jagged=true:   filled disc + jittered perimeter polygon outline
7       'rect'    + jagged=false:  filled rect + bracket corners
8       'rect'    + jagged=true:   filled triangle fan + jittered perimeter polygon outline
9       'polygon' + jagged=false:  filled disc + clean polygon outline
10      'polygon' + jagged=true:   filled disc + jittered polygon outline (jitter mutates hit area)
11  
12    Damage queries match base shape (not jagged):
13      circle  → query_entities_circle   (jagged is visual-only)
14      rect    → query_entities_box      (jagged is visual-only)
15      polygon → query_entities_polygon  (jagged actually changes hit area, since verts are the shape)
16  
17    Two lifecycle modes selected by `duration`:
18  
19      Instant (default, duration = nil): tween radius 0 → target over 0.05s
20        → single damage pass + spring pop + 0.15s flash → 0.2s hold → blink × 7 → kill.
21  
22      Persistent (duration set): tween radius 0 → target over 0.25s. Damage
23        ticks every `tick_rate` seconds (default 0.5s); each tick that lands
24        on anyone plays `dot_tick`, pulls the spring 0.1, flashes 0.1s, and
25        spikes the arc speed by 1.25π (capped at 3π). After `duration`
26        seconds, blink × 7 → kill. Per-enemy cooldown prevents the same
27        enemy from being hit more than once per tick_rate window.
28  
29    Caller API:
30      spawn_area(x, y, {
... [468 more lines]

1    player = class()
2   
3   function player:new(x, y)
4     self.x, self.y = x, y
5     self.w, self.h = 10, 10
6     self.base_speed = 100
7     self.speed = self.base_speed
8     self.r = 0
9     self.visual_r = 0
10    self.sx, self.sy = 1, 1
11    self.spec = player_spec   -- four-axis effect spec (see snkrx/init.lua)
12    self.moving = false
13    self.previous_moving = false
14    self.flashing = false
15  
16    -- Resource stats. Register modifier stats (hp_max, mp_max, regens)
17    -- before the pool stats so stats_update walks the caps first;
18    -- pool maxes are then re-synced from p.hp_max / p.mp_max in
19    -- player:update via stats_set_min_max. See stats.lua docs for the
20    -- pool-vs-modifier convention.
21    stats_set(self, 'hp_max',   100, 0, math.huge)
22    stats_set(self, 'mp_max',   100, 0, math.huge)
23    stats_set(self, 'hp_regen', 2,   0, math.huge)
24    stats_set(self, 'mp_regen', 10,  0, math.huge)
25    stats_set(self, 'hp',       100, 0, self.hp_max)
26    stats_set(self, 'mp',       100, 0, self.mp_max)
27  
28    make_entity(self)
29  
30    self.collider = collider(self, 'player', 'dynamic', 'box', self.w, self.h)
... [158 more lines]

1    --[[
2     seeker.lua — basic chase-the-player enemy.
3   
4     Faithful port of v1's seeker (~main.lua 9203-9514). Same silhouette
5     (14×6 rounded rect), same hp pool, same speed range, same steering
6     recipe (seek + wander + separate combined inside max_force=200),
7     same spawn/hit/death FX, same sounds. The bytepath-era pack /
8     rarity / modifiers system (yellow/blue specials, slow_aura,
9     explode_on_death) is intentionally NOT ported here — Invoker's
10    loot/modifier layer is going to live higher up the stack; the
11    seeker itself stays mechanical.
12  
13    Differences from v1 that aren't cosmetic:
14      • Procedural Anchor 2 patterns: plain field timer/spring/collider,
15        explicit update of each sub-module, `cached_enemies` is replaced
16        by iterating the seekers[] array for steering_separate.
17      • `cyclone_spin` death-spin parameter dropped (no cyclone ability
18        yet — spin defaults to 0, which matches v1's effective behavior
19        when nothing has tagged the seeker with cyclone). Re-add when
20        Cyclone lands.
21      • `damaged_by_area` tick-rate guard dropped — fireball is the only
22        area right now and it's instant, so re-hits per cast can't happen.
23        Bring back the guard when duration zones land.
24      • Push knockback timer-name bug fixed. v1 reuses the name 'push'
25        for both the 0.15s flash-off and the 0.5s pushed-state-off
26        timers, so the second registration cancels the first and the
27        seeker stays white-flashed forever after a push. We use
28        distinct names ('push_flash' / 'push_end') so both fire.
29  ]]
30  
... [343 more lines]

Your questions have been answered: "How should the Cleave's hit shape work? (This is the swordsman's core verb, so it's worth nailing.)"="Same as SNKRX, a square.", "How should enemies keep coming while you fun-test the swing?"="Trickle spawner from the right of the screen towards the player.". You can now continue with these answers in mind.

Exit code 3
robocopy exit: 3

Name             
----             
.claude          
anchor           
assets           
snkrx            
anchor.exe       
design.md        
main.lua         
main_old.lua     
main_scaffold.lua
README.md        
run.bat          
--- snkrx present? ---
True
True
False

104  -- ============================================================
105 -- INPUT
106 -- ============================================================
107 bind('left',  'key:a'); bind('left',  'key:left')
108 bind('right', 'key:d'); bind('right', 'key:right')
109 bind('up',    'key:w'); bind('up',    'key:up')
110 bind('down',  'key:s'); bind('down',  'key:down')
111 bind('toggle_debug_draw', 'key:f2')
112 
113 -- ============================================================
114 -- LAYERS  (structural — drawn bottom-to-top)
115 -- ============================================================
116 floor_layer   = layer_new('floor')    -- bg fill (no camera, no effect)
117 wall_layer    = layer_new('wall')     -- wall bodies
118 game_layer    = layer_new('game')     -- player + seekers + every carrier
119 effects_layer = layer_new('effects')  -- fxs (hit circles, particles, ...)
120 debug_layer   = layer_new('debug')    -- F2 collider overlay
121 
122 main_camera = camera_new(width, height)
123 main_camera.x = width/2
124 main_camera.y = height/2
125 
126 debug_draw_enabled = false
127 
128 -- ============================================================
129 -- SCENE
130 -- ============================================================
131 -- The player — moved by the WASD / arrow binds, aims at the mouse.
132 -- It carries player_spec (a snkrx_blue↔light_blue organic breathe — see
133 -- snkrx/init.lua); set p.spec = {...} to re-theme it.
... [10 more lines]

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

1    ---
2   name: project_062026
3   description: "062026 (working title) — side-project build-heavy action roguelite (SNKRX units reimagined as solo RoR-like classes, Linked-Socket gem builds); designed alongside Mini Looper"
4   metadata: 
5     node_type: memory
6     type: project
7     originSessionId: 081fadb9-c1ff-4449-b7f2-a024fefea81f
8   ---
9   
10  `062026` (`E:/a327ex/062026/`, a temporary date-name) is a **side project** — something to design/build in the gaps while the agent runs [[project_mini_looper]] tasks. It is explicitly NOT a second main project; keep it cheap.
11  
12  A **build-heavy action roguelite** (SNKRX × Risk of Rain): pick one of the ~55 SNKRX units reimagined as a solo **active-aim** class (kit = Passive + Primary + Secondary + Mobility + Ultimate), fight waves, and build it via **Linked Sockets** — gems socketed into abilities (5 sockets/ability, intrinsic socket-cost [1, keystones 2–3], per-ability caps, full-catalogue **deterministic** choice — no gambling). Builds are authored; per-run "surprise" is a **deferred** knob (seed / menu-subset / mutator / route / threat).
13  
14  **Full design + the canonical unit-creation process + two worked example units live in `E:/a327ex/062026/design.md` — read it first.** Examples: Swordsman (multi-carrier melee: cleave + Cross-Guard flurry) and Archer (single-carrier, all arrows).
15  
16  Key principle — the **Carrier Axis**: a class is single-carrier (one delivery method → archetypes blend, high interplay, global gems) or multi-carrier (distinct methods → modal builds, per-ability gems); choose consciously per unit. Favor archetype interplay (X+Y builds).
17  
18  Status (2026-06-05): concept + 2 example units designed in an ideaguy session; **NO code yet**, no engine chosen (would presumably be Anchor 2 like the other games). Honest next gate = grey-box ONE class to fun-test the active-aim + linked-socket loop before scaling the roster (it's a side project — see [[feedback_shipping_gate]]). Not in global CLAUDE.md project list yet.
19  

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

54   ## Mini Looper (game project)
55  - [Mini Looper](project_mini_looper.md) — active game (SNKRX × tower-defense, Anchor 2); both fun-gates passed, now entering production as an RTS loop-economy (map varies per run; Slice v0 = economy on fixed loop = 3rd fun-gate); NOT in global CLAUDE.md, game in root `*.lua`
56  
57  ## 062026 (side-project game)
58  - [062026](project_062026.md) — side project to design/build in the gaps while the agent runs Mini Looper tasks; build-heavy action roguelite (SNKRX units as solo active-aim classes + Linked-Socket gem builds); concept + 2 example units designed, NO code yet; full design + unit-creation process in `E:/a327ex/062026/design.md`
59  

The file C:\Users\adn\.claude\projects\E--a327ex\memory\MEMORY.md has been updated successfully. (file state is current in your context — no need to Read it back)

1    --[[
2     snkrx/init.lua — the SNKRX attack toolkit aggregator.
3   
4     `require('snkrx')`, from main.lua and AFTER `require('anchor')({...})`,
5     loads every toolkit module and performs all the cross-cutting setup a
6     new attack should never have to write itself:
7       • the effect draw-shader stack + the default effect specs
8       • the sfx wrapper, the sounds / volumes tables, every carrier's
9         sound + spritesheet asset
10      • the hit-stop machinery
11  
12    Nothing here is hidden — it is all plain, readable Lua; the point is
13    only that main.lua need not repeat it. STRUCTURAL things (physics
14    setup, layers, camera, the carrier object lists and their update /
15    draw loops) stay explicit in main.lua, NOT here.
16  
17    The toolkit files live flat in snkrx/; this file requires them as
18    `snkrx.<name>`. Carrier object lists (projectiles / areas / beams /
19    flickers / props / debris_pieces) and entity lists (seekers / walls /
20    fxs) are globals defined by their own modules — main.lua iterates
21    them directly.
22  ]]
23  
24  -- Boot RNG (both Lua's and the engine's).
25  math.randomseed(os.time())
26  random_seed(os.time())
27  
28  -- ── Effect / draw-shader stack ────────────────────────────────────
29  -- The four-axis effect system (pattern × color × dither × shape) is the
30  -- project's rendering substrate — there is no separate "edition" system.
... [170 more lines]

1    --[[
2     palette.lua — locked color tokens + the effect-system palette adapter.
3   
4     This file is the SINGLE source of truth for what colors the project uses.
5     Three sections:
6   
7       1. NAMED COLOR TOKENS (atoms). 18 canonical tokens that form the
8          project's locked palette (9 chrome / grayscale ladder + 9 accents
9          roughly by hue), plus 8 legacy SNKRX tokens. Every drawn thing
10         should pull from these tokens; no inline RGB values in game code.
11  
12      2. THE EFFECT ADAPTER. `palette` (name → color object), the ordered
13         `palette_token_names` list, the `palette_token_index` (0-based)
14         map, and `palette_init()` — everything snkrx/effect.lua needs to
15         push the palette to the draw shader's u_palette[] uniform array
16         and to resolve a spec's `color_a` / `color_b` token NAME into the
17         integer index the shader expects.
18  
19    The four-axis effect system (snkrx/effect.lua + assets/draw_shader.frag)
20    is the project's rendering substrate — there is no separate "edition"
21    system anymore. A drawable carries a four-axis SPEC (pattern × color ×
22    dither × shape); the color axis names tokens from THIS file.
23  
24    USAGE
25      Tokens are global functions. Call them with () to get a color value:
26          layer_rectangle(layer, 0, 0, 100, 100, red())
27          layer_text(layer, msg, font, x, y, text())
28  
29      For the effect pipeline, pass the token NAME (a string) via a spec's
30      color_a / color_b:
... [148 more lines]

1    --[[
2     ui/rect.lua — RectCut layout primitive for the UI toolkit.
3   
4     A rect is a plain table {x, y, w, h}. Three families of operations:
5   
6       cut_*(r, n) — mutates r (eats n pixels from one side), returns the eaten slice.
7       get_*(r, n) — pure: returns a slice of r without mutating.
8       add_*(r, n) — pure: returns a new rect adjacent to r (extends outward).
9   
10    Plus utilities: contract / expand (inset / outset), center (place a w×h
11    rect centered inside another), split_h / split_v (divide into n equal parts).
12  
13    Origin: cut/get/add are the Halt RectCut pattern. Cuts are destructive on
14    the parent so successive cuts walk the rect. Canonical idiom:
15      local topbar = rect_cut_top(r, 24)   -- r is now the body below the topbar
16      local botbar = rect_cut_bot(r, 22)   -- r is now the body between bars
17  
18    Verbatim from the Anchor App (Anchor2/app/rect.lua) — proven, unchanged.
19  ]]
20  
21  function rect_new(x, y, w, h)
22    return {x = x, y = y, w = w, h = h}
23  end
24  
25  -- cut_*: mutate r (eat n from one side), return the eaten slice.
26  function rect_cut_left(r, n)
27    local s = {x = r.x, y = r.y, w = n, h = r.h}
28    r.x = r.x + n
29    r.w = r.w - n
30    return s
... [71 more lines]

759:function ui_slider(opts)
760-  local r       = opts.rect
761-  local id      = opts.id
762-  local ed      = opts.spec
763-  local track_h = opts.track_h or 5
764-  local knob_d  = opts.knob or 12
765-  local knob_r  = knob_d/2
766-
767-  -- Knob travel is inset by the knob radius so it never clips the rect.
768-  local travel = r.w - knob_d
769-
770-  -- Interaction: press grabs, drag tracks the cursor, release lets go.
771-  local value   = math.clamp(opts.value or 0, 0, 1)
772-  local hovered = false
773-  if id then
774-    ui_claim_hot(id, r)
775-    hovered = ui_is_hot(id)
776-    if hovered and mouse_is_pressed(1) then
777-      ui_state.active_id = id
778-      ui_state.focus_id  = id
779-      ui_juice_pull(id, 0.2, r)
780-    end
781-    if ui_state.active_id == id then
782-      local mx = mouse_position()
783-      value = math.clamp((mx - r.x - knob_r)/travel, 0, 1)
784-      if mouse_is_released(1) then ui_state.active_id = nil end
785-    end
786-    ui_juice_hover(id, hovered, nil, r)
787-  end
788-
... [41 more lines]

062026\snkrx\ui\core.lua:90:function ui_heading(o)
E:\a327ex\062026\snkrx\ui\core.lua-91-  ui_text({ rect = { x = o.x, y = o.y, w = o.w, h = ui_font_body_ark.height },
E:\a327ex\062026\snkrx\ui\core.lua-92-            text = string.upper(o.text), font = ui_font_body_ark,
E:\a327ex\062026\snkrx\ui\core.lua-93-            color = text_muted, align_v = 'top', spec = o.spec })
E:\a327ex\062026\snkrx\ui\core.lua-94-  local ly = o.y + ui_font_body_ark.height + ui_sp.s1
E:\a327ex\062026\snkrx\ui\core.lua-95-  ui_rect(o.x, ly, o.w, 1, panel_border, o.spec)
E:\a327ex\062026\snkrx\ui\core.lua-96-  return { next_y = ly + ui_sp.s3, next_x = o.x + o.w }
E:\a327ex\062026\snkrx\ui\core.lua-97-end
E:\a327ex\062026\snkrx\ui\core.lua-98-
E:\a327ex\062026\snkrx\ui\core.lua-99---[[
E:\a327ex\062026\snkrx\ui\core.lua-100-  ui_sublabel(o) -> { next_y }
062026\snkrx\ui\core.lua-101-  A muted small-caps label, no rule. opts: x, y, text, spec?.
E:\a327ex\062026\snkrx\ui\core.lua-102-]]
062026\snkrx\ui\core.lua:103:function ui_sublabel(o)
E:\a327ex\062026\snkrx\ui\core.lua-104-  ui_text({ rect = { x = o.x, y = o.y, w = 9999, h = ui_font_body_ark.height },
E:\a327ex\062026\snkrx\ui\core.lua-105-            text = string.upper(o.text), font = ui_font_body_ark,
E:\a327ex\062026\snkrx\ui\core.lua-106-            color = text_muted, align_v = 'top', spec = o.spec })
E:\a327ex\062026\snkrx\ui\core.lua-107-  return { next_y = o.y + ui_font_body_ark.height + ui_sp.s2 }
E:\a327ex\062026\snkrx\ui\core.lua-108-end
E:\a327ex\062026\snkrx\ui\core.lua-109-
E:\a327ex\062026\snkrx\ui\core.lua-110---[[
E:\a327ex\062026\snkrx\ui\core.lua-111-  ui_stack(rect[, gap]) -> stack
E:\a327ex\062026\snkrx\ui\core.lua-112-  A vertical layout cursor over a region rect. Kills the hand-mathed
E:\a327ex\062026\snkrx\ui\core.lua-113-  `y = y + h + gap` pattern.
062026\snkrx\ui\core.lua-114-    :take(h)        -> a {x, y, w, h} row at the cursor; advances by h + gap
062026\snkrx\ui\core.lua-115-    :skip(n) / :gap(n?) -> advance without taking
062026\snkrx\ui\core.lua-116-    :heading(text)  -> draw a ui_heading across the column; advance
062026\snkrx\ui\core.lua-117-    :sublabel(text) -> draw a ui_sublabel; advance
E:\a327ex\062026\snkrx\ui\core.lua-118-  Fields .x / .y / .w are live (the column origin + width).
E:\a327ex\062026\snkrx\ui\core.lua-119-]]
... [93 more lines]

1    --[[
2     ui/core.lua — shared UI core: spacing, the uniform return, the interaction
3     machine, the id guard, and layout helpers. The snkrx analog of ricochet's
4     `ric.*` core, adapted to snkrx's update-phase UI + its juice.
5   
6     Loaded before primitives/widgets so they can build on `ui_ret` / `ui_interact`.
7     The contract helpers (`ui_begin` / `ui_render`) live in ui/init.lua — they
8     need the layers + shadow pipeline set up there.
9   
10    CONVENTIONS
11      • Every ui_* widget returns a TABLE via `ui_ret`: `next_x` / `next_y` (just
12        past the widget + a `ui_sp.s2` gap, for chaining), the occupied rect
13        (`x` / `y` / `w` / `h`), merged with the widget's own fields (`clicked` /
14        `value` / `checked` / ...).
15      • Interactive widgets pass `id`; OMITTING `id` makes the widget STATIC (no
16        hover / click / juice). This permissive model is intentional (a button
17        with no id is a valid static badge). `ui_req_id` is the OPT-IN guard for
18        the rare widget where a missing id is definitely a bug.
19  ]]
20  
21  -- Spacing scale (px). Gaps + paddings pull from here instead of hardcoding.
22  -- s2 is the standard inter-widget chaining gap (used by ui_ret).
23  ui_sp = { s1 = 2, s2 = 4, s3 = 6, s4 = 10, s5 = 16 }
24  
25  --[[
26    ui_ret(rect, fields) -> table
27    The uniform widget return. `rect` is the widget's occupied {x,y,w,h};
28    `fields` (optional) is the widget's own result table. Returns `fields`
29    augmented with the occupied rect + `next_x` / `next_y` (just past the
30    widget + a ui_sp.s2 gap, for chaining in either direction).
... [112 more lines]

104  -- ============================================================
105 -- INPUT
106 -- ============================================================
107 bind('left',  'key:a'); bind('left',  'key:left')
108 bind('right', 'key:d'); bind('right', 'key:right')
109 bind('up',    'key:w'); bind('up',    'key:up')
110 bind('down',  'key:s'); bind('down',  'key:down')
111 bind('toggle_debug_draw', 'key:f2')
112 bind('cleave', 'mouse:1')   -- swordsman primary: a square cleave toward the cursor
113 
114 -- ============================================================
115 -- LAYERS  (structural — drawn bottom-to-top)
116 -- ============================================================
117 floor_layer   = layer_new('floor')    -- bg fill (no camera, no effect)
118 wall_layer    = layer_new('wall')     -- wall bodies
119 game_layer    = layer_new('game')     -- player + seekers + every carrier
120 effects_layer = layer_new('effects')  -- fxs (hit circles, particles, ...)
121 debug_layer   = layer_new('debug')    -- F2 collider overlay
122 
123 main_camera = camera_new(width, height)
124 main_camera.x = width/2
125 main_camera.y = height/2
126 
127 debug_draw_enabled = false
128 
129 -- ============================================================
130 -- SCENE
131 -- ============================================================
132 -- The player — moved by the WASD / arrow binds, aims at the mouse.
133 -- It carries player_spec (a snkrx_blue↔light_blue organic breathe — see
... [80 more lines]

213  
214   --[[ ATTACKS — fire a carrier here.  Bind a key in the INPUT section
215        above, then call its spawn_* helper on the press. Every carrier's
216        list + update/draw loop is already wired below, so this is the
217        ONLY code a new attack needs. Full opts: snkrx/<carrier>.lua.
218 
219          spawn_projectile(p, { damage = 1, speed = 190, max_range = 220,
220            fire_sounds = {{ sound = sounds.arrow_shoot,
221                             vol   = volumes.arrow_shoot }} })
222 
223          spawn_area(main_camera.mouse.x, main_camera.mouse.y,
224            { radius = 30, damage = 2, caster = p, shape = 'circle' })
225            -- shape 'rect' / 'polygon'; pass duration = N for a DoT area
226 
227          spawn_beam(p, { damage = 2, length = 600 })
228            -- persistent = true to channel it (hold to fire, release to stop)
229 
230          spawn_flicker(p, { damage = 2, hits = 5 })
231 
232          spawn_polygonal(p, { damage = 12, area_radius = 30 })
233            -- a rock lobbed in an arc; shatters into debris on landing
234 
235        Example — a projectile on left click (also bind 'fire' above):
236          if is_pressed('fire') and not p._dead then
237            spawn_projectile(p, { max_range = 220 })
238          end
239   ]]
240 
241   -- Swordsman Cleave: a square AoE in front of the aim, on a short cooldown.
242   if is_pressed('cleave') and not p._dead and time >= next_cleave_time then
... [12 more lines]

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SNKRX\buy_screen.lua:99:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 34, y = gh/2 - 30, character = 'swordsman', level = 1})
SNKRX\buy_screen.lua:100:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 54, y = gh/2 - 30, character = 'swordsman', level = 1})
SNKRX\buy_screen.lua:101:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 74, y = gh/2 - 30, character = 'swordsman', level = 1})
SNKRX\buy_screen.lua:102:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 34, y = gh/2 - 10, character = 'swordsman', level = 2})
SNKRX\buy_screen.lua:103:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 54, y = gh/2 - 10, character = 'swordsman', level = 2})
SNKRX\buy_screen.lua:104:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 74, y = gh/2 - 10, character = 'swordsman', level = 2})
SNKRX\buy_screen.lua:105:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 114, y = gh/2 - 30, character = 'swordsman', level = 2})
SNKRX\buy_screen.lua:106:    table.insert(self.tutorial_cards, TutorialCharacterPart{group = self.tutorial, x = gw/2 + 114, y = gh/2 - 10, character = 'swordsman', level = 3})
SNKRX\buy_screen.lua:108:    table.insert(self.tutorial_cards, TutorialClassIcon{group = self.tutorial, x = gw/2 + 134, y = gh/2 + 18, class = 'warrior', units = {{character = 'swordsman'}, {character = 'barbarian'}, {character = 'juggernaut'}}})
SNKRX\buy_screen.lua:109:    table.insert(self.tutorial_cards, TutorialClassIcon{group = self.tutorial, x = gw/2 + 154, y = gh/2 + 18, class = 'warrior', units = {{character = 'swordsman'}, {character = 'barbarian'}, {character = 'juggernaut'},
SNKRX\devlog.md:10:* Swordsman: deals damage in an area around the unit, small range
SNKRX\devlog.md:77:* Swordsman: deals physical damage in an area around the unit, small range
SNKRX\devlog.md:126:| Swordsman | deals physical damage in an area around the unit | small | medium |
SNKRX\devlog.md:151:| Swordsman | warrior |
SNKRX\devlog.md:258:| Swordsman | deals damage in an area around the unit | small | medium |
SNKRX\devlog.md:283:| Swordsman | warrior |
SNKRX\devlog.md:504:    * Swordsman [warrior]: deals AoE damage, deals extra damage for each unit hit - Lv.3: Cleave - damage is doubled
SNKRX\devlog.md:596:| Swordsman | warrior | deals AoE damage and deals extra damage for each unit hit |
SNKRX\devlog.md:642:| Swordsman | Cleave | damage is doubled |
SNKRX\devlog.md:811:| Swordsman | warrior | deals X AoE damage in an area, deals extra X/3 damage per unit hit |
SNKRX\devlog.md:824:| Swordsman | Cleave | the swordsman's damage is doubled |
SNKRX\main.lua:68:  swordsman1 = Sound('Heavy sword woosh 1.ogg', s)
SNKRX\main.lua:69:  swordsman2 = Sound('Heavy sword woosh 19.ogg', s)
SNKRX\main.lua:277:    ['swordsman'] = 'Swordsman',
SNKRX\main.lua:337:    ['swordsman'] = yellow[0],
SNKRX\main.lua:397:    ['swordsman'] = 'yellow',
SNKRX\main.lua:457:    ['swordsman'] = {'warrior'},
SNKRX\main.lua:517:    ['swordsman'] = '[yellow]Warrior',
SNKRX\main.lua:592:    ['swordsman'] = function(lvl) return '[fg]deals [yellow]' .. get_character_stat('swordsman', lvl, 'dmg') .. '[fg] damage in an area, deals extra [yellow]' ..
SNKRX\main.lua:593:      math.round(get_character_stat('swordsman', lvl, 'dmg')*0.15, 2) .. '[fg] damage per unit hit' end,
... [12 more lines]

SNKRX\player.lua:1926:    _G[random:table{'swordsman1', 'swordsman2'}]:play{pitch = random:float(0.9, 1.1), volume = 0.75}
SNKRX\main.lua:68:  swordsman1 = Sound('Heavy sword woosh 1.ogg', s)
SNKRX\main.lua:69:  swordsman2 = Sound('Heavy sword woosh 19.ogg', s)

1905   end
1906    
1907      if self.character == 'arcanist' then
1908        arcane1:play{pitch = random:float(0.95, 1.05), volume = 0.3}
1909      end
1910    
1911      if self.chance_to_barrage and random:bool(self.chance_to_barrage) then
1912        self:barrage(r, 3)
1913      end
1914    end
1915    
1916    
1917    function Player:attack(area, mods)
1918      mods = mods or {}
1919      camera:shake(2, 0.5)
1920      self.hfx:use('shoot', 0.25)
1921      local t = {group = main.current.effects, x = mods.x or self.x, y = mods.y or self.y, r = self.r, w = self.area_size_m*(area or 64), color = self.color, dmg = self.area_dmg_m*self.dmg,
1922        character = self.character, level = self.level, parent = self}
1923      Area(table.merge(t, mods))
1924    
1925      if self.character == 'swordsman' or self.character == 'barbarian' or self.character == 'juggernaut' or self.character == 'highlander' then
1926        _G[random:table{'swordsman1', 'swordsman2'}]:play{pitch = random:float(0.9, 1.1), volume = 0.75}
1927      elseif self.character == 'elementor' then
1928        elementor1:play{pitch = random:float(0.9, 1.1), volume = 0.5}
1929      elseif self.character == 'psychic' then
1930        psychic1:play{pitch = random:float(0.9, 1.1), volume = 0.4}
1931      elseif self.character == 'launcher' then
1932        buff1:play{pitch == random:float(0.9, 1.1), volume = 0.5}
1933      end
1934    

SNKRX\assets\sounds\Heavy sword woosh 1.ogg
SNKRX\assets\sounds\Heavy sword woosh 19.ogg

E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 4.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 4.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 14.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 14.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 20.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 20.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 5.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 5.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 2.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 2.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 18.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 18.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 15.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 15.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 13.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 13.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 7.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 7.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 19.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 19.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 17.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 17.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 1.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 1.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 6.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 6.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 16.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 16.wav
E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 8.wav
E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 8.wav
... [10 more lines]

ffmpeg: C:\Users\adn\AppData\Local\Microsoft\WinGet\Packages\Gyan.FFmpeg_Microsoft.Winget.Source_8wekyb3d8bbwe\ffmpeg-8.0.1-full_build\bin\ffmpeg.exe
ffmpeg version 8.0.1-full_build-www.gyan.dev Copyright (c) 2000-2025 the FFmpeg developers
oggenc: NOT FOUND

5:  list with its current bits / sr_div / volume. Arrow-key navigation;
11:  and (new) volume. Auto-replays every 0.5s; Space forces an immediate
30:    snkrx/volume_tuning.lua per-gameplay-name volume overrides.
33:    Sound files in `sounds` (gameplay-name keys) imply a volume key in
34:    `volumes` of the same name (for variants tables, the `_variants`
35:    suffix is stripped — so `sounds.enemy_die_variants` aliases to
36:    `volumes.enemy_die`). The path→key mapping is built once on first
39:    If a sound has no matching entry in `volumes`, the modal displays
40:    `—` for the volume value. Pressing the volume keys auto-creates
49:              S                 save sound_tuning + volume_tuning
53:              , / .             volume −/+ (step 0.02, clamped to ≥0)
93:local tune_volume_keys = {}  -- path → gameplay-name volume key
110:-- Walk the live `sounds` global to build path → volume key map.
112:-- Variant tables:        sounds.X_variants = {h1, h2, ...} → each
113:--                        path → 'X' (strip _variants suffix).
114:local function tune_build_volume_keys()
115:  tune_volume_keys = {}
117:  for name, entry in pairs(sounds) do
119:      local vol_key = name:match('^(.-)_variants$') or name
121:        local path = sound_get_path(handle)
122:        if path then tune_volume_keys[path] = vol_key end
126:      local path = sound_get_path(entry)
127:      if path then tune_volume_keys[path] = name end
140:-- read returns (number | nil) — nil means "no volume entry exists".
142:  local key = tune_volume_keys[path]
144:  return volumes[key], key
147:-- Apply a signed step to a path's volume. If no entry exists yet,
152:  local key = tune_volume_keys[path]
154:  local cur = volumes[key]
156:  volumes[key] = math.max(0.0, cur + delta)
... [16 more lines]

=== E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 1.wav ===
size: 148.336 bytes
codec_name=pcm_s16le
sample_rate=44100
channels=2
bits_per_sample=16
duration=0.834354
=== E:\sound packs\Ultimate SFX Bundle (2020)\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 19.wav ===
size: 132.868 bytes
codec_name=pcm_s16le
sample_rate=44100
channels=2
bits_per_sample=16
duration=0.746667
=== E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 1.wav ===
size: 148.336 bytes
codec_name=pcm_s16le
sample_rate=44100
channels=2
bits_per_sample=16
duration=0.834354
=== E:\sound packs\Ultimate SFX Bundle - HD Remaster\Sword Sounds Pro\Heavy sword wooshes\Heavy sword woosh 19.wav ===
size: 132.868 bytes
codec_name=pcm_s16le
sample_rate=44100
channels=2
bits_per_sample=16
duration=0.746667

OK  Heavy sword woosh 1.ogg  (47.042 bytes)
OK  Heavy sword woosh 19.ogg  (41.722 bytes)
--- wav remaining in assets? ---
none (clean)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

16   Key principle — the **Carrier Axis**: a class is single-carrier (one delivery method → archetypes blend, high interplay, global gems) or multi-carrier (distinct methods → modal builds, per-ability gems); choose consciously per unit. Favor archetype interplay (X+Y builds).
17  
18  Status (2026-06-05): **grey-box started.** Forked from `snkrx-template` into `E:/a327ex/062026/` (its own copy of Anchor 2 + the snkrx toolkit; `.git` not copied). The build lives in `062026/main.lua` (started from the clean reference scene). First playable: moving player (WASD/arrows + mouse-aim, already in the template), a **trickle of seekers from the right** edge toward the player (cap 12, one per 0.6s, 4 seeded), 4 boundary walls, and the **Swordsman Cleave** on LMB — a **square** AoE (`area` carrier, `shape='rect'`) popped just ahead of the aim (placeholder dmg 8 / cd 0.35s / half-side 18). Decisions this session: cleave = SNKRX-style **square** (not wedge/circle); enemies enter **from the right**. Deliberately NOT done yet (discipline): crowd-scaling on Cleave (the swordsman's "tighter mob = harder hit" identity — the immediate next step), the rest of the kit (Passive/Secondary/Mobility/Ultimate), gems, UI/HUD, player death/fail. Honest gate still = fun-test the active-aim loop on the third sitting before scaling the roster (side project — see [[feedback_shipping_gate]]). Tuning knobs are all-caps globals near the SCENE section. Not in global CLAUDE.md project list yet.
19  

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

deleted Heavy sword woosh 1.ogg
deleted Heavy sword woosh 19.ogg
woosh files remaining: 0

SYNTAX OK

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

SYNTAX OK

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

Found 47 files
Invoker-old\ui.lua
Invoker-old\spells.lua
Invoker-old\spells.md
Invoker-old\wall_symbols.lua
Invoker-old\archive\inventory_ui.lua
Invoker-old\archive\equipment.lua
Invoker-old\reference\ui_primitives_spec.md
Invoker-old\reference\mockup_ui_kit_4.html
Invoker-old\reference\mockup_ui_kit_3.html
Invoker-old\reference\mockup_ui_kit_1.html
Invoker-old\reference\archive\orblike_ability_system_old.md
Invoker-old\reference\archive\orblike_ability_system.md
Invoker-old\reference\archive\feature_by_feature_analysis.md
Invoker-old\reference\poe_skill_examples.md
Invoker-old\reference\poe_gem_mechanics.md
Invoker-old\reference\mockup_ui_v2_snkrx.html
Invoker-old\reference\mockup_ui_elements.html
Invoker-old\reference\mockup_book_regional_entry.html
Invoker-old\reference\mockup_book_field_manual.html
Invoker-old\v1\main.lua
Invoker-old\reference\todo.md
Invoker-old\reference\file_split_and_ownership.md
Invoker-old\reference\anchor_usage_analysis.md
Invoker-old\reference\ai_coding_paradigms.md
Invoker-old\reference\interactions.md
Invoker-old\reference\tags.md
Invoker-old\reference\map_visual_system.md
Invoker-old\reference\ability_modifier_map.md
Invoker-old\v1\anchor\init.lua
... [18 more lines]

Found 23 files
word-game\snkrx\findings.md
062026\snkrx\findings.md
a327ex-site\logs\attack-system-generalization-4.md
a327ex-site\logs\attack-system-generalization-3.md
a327ex-site\logs\attack-system-generalization-2.md
a327ex-site\logs\attack-system-generalization-1.md
a327ex-site\logs\orblike-wall-visuals-ability-editions.md
a327ex-site\logs\orblike-visual-aural-consistency.md
a327ex-site\logs\orblike-poe-sap-based-analysis.md
a327ex-site\logs\orblike-pack-system.md
a327ex-site\logs\orblike-more-visuals-edition-system.md
a327ex-site\logs\orblike-map-gen-wall-visuals.md
a327ex-site\logs\orblike-hideout-1.md
a327ex-site\logs\orblike-damage-system.md
a327ex-site\logs\orblike-assorted-improvements.md
a327ex-site\logs\orblike-6-abilities.md
a327ex-site\logs\orblike-5-arrow-abilities.md
a327ex-site\logs\orblike-3-melee-abilities.md
a327ex-site\logs\orblike-3-abilities-15-mods.md
a327ex-site\logs\orblike-1-ability-and-4-modifiers.md
a327ex-site\logs\anchor-rewrite.md
anchor.blot.im\logs\anchor-rewrite.md
.claude\skills\add-ability\skill.md

33-| `aimed_area` | 1509 | `area` placed at mouse with `max_range` clamp | `windfield` |
34-| `melee` | 1342 | sequential wave of small `area` instances marching from player toward mouse | `fissure` |
35-| `chain` | 1578 | sequence of `lightning_line` + `hit_circle` hops between enemies | `arc` |
36:| `beam` | 3619 | per-frame dashed-line beam attached to player or orb, tick damage | `beam` |
37-| `cyclone` | 4052 | persistent `area` following the player with orbiting particles | `cyclone` |
38-| `toggle_area` | 4164 | persistent `area` following player, toggled on/off | `righteous_fire` |
39-| `big_rock` | 1798 | `big_rock_effect` (parabolic throw → impact area + fragments) | `big_rock` |
40-| `construct` | 1869 | `rotating_turret` static entity that fires projectiles | `rotating_turret` |
41:| `asal` | 3160 | charged dash that kills first enemy (with chain explosions) | `asal` |
42:| `dash_strike` | 2320 | dash-through-enemies with delayed sword-slash hits | `dash_strike` |
43-| `flicker` | 4450 | bezier-hopping clone chain between enemies | `flicker_strike` |
44-| `railgun` | 2590 | charged straight line, instant damage along path | `railgun` |
45-| `psylance` | 4227 | two-phase force-line (gather enemies, then damage) | `psylance` |
--
85-
86-| Ability | Element | Visual | Cast sound | Loop sound | Special |
87-|---|---|---|---|---|---|
88:| `beam` | force | dashed line with leading-edge white flash + tip circle + guide lines (when widened) | `beam_cast` | `beam_drone` (looped, pitched by tick_rate) | hold carrier; beam_length=150, beam_width=2, tick_rate=0.15 |
89-| `cyclone` | wind | persistent `area` (circle) following player with orbit-arcs | `hurricane_start` | `hurricane_loop` + periodic `wind_proj_*` whooshes | hold carrier; speed_mult=0.5, trigger_rate=2 |
90:| `psylance` | force | two-phase line: pulls enemies in, then dashed-line damage | `formation_activate` (fire) | `beam_drone` x 0.8 vol (loop) | hold carrier; gather_duration=0.5, damage_delay=0.15 |
91-
92-### Strikes / movement
93-
94-| Ability | Element | Visual | Cast sound | Hit sound | Special |
95-|---|---|---|---|---|---|
96:| `asal` | (no element field; physical-ish) | charged dash; on hit spawns chain explosions on overkill | `charging_loop` (loop) → `subtle_whoosh` (release) → `magic_punch_1/3` (impact) | `magic_punch_*` | charge-based; `charge_duration=0.3`; explosion_radius=25; `chain` on kill via overkill |
97:| `dash_strike` | (no element) | dash + delayed hits at each enemy crossed with anime delay between hits | `subtle_whoosh` | `sword_slash_1..4` random pitch | `dash_range=184`, `dash_lerp_time=0.06`, `hit_delay_start=0.04`, `hit_delay_per=0.02` |
98-| `flicker_strike` | (no element) | bezier hops between enemies leaving rounded-rect clone trail | (none specific) | `slash_hit` + `sword_slash_*` | charges=10, range=120, delay=0.05 |
99-
100-### Polygonal projectile / chain
... [143 more lines]

578:-- Shared trail system: update trail points and draw as dashed lines
595:  local dash_len = 5
597:  local stride = dash_len + gap_len
621:    local dash_start = d
622:    local dash_end = math.min(d + dash_len, total_dist)
623:    if dash_end - dash_start > 0.5 then
624:      local mid = (dash_start + dash_end)/2
644:      local sx, sy = trail_pos(dash_start)
645:      local ex, ey = trail_pos(dash_end)
897:    dash_range = 80,
898:    dash_lerp_time = 0.08,
916:  dash_strike = {
919:    carrier = 'dash_strike',
923:    dash_range = 184,
924:    dash_lerp_time = 0.06,
1090:  'beam', 'deploy', 'cyclone', 'asal', 'flicker_strike', 'dash_strike',
2320:    if def and def.activation == 'manual' and def.carrier == 'dash_strike' then
2322:      -- Lerp during dash
2323:      if self.dash_strike_lerping then
2324:        self.dash_strike_lerp_t = self.dash_strike_lerp_t + dt
2325:        local t = math.min(self.dash_strike_lerp_t/def.dash_lerp_time, 1)
2326:        local px = self.dash_strike_from_x + (self.dash_strike_to_x - self.dash_strike_from_x)*t
2327:        local py = self.dash_strike_from_y + (self.dash_strike_to_y - self.dash_strike_from_y)*t
2329:        if not self.dash_strike_is_null then
2335:            t = 1 -- end dash early
2336:            self.dash_strike_lerp_t = def.dash_lerp_time
2339:        if self.dash_strike_is_null then
2347:          p1.r = self.dash_strike_r
2350:        local src = self.dash_strike_is_null and self or p1
2352:          if not e.dead and not self.dash_strike_hit_set[e] then
... [32 more lines]

19:  windfield_cast = 0.6,
30:  wind_whoosh_1 = 0.14,
33:  windmagic_impact = 0.26,
34:  windmagic_epic_impact = 0.26,
35:  wind_whoosh_2 = 0.378,
36:  wind_proj = 0.3,
45:  subtle_whoosh = 0.43,
55:  wind_slash_cast = 0.65,
56:  wind_slash_hit = 0.5,
149:an:sound('windfield_cast', 'assets/RPG3_WindMagic_Cast04.ogg')
159:an:sound('wind_whoosh_1', 'assets/Wind_Whoosh_01.ogg')
162:an:sound('hurricane_start', 'assets/RPG3_WindMagicEpic_Hurricane01v3_Short.ogg')
163:an:sound('hurricane_start_lightmed', 'assets/RPG3_WindMagicEpic_Hurricane01v3_Short_lightmed.ogg')
164:an:sound('windmagic_impact', 'assets/RPG3_WindMagic_Impact02.ogg')
165:an:sound('windmagic_impact_lightmed', 'assets/RPG3_WindMagic_Impact02_lightmed.ogg')
166:an:sound('windmagic_epic_impact', 'assets/RPG3_WindMagicEpic_Impact02.ogg')
167:an:sound('windmagic_epic_impact_lightmed', 'assets/RPG3_WindMagicEpic_Impact02_lightmed.ogg')
168:an:sound('wind_whoosh_2', 'assets/Wind_Whoosh_1.ogg')
169:an:sound('wind_whoosh_3', 'assets/Wind_Whoosh_2.ogg')
170:an:sound('wind_proj_1', 'assets/RPG3_WindMagic_Projectiles01.ogg')
171:an:sound('wind_proj_2', 'assets/RPG3_WindMagic_Projectiles02.ogg')
172:an:sound('wind_proj_3', 'assets/RPG3_WindMagic_Projectiles03.ogg')
180:an:sound('subtle_whoosh', 'assets/RPG3_Generic_SubtleWhoosh02.ogg')
196:an:sound('wind_slash_cast', 'assets/RPG3_WindMagicEpic_Projectiles02.ogg')
197:an:sound('wind_slash_hit', 'assets/RPG3_WindMagic_LightImpact01.ogg')
511:  {'windfield_cast', 'assets/RPG3_WindMagic_Cast04'},
523:  {'wind_whoosh_1', 'assets/Wind_Whoosh_01'},
525:  {'hurricane_start', 'assets/RPG3_WindMagicEpic_Hurricane01v3_Short'},
526:  {'windmagic_impact', 'assets/RPG3_WindMagic_Impact02'},
527:  {'windmagic_epic_impact', 'assets/RPG3_WindMagicEpic_Impact02'},
... [2 more lines]

1    --[[
2     flicker.lua — flicker-strike line/trail carrier (v1 flicker_strike).
3   
4     A self-contained moving entity. NOT the player — the caster only
5     supplies a spawn position, an aim direction, and an edition tint;
6     after that the flicker is autonomous. It hops between enemies along
7     cubic-bezier curves, leaving a fading dashed trail and spawning the
8     full v1 flicker-strike hit FX at each enemy it reaches. Port of v1's
9     flicker_strike (line 4450) — visuals + sounds, no player movement,
10    no modifiers (multistrike / melee_splash / echo are gameplay-side).
11  
12    Lifecycle:
13      1. Find an initial target: closest enemy to the click position
14         (target_x/target_y) within `range` of it — v1 flicker_strike's
15         first jump (closest enemy to the cursor). No target → fizzle.
16      2. Hop to it via a cubic bezier (control points 80% along the
17         entry/exit angles; exit angle pre-bends toward the next target),
18         lerped over `hop_delay`. Departure puff + 2 particles + shake.
19      3. On arrival: per-enemy hit FX (fx_energy_122 burst, hit_circle,
20         4 zag particles) + arrival juice (slash sounds, shake, body
21         flash + spring pulse).
22      4. After `hits` enemies are struck (or targets run out), stop with
23         the final burst (hit_stop, slash_final, AoE knockback, big FX).
24         The trail fades; the entity self-destructs once it's empty.
25  
26    Caller API:
27      spawn_flicker(caster, {
28        target_x,        -- click position; first hop targets the enemy
29        target_y,        --   closest to it. default: main_camera.mouse
30        aim_r,           -- optional, default: caster → click position
... [369 more lines]

E:\sound packs\RPG Magic Sound Effects Pack 3 [ELEMENTAL]\Generic Magic and Impacts\RPG3_Generic_SubtleWhoosh04.wav
E:\sound packs\RPG Magic Sound Effects Pack 3 [ELEMENTAL]\Generic Magic and Impacts\RPG3_Generic_SubtleWhoosh02.wav
E:\sound packs\RPG Magic Sound Effects Pack 3 [ELEMENTAL]\Generic Magic and Impacts\RPG3_Generic_SubtleWhoosh03.wav
E:\sound packs\RPG Magic Sound Effects Pack 3 [ELEMENTAL]\Generic Magic and Impacts\RPG3_Generic_SubtleWhoosh01.wav

48:  -- Last arg can be an opts table (e.g. {sensor = true})
125:function collider:set_filter_group(group, shape) physics_shape_set_filter_group(shape or self.shape, group) end

062026\anchor\camera.lua:196:    c.x = math.lerp_dt(c.follow_lerp, c.follow_lerp_time, dt, c.x, tx)
062026\anchor\camera.lua:197:    c.y = math.lerp_dt(c.follow_lerp, c.follow_lerp_time, dt, c.y, ty)
062026\anchor\math.lua:5:    lerp, lerp_dt             - Linear interpolation
062026\anchor\math.lua:6:    lerp_angle, lerp_angle_dt - Angle interpolation with wrapping
062026\anchor\math.lua:55:function math.lerp(t, source, destination)
062026\anchor\math.lua:63:    x = math.lerp_dt(0.9, 1, dt, x, target)   -> covers 90% of distance in 1 second
062026\anchor\math.lua:64:    x = math.lerp_dt(0.5, 0.5, dt, x, target)  -> covers 50% of distance in 0.5 seconds
062026\anchor\math.lua:79:function math.lerp_dt(p, t, dt, source, destination)
062026\anchor\math.lua:142:function math.lerp_angle(t, source, destination)
062026\anchor\math.lua:152:    angle = math.lerp_angle_dt(0.9, 1, dt, angle, target_angle)
062026\anchor\math.lua:165:    - Exponential approach like lerp_dt
062026\anchor\math.lua:167:function math.lerp_angle_dt(p, t, dt, source, destination)

2318   if ability_name then
2319        local def = abilities[ability_name]
2320        if def and def.activation == 'manual' and def.carrier == 'dash_strike' then
2321          self.cooldown = math.max(self.cooldown - dt, 0)
2322          -- Lerp during dash
2323          if self.dash_strike_lerping then
2324            self.dash_strike_lerp_t = self.dash_strike_lerp_t + dt
2325            local t = math.min(self.dash_strike_lerp_t/def.dash_lerp_time, 1)
2326            local px = self.dash_strike_from_x + (self.dash_strike_to_x - self.dash_strike_from_x)*t
2327            local py = self.dash_strike_from_y + (self.dash_strike_to_y - self.dash_strike_from_y)*t
2328            -- Wall collision check: raycast from current to target, stop at wall
2329            if not self.dash_strike_is_null then
2330              local hit = an:raycast(p1.x, p1.y, px, py, {'wall'})
2331              if hit then
2332                -- Stop slightly before wall (4px offset along normal)
2333                px = hit.point_x + hit.normal_x*4
2334                py = hit.point_y + hit.normal_y*4
2335                t = 1 -- end dash early
2336                self.dash_strike_lerp_t = def.dash_lerp_time
2337              end
2338            end
2339            if self.dash_strike_is_null then
2340              self.x, self.y = px, py
2341              self.ox = self.x - p1.x
2342              self.oy = self.y - p1.y
2343              self.collider:set_position(self.x, self.y)
2344            else
2345              p1.collider:set_position(px, py)
2346              p1.x, p1.y = px, py
2347              p1.r = self.dash_strike_r
... [18 more lines]

No matches found

E:\a327ex\062026\anchor\collider.lua-394-
062026\anchor\collider.lua-395-  opts:
062026\anchor\collider.lua:396:    tag             physics tag to raycast against. Default 'wall'.
E:\a327ex\062026\anchor\collider.lua-397-    lookahead       minimum feeler length when stationary. Default 30.
E:\a327ex\062026\anchor\collider.lua-398-    predictiveness  velocity multiplier added on top of lookahead. The
--
E:\a327ex\062026\anchor\collider.lua-444-
E:\a327ex\062026\anchor\collider.lua-445-  -- Closest hit wins. We compare by ray fraction since fraction is
062026\anchor\collider.lua:446:  -- already in 0..1 along each ray (Box2d raycast convention) — no need
E:\a327ex\062026\anchor\collider.lua-447-  -- to sqrt distances. Stash the chosen hit's outward normal for the
E:\a327ex\062026\anchor\collider.lua-448-  -- steering force.
--
E:\a327ex\062026\anchor\collider.lua-451-  for i = 1, 3 do
E:\a327ex\062026\anchor\collider.lua-452-    local f = feelers[i]
062026\anchor\collider.lua:453:    local hit = physics_raycast(px, py, f.x, f.y, { tag })
E:\a327ex\062026\anchor\collider.lua-454-    if hit and hit.fraction < closest_frac then
E:\a327ex\062026\anchor\collider.lua-455-      closest_frac = hit.fraction
--
E:\a327ex\062026\.claude\CLAUDE.md-215-### Carriers
E:\a327ex\062026\.claude\CLAUDE.md-216-- **`projectile.lua`** — straight-line rounded-rect carrier with
062026\.claude\CLAUDE.md:217:  sensor collider, wall raycast, max-range cap, spec-tinted
062026\.claude\CLAUDE.md-218-  hit\wall\death FX. Caller API: `spawn_projectile(caster, opts)`
E:\a327ex\062026\.claude\CLAUDE.md-219-  where opts can pass `fire_sounds = {{sound, vol}, ...}` (default
--
E:\a327ex\062026\.claude\CLAUDE.md-317-- Projectile has a sensor box collider (passes through everything
E:\a327ex\062026\.claude\CLAUDE.md-318-  visually; events fire via `sensor_entities_begin('projectile','enemy')`).
062026\.claude\CLAUDE.md:319:  Walls are caught by the projectile's per-frame forward raycast.
E:\a327ex\062026\.claude\CLAUDE.md-320-- Areas / beams / flickers / props are NOT physics objects — they
E:\a327ex\062026\.claude\CLAUDE.md-321-  query existing colliders by tag at damage time (circle / box /
062026\.claude\CLAUDE.md:322:  polygon queries; beams also raycast walls per path segment). The
... [12 more lines]

440        y = py + ( hx*sin_a + hy*cos_a)*side_len },
441     { x = px + ( hx*cos_a + hy*sin_a)*side_len,
442       y = py + (-hx*sin_a + hy*cos_a)*side_len },
443   }
444 
445   -- Closest hit wins. We compare by ray fraction since fraction is
446   -- already in 0..1 along each ray (Box2d raycast convention) — no need
447   -- to sqrt distances. Stash the chosen hit's outward normal for the
448   -- steering force.
449   local closest_nx, closest_ny
450   local closest_frac = math.huge
451   for i = 1, 3 do
452     local f = feelers[i]
453     local hit = physics_raycast(px, py, f.x, f.y, { tag })
454     if hit and hit.fraction < closest_frac then
455       closest_frac = hit.fraction
456       closest_nx, closest_ny = hit.normal_x, hit.normal_y
457     end
458   end
459 
460   if not closest_nx then return 0, 0 end
461 
462   -- Desired velocity = max_speed along the outward normal. Steering =
463   -- desired - current, clamped to max_force. The closer the hit (smaller
464   -- fraction), the more the current velocity opposes desired and the
465   -- larger the resulting steering — natural penetration-depth scaling.
466   local dvx = closest_nx*max_speed
467   local dvy = closest_ny*max_speed
468   local fx, fy = dvx - vx, dvy - vy
469   return math.limit(fx, fy, max_force or 1000)

OK 66.677 bytes
wav remaining: 0

The file E:/a327ex/062026/snkrx/flicker.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/flicker.lua has been updated successfully. (file state is current in your context — no need to Read it back)

<tool_use_error>File has not been read yet. Read it first before writing to it.</tool_use_error>

1    player = class()
2   
3   function player:new(x, y)
4     self.x, self.y = x, y
5     self.w, self.h = 10, 10
6     self.base_speed = 100
7     self.speed = self.base_speed
8     self.r = 0
9     self.visual_r = 0
10    self.sx, self.sy = 1, 1
11    self.spec = player_spec   -- four-axis effect spec (see snkrx/init.lua)
12    self.moving = false
13    self.previous_moving = false
14    self.flashing = false
15  
16    -- Resource stats. Register modifier stats (hp_max, mp_max, regens)
17    -- before the pool stats so stats_update walks the caps first;
18    -- pool maxes are then re-synced from p.hp_max / p.mp_max in
19    -- player:update via stats_set_min_max. See stats.lua docs for the
20    -- pool-vs-modifier convention.
21    stats_set(self, 'hp_max',   100, 0, math.huge)
22    stats_set(self, 'mp_max',   100, 0, math.huge)
23    stats_set(self, 'hp_regen', 2,   0, math.huge)
24    stats_set(self, 'mp_regen', 10,  0, math.huge)
25    stats_set(self, 'hp',       100, 0, self.hp_max)
26    stats_set(self, 'mp',       100, 0, self.mp_max)
27  
28    make_entity(self)
29  
30    self.collider = collider(self, 'player', 'dynamic', 'box', self.w, self.h)
... [158 more lines]

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

player.lua OK
flicker.lua OK

74   -- The SNKRX attack toolkit. Must come AFTER require('anchor') above —
75  -- it loads sounds / shaders / spritesheets, which need the engine up.
76  require('snkrx')
77  
78  -- Apply persisted volume overrides from snkrx/volume_tuning.lua and
79  -- snapshot the baseline for the F3 tuner's diff-save. Place this AFTER
80  -- all baseline `volumes.X = ...` entries (snkrx/init.lua's defaults
81  -- plus any host additions in this file). If you add custom volume
82  -- entries later in this file, move this call AFTER them — otherwise
83  -- the snapshot will miss them and the tuner will write your custom
84  -- entries to volume_tuning.lua even when you haven't changed them.
85  volumes_apply_overrides()
86  
87  -- ============================================================
88  -- PHYSICS  (structural — the whole collision matrix lives here)
89  -- ============================================================
90  physics_init()
91  physics_register_tag('player')
92  physics_register_tag('wall')
93  physics_register_tag('enemy')
94  physics_register_tag('projectile')   -- carrier: projectile (sensor box)
95  physics_register_tag('debris')       -- carrier: prop shatter shards
96  physics_enable_collision('player', 'wall')
97  physics_enable_collision('player', 'enemy')
98  physics_enable_collision('enemy', 'wall')
99  physics_enable_collision('enemy', 'enemy')
100 physics_enable_sensor('projectile', 'enemy')   -- carrier: projectile hits
101 physics_enable_collision('debris', 'debris')   -- carrier: prop
102 physics_enable_collision('debris', 'wall')     -- carrier: prop
103 
... [70 more lines]

173  end
174 
175 -- Seed a few so the first sitting has immediate action.
176 for i = 1, 4 do spawn_from_right() end
177 
178 -- ============================================================
179 -- F1 DEV TUNER  (live knob editing — built from the snkrx UI toolkit)
180 -- ============================================================
181 -- Runtime only: nudge a value until it feels right, then bake the good
182 -- number into the constants above. Each knob reads/writes its global by
183 -- name via _G[key]; the slider is normalized 0..1, mapped through [min,max].
184 tuner_open = false
185 tuner_panel_rect = nil   -- set each frame the panel draws; nil when closed.
186                          -- Used to suppress a cleave swing when a click
187                          -- lands on the panel.
188 tuner_knobs = {
189   { key = 'CLEAVE_DAMAGE', label = 'cleave dmg',   min = 1,    max = 40,  int = true },
190   { key = 'CLEAVE_CD',     label = 'cleave cd',    min = 0.05, max = 1.0             },
191   { key = 'CLEAVE_RADIUS', label = 'cleave size',  min = 6,    max = 48,  int = true },
192   { key = 'CLEAVE_OFFSET', label = 'cleave reach', min = 0,    max = 48,  int = true },
193   { key = 'SEEKER_CAP',    label = 'max enemies',  min = 1,    max = 40,  int = true },
194   { key = 'SPAWN_CD',      label = 'spawn rate',   min = 0.1,  max = 2.0             },
195 }
196 
197 -- Queue the tuner panel onto ui_layer (call from update() while open). One
198 -- row per knob: a `label  value` line + a slider beneath. Composed from
199 -- ui_panel / ui_heading / ui_text / ui_slider; rides the existing
200 -- ui_begin / ui_render pipeline, so it gets the breathe + drop shadow.
201 function tuner_ui()
202   local fh     = ui_font_body_ark.height
... [85 more lines]

288    --   if r.clicked then game_paused = not game_paused end
289   -- Each widget call queues commands onto `ui_layer`. The render
290   -- pipeline in draw() (UI RENDER section) composites them last.
291 
292   --[[ ATTACKS — fire a carrier here.  Bind a key in the INPUT section
293        above, then call its spawn_* helper on the press. Every carrier's
294        list + update/draw loop is already wired below, so this is the
295        ONLY code a new attack needs. Full opts: snkrx/<carrier>.lua.
296 
297          spawn_projectile(p, { damage = 1, speed = 190, max_range = 220,
298            fire_sounds = {{ sound = sounds.arrow_shoot,
299                             vol   = volumes.arrow_shoot }} })
300 
301          spawn_area(main_camera.mouse.x, main_camera.mouse.y,
302            { radius = 30, damage = 2, caster = p, shape = 'circle' })
303            -- shape 'rect' / 'polygon'; pass duration = N for a DoT area
304 
305          spawn_beam(p, { damage = 2, length = 600 })
306            -- persistent = true to channel it (hold to fire, release to stop)
307 
308          spawn_flicker(p, { damage = 2, hits = 5 })
309 
310          spawn_polygonal(p, { damage = 12, area_radius = 30 })
311            -- a rock lobbed in an arc; shatters into debris on landing
312 
313        Example — a projectile on left click (also bind 'fire' above):
314          if is_pressed('fire') and not p._dead then
315            spawn_projectile(p, { max_range = 220 })
316          end
317   ]]
... [60 more lines]

377  
378   -- Collisions. airborne_no_collide skips airborne-vs-grounded pairs.
379   for _, ev in ipairs(collision_entities_begin('player', 'enemy')) do
380     local pl, e = ev.a, ev.b
381     if pl and not pl._dead and e and not e._dead
382        and not airborne_no_collide(pl, e) then
383       local r = math.angle_to_point(pl.x, pl.y, e.x, e.y)
384       if e.push then e:push(r, 6) end
385       local px, py = ev.x, ev.y
386       if not px then px, py = (pl.x + e.x)*0.5, (pl.y + e.y)*0.5 end
387       pl:hit(e.contact_damage or 1, px, py, e)
388     end
389   end
390   for _, ev in ipairs(collision_entities_begin('enemy', 'wall')) do
391     local e, w = ev.a, ev.b
392     if e and e.wall_bump and not e._dead and w
393        and not airborne_no_collide(e, w) then
394       e:wall_bump(math.angle_to_point(w.x, w.y, e.x, e.y))
395     end
396   end
397   for _, ev in ipairs(sensor_entities_begin('projectile', 'enemy')) do
398     local pr, e = ev.a, ev.b
399     if pr and pr.on_hit and not pr._dead and e and not e._dead
400        and not airborne_no_collide(pr, e) then
401       pr:on_hit(e)
402     end
403   end
404 
405   process_destroy_queue()
406 end

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

main.lua OK

1045 
1046    Same conventions as Anchor 2 / ricochet-template / Invoker:
1047    
1048    - **⛔ DESIGN BRIEF before code.** See the workflow rule at the top of
1049      this file. No `Write` / `Edit` on project code without first posting
1050      a conceptual design brief (approach + interfaces + per-function
1051      notes), iterating it with the user, and reaching a conclusion.
1052      Trivial changes skip the brief.
1053    - **One change at a time.** The user tests between each step.
1054    - **Don't run `./run.bat`** — user runs.
1055    - **Syntax-check Lua changes** with `lua54.exe -e "loadfile(...)"`.
1056    - **AskUserQuestion for design decisions** (carrier shape, parameter ranges, key bindings, sound placement).
1057    - **Code style:** operator spacing `*` `/` no spaces, `+` `-` with spaces. See `E:/a327ex/.claude/CLAUDE.md` for project-wide rules.
1058    - **Keep the docs in sync.** If you change behavior, update the relevant top-of-file docblock + this CLAUDE.md.
1059    - **The effect inspector (F5) is the place to explore patterns / colors /
1060      dithers / shapes** — click a sample shape, edit its spec. To try an
1061      effect on a real entity instead, set its `.spec` (or pass `spec` to a
1062      spawn helper) and use the `effect_next_*` / `effect_prev_*` cyclers.
1063    

The file E:/a327ex/062026/.claude/CLAUDE.md has been updated successfully. (file state is current in your context — no need to Read it back)

18   Status (2026-06-05): **grey-box started.** Forked from `snkrx-template` into `E:/a327ex/062026/` (its own copy of Anchor 2 + the snkrx toolkit; `.git` not copied). The build lives in `062026/main.lua` (started from the clean reference scene). First playable: moving player (WASD/arrows + mouse-aim, already in the template), a **trickle of seekers from the right** edge toward the player (cap 12, one per 0.6s, 4 seeded), 4 boundary walls, and the **Swordsman Cleave** on LMB — a **square** AoE (`area` carrier, `shape='rect'`) popped just ahead of the aim (placeholder dmg 8 / cd 0.35s / half-side 18). Decisions this session: cleave = SNKRX-style **square** (not wedge/circle); enemies enter **from the right**; the swordsman is **yellow** (SNKRX-canon). Since then: cleave tuned to size/reach 32 (a 64px square) + cd 1 + **hold-LMB-to-repeat**; an **F1 live knob-tuner** panel (built from the snkrx UI toolkit) over the cleave/spawn constants; and a **swing sound** on the cleave — the template's existing `sword_slash` v3 (`Sword_Slash_1_v3.ogg`) at ±10% pitch, F3-tunable under the `sword_slash` volume key. (Briefly wired the SNKRX `Heavy sword woosh` pair from the sound packs, then dropped it for the existing slash.) ⛔ **The discipline / shipping gate does NOT apply to 062026** — the user declared it a side project for fun where he indulges however he likes; do NOT flag juice / polish / custom sound / infra as B-work on this project (he'll consciously decide), in contrast to [[feedback_shipping_gate]] which still governs his MAIN game projects. Cleave **crowd-scaling is now in**: each swing = base `CLEAVE_DAMAGE` (3) **+1 per enemy caught** in the square (counted at fire via `query_entities_box`, keeping `area.lua` generic; the +1/enemy is hardcoded, NOT a UI knob, per the user) — the "tighter mob = harder hit" identity, live. Genuinely next (un-gated, just unbuilt): the rest of the kit (Passive/Secondary/Mobility/Ultimate), gems, and player death/fail. Tuning knobs are all-caps globals near the SCENE section. Not in global CLAUDE.md project list yet.
19  

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

41     self.timer = timer_new()
42    self.spring = spring_new()
43    spring_add(self.spring, 'hit', 1)
44    spring_add(self.spring, 'shoot', 1)
45    spring_add(self.spring, 'move', 1)
46  
47    -- Character identity — all class-specific ability logic branches on this
48    -- (`if self.character == 'swordsman' then ...`). Hardcoded for now; becomes
49    -- a constructor arg as more classes land.
50    self.character = 'swordsman'
51    -- Ability cooldown timestamps + dash state.
52    self.next_cleave_time = 0
53    self.next_dash_time   = 0
54    self.dashing  = false
55    self.dash_r   = 0
56    self.dash_t   = 0
57    self.dash_to_x, self.dash_to_y = 0, 0
58    self.dash_trail   = {}
59    self.dash_hit_set = {}
60  end
61  
62  -- ── Abilities (character-branched) ────────────────────────────────
63  -- All class-specific input -> ability dispatch lives here, behind
64  -- `if self.character == '<class>' then`. As more classes land this grows
65  -- into an if/elseif chain — the project's chosen structure.
66  function player:update_abilities()
67    if self.character == 'swordsman' then
68      -- Primary - Cleave (hold LMB). game_input_blocked stops a click that
69      -- lands on the tuner panel from also swinging (a mouse-only guard).
70      if is_down('cleave') and not self._dead and not game_input_blocked
... [110 more lines]

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

player.lua OK
main.lua OK

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

The file C:\Users\adn\.claude\projects\E--a327ex\memory\project_062026.md has been updated successfully. (file state is current in your context — no need to Read it back)

1    player = class()
2   
3   -- Lunge charges: this many dashes before the full-refill lockout (DASH_CD, 8s)
4   -- triggers — and only once ALL are spent (see player:start_dash). A local
5   -- (not a main.lua global) because it's read in player:new, which runs before
6   -- main.lua's DASH_* globals exist.
7   local DASH_MAX_CHARGES = 2
8   
9   function player:new(x, y)
10    self.x, self.y = x, y
11    self.w, self.h = 10, 10
12    self.base_speed = 100

100    -- Crowd-scaling: base + 1 per enemy caught, counted with the same box
101   -- query the area uses at damage time (so area.lua stays generic).
102   local hits = query_entities_box(ax, ay, CLEAVE_RADIUS*2, CLEAVE_RADIUS*2, self.r, {'enemy'})
103   local dmg = CLEAVE_DAMAGE + (hits and #hits or 0)
104   spawn_area(ax, ay, { shape = 'rect', radius = CLEAVE_RADIUS, rect_h = CLEAVE_RADIUS,
105                        damage = dmg, caster = self })
106   sfx(sounds.sword_slash_variants[3], volumes.sword_slash, random_float(0.9, 1.0))
107   sfx(sounds.sword_slash_variants[2], volumes.sword_slash, random_float(0.95, 1.05))
108   self.next_cleave_time = time + CLEAVE_CD
109 end
110 
111 -- Mobility - Lunge: a position dash copying v1 dash_strike — a target
112 -- DASH_DIST ahead in the MOVEMENT direction (last_move_r, not the aim),
113 -- eased toward with math.lerp_dt (not a raw lerp), applied via
114 -- collider:set_position so it teleport-lerps THROUGH enemies; a wall raycast
115 -- clamps it; enemies swept take DASH_DAMAGE (0 by default → pure mobility).
116 function player:start_dash()
117   self.dashing = true
118   self.dash_t  = 0
119   self.dash_r  = self.last_move_r          -- follow movement, not the mouse
120   self.dash_to_x = self.x + DASH_DIST*math.cos(self.dash_r)
121   self.dash_to_y = self.y + DASH_DIST*math.sin(self.dash_r)
122   self.dash_hit_set = {}
123   -- Spend a charge; when the last one goes, start the full-refill lockout.
124   self.dash_charges = self.dash_charges - 1
125   if self.dash_charges <= 0 then self.dash_recharge_at = time + DASH_CD end
126   sfx(sounds.subtle_whoosh, volumes.subtle_whoosh, random_float(0.9, 1.1))
127 end
128 
129 function player:update_dash(dt)
... [100 more lines]

229    stats_add(self, 'mp', self.mp_regen*dt)
230 
231   timer_update(self.timer, dt)
232   spring_update(self.spring, dt)
233 
234   self.x, self.y = self.collider:get_position()
235 
236   self:update_abilities()
237 
238   if self.dashing then
239     self:update_dash(dt)
240   else
241     self:update_walk()
242   end
243   -- Tick the dash wake every frame so its points expire (it fades after
244   -- the dash, not only during it).
245   trail_update(self.dash_trail, self.x, self.y, self.dashing, DASH_TRAIL_DURATION)
246 
247   local mx, my = main_camera.mouse.x, main_camera.mouse.y
248   local target_r = math.angle_to_point(self.x, self.y, mx, my)
249   self.r = math.lerp_angle_dt(0.99, 0.1, dt, self.r, target_r)
250 
251   -- Lock the collider's angle to self.r (mouse-aim only — visual_r and the
252   -- sx/sy scale juice stay draw-only). set_angular_velocity(0) cancels any
253   -- spin a contact may have imparted; without it, fixed_rotation=false
254   -- bodies can drift between physics steps even when set_angle is called
255   -- every frame.
256   self.collider:set_angle(self.r)
257   self.collider:set_angular_velocity(0)
258 end

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

player.lua OK

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

player.lua OK

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/snkrx/player.lua has been updated successfully. (file state is current in your context — no need to Read it back)

164  -- each swing. caster = p makes it inherit the player's blue breathe + the
165 -- carrier's cast juice (shake / recoil / flash / muzzle particles).
166 -- Placeholder numbers; tune freely.
167 CLEAVE_RADIUS = 32      -- half-side; the square's side is CLEAVE_RADIUS*2
168 CLEAVE_OFFSET = 32      -- how far ahead of the player the square lands
169 CLEAVE_DAMAGE = 3       -- base damage; Cleave adds +1 per enemy caught (crowd-scaling)
170 CLEAVE_CD     = 1       -- seconds between swings (hold LMB to repeat)
171 
172 -- Lunge (mobility) — a position dash (math.lerp_dt toward a target DASH_DIST
173 -- ahead in the MOVEMENT direction), copying v1 dash_strike: set_position
174 -- teleport-lerps THROUGH enemies, a wall raycast stops it. 2 charges (the
175 -- DASH_MAX_CHARGES local in player.lua), then a full refill DASH_CD after BOTH
176 -- are spent. Implemented in player.lua (player:start_dash / update_dash);
177 -- these globals are the F1-tunable knobs + the fixed constants it reads.
178 DASH_SPEED  = 700       -- approach speed (u/s); lerp time = DASH_DIST/DASH_SPEED
179 DASH_DIST   = 100       -- dash distance (px)
180 DASH_CD     = 8         -- full-refill lockout (s) after BOTH dash charges spent
181 DASH_DAMAGE = 0         -- flat damage per enemy passed (0 = pure mobility dash)
182 DASH_HIT_RADIUS     = 16   -- enemies within this of the player are struck
183 DASH_TRAIL_DURATION = 0.4  -- dash wake lifetime (s)
184 DASH_MAX_TIME       = 0.6  -- safety cap so the eased dash always ends
185 
186 -- Set each frame in update(): true while a click is interacting with the tuner
187 -- panel, so mouse abilities (Cleave) don't fire through it. The player reads
188 -- this in player:update_abilities (keeps the player out of UI internals).
189 game_input_blocked = false
190 
191 -- Enemy supply — a trickle from the right edge, walking toward the player.
192 SEEKER_CAP   = 12
193 SPAWN_CD     = 0.6
... [12 more lines]

211  tuner_panel_rect = nil   -- set each frame the panel draws; nil when closed.
212                          -- Used to suppress a cleave swing when a click
213                          -- lands on the panel.
214 tuner_knobs = {
215   { key = 'CLEAVE_DAMAGE', label = 'cleave dmg',   min = 1,    max = 40,   int = true },
216   { key = 'CLEAVE_CD',     label = 'cleave cd',    min = 0.05, max = 1.0              },
217   { key = 'CLEAVE_RADIUS', label = 'cleave size',  min = 6,    max = 48,   int = true },
218   { key = 'CLEAVE_OFFSET', label = 'cleave reach', min = 0,    max = 48,   int = true },
219   { key = 'DASH_SPEED',    label = 'dash speed',   min = 200,  max = 1500, int = true },
220   { key = 'DASH_DIST',     label = 'dash dist',    min = 40,   max = 220,  int = true },
221   { key = 'DASH_CD',       label = 'dash cd',      min = 0.5,  max = 12.0             },
222   { key = 'DASH_DAMAGE',   label = 'dash dmg',     min = 0,    max = 20,   int = true },
223   { key = 'SEEKER_CAP',    label = 'max enemies',  min = 1,    max = 40,   int = true },
224   { key = 'SPAWN_CD',      label = 'spawn rate',   min = 0.1,  max = 2.0              },
225 }
226 

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

The file E:/a327ex/062026/main.lua has been updated successfully. (file state is current in your context — no need to Read it back)

player.lua OK
main.lua OK

Launching skill: end-session

2026-06-06T02:32:12.944Z c9ce0c2a-2972-4b95-8fba-17f80e2bc2f4 [claude] <-- MOST RECENT
   C:\Users\adn\.claude\projects\E--a327ex\c9ce0c2a-2972-4b95-8fba-17f80e2bc2f4.jsonl

2026-06-06T02:22:24.410Z 2ad493d3-379d-41e8-82b3-746a33b76c7b [claude]
   C:\Users\adn\.claude\projects\E--a327ex\2ad493d3-379d-41e8-82b3-746a33b76c7b.jsonl

2026-06-05T14:15:33.400Z aeea58cd-7990-4e11-bd9d-a4d928263e71 [claude]
   C:\Users\adn\.claude\projects\E--a327ex\aeea58cd-7990-4e11-bd9d-a4d928263e71.jsonl

2026-06-05T13:20:26.434Z d28a11ef-b75f-4096-99ae-ccc3c67f513b [claude]
   C:\Users\adn\.claude\projects\E--a327ex\d28a11ef-b75f-4096-99ae-ccc3c67f513b.jsonl

2026-06-05T04:33:24.564Z 081fadb9-c1ff-4449-b7f2-a024fefea81f [claude]
   C:\Users\adn\.claude\projects\E--a327ex\081fadb9-c1ff-4449-b7f2-a024fefea81f.jsonl

=== END TS ===
2026-06-05 23:32:30