DFDF

브라우저에서 바로 하는 5대5 공격/수비 전술 FPS입니다. 공격팀은 스파이크를 설치하고, 수비팀은 막거나 해제합니다.

게임

• 요원: 28명(네온 포함), 능력 112개. 요원마다 Q/E/C/X 능력 4개가 있습니다. 최초 요원 목록은 js/engine/agents.js이며 js/legacy/의 여러 묶음이 보완합니다.
• 요원 정리 (43명 → 28명): 능력이 다른 요원과 겹치던 15명(뇌하·화산·철혈·현랑·무영·경연·송골·울림·해랑·묵향·영월·늪지·철벽·등불·회로)을 뺐고, 그들의 좋은 능력 17개를 남은 요원의 약하거나 겹치던 능력 자리로 옮겼습니다. 능력의 동작은 그대로이고 주인·칸·이름·설명만 바뀝니다. 화령 C 용암 갑옷, 강철 Q 지진 강타, 홍혈 E 피의 맹세, 칼날 X 칼날 만화경, 바람 C 칼바람 가르기, 추적 E 추적 화살, 환영 C 환영 건너기·X 환영의 장막, 별빛 C 별똥 이동, 단비 Q 물대포·X 벼락 사슬, 흑사 Q 모래 감옥·X 흑사병, 덩굴 C 흡혈 덩굴, 백호 E 정찰 화살·C 곡사 화살, 자철 X 자기장 돔 (js/legacy/107-twenty-eight-agents-…js, window.ROSTER_CUT).
• 스킬 모션: 네온을 뺀 능력 107개가 저마다 다른 시전 동작을 가집니다(전에는 던지기·놓기·휘두르기 등 7가지를 나눠 썼습니다). 1인칭에서는 손이 능력마다 짠 경로를 따라 움직입니다. 화염탄은 머리 뒤로 젖혔다 내리꽂고, 지진 강타는 두 손을 들어 바닥을 내려치고, 활은 한 손으로 활을 내밀고 다른 손으로 시위를 당겼다 놓고, 폭풍의 눈은 손을 두 바퀴 돌리고, 레드카드는 머리 위로 치켜듭니다. 두 손 동작(34개)에서는 다른 손도 함께 움직이고, 손에 든 도구는 날아가거나 돌거나 뒤집히거나 기울어집니다. 손 끝에 요원 색의 궤적이 남고, 놓는 순간 섬광·고리·바닥 충격파·불꽃·날아가는 빛·모으는 빛·소용돌이 가운데 그 능력에 맞는 것이 나옵니다. 팔뚝은 손목이 어떻게 꺾여도 화면 아래쪽 팔꿈치로 이어져 카메라를 가리지 않습니다. 다른 사람에게는 같은 경로로 시전자의 팔과 상체가 움직입니다. 동작 줄이기 설정에서는 떨림·흔들림이 빠지고 동작만 남습니다. 모양만 바뀌고 판정·시간·위력은 그대로입니다 (js/ability-motions.js, npm run test:ability-motions).
• 멀티플레이: PeerJS(WebRTC) P2P. 대기실의 빈 자리는 AI 봇으로 채울 수 있습니다.
• 성장: 계정, 레벨/XP, 골드, 랭크, 미션, 뽑기, 스킨.
• 챔피언스 마무리는 매판: 일반전에서 라운드를 끝내는 마지막 킬을 사람(나 포함 방의 모든 플레이어)이 총·헤드샷·칼로 하면, 어떤 스킨을 끼고 있어도(기본 스킨 포함) 챔피언스 마무리(용 연출, 8초)가 뜹니다. 공격팀은 공격 쪽, 수비팀은 수비 쪽 변형입니다. 능력으로 끝낸 킬은 전과 같이 마무리가 없습니다. 반대로 봇이 라운드를 끝내는 킬에는 어떤 스킨이든 마무리가 뜨지 않습니다(봇이 스킨을 끼게 되어 연출이 자주 나오지 않도록). 킬 이벤트의 finisherSkin·byBot로 구분합니다 (js/game-rules.js, js/game-events.js, npm run test:finisher-always).
• 봇도 스킨을 끼고 나옵니다: 봇은 모든 총에 무작위 스킨을 끼고 경기 내내 그대로 씁니다. 등급은 일반~전설까지이고 초월(챔피언스 팬텀)은 봇이 입지 않습니다. 운영자 페이지 '게임 설정 → 봇이 입는 최고 등급'(기본 4)으로 낮출 수는 있지만 초월까지 올릴 수는 없습니다 (js/legacy/58-gun-skins.js의 botSkins).
• 스파이크 설치는 직접: 공격 요원이 사이트에 들어가도 저절로 설치되지 않습니다. 사이트 안에서 4 또는 F를 누르고 있어야 설치가 진행되고(4초), 키를 떼면 멈추며, 움직이면 "멈추면 설치 진행"으로 잠시 멈췄다가 다시 서면 이어집니다. 사이트 밖에서는 눌러도 아무 일도 없고 화면에 "사이트 안에서 4 또는 F를 눌러 설치"라고 뜹니다. 폰은 오른쪽의 F 버튼을 누르고 있으면 되고, 사이트 안에서 스파이크를 들고 있으면 F 버튼이 밝아집니다. 봇은 전과 같이 스스로 설치합니다 (js/legacy/03-engine.js의 handleSpike, npm run test:manual-plant).
• 아이디(닉네임) 중복 금지: 아이디가 곧 게임 속 이름이고 대소문자를 가리지 않고 하나뿐입니다. 이미 있는 아이디로 가입하려 하면 "이미 있는 아이디입니다"라고 알려 줍니다(같은 칸에서 로그인도 하므로 주인은 그대로 로그인). 동시에 같은 이름으로 가입하면 한 명만 됩니다. 새 계정은 게스트·guest로 시작하거나 플레이어/player+숫자인 이름(자동으로 붙는 이름)을 쓸 수 없습니다. 게스트 이름(게스트NNNN)도 기기마다 하나라서 두 기기가 같은 이름을 갖지 않고, 겹치면 빈 번호로 옮깁니다 (api/v1.js의 RESERVED_ID, guestName).
• 관리자 페이지: admin.html (/admin).
• PWA: manifest.webmanifest, sw.js. Vercel에 배포됩니다.
• 무기: 총 18종과 별도 칼. 팬텀은 원본 모델·30발 자동사격, 점사소총은 3점사, 정찰 소총은 스코프·15발 단발입니다. 새 코멧 소총은 독립적인 불펍 모델과 30발·750 RPM 자동사격을 사용합니다. 챔피언스 공격/수비는 팬텀에 장착합니다.
• 초기 제작 총기 개편: 원본 팩을 보존하면서 6종의 형태와 탄창·산탄총 장전을 정리했습니다. 총기별 전후와 검증, 전체 점검·개선 우선순위를 참고하세요.
• 점검 기록: 2026-10-21 전체 검사 결과와 미검증 범위.
• 마크X발로: 일반 요원 선택·방의 맵 목록에서 선택합니다. 원본 schematic 지형과 Minecraft 기본 블록 텍스처를 불러오며 선택하기 전에는 지형 파일을 다운로드하지 않습니다.

그래픽과 사운드

효과음, 초상화, 일부 텍스처는 코드로 만듭니다. 맵 표면 재질과 하늘 조명은 파일을 씁니다.

• assets/mat/: 표면 재질 webp 54개 (색, 노멀, ORM). play.html이 assets/mat/<재질>_<종류>.webp로 불러옵니다.
• assets/env/: 하늘 조명 HDR 7개 (alpine, city, dawn, forest, park, studio, warehouse). assets/env/<이름>.hdr로 불러옵니다.
• 출처는 assets/CREDITS.md에 있습니다 (CC0).

스킨 연출과 포구 맵

• 킬 효과: 처치마다 두 음 "타-단"이 나고, 연속 처치(4.5초 안)할수록 음이 오음계로 올라가 에이스에서 끝납니다. 영웅 이상 스킨은 종·울림을 더하고 배너 색이 스킨을 따릅니다. 스킨 31종은 각자 킬배너가 있습니다 (js/legacy/61-kill-banners.js). 소리와 모양만 바뀌고 전투에는 영향이 없습니다.
• 총소리: 기본 총소리 밑에 총 크기에 따른 저음·몸통·꼬리를 깝니다 (js/legacy/63-heavier-gunshots.js).
• 해안 포구: 구역별 색·재질, 랜드마크(크레인, 등대, 시계탑, 터미널), 창문·소품·조명으로 꾸민 맵입니다. 충돌체와 이동 격자는 꾸미기 전과 같습니다 (js/legacy/76-*, 77-*).
• 랭크전: "같이 하기"의 랭크전 찾기로 열린 랭크 방에 들어가거나 새로 엽니다. 랭크 방에서는 관리자 설정, 치트, 계정별 치트 권한, 운영자 방 명령, 방장의 규칙 변경이 모두 꺼지고 모드·맵·라운드는 방을 열 때 정해진 대로 갑니다. 서버는 랭크 방에서 시작한 경기의 확인표에만 랭크 표시를 서명하고, 사람이 rank.minHumans명 이상일 때만 RR을 바꿉니다. 일반 경기는 XP와 골드만 줍니다 (js/legacy/81-ranked-*.js, api/v1.js의 match_start·progress·room_up).
• 시프트 아레나: 90 × 110 m, 3대3. 가운데 단상과 계단, 블록과 엄폐물, 양옆 탑, 사이트 단상이 있고 세 묶음의 높은 장벽이 22초마다 한 묶음씩 내려갔다가 올라옵니다. 바뀌기 3.5초 전에 해당 장벽이 주황색으로 깜빡이고 화면에 카운트가 뜹니다. 시계는 방장이 가지고 손님에게 알리며, 라운드가 시작되면 처음 모양으로 돌아갑니다 (js/legacy/82-shift-arena-*.js).
• 장전: 총마다 다르게 갈아 끼웁니다. 소총·SMG는 탄창을 빼서 새로 끼우고 노리쇠를 당기고, 권총은 손잡이 탄창을 바꾸고, 펌프·반자동 산탄총은 한 발씩 넣고, 저격총(볼트액션)은 노리쇠를 올려 당긴 뒤 탄창을 바꾸고 밀어 닫습니다. 리볼버·핸드캐논은 실린더를 빼서 탄피 6개를 털고 스피드로더로 넣고, 더블배럴·산탄 권총은 꺾어 열어 두 발을 버리고 넣은 뒤 탁 닫습니다. 기관총은 덮개를 열고 탄통을 바꾼 뒤 덮개를 닫고 장전 손잡이를 당기고, RPG는 로켓을 앞으로 밀어 넣은 다음 탄두 캡을 빼고 공이를 젖힙니다 (js/legacy/54-reload-animation.js).
• RPG: RPG-7 모양입니다. 강철 발사관, 나무 열차폐판 두 개, 뒤쪽 나팔형 분사구, 권총 손잡이와 앞손잡이, 가늠쇠·가늠자, 왼쪽 광학 조준경, 멜빵 고리, 앞에 튀어나온 PG-7V 탄두(원뿔 머리, 띠, 신관)가 있습니다 (js/legacy/52-projectiles.js).
• 칼 돌리기: 칼은 따로 돌고 손과 팔은 그대로입니다. 대부분은 손잡이 가운데가 축이고, 카람빗은 실제처럼 검지가 낀 링이 축입니다. 손가락은 손잡이를 감싸고 칼이 돌 때 펴집니다. 점검(Y)은 칼마다 다릅니다 — 기본 칼은 손가락으로 한 바퀴와 토스, 발리송은 손잡이를 부채처럼 돌리고 롤오버 뒤 공중 토스, 접이식은 두 번 접었다 튕겨 열고 손바닥 토스, 탄토는 칼날을 아래로 한 역수 전환과 찌르기, 쿠크리는 묵직한 풍차 돌리기와 내려치기입니다. 카람빗은 앞으로 두 바퀴, 뒤돌리기, 칼이 누워 도는 헬리콥터, 던져 두 번 돌려 링으로 받는 연속 기술이고 칼날 뒤로 빛 잔상이 남으며 받을 때 맑은 소리가 납니다. 가만히 들고 있으면 칼마다 짧은 묘기를 가끔 보여 줍니다 (js/legacy/83-knife-tricks-*.js).
• 일일 상점: 무기고의 상점 탭. 매일 자정(한국 시간)에 스킨 20개(일반 7·희귀 6·영웅 4·전설 3)가 바뀌고 모두에게 같은 목록이 뜹니다. 뽑기와 달리 원하는 스킨을 골라 골드로 바로 삽니다. 가격은 뽑기보다 비싸게 정했습니다: 일반 1,200 · 희귀 3,000 · 영웅 7,000 · 전설 15,000 골드, 칼 모양 스킨은 1.5배 (뽑기 1회 300). 구매 버튼은 두 번 눌러야 사지고(첫 번째는 확인), 골드가 모자라면 얼마가 부족한지 보여 줍니다. 목록은 서버가 날짜와 비밀키로 정하므로 내일 목록을 미리 알 수 없고, 살 때 서버가 오늘 목록을 다시 계산해 확인합니다 (shop, shop_buy). 스킨을 얻는 길은 뽑기와 상점 두 가지입니다. 운영자는 '게임 설정 → 일일 상점'에서 열기·닫기, 등급별 개수, 가격, 칼 배율을 정하고, 대시보드에서 오늘 목록을 보고 상점 새로 고침으로 바로 바꿉니다. 구매는 서버 로그(상점)와 대시보드(상점 구매 수·쓴 골드)에 남습니다.

봇 난이도와 레벨 표시

봇의 세기는 skill 숫자 하나로 정합니다 (js/bot-skill.js, 순수 함수라 tests/bot-skill.test.js가 직접 읽습니다). skill은 예전 보통 봇의 배수로, 1.00이 정확히 예전 보통입니다. 1.00 아래에서는 회전 속도·사거리·피해·헤드샷은 곱하고 조준 오차·탄 퍼짐은 나눕니다 (0.60이면 보통의 60%). 1.00 위에서는 보통에서 예전 빡셈까지 직선으로 올라 1.20이 빡셈과 같고, 그 위는 잘라내므로 에임봇은 없습니다.

• 경쟁(랭크)방: 사람 플레이어의 평균 티어 → 아이언 0.60 … 레디언트 1.20 (9단계 직선).
• 그 밖의 모드(일반·신속·TDM·DM 등): 사람 플레이어의 평균 계정 레벨 → Lv1 0.60 … Lv50 이상 1.00 (보통 이상은 없음). 계정이 없는 게스트는 평균에서 빠지고, 아무도 없으면 0.80입니다.
• room.diff의 easy는 0.60, hard는 1.20으로 고정되고 normal(기본값, 경쟁방 포함)이 위의 자동 값을 따릅니다.
• 방장이 라운드가 시작될 때 한 번 계산해 BOT_RT.skill에 두고, diffTune()(js/legacy/03-engine.js)과 탄 퍼짐(모듈 31)과 피해 배율이 그 숫자만 읽습니다.

점수판·로비 슬롯·킬 피드의 이름 옆에 Lv N 칩이 붙습니다 (js/legacy/109-*). 게스트의 레벨·티어는 hello 메시지로 방장에게 가고, 방장이 로비·참가자 목록·ctrl 이벤트로 나머지에게 전합니다. 게스트가 hello에 적은 레벨·티어는 주장일 뿐입니다. 방장이 서버(api/v1.js의 공개 액션 levels, ids 12개까지, 주소당 분당 120회)에 이름마다 실제 계정의 레벨·티어를 물어보고, 서버 값이 주장을 대신해 방의 봇 세기와 칩에 쓰입니다 (낮은 레벨을 적어 쉬운 봇을 받을 수 없습니다). 응답에는 레벨과 공개 티어(배치 중이면 숨김)만 있고 MMR·이메일·토큰·IP·기기는 없으며, 게스트·없는 이름·잘못된 이름은 모두 같은 빈 값입니다. 랭크 방은 ranked_start의 응답(lv)이 같은 서버 값을 한 번 더 줍니다. 서버에 닿지 못하면 주장은 예전처럼 봇 세기에만 쓰이고 칩은 보이지 않습니다 (서버가 준 숫자만 칩에 나옵니다). 이름만 보고 계정을 찾으므로, 남의 계정 이름을 대는 것까지는 막지 못합니다. 계정이 없는 게스트와 봇에는 칩이 없습니다. 검사는 npm test(표)와 npm run test:bot-skill(= test:verified-levels, 실제 게임 두 창: 주장 Lv 1 대 실제 Lv 30, 서버가 안 될 때)입니다.

테스트

npm test는 단위 테스트(tests/)입니다. 브라우저 검사(npm run test:browser, test:regression, test:startup, test:maps, test:online, test:ranked, test:shift, test:reload, test:knife, test:aim, test:admin, test:shop, test:modes2, test:wish, test:train, test:agents4, test:season, test:infection, test:conquest, test:range, test:cosmetics, test:newmaps, test:hospital, test:hospital-bots, test:landing, test:gunshots, test:details, test:ui-fixes, test:ctf, test:zone, test:feedback, test:orders, test:followup)는 Playwright가 필요하고 DFDF_PLAYWRIGHT_MODULE, DFDF_BASE_URL 등을 설정합니다. 소프트웨어 GL(헤드리스) 환경에서는 느려서 test:regression의 첫 클릭과 test:followup의 실제 클릭이 간헐적으로 시간 초과됩니다. 코드를 바꾸지 않은 브랜치에서도 같았습니다.

파일

파일	설명
play.html	게임 화면·스타일과 스크립트 실행 순서
js/legacy/	기존 엔진·요원·맵·계정·스킨 기능 103개, 순서는 manifest.json
js/engine/	초기 요원·무기·맵 데이터, 텍스처·초상화 생성
js/	공통 요청·오디오·처치 원인·홈·포커스·부팅 관리
index.html	소개 페이지
admin.html	관리자 페이지
api/v1.js	서버 함수 (?a=<action>), 데이터는 Upstash Redis REST
sw.js, manifest.webmanifest	PWA
vercel.json	배포 설정

Competitive (server)

RR and the hidden MMR are computed only in api/v1.js from a match the host attested; what a player reports about himself (humans, win) is never used for ranked RR. All calls are POST /api/v1?a=<action> with a JSON body.

1. ranked_start {token, room, a: [ids], b: [ids]} (host, ranked room) returns {id, t0, rm, a, b, ownerPlayed}. rm is a signed ticket for the host. Unknown, guest and banned accounts are dropped from the roster; the host must stay in it. MMR of everyone is snapshotted here.
2. match_start {token, ranked: true, room} (every player) returns {ticket, ranked}; the ticket (mt) carries the match id. 403 if the account is not in the roster, 409 until the host has called ranked_start. Asking again returns the same ticket.
3. ranked_result {token, rm, w: "a"|"b"|"draw", k: {id: kills}} (host, after at least 60 s) returns {accepted, duplicate, w}. The first result stands.
4. progress {token, mt, kills, win, outcome, match, giveUp?} (every player, unchanged for normal matches). In a ranked match win/outcome must equal the attested result for the player's team (else 409, counted as a dissent); humans is ignored. 425 means the host has not reported yet (retry); giveUp: true takes the plain XP/gold reward without RR. The answer adds rankedCounted, rankedWhy (few_humans, draw, disputed, no_result, duplicate), placement: {done, of: 5} and rr (the change; 0 while placing).

Rules: at least rank.minHumans roster accounts must have fetched a ticket; a draw, a match under 60 s and a disputed match move nothing; a match is disputed when a strict majority of the non-host players of a team dissent; an account settles a match once; rank.maxPerDay still caps daily RR gain. The operator's matches count like anyone's (ownerPlayed: true is kept on the match record); cheats are closed in ranked rooms for everyone but the operator (owner_ticket is issued to the owner only, perm_ticket never).

MMR (Elo, field mmr, placed): older accounts get 1000 + RR on first read (placed if they have RR or ranked history). The first 5 counted matches are placement (K = 120, tier hidden: user.rank.hidden === true, user.placement); after the fifth, RR = MMR - 1000. After that RR change = base win/loss x clamp(0.5 + (1 - expected) | 0.5 + expected, 0.5, 1.5) + the kill bonus, with expected from the two teams' average MMR (pure helpers in module.exports.rankMath). A season roll shrinks MMR toward 1000 by the same season.keep factor as RR.

leaderboard {n?} (public, default 50, max 100) returns {season: {n, end}, rows: [{pos, name, tier, t, div, rr, wins, played}]}: placed accounts that counted a ranked match this season (Redis sorted set lb:<season>), no MMR or private data.

Matchmaking: rooms and room_up give a ranked room band (its average MMR rounded to 50, null when unknown) and range (150 MMR, +50 per minute the room has been open, up to 600). ranked_can_join {token, code} returns {ranked, ok, range, band}; the operator and rooms without a measured average are always open.

Competitive (client)

The client side of the flow above (js/legacy/109-ranked-flow-*.js, with 44-account-sync.js, 71-…rank…, 81-ranked-play-… and js/leaderboard.js). Ranked rooms are for signed-in accounts only; a guest is refused before joining (and sent out if it got in by a link).

• Flow. When the host starts a ranked match it sends the roster (accounts per team) with ranked_start and tells the room (rk-go); everyone else waits for that, then calls match_start {ranked: true, room} (retrying on 409; on 403 or any failure the match gets a plain ticket: XP and gold, no RR). When the match is over the host sends ranked_result (winning side, kills per account), then every player's progress report settles it. The report queue keeps a ranked report on 425 (the host's result is not in yet) and asks again every few seconds; after two minutes it asks with giveUp: true (plain reward); a 409 drops it. humans is no longer sent.
• Placement. While user.placement.done < 5 the title chip, the result screen and the "Play together" card show "배치 n/5" with a "?" gem instead of a tier; the fifth counted match reveals the tier (result screen cell and banner). A counted match afterwards shows +/-RR; a match that did not count says why (few_humans, draw, disputed, no_result).
• Matchmaking. The room list shows a ranked room's band as the tier it sits in. Joining a ranked room (list, code, link, "Find a ranked match") first asks ranked_can_join; out of range gives a Korean message (the room list note and a banner). Note the server answers an out-of-range room with HTTP 200 {ok: false, ranked, range, band}, so the client reads that answer raw instead of through the shared api() (which treats ok: false as an error).
• Leaderboard. "순위표" in the home menu (also play.html#ranks, linked from the homepage): the season, the top 50 with tier, RR and wins, my row marked.
• Cheats. In a ranked room the admin switches, account cheat rights, owner commands and room rules are closed for everyone. The exception is the operator: a client claiming to be the owner stays locked until the server hands it an owner_ticket for that room (a normal account gets none, so editing window.IS_OWNER opens nothing). A confirmed operator keeps his own cheats (the host listens to his personal switches and to his commands about himself); room-wide switches (speed, gravity, round time, bots, …), cheats for others and kick/move/message/close stay shut for him too. His match counts for RR like anyone's (the server marks ownerPlayed).
• Checks. npm test (tests/ranked-client.test.js), npm run test:ranked (the room and its lock), (three browsers: roster, tickets, result, settle, placement, reveal, leaderboard screen, band and range message, cheat lock for a normal account and for the operator), .

환경변수 (Vercel)

이름	용도
KV_REST_API_URL / UPSTASH_REDIS_REST_URL	Redis 주소
KV_REST_API_TOKEN / UPSTASH_REDIS_REST_TOKEN	Redis 토큰
ADMIN_MASTER_PASS	관리자 비밀번호
SESSION_SECRET	세션·매치 티켓 서명 키
OWNER_ID	마스터 비밀번호로 로그인하는 소유자 계정 아이디
CF_TURN_KEY_ID, CF_TURN_API_TOKEN	Cloudflare TURN 임시 접속 정보 발급
TURN_URLS, TURN_USERNAME, TURN_CREDENTIAL	대체 TURN 서버 접속 설정

SESSION_SECRET이 없으면 관리자 비밀번호와 Redis 토큰에서 만든 값을 대신 씁니다. 그러면 비밀번호를 바꿀 때 기존 티켓이 모두 무효가 되므로, Vercel에 따로 설정해 두세요.

개발과 검증

Node.js 20 이상에서 npm run dev로 정적 페이지와 /api/v1을 실행합니다. 실제 계정 기능에는 위 Redis 환경변수가 필요합니다. 환경변수가 없으면 저장 요청이 실패하며 운영 데이터를 흉내 내지 않습니다.

설정 → 그래픽은 휴대폰·성능·비주얼·최고 네 모드입니다. 새 휴대폰 사용자는 휴대폰, PC 사용자는 성능 모드로 시작합니다. 휴대폰·성능은 그림자·후처리·MSAA·탄피를 끄고 화면 해상도와 장식 이펙트를 줄입니다. 비주얼·최고는 상세 총기·그림자·조명·후처리를 켭니다. 동적 해상도는 선택한 모드 안에서만 조절하며 다른 모드로 자동 변경하지 않습니다. 이전 최소/low/fast는 휴대폰, 균형은 성능, 자동은 기기 기본값으로 이전합니다. 제공된 원본 무기·스킨·마크X발로 지형 파일은 보존합니다.

• npm run check: 서버, 기능 모듈 및 HTML의 인라인 스크립트 문법 검사.
• npm test: 임시 메모리 저장소로 인증 경계, 동시 저장, 보상 재시도, 입력·능력·피니셔 조건 검사. 운영 Redis의 통합 검증은 별도로 필요합니다.
• npm run test:browser: 실행 중인 개발 서버에서 작은 가로 화면의 홈·요원 선택·무기고·처치·결과·로그아웃을 검사합니다. Playwright와 Chromium이 필요합니다. 선택적으로 DFDF_BASE_URL, CHROME_BIN, DFDF_PLAYWRIGHT_MODULE, DFDF_THREE_PATH를 설정할 수 있습니다.
• npm run test:maps: 문·순간이동 장치·집라인의 맵 재로딩 후 자원 해제, 중복 해제 방지, 공유 자산 유지, 문 조작 및 반복 렌더링 검사.
• npm run test:performance: 일반 맵 선택으로 마크X발로를 실행해 미니맵 지형 캐시 재사용, 원래 지형 그림과 픽셀 일치, 실시간 스파이크 표시를 검사합니다. 120회 게임 처리 시간과 그리기 횟수를 test-results/performance.json에 기록합니다. 헤드리스 CPU 처리 시간이며 실제 기기 FPS는 아닙니다. 수정 전 엔진·폐병원 스크립트 파일을 DFDF_PERF_BASELINE_ENGINE, DFDF_PERF_BASELINE_HOSPITAL로 지정하면 같은 실행에서 전후를 비교합니다.
• npm run test:graphics: 홈 → 설정 → 그래픽의 네 모드, 실제 렌더링 예산·전환·기본값 복원·저장/새로고침, 휴대폰 회전 안내·가로 배치와 마크X발로 전환 중 지형·플레이어 상태 보존 검사. 휴대폰은 브라우저 에뮬레이션이며 실기기 FPS 검사가 아닙니다.
• npm run test:home-layout: 상단 메뉴와 원래 플레이 버튼·로고·요원·계정 칩 스타일 유지, 5개 화면 크기의 경계·겹침·실제 메뉴 클릭 검사. 수정 화면.
• npm run test:startup: 엔진 로딩 전 무기고 버튼 표시, 스킨 바로가기, 지연된 보유품 조회·뽑기 및 화면에 보이는 최종 요원 사진 검사.
• npm run test:followup: 방 목록 갱신·정렬·실패 표시, 요원 전용 그래픽 자원 해제, Chromium CDP 멀티터치·취소, 배치 편집·복원, 계정 전환·다른 탭 로그아웃과 한국어/영어 화면 검사. API는 테스트 저장소로 대체하며 서비스 워커를 막아 요청을 정확히 대체합니다. 모바일 실기기나 운영 데이터 검증을 뜻하지 않습니다.
• js/game-rules.js: 입력·능력·승패·피니셔의 공통 규칙.
• js/game-events.js: 온라인 처치 정보, 피니셔, 재접속 보호, 결과 완료 사건.
• js/home.js, js/home-details.js, css/home.css: 홈 동선, 최근 설정·즐겨찾기·모드 안내·장착 스킨과 미리보기.
• js/home-navigation.js, css/home-navigation.css: 상단 메뉴·계정 배치와 원래 홈의 위치·크기 조정.
• js/damage-cause.js: 지연 피해의 발사 당시 무기·스킨.
• js/modal-focus.js: 주요 모달의 키보드 포커스.
• js/portrait-loader.js: 부팅 후 화면에 보이는 요원 사진을 작업별로 생성하고, 교체된 카드의 대기 작업 정리.
• js/game-boot.js: 모든 스크립트 로딩 뒤 프레임·초대 연결 시작.
• npm run test:regression: 추가 홈 기능·실제 RPG 폭발·부활·수류탄·반복 경기 검사.
• npm run test:network-recovery: 실제 게임을 두 브라우저에서 실행하고 통제된 전송으로 채널 단절·재접속·진행 중 참가를 검사합니다. WebRTC/ICE/TURN 성공 검사는 아닙니다. 멀티 검사 기록.

전체 작업 계획과 남은 항목은 개발 메모 #17에 기록합니다.

실제 Redis의 Lua 저장 경로는 임시 Redis 인스턴스를 실행한 뒤 DFDF_REDIS_CLI와 DFDF_REDIS_SOCKET을 지정해 npm test로 검사할 수 있습니다. 지정하지 않으면 해당 통합 테스트 하나를 건너뜁니다. 테스트 API 요청은 운영 서버로 전송하지 않습니다. test:online은 브라우저가 WebRTC 연결을 허용하는 환경이 필요합니다. 관리 정책으로 직접 UDP가 차단되고 TURN도 없는 환경에서는 연결 실패를 보고하며, 성공한 검증으로 간주하지 않습니다.

소유자와 관리자 인증 형식을 갱신했으므로 적용 후 해당 계정은 다시 로그인해야 합니다. 일반 계정은 비밀번호 초기화 또는 새 세션 발급에 따라 이전 세션이 무효가 될 수 있습니다. 보상은 유효한 경기 확인표가 있어야 지급되며, P2P 호스트의 경기 자체를 서버가 검증하는 구조는 아닙니다.

RR은 서버에서 발급한 랭크 경기 확인표와 최소 실제 참가자 조건을 만족한 경기에만 반영됩니다. AI전·일반 비공개 방은 랭크 경기로 계산하지 않으며 사격 연습과 맵 탐방은 경기 보상을 지급하지 않습니다.

세션 버전이 없는 이전 로그인은 다시 로그인해야 합니다. 경기 보상 확인표도 해당 계정의 세션 버전에 묶으므로, 비밀번호 초기화 또는 삭제·재가입 이전의 확인표는 사용할 수 없습니다. 업데이트 전에 발급한 이전 형식의 확인표는 새 경기 시작 후 새 확인표로 대체됩니다.

챔피언스 팬텀 스킨

전설보다 높은 초월 등급의 팬텀 공격·수비 스킨을 지원합니다. 경기 완료마다 초월 코인 1개를 받고 스킨 한 종류를 700개로 구매하거나, 뽑기 0.00000000000000001% 확률로 획득합니다. 총 스킨 창 위쪽 챔피언스 탭에서 제공된 원본 모델·텍스처를 자동으로 불러와 구매·미리보기를 하고, 뽑기는 기존 뽑기 탭에서 함께 진행합니다. 별도 등급표와 전용 킬 배너·원본 용/뱀 마무리·원본 1~5킬 연주, 로컬 JAR 교체도 지원합니다. 마무리는 플레이어 키의 최소 5배 크기이며 일반전 마지막 처치 후 8초 뒤 다음 라운드(마지막 라운드는 결과 화면)로 전환합니다. 사용 방법과 원본 자산 처리, 테스트는 연결 안내를 참고하세요.

네온 요원

타격대 네온은 이 게임이 직접 만든 요원입니다. 외형·초상화·1인칭 팔과 스킬 동작·아이콘·전기 효과·미끄러지기 자세를 모두 이 저장소의 코드로 그리고, 바깥에서 가져온 모델·텍스처·애니메이션·효과 코드는 쓰지 않습니다(능력의 동작과 수치만 참고했습니다). Q 되튐 전격(한 번 튕기는 전기탄, 닿는 곳마다 0.8초 뒤 뇌진탕), E 질주 회로(10초 +40%, 좌클릭으로 6m 미끄러지기), C 전류 통로(25m 전류 벽 두 개, 4초 시야 차단), X 과충전(20초 40m 빔). 자세한 내용은 docs/NEON_AGENT.md, 검사는 npm run test:neon, test:neon-look, test:neon-online.

마크X발로 원본 지형 시험

/play.html?ascent-trial=1 → 이 맵으로 연습 시작에서 제공된 schematic 지형을 우리 이동·사격 엔진으로 시험합니다. Minecraft 1.20.1 기본 블록 텍스처 239개를 사용하며 일반 진입은 추가 맵 데이터를 내려받지 않습니다. 변환 방식과 솔로 검증 범위는 시험 맵 안내를 참고하세요.

제공된 Valorant 팩의 총 9종과 나이프 스킨 6종을 연결했습니다. 정찰 소총과 팬텀은 표시 이름을 맞바꾸었고, 챔피언스는 팬텀(scout)에 장착합니다. 총기 18종과 별도 나이프를 제공하며 기관권총·위스퍼 기관단총·점사소총·산탄총·정찰 소총을 복원했습니다. 기존 보유 스킨은 보존하고 통합 당시 보관한 원본 보유 목록에서도 한 번 복원합니다. 구매창은 카테고리별 총 실루엣 카드와 선택한 장착 스킨의 실제 모델 미리보기를 제공합니다. 원본 파일 보존과 적용 범위는 무기 팩 안내를 참고하세요.

개선과 반복 검사

2026-10-21의 구현 내용·24개 개선 항목·실행한 검사와 남은 환경은 개선 적용 기록에 정리했습니다.

홈의 성능 진단에서 최근 1,800 프레임의 중앙값·p95, 긴 프레임 수, 자원 수와 연결 단계를 기기에만 기록하고 JSON으로 저장할 수 있습니다. 자동 조절은 탄피와 그림자 갱신 빈도를 먼저 줄이고, 부담이 계속되면 후처리를 끕니다. 휴대폰 모드의 선명도와 능력 판정은 유지합니다. 연습 → 빠른 훈련에 표적장과 능력·스파이크 연습이 있고, 마크X발로는 홈에서 직접 선택할 수 있습니다.

일반~전설 수집을 끝낸 계정도 기존 확률로 초월 뽑기를 시도하며, 받을 일반 스킨이 없는 미당첨 회차는 골드를 반환합니다. 700코인 구매와 경기 완료당 1코인은 그대로입니다.

재현: npm ci 후 npx playwright install chromium, npm run check, npm run check:assets, npm test, npm run test:suite(핵심) 또는 npm run test:full(전체). Node 20 이상. API 계정·구매는 격리된 fixture이며 실제 결제를 하지 않습니다. GitHub CI는 PR 핵심 검사, 야간 전체 검사와 임시 Redis Lua 통합 검사를 실행합니다.

ICE 로그 (멀티플레이 연결 진단)

게임이 여는 모든 WebRTC 연결(방장과 게스트)은 js/legacy/110-…js가 기록합니다. 만들어짐, 찾은 후보 종류별 개수(host / srflx / relay), ICE 상태 변화, 연결되거나 끊길 때 실제 쓰인 경로(로컬·원격 후보 종류, 왕복 시간), 앱이 직접 닫았는지(closed-by-app)를 남깁니다. 기록은 브라우저 안에만 있고 어디로도 보내지 않으며 최근 300줄입니다. 콘솔에서 [ice]로 보거나 iceLogText()로 전체를 복사할 수 있습니다. 테스트는 npm run test:ice-log입니다.

연결 기록 신고: 연결이 끊기면(ICE failed/disconnected, 또는 방장을 잃음) 마지막 40줄을 요약해 sessionStorage(lgp_ice_report)에 둡니다. 새로고침해도 남고 30분 뒤 무시됩니다. 요약에는 시각·연결 번호·역할·이벤트·후보 종류(host/srflx/relay)·프로토콜·왕복 시간·후보 개수만 있고, 후보 주소와 서버 주소는 없습니다(서버 목록은 개수만). 방장을 잃은 게스트에게는 연결이 끊겼습니다 · 연결 문제 신고 카드(js/legacy/111-…js, 방장이 일부러 나간 경우는 제외, 새로고침 뒤에도 한 번 다시 보임)가 뜨고, 누르면 버그 신고 양식이 어디서: 연결 끊김으로 열립니다. 양식(js/feedback.js)은 저장된 기록이 있으면 연결 기록 첨부됨 (N줄)을 보여 주고, 첨부하지 않기로 뺄 수 있습니다. 서버(cleanIce)는 버그 신고의 ctx.ice만 받아 정해진 모양(이벤트 이름·후보 종류·프로토콜·숫자)에 맞는 최대 40줄만 저장하고 나머지는 버립니다. 운영자 페이지 문의 카드는 이를 표(시각·pc·역할·이벤트·경로)로 보여 주고, 연결 기록 있는 것만 체크로 거릅니다. 테스트는 npm test(tests/feedback-ice.test.js)와 npm run test:ice-report(끊김은 실제 RTCPeerConnection에 failed 상태를 알려 흉내 냄)입니다.