Blocklot L33tAgents

Client side of the placement feedback fix. mp.js maps server edit rejections to specific messages in the multiplayer system chat instead of the generic Connection lost text: out_of_range shows 'Too far, move closer', not_adjacent shows 'Build next to an existing block', plus specific texts for invalid_block, occupied and nothing_to_break, with a generic fallback for badEdit without reason. survival-client.js shows the same reasons as a HUD toast in survival and super rooms. Six new i18n keys added in English and Spanish. Reason codes are produced by the companion blocklot-mp server patch.

Server side of the placement feedback fix. The place/break handler keeps the exact same validation rules, but every rejection now carries a machine-readable reason plus a clearer human message: out_of_range (y out of range, too far), not_adjacent (floating placement), invalid_block (block not allowed), occupied (not air), nothing_to_break, bad_input (non-integer coords). The per-connection err helper gained an optional third reason argument and always sends a non-empty code. Only the error payload changed, no validation logic.

Fix for the Server error undefined x8 finding. The QA adapter records kind m.code || m.kind, so an err reply with a missing or empty code is logged as undefined (sample msg was 'not air'). errSend now falls back to a non-empty 'serverError' code so no server-initiated error can ever be recorded as undefined. Combined with the structured place/break reason patch, every rejection path emits a structured payload with code and message.

root cause: bots en wave morian por heartbeat estricto: el server terminaba la ws con UN solo pong perdido en la ventana de 20s, sin log ni contexto. Logs de .12 muestran dcs de bots sw-* alineados a la rejilla de 20s del heartbeat (08:04:15.617 y 08:04:35.615-618 el 09-22, 6 dcs simultaneos el 09-21), sin leave ni kick: un stall breve del cliente (GC pausa, scheduler) basta para que se pierda 1 pong y el server corte la sesion. cambios en server.js: 1) heartbeat tolerante: termina solo tras 2 pongs consecutivos perdidos (~40-60s de silencio) en vez de 1; 2) log warn hb_drop con room/id/name para observabilidad de futuras caidas; 3) ws.blk con contexto de sesion en joinRoom; 4) keepalive a nivel aplicacion cada 10s (t:ka) para que todo cliente reciba trafico aunque este idle o solo en sandbox. verificacion: node --check OK, smoke test local 23s con cliente ws real: 2 ka recibidos, cierre limpio 1000, sin hb_drop falso. no toca logica de edits ni placement, acceptance badEdit sin cambio. Merge automatico post QA (aprobar todo y desarrollar, 2026-09-23)

How-to-play upgraded to a single reference screen: Controls (WASD / mouse / touch / Esc-pause / R-respawn) + Goal sections, 11 lines total. New i18n keys EN/ES in js/i18n.js (howtoControls, howtoGoal, howtoTouch, howtoPause, howtoTeams, howtoMp); menu markup reorganized in index.html (.howto-sec headers + ul wrappers, CSS added). Additive: reuses existing howto1-5/h6/arenaHow keys, no removals. QA: node --check js/*.js OK (node v20.20.2); headless Chrome SwiftShader smoke 10/10 PASS (menu, WebGL boot, howto EN/ES, 11 non-empty lines, circuit start) 0 JS errors. Base 9e2afca (main). Branch agent/d318a9df.

Milestone unlockables (client-only): 5 avatar trails earned by playing — Ember (3 Arena matches), Frost (level 3), Gilded (3 gold medals), Void (wave 8), Rainbow (all 10 circuits). New js/unlocks.js (ES module, own rAF, wraps game.onEvent additively after mp.js wrap; no ui.js/main.js edits). Persistence in blocklot.progress.v1 with automatic migration: progress.js save() now merges over the raw stored object so sibling fields (stats/unlocks) survive wallet writes, and Unlocks backfills defaults on load — existing coins/XP wallets keep balances. Menu: new ghost-btn 'Unlocks' + panel with progress per milestone, tap-to-equip, first unlock auto-equips, i18n EN/ES. Coin-shop-safe: zero overlap with in_review shop items/prices (additive ids only). QA: node --check js/*.js OK; headless Chrome SwiftShader 23/23 PASS (5 cards locked fresh, 3 arenaOver events unlock Ember + toast + auto-equip, wallet write preserves stats/unlocks, equip toggle, reload persistence, ember particles in scene, quit/panel flows, ES texts) 0 JS errors. Base 9e2afca (main). Branch agent/61ee3902.

Lightweight client-only social hook: weekly local records panel + share. New js/social.js aggregates circuit runs (blocklot.records.v1) of the current week (Mon 00:00 local): runs count, circuits played, best-of-the-week, per-circuit rows; Share button uses navigator.share when available, clipboard fallback with toast, then execCommand fallback. No server, no blocklot-mp changes, no new assets. Menu: ghost-btn 'My week' + panel, i18n EN/ES, self-managed open/close via MutationObserver (zero ui.js edits). QA: node --check js/*.js OK; headless Chrome SwiftShader 18/18 PASS (empty state, week filtering excludes last-week runs, best/runs counts, share text EN/ES with circuit name+time+site URL, ES row names, circuit start, panel flows) 0 JS errors. Base 9e2afca (main). Branch agent/aca65854.

Daily Login calendar: ciclo de 7 dias (20-150 monedas + XP) con racha que crece cada dia consecutivo y se resetea si falta un dia. Badge pulsante en el menu cuando hay recompensa pendiente. Nuevo js/daily.js + boton + modal + i18n EN/ES en las 3 builds. Solo local (localStorage blocklot.daily.v1) sobre el monedero Progress compartido. merged by blk-0929 coder agent after green QA

Guided Tutorial interactivo en isla dedicada: 5 pasos (mover, saltar, picar, colocar, llegar a la placa dorada) con HUD de progreso y boton saltar. Primera vez paga 50 monedas + 30 XP; repeticiones 10 monedas. Nuevo js/tutorial.js, game.loadTutorial() (mundo propio, sin tocar sandbox guardado), UI.enterTutorial(), hook de frame en main.js, markup en las 3 builds. merged by blk-0929 coder agent after green QA

Build Challenges semanales: 3 misiones rotativas por semana (construir 150 bloques en sandbox, completar circuitos, circuito <40s, oleada 5 en Arena, 8 eliminaciones en 3v3, nivel 3, sesion co-op) con recompensa de monedas + XP. Progreso por eventos del juego (cadena game.onEvent, patron ya usado por mp.js). Nuevo js/challenges.js + UI + i18n. merged by blk-0929 coder agent after green QA

Blueprint Shop: 4 skins raras de bloques (recolor de paleta voxel con restauracion automatica al salir del sandbox) y 4 kits pre-hechos (castillo, piramide, arco, torre) que se estampan en el Sandbox individual apuntando al suelo. Compra con monedas via nuevo Progress.spend(). Nuevo js/shop.js + boton de kits en sandbox + i18n. merged by blk-0929 coder agent after green QA

Co-op Building sobre las salas MP existentes: lista de amigos con codigo de sala guardado + boton unirse, contador en vivo de bloques del equipo con hitos que pagan monedas (100/250/500/1000), stats por jugador y sesiones acumuladas. mp.js: 4 hooks con guard (welcome/join/place/leave). Sin cambios de protocolo ni de servidor. merged by blk-0929 coder agent after green QA

Soft currency completo: (1) Tienda en menu con 6 skins de avatar (classic gratis, lava/frost 250, neon/forest 400, gold 600) y 2 helpers consumibles de Arena (corazon extra 120, duplicador x2 200). (2) Pill de monedas en HUD de circuito/arena/teams. (3) Recompensas: circuito por medalla (40/20/10/4), teams 30/15/8 +3xkill, MP tower/lucky 25 win /10 participacion. Persistencia localStorage (blocklot.progress.v1) con migracion de wallets previas. i18n EN/ES. QA headless Chrome: 11/11 PASS, 0 errores JS; skin aplicada al avatar heroe (no bots). Rama agent/74fc21f5 pusheada al mirror. [blk-coins-0926] QA re-run: test_cmd original (node --check main.js) era incorrecto para este repo (main.js vive en js/, no en raiz) y no podia pasar nunca; corregido a bucle node --check sobre js/*.js (verificado OK en node v20.20.2, auto-detecta ESM). Primer run quedo en in_review qa_ok=false solo por eso. Config devenv de blocklot-io actualizada via SQL. merge approved by owner order 2026-10-06 (Alfredo via DataZero)