D4Assist 한국어 도움말

빠른 시작

시작키와 중지키를 지정합니다. 같은 키를 두 곳에 넣으면 한 번 누를 때 시작, 다시 누르면 중지되는 토글로 동작합니다.
키/마우스 탭의 첫 열에 반복할 키를, 시작 지연 및 간격의 오른쪽 칸에 반복 간격을 입력합니다.
필요하면 환경설정에서 시작/중지 소리와 최소화 옵션을 확인한 뒤 설정을 저장합니다.
Diablo IV.exe 창을 전경으로 만든 상태에서 시작키를 누릅니다.

창 모드와 창 모드(전체 화면)도 사용할 수 있습니다. 화면 표시 방식이 아니라 현재 전경 창을 가진 프로세스가 Diablo IV.exe인지 확인합니다.

입력 안전 동작

Alt+Tab / 포커스 상실

게임이 전경에서 벗어나면 반복 타이머를 정지하고 D4Assist가 누른 키와 마우스 버튼을 해제합니다. 게임으로 돌아오면 실행 상태에 맞춰 안전하게 재개합니다.

Windows 키

Windows 키가 눌리면 먼저 합성 입력을 해제하고 일시 중단합니다. 이 때문에 매크로의 4·F가 Win+4·Win+F로 바뀌어 다른 앱을 여는 현상을 줄입니다.

중지는 항상 우선

시작은 Diablo IV가 전경일 때만 허용되지만, 중지키는 안전을 위해 다른 창에서도 받아들입니다.

입력 실패

Windows SendInput 전송이 실패하면 바로 실행을 중단하고 일반 매크로도 안전 정지합니다.

0ms 차단은 보장되지 않습니다. 전경 변경 감시와 안전 타이머는 빠르게 반응하지만 Windows 스케줄링에 따른 짧은 지연이 생길 수 있습니다.

상단 시작/중지 영역

항목	동작
시작키	Diablo IV가 전경일 때 일반 매크로를 시작합니다.
중지키	일반 매크로·바로 실행·보유 중인 합성 입력을 정지/해제합니다.
같은 시작/중지키	`[XButton1]`처럼 같은 키를 두 칸에 넣으면 한 키 토글로 동작합니다. 키보드 자동 반복과 XButton 중복 DOWN은 필터링합니다.
시작을 금지함	일반 매크로와 바로 실행의 새 시작을 막습니다. 체크박스 오른쪽 단축키 입력칸에 원하는 키를 지정하면 Diablo IV가 전경일 때 그 키를 누를 때마다 ON/OFF가 토글됩니다. 현재 실행 중인 항목의 중지는 계속 가능합니다.
저장 / 읽기	현재 프로필을 별도 INI로 저장하거나 불러옵니다. 최근 파일은 오른쪽 목록에서 다시 열 수 있습니다.

시작 금지 단축키: 체크박스 오른쪽 입력칸에 [HOME], [DEL], [F8] 등 기존 D4Assist가 지원하는 키를 지정할 수 있습니다. 지정 키를 한 번 누르면 시작을 금지함이 켜지고, 다시 누르면 꺼집니다. 이 토글은 Diablo IV가 전경일 때만 동작하며, 설정은 D4Assist.ini에 저장됩니다. 시작/중지키와 같은 키를 지정하면 시작/중지 처리가 우선하므로 서로 다른 키를 권장합니다.

마우스 휠은 시작/중지키로 사용하지 않습니다. 빠른 스크롤이 오작동을 일으키지 않도록 [WheelUp]과 [WheelDn] 실제 입력은 시작/중지 처리에서 제외되어 있습니다.

키/마우스 탭 — 일반 매크로 8행

각 행은 독립된 반복 작업입니다. 출력키와 간격이 모두 있어야 활성화됩니다.

열	설명	예
키+	게임에 보낼 키·마우스 입력. 여러 키는 `\|` 또는 `&`로 묶을 수 있습니다.	`4`, `[mbRight]`, `2&3&R`
시작 지연	매크로 시작 후 이 행의 첫 실행까지 기다리는 시간(ms). 비우면 즉시 준비합니다.	`500`
간격	반복 주기(ms). 1~29를 입력해도 내부에서는 30ms로 제한됩니다.	`100`, `1000`
홀딩	반복 클릭 대신 DOWN 상태를 소유해 유지하고, 행이 멈추거나 포커스를 잃을 때 UP을 보냅니다.	마우스 버튼 유지
일시정지키	이 행만 잠시 멈추는 키. 일반 키는 토글 성격이며 조합/복수 표기도 사용할 수 있습니다.	`[SHIFT]`
활성화키	이 키 조건이 만족되는 동안 해당 행을 실행합니다. 비우면 매크로 시작과 함께 실행됩니다.	`F`, `[CONTROL]`
설명	사용자가 적는 메모이며 입력 동작에는 영향을 주지 않습니다.	방어 기술

표시 초기화 시간(ms)은 아래 경과 시간 표시가 다시 0으로 돌아갈 주기입니다. 0이면 자동 초기화하지 않습니다.

바로 실행 — 최대 5개

바로 실행은 일반 매크로가 꺼져 있을 때, 오른쪽 활성화키를 누르고 있는 동안 왼쪽 출력키를 지정 간격으로 반복합니다.

F
출력키

→

30 ms

← 활성화 →

F
누르는 키

위 설정은 오른쪽 F를 누르는 동안 왼쪽 F를 30ms 간격으로 반복합니다. 출력키와 활성화키가 같아도 작동합니다.

다섯 줄을 서로 다른 활성화키로 설정할 수 있습니다.
최소 간격은 30ms입니다. 10처럼 더 작은 값은 실행/불러오기 시 30으로 보정됩니다.
30ms는 이론상 초당 약 33.3회이며, 실제 속도는 Windows 타이머와 게임 처리량에 따라 더 낮을 수 있습니다.
D4Assist 창에 입력 포커스가 있거나 Diablo IV가 전경이 아니면 시작하지 않습니다.
활성화키를 놓거나 포커스를 잃으면 해당 바로 실행이 정지합니다.

키와 마우스 입력 표기

종류	표기 예
문자·숫자	`A`~`Z`, `0`~`9`
기능키	`[F1]`~`[F12]`, `[SPACE]`, `[ENTER]`, `[ESC]`, `[TAB]`
보조키	`[SHIFT]`, `[CONTROL]`, `[ALT]`
편집·이동키	`[DEL]`, `[INS]`, `[HOME]`, `[END]`, `[PGUP]`, `[PGDN]`, 방향키
기본 마우스	`[mbLeft]`, `[mbRight]`, `[mbMiddle]`
측면 버튼	`[XButton1]`, `[XButton2]`
휠 출력	`[WheelUp]`, `[WheelDn]` — 출력으로는 가능하지만 실제 휠을 제어키로 쓰는 것은 제외됩니다.

복수키와 AND 모드

A|B는 여러 후보 중 하나가 눌린 상태를 조건으로 사용합니다. A&B는 두 키가 모두 눌려야 하는 AND 조건이며, 출력키에서는 한 번에 함께 누르고 놓는 조합으로 처리합니다. 화면의 멀티키 AND 모드는 필드에 키를 추가할 때 구분자를 &로 만듭니다.

입력칸을 선택한 뒤 ESC로 지우거나 Backspace를 사용할 수 있습니다.

다른 탭과 환경설정

순차적 키

현재 화면에도 표시되듯 이 탭은 아직 지원되지 않습니다. 설정 용도로 사용하지 마십시오.

중지키들

최대 16개의 이름/키를 지정합니다. 이름 끝 문자가 동작을 결정합니다.

이름 예	동작
`긴급중지`	해당 키를 누르면 전체 매크로 중지
`잠시멈춤+`	누를 때마다 전체 일시정지/재개 토글
`누르는동안-`	키를 누르는 동안 일시정지, 놓으면 재개

환경설정

항상 위: D4Assist 창을 다른 창 위에 둡니다.
Diablo IV 프로세스만: 이 수정본에서는 항상 켜져 있고 대상은 Diablo IV.exe로 고정됩니다.
투명도: 간소화/실행 중 창 표시 투명도를 조절합니다.
시작 시 최소화: 매크로 시작과 함께 창을 최소화합니다.
시작/중지 소리: tts\start.wav, tts\stop.wav를 재생합니다.
키/마우스 클릭 보정: DOWN 뒤 UP까지 추가 지연(0~50ms). 일반적으로 비우거나 0을 권장합니다.

저장, 파일 구성, 포터블 실행

설치 프로그램은 필요하지 않습니다. Final 폴더를 통째로 복사해 사용할 수 있습니다.

파일/폴더	용도
`D4Assist.exe`	실행 파일
`D4Assist.ini`	창 위치, 언어, 소리, 최근 프로필 등 프로그램 환경
사용자가 저장한 `*.ini`	키/마우스와 바로 실행 프로필
`D4Assist.files`	최근에 연 프로필 목록
`lang`	한국어/영어 UI 번역
`tts`	시작/중지 WAV 및 TTS 미디어
`styles`	스킨과 선택 기능 리소스
`D4Assist_Help_KO.html`, `D4Assist_Help_EN.html`	오프라인 도움말. D4Assist.exe와 같은 폴더에 있어야 도움말 메뉴가 로컬 파일을 엽니다.
`D4Assist_Release_KO.html`, `D4Assist_Release_EN.html`	오프라인 릴리스 노트. EXE와 같은 폴더에 배치합니다.

.ilc, .ild, .ilf, .ils, .map, .tds는 빌드 중간/디버그 파일이므로 배포 폴더에는 필요하지 않습니다.

언어 변경

보기 → 언어 선택에서 Korean 또는 English를 선택하면 프로그램이 재시작됩니다. 이후 도움말도 같은 언어로 열립니다.

시작/중지 소리

D4Assist.exe 옆에 tts 폴더가 있는지 확인합니다.
tts\start.wav와 tts\stop.wav가 존재해야 합니다.
환경설정의 시작/중지 시 오디오 재생을 켜고 이름을 start, stop으로 둡니다. 확장자 .wav는 입력하지 않습니다.
Windows 설정 → 시스템 → 소리 → 볼륨 믹서에서 D4Assist의 출력 장치를 원하는 HDMI/Realtek 장치로 지정합니다.

D4Assist 소리는 Diablo IV 프로세스의 오디오 장치를 자동으로 따라가지 않습니다. Windows 볼륨 믹서에서 D4Assist 앱의 출력 장치를 별도로 지정하는 방식이 가장 확실합니다.

문제 해결

증상	확인할 것
시작키가 반응하지 않음	Diablo IV 창이 전경인지, 시작을 금지함이 꺼졌는지, 입력칸을 편집 중이지 않은지 확인합니다.
시작 금지 단축키가 토글되지 않음	Diablo IV가 전경인지 확인하고, 단축키 입력칸을 편집 중인지 확인합니다. 시작/중지키와 같은 키를 지정했다면 시작/중지 처리가 우선합니다.
빠른 휠로 시작/중지되지 않음	정상입니다. 휠 실제 입력은 오작동 방지를 위해 제어키에서 제외되었습니다. XButton 또는 키보드 키를 사용하십시오.
바로 실행이 안 됨	일반 매크로를 중지하고, 오른쪽 활성화키·가운데 간격·왼쪽 출력키가 모두 있는지 확인합니다. D4Assist 창이 아니라 Diablo IV를 전경으로 둡니다.
10ms를 넣었는데 30으로 바뀜	정상입니다. VCL 타이머 과부하와 이벤트 폭주를 막기 위한 최소값입니다.
Alt+Tab 뒤 키가 계속 눌린 것 같음	중지키를 한 번 누르십시오. 계속되면 프로그램을 종료한 뒤 재실행하고, 동일 키를 여러 행에서 홀딩하는 설정을 점검합니다.
소리가 안 남	WAV 파일, 환경설정 체크, Windows 볼륨 믹서의 D4Assist 음소거/출력 장치를 확인합니다.
SendInput blocked 표시	게임·보안 프로그램·권한 차이로 Windows 합성 입력이 거부된 상태입니다. D4Assist는 우회하지 않고 안전 정지합니다.
도움말을 누르면 GitHub가 열림	`D4Assist_Help_KO.html`과 `D4Assist_Help_EN.html`이 D4Assist.exe와 같은 폴더에 있는지 확인합니다. 현재 언어 파일이 없으면 다른 언어 파일을 시도하고, 둘 다 없을 때만 프로젝트 GitHub 페이지를 엽니다.

알려진 한계

마우스 드라이버가 실제 클릭과 완전히 같은 XButton DOWN/UP 패킷을 생성하면 프로그램이 물리 클릭과 완벽히 구분할 정보가 없습니다.
Windows 스케줄링 때문에 Alt+Tab 순간의 정확한 0ms 중단은 보장할 수 없습니다.
Windows 또는 보안 프로그램이 저수준 입력 훅 설치를 거부하거나 훅을 제거할 수 있습니다. 프로그램은 재설치를 시도하지만 강제할 수 없습니다.
게임이나 보안 정책이 SendInput을 차단할 수 있으며, 이를 우회하는 기능은 포함하지 않습니다.
30ms는 요청 간격이지 실시간 보장값이 아닙니다.

1.0.4.1 수정 내역

D3Assist / D3Assistant 계열 이름을 D4Assist / D4Assistant로 통일
YoloMouse 관련 기능·UI·잔여 Cursors 자산 제거
시작을 금지함 체크박스에 사용자 지정 단축키 토글 기능 추가 및 D4Assist.ini 저장 지원
Backspace 표기를 [BACK]으로 통일
CheckKeyState 활성 시 반복 키/마우스 입력을 훅에서 삼키지 않고 다음 훅으로 전달하도록 수정
사용되지 않던 안전장치 없는 구형 전역 입력 함수 제거
파일 버전 조회 실패·길이·서명 검사 추가
설정 창 활성화 시 큐의 KEYUP/MouseUp 해제 이벤트가 소실되지 않도록 처리
XButton 필터를 시간 기반이 아니라 D4Assist 합성 입력 태그 기준으로 구분하도록 보강
Diablo IV 전경 검증, Windows 키/Alt+Tab 안전 해제, 5개 바로 실행, 최소 30ms, 입력 실패 안전 정지 등 1.0.3.186 안정화 항목 유지
한국어/영어 오프라인 도움말과 릴리스 노트를 1.0.4.1 기준으로 갱신

소스 정적 검증과 코드 경로를 기준으로 정리한 내용입니다. 실제 C++Builder 빌드와 Diablo IV 실사용 동작은 해당 Windows 환경에서 최종 확인이 필요합니다.