아톰 설명서

1. 처음 켜기

아톰 폴더의 run_atom.bat 을 두 번 누릅니다. 검은 창이 뜨고 “Atom standing by.” 가 들리면 준비 끝입니다.
게임에서 「아톰」 하고 부르면 “Voice control online.” — 이제 명령어만 말하면 됩니다.
그만 쓸 때는 「아톰 오프」. 프로그램을 끄려면 검은 창을 닫습니다.

게임 창이 앞에 있어야 키가 들어갑니다. 알트탭 중에 말한 명령은 누르지 않습니다.

2. 마이크 고르기

윈도우의 기본 마이크가 실제로 쓰는 마이크가 아닐 수 있습니다. mic.bat 을 누르면 마이크마다 소리 막대가 나옵니다. 말을 하면서 막대가 움직이는 줄을 누르면 저장됩니다. 고른 뒤 아톰을 다시 켜면 적용됩니다.

켤 때 마이크에서 소리가 전혀 안 들어오면 아톰이 “Microphone is silent.” 라고 알려 줍니다. 그때 마이크를 다시 고르세요.

3. 보조 키 넣기 (한 번만)

아톰은 내 게임 키 설정을 읽어서 누릅니다. 그런데 나브·전투·건·미사일 모드, 문 잠금 같은 몇 가지는 게임에 기본 키가 없습니다. 그런 명령에는 비어 있는 왼쪽 Alt + 글자 키를 하나씩 채워 넣어야 아톰이 누를 수 있습니다.

게임을 끈 상태에서 아톰 폴더에서 keymap.py apply 를 돌립니다(키 설정 파일 경로를 뒤에 붙임).
원래 설정은 자동으로 백업됩니다. 내가 바꾼 키는 그대로 두고, 빈 자리에만 더합니다.
게임 설정 화면에서 그 명령에 「왼쪽 Alt + 글자」가 보이면 된 것입니다.

되돌리기: keymap.py undo — 아톰이 넣은 키만 지웁니다. Alt+F1~F12 조합은 게임이 잘 받지 않아 쓰지 않습니다.

4. 목소리 등록 (한국어, 권장)

train.bat 을 누르고 화면에 뜨는 문장을 차례로 말합니다(10분 안팎). 받아쓰기가 내 목소리를 어떻게 받아쓰는지 (특히 「아톰」·「아톰 오프」 발음)를 배워 둡니다. 모델을 새로 학습하는 게 아니라 따로 깔 것이 없습니다.

중간에 창을 닫아도 다음에 이어서 합니다.
끝나면 몇 개를 맞혔는지와 못 맞춘 번호가 나오고, 그 번호만 다시 말할 수 있습니다.
명령 앞에 「아톰」을 붙이지 마세요. 「아톰」은 켤 때, 「아톰 오프」는 끌 때만 씁니다.

5. 키 시험 (말하지 않고)

모드 키가 게임에서 먹는지 말 없이 확인합니다.

배에 시동을 켜고 조종석에 앉습니다. SCM·건 모드 상태로 둡니다(격납고 안이어도 됨).
selftest.bat 을 누르고 10초 안에 게임 창을 누릅니다.
6초마다 키가 하나씩 눌리고 대답 소리가 납니다: 미사일 → 건 → 스캔 켜기 → 스캔 끄기 → NAV → SCM → 퀀텀(NAV) → 퀀텀(SCM).
화면에서 안 바뀐 번호만 기억하면 됩니다. 기록은 selftest_log.txt.

6. 한글채팅과 같이 쓰기

한글채팅(SC-KoChat) 창의 「음성 명령 · 아톰」 칸에서 켜고 끕니다.

아톰 켜기/끄기 — 아톰이 작업표시줄에 내려놓은 창으로 뜹니다.
마이크 고르기 — 2번의 마이크 창을 엽니다.
한글 채팅 켤 때 아톰도 같이 켜기 — 켜 두면 다음부터 같이 켜집니다.
한글채팅을 끄면 한글채팅이 켠 아톰도 같이 꺼집니다.
채팅창이 열려 있는 동안은 아톰이 키를 누르지 않습니다 — 채팅에 글자로 들어가는 것을 막습니다(“Chat window is open.”).

아톰만 따로 쓸 때는 이 보호가 없습니다. 채팅을 치는 동안에는 명령을 말하지 마세요.

7. 영어로 쓰기 · English

아톰은 영어권 사용자도 혼자 쓸 수 있습니다. 아톰 폴더의 atom_config.json 에서 "language": "en" 으로 바꾸면 영어로 듣고 화면 글도 영어로 바뀝니다. 영어는 정해진 말 목록에서만 고르는 방식(Vosk)이라 목소리 등록 없이도 잘 알아듣습니다.

Set "language": "en" in atom_config.json. Say “Atom” to turn it on, then just the command (“quantum mode”, “flares”). “Atom off” turns it off. When Atom asks “Did you mean …?”, answer “yes” or “no”. Pick your microphone with mic.bat. Commands with no default key need a spare Left Alt + letter key (keymap.py apply, game closed).

8. 문제 해결

아무 말도 못 알아듣는다: 검은 창(또는 atom_log.txt)에 「마이크에서 소리가 안 들어옵니다」가 있으면 엉뚱한 마이크입니다. mic.bat 으로 고르세요.
「Star Citizen is not in focus.」: 게임 창이 앞에 없습니다. 게임 화면을 한 번 누르세요.
「Chat window is open.」: 한글채팅이 채팅창이 열려 있다고 보고 있습니다. 채팅을 보내거나 Esc 로 닫은 뒤 다시 말하세요.
퀀텀 모드가 반대로 된다: 퀀텀 모드는 게임의 「B 길게」와 같습니다 — 누를 때마다 SCM 과 NAV 를 오갑니다. 이미 NAV 면 SCM 으로 돌아갑니다.
미사일 모드에서 안 빠져나온다: 「건 모드」(또는 「미사일 끄기」·「미사일 해제」)라고 하세요.
되물을 때 대답이 안 먹는다: 6초 안에 「응」·「네」 또는 「아니」. 같은 명령을 한 번 더 말해도 실행됩니다.
「아톰 오프」가 잘 안 된다: 목소리 등록을 하면 내 발음을 배워 훨씬 잘 됩니다. 급하면 검은 창을 닫으면 완전히 꺼집니다.
어떤 명령만 키가 안 먹는다: 5번 키 시험으로 확인하세요. 게임에서 키를 바꿨으면 아톰이 다음 명령 때 새 설정을 다시 읽습니다. 기본 키가 없는 명령이면 3번 보조 키를 넣었는지 보세요.

9. 아톰 폴더의 파일

run_atom.bat — 아톰 켜기
mic.bat — 마이크 고르기
train.bat — 목소리 등록
selftest.bat — 조종석 키 시험
atom_config.json — 설정(언어 language, 대답 목소리 voice, 마이크 mic)
atom_log.txt — 무엇을 듣고 무엇을 눌렀는지 기록
commands.tsv — 명령표(말·다른 말·영어·키·대답)

대답 목소리는 영국식 넷(bf_emma·bf_lily·bm_george·bm_lewis) 중에서 고릅니다.