# 타자 대결 (`typing`) > 사이트에서 직접 만든 게임(2026-11-12 사용자 요청). 한컴 타자연습의 타수·정확도 개념에 여러 명 대결 방식을 더했다. ## 1. 개요 - 1~8명(서바이벌은 2명부터), 컴퓨터 상대 가능. 한 판 3~10분. - 모두에게 같은 글이 나오고, 입력 칸에 그대로 친 뒤 Enter. 맞은 글자는 초록, 틀린 글자는 빨강, 조합 중인 글자는 파랑 밑줄. ## 2. 모드와 옵션 | 옵션 | 값 (기본값 굵게) | |---|---| | 언어 | **한국어**, 영어 | | 대결 방식 | **가장 먼저 입력**, 서바이벌, 타수 비교, 정확도 대결, 타임어택, 연습 | | 대결 종목 | 단어, **짧은글**, 긴글 | | 주제 | 여러 개 고르기, 비우면 **전체**(언어·종목에 맞는 주제만 쓰임) | | 라운드 | 1~10 (**3**) | | 서바이벌 탈락 조건 | **틀렸을 때**, 문장별, 시간별, 시간 초과 | | 목숨(틀렸을 때) | 1~5 (**3**) | | 탈락 간격(시간별) | 10·**15**·20·30초 | | 제한 시간 | **자동(글 길이)**, 10초~5분, 무제한 — 가장 먼저 입력·서바이벌은 한 문제, 타수 비교·정확도 대결은 한 라운드 | | 타임어택 시간 | 30초·**1분**·1분 30초·2분 | ## 3. 구성물 (글 묶음, `packages/games/src/typing/texts.ts`) - 한국어 단어: 과일, 동물, 채소, 나라, 음식, 직업, 스포츠, 사자성어 - 한국어 짧은글: 속담, 명언, 잰말놀이, 일상 문장 - 한국어 긴글: 애국가, 별 헤는 밤·서시(윤동주), 진달래꽃·산유화(김소월), 님의 침묵(한용운), 훈민정음 서문(현대어 풀이), 흥부와 놀부·해님 달님·토끼와 거북(사이트에서 다시 씀) - 영어 단어: Fruits, Animals, Colors, Countries, Food, Jobs, Sports - 영어 짧은글: Proverbs, Famous quotes, Tongue twisters, Pangrams - 영어 긴글: Gettysburg Address, The Road Not Taken, Sonnet 18, Daffodils, Twinkle Twinkle Little Star, US Constitution Preamble, The Tortoise and the Hare - 시는 위키문헌 원문과 대조해 현대 맞춤법으로 적었다. 일반 자판으로 칠 수 있는 글자만(한자·둥근 따옴표·줄표 없음, 테스트로 확인). ## 4. 준비 - 단어·짧은글: 고른 주제의 항목을 모두 섞은 덱 하나(시드 RNG). 라운드마다 덱에서 차례로 뽑는다(가장 먼저 입력: 단어 10개·짧은글 5문장, 타수 비교·정확도 대결: 단어 15개·짧은글 3문장). 덱을 다 쓰면 다시 섞는다. - 긴글: 주제 순서를 섞고 라운드마다 다음 주제의 다음 단락(8줄 안팎, 남는 2줄 이하는 앞 단락에 붙임)을 친다. 긴 줄은 띄어쓰기에서 나눈다(한국어 34자, 영어 52자). - 서바이벌·타임어택은 글이 끝없이 돈다. - 연습(2026-11-12 사용자 요청, 한컴 타자연습의 짧은글·긴글 연습처럼): 라운드 1번, 제한 시간·점수 없음(라운드·제한 시간 옵션은 안 씀). 단어 20개·짧은글 10문장, 긴글은 고른 주제 중 한 편을 처음부터 끝까지. - 라운드마다 3초 카운트다운. 그동안 첫 글은 숨긴다. ## 5. 진행 규칙 - **함께 치기**(가장 먼저 입력, 서바이벌 중 시간별 아닌 것): 모두 같은 문제를 동시에 친다. 문제가 정해지면 1.5초 쉬고 다음 문제가 열린다. - 가장 먼저 입력: 먼저 정확하게 친 사람 1점. 틀리면 고쳐서 다시. 시간이 끝나면 아무도 점수 없음. - 서바이벌 틀렸을 때: 틀린 Enter·시간 초과마다 목숨 −1, 0이면 탈락. 살아 있는 사람이 모두 치면 다음 문제. - 서바이벌 문장별: 남은 사람 중 마지막 한 사람이 남으면 그 사람 탈락. 시간 안에 못 친 사람도 탈락. - 서바이벌 시간 초과: 시간 안에 못 친 사람 모두 탈락. - **각자 치기**(타수 비교, 정확도 대결, 타임어택, 서바이벌 시간별, 연습): 각자 한 줄 치고 Enter → 다음 줄. 틀린 채로 넘어가도 되고 그만큼 정확도·타수가 깎인다. - 서바이벌 시간별: 정해진 간격마다 그때까지 친 타 수(지금 줄 포함)가 가장 적은 사람(같으면 함께) 탈락. - 연습: 줄마다 첫 타(첫 진행)부터 시간을 잰다(줄 사이에 쉬어도 타수가 안 떨어짐). 첫 타의 시간 몫으로 0.15초 앞당겨 시작하고, 그래서 붙여 넣기 막기도 다른 방식과 같다. 줄마다 타수의 최고값(`best`)을 둔다. 모두 다 치면 끝(여럿이면 각자 속도로). - 서바이벌은 문제마다 제한 시간이 0.9배씩 줄고(무제한은 자동으로 친다), 아주 빠른 사람(900타)이 치는 시간 + 1초 아래로는 줄지 않는다. 그래서 라운드가 반드시 끝난다. - 남은 사람이 모두 한꺼번에 탈락하게 되면 아무도 탈락하지 않는다(목숨은 1개로). - 붙여 넣기 막기: 화면에서 붙여 넣기·끌어 놓기를 막고, 서버는 2,400타/분 + 0.15초보다 빠른 Enter를 거절하며 진행 막대도 그 속도 이상 앞서지 않는다. ## 6. 승패와 점수 계산 - 타수 = 1분에 친 자판 수(두벌식: 겹모음·겹받침 2타, 쌍자음 1타, 영어는 글자 수). 각자 치기는 줄의 타 수 × 정확도, 함께 치기는 맞게 친 문제(못 친 문제는 맞게 친 데까지). - 정확도 = 1 − 편집 거리 / 긴 쪽 글자 수. - 라운드 점수: 가장 먼저 입력은 문제마다 1점, 나머지는 라운드 1등(같으면 모두) 1점 — 타수 비교는 타수, 정확도 대결은 정확도(같으면 타수), 타임어택은 친 타 수, 서바이벌은 끝까지 남은 사람. - 최종: 점수 → 평균 타수 → 평균 정확도 순. 나간 사람은 맨 뒤. - 연습: 점수 없음, 순위는 평균 타수 → 정확도. `scoreText` = "평균 N타 · 정확도 N%". ## 7. 하우스 룰 - 없음(위 옵션으로 조절). ## 8. 엔진 설계 ### 8.1 상태 `phase`(countdown·playing·roundEnd·ended), `round`, `items`·`itemTopic`·`cycle`, 함께 치기의 `cur`·`curAt`·`curOpen`·`curEndsAt`·`last`, 시간별 `nextCutAt`, 각자의 라운드 기록 `rs`(idx·prog·done·keys·ms·정확도 합·wrong·lives·alive·place), 누적 `totals`, 라운드 결과 `rounds`, 덱 `deck`·`deckAt`, 긴글 `longOrder`·`longAt`. ### 8.2 액션 `progress { item, text }`(stream: 서버는 이벤트만 전달, 보기를 다시 보내지 않음), `submit { item, text }`, 시스템 `tick`·`leave`. 초당 15번 제한. ### 8.3 공개/비공개 정보 다른 사람이 친 글은 보내지 않고 진행 비율만. 카운트다운과 문제 사이 쉬는 동안 다음 글은 숨김. ### 8.4 랜덤 요소 덱 섞기, 긴글 주제 순서. ### 8.5 타이머·연결 끊김 `realtime`. 시계가 있는 단계(카운트다운, 쉬는 시간, 문제·라운드 시간, 시간별 간격)는 그 시각에만 끝나고 끊긴 사람 때문에 당겨지지 않는다. 시계가 없는 단계(무제한)는 기다리는 사람만 시간 초과 대상이라, 끊긴 사람은 방의 유예 시간 뒤 한 번만 처리된다(각자 치기: 친 데까지로 멈춤). ### 8.6 종료와 결과 마지막 라운드가 끝나거나 한 명만 남으면(나머지가 나감) 끝. 연습은 남은 사람이 다 칠 때까지 계속하고, 모두 나가야 끝. `scoreText` = "N문제/N승 · 평균 N타 · 정확도 N%". ## 9. UI/UX - 위: 라운드·방식·몇 번째·남은 사람·시계. 가운데 카드: 주제, 칠 글(글자별 색, 커서 밑줄), 긴글은 단락 전체와 지금 줄, 각자 치기는 다음 두 줄 미리 보기, 입력 칸 + [입력]. - 한글 조합 중 Enter는 조합이 끝난 뒤 보낸다(IME가 Enter를 두 번 보내는 것도 거름). 붙여 넣기·끌어 놓기 막음, 자동 완성·맞춤법 끔. - 한/영이 반대로 쳐지면 경고. 지금 타수·라운드 타수·정확도·틀린 횟수 표시. - 아래: 모두의 진행 막대(stream으로 실시간), 목숨 하트, 탈락·다 침 표시. 문제가 정해지면 "OO님이 먼저 쳤어요! 352타"/"OO님 탈락!" 띠. 라운드 끝 표(순위·친 문제·타수·정확도), 6초 뒤 다음 라운드. - 연습: 라운드 표시 대신 걸린 시간(⏱), 아래에 지금·평균·최고 타수, 정확도, 진행 %. 끝나면 평균·최고 타수, 정확도, 틀린 줄. 참가자 막대 옆은 점수 대신 타수. - 소리: 자판 딸깍, 맞음, 틀림 삐, 먼저 침 팡파르, 탈락, 3·2·1, 마지막 5초. ### 9.1 설정 화면 언어·방식(서바이벌이면 탈락 조건·목숨·간격)·종목·주제(전체 또는 여러 개)·라운드 1~10·제한 시간/타임어택 시간. 방식마다 한 줄 설명. ## 10. 테스트 체크리스트 - keys.test: 두벌식 타 수, 조합 중 글자, 정확도·편집 거리, 글 묶음 글자 검사·줄 나누기. - typing.test: 옵션·주제, 가장 먼저 입력(쉬는 시간, 늦은 답, 붙여 넣기, 시간 초과, 라운드·최종), 서바이벌 4가지와 모두 탈락 방지·줄어드는 시계, 타수 비교·정확도 대결·타임어택·무제한, 나가기, 무작위 대국 10가지 설정(누출 없음). - typing.test 연습: 10문장·시계 없음·점수 없음, 첫 타부터 시간·최고 타수·붙여 넣기 막기, 긴글 한 편 전체, 여럿이 각자. - e2e typingPractice(짧은글, 3초 쉬어도 타수 유지)·typingPracticeLong(애국가 16줄 전체). - bot.test: 10가지 설정(연습은 컴퓨터끼리만) × (사람 1 + 컴퓨터 / 컴퓨터만) 거절 0, 레벨별 타수. - typing.room.test: 진행 stream, 연습 방, 끊긴 사람. - 웹 help.test: 도움말, 글자 표시. ## 11. 참고 자료 - 한컴 타자연습(타수·정확도 개념), 위키문헌(애국가·윤동주·김소월·한용운 원문). ## 12. 메모 - 시·노래는 저작권이 끝난 것만(저자 사후 70년 경과, 애국가). 동화는 직접 다시 썼다. ## 13. 컴퓨터 상대 - `LIVE_BOT_STRATEGIES.typing`: 자기 화면만 보고 자기 시계로 친다. 레벨 1~60에 따라 한국어 120~620타(영어 100~500), 읽는 시간 0.9~0.35초, 오타 확률(글이 길수록 높음). 함께 치기에서는 틀린 Enter 뒤 고쳐서 다시, 각자 치기에서는 오타를 둔 채 넘어간다. 진행은 0.35~0.65초마다 보낸다.