AutoKkutu - KKutu-Helper 기반 끄투 단어 추천 및 자동 입력기

AutoKkutu는 끄투 헬퍼 V (KKutu-Helper V) Release v5.6.8500 버전을 개조하여 만들어졌습니다. 원 프로그램은 여기에서, 글은 여기에서 보실 수 있습니다. (제작자가 리버싱 후 수정 허용함)

현재 Selenium 버전 사용 시, 브라우저 창과 메인 GUI를 닫아도 프로그램이 종료되지 않는(콘솔 창이 꺼지지 않는) 문제가 있습니다. 프로그램을 종료하시려면 콘솔 창에서 Ctrl+C나 Ctrl+Break를 눌러 종료해 주세요.

다운로드 / 설치 방법

README 상단의 Build status 버튼 또는 이 링크을 클릭하여 AppVeyor CI에서 nightly 버전을 다운로드받으실 수 있습니다.
- 상단의 AppVeyor 링크를 클릭하신 후, Artifacts라는 버튼을 찾아 클릭합니다. 그러면 Windows.x64.Release.7z라는 파일이 보일 것입니다. 이를 클릭하여 다운받으신 후 반디집, 7-zip 또는 PeaZip 등으로 압축을 풀고 사용하시면 됩니다.
사용중인 운영 체제에 맞는 버전(32비트 또는 64비트)를 다운로드 후, 압축을 풀고, AutoKkutuGui.exe 파일을 실행시키면 됩니다.
- .NET Framework가 설치되어 있지 않을 경우, 이에 대한 설치 요구 메세지가 뜰 수 있습니다.

지원 기능

내 턴에 단어 자동 검색
- 검색 시 미션 단어 자동 감지 및 단어 우선 순위 자동 조정
- 단어의 종류가 '한방 단어', '공격 단어', '일반 단어'로 나뉘어 있으며, '한방 단어'와 '공격 단어'는 비활성화 가능
  - 이러한 '한방 단어', '공격 단어'는 각 게임 모드에 따라 모두 분리되어 있음 (예시: '기쁨'은 '끝말잇기' 모드에서는 한방 단어이나 '앞말잇기' 모드에서는 단어에서는 일반 단어임)
  - 이러한 단어의 종류는 특정 '노드'(끝말잇기에서는 끝 글자, 앞말잇기에서는 앞 글자 등등...)에 의해 관리됨. 즉, '듐'을 한방 노드로 등록시켜 놓고 데이터베이스 업데이트 시 '소듐', '라듐', '스칸듐' 등은 모두 한방 단어로 취급됨.
자동 입력: 검색된 단어 중 가장 최적의 것을 자동으로 입력
- 단어 입력 시 일정 시간 지연(딜레이)
  - 글자 수에 비례한 딜레이
    - 만약 단어의 길이가 너무 길어 현재 남은 턴 시간 안에 입력을 마치지 못하고 게임 오버될 것이 예상되는 경우, 해당 단어는 입력 후보에서 자동으로 제외
  - 딜레이 시작 타이밍을 '나에게 턴이 돌아왔을 때'와 '마지막 단어를 입력한 이후' 둘 중에서 선택 가능
게임 종료 후 해당 게임에서 입력되었던 단어 이력을 기반으로 데이터베이스 자동 업데이트
- 새로운 단어 자동으로 추가
- 지원되지 않는 단어 자동으로 삭제
- 새로운 한방 단어 노드 자동으로 추가
단어 및 노드 일괄 추가 기능
- 파일로부터 추가, 폴더의 파일들로부터 추가 이전 데이터베이스 파일 불러오기 기능
CefSharp 기반 임베디드 브라우저와 Selenium 기반 WebDriver 브라우저 모두 지원.
- Selenium 사용 시, WebDriver 감지를 피하기 위해 UndetectedChromeDriver 사용
특수 단어(한방 단어, 공격 단어, 미션 단어 등) 강조 색상 사용자가 지정 가능

임베디드 브라우저(CefSharp 등) vs 웹 드라이버(Selenium 등)

임베디드 브라우저: CefSharp

👍 전반적인 자동 반응 속도가 빠릅니다.
👍 핸들러 코드가 비교적 최적화되어 있습니다.
👎 구글 로그인 시, 약간의 꼼수가 필요합니다. (User-Agent 변경)

웹 드라이버: Selenium + UndetectedChromeDriver

👍 사이트 움직임이 매우 부드럽다. 마치 실제로 Chrome에서 열고 게임하는 것처럼.
👍 CefSharp와는 달리 구글 로그인 관련 문제가 없다.
👎 입력 뿐만이 아니라, 전반적인 사이트 자동 반응 속도가 CefSharp에 비해 느리다. (애초에 단일 소켓을 통해 브라우저와 통신하기에, 브라우저와 직접 통신 가능한 CefSharp보다 느릴 수 밖에 없음)
👎 핸들러가 자주 꼬인다. (표시된 단어 조건과 다른 단어를 찾아 입력하려고 한다던지...)

지원되는 게임 모드

끝말잇기
앞말잇기
가운뎃말잇기 (완벽하지 않음)
타자 대결
전체
자유
자유 끝말잇기

UI 상 단축키 모음

Alt+A - 자동 입력 토글
Alt+D - 자동 입력 딜레이 토글
Alt+Shift+D - 모든 종류의 입력 딜레이 토글 (입력 딜레이 + 자동 수정 딜레이)

개발 언어

지원하는 데이터베이스 종류

현재 (공식적으로) 지원되는 사이트

이름 없는 끄투
핑크끄투
BF 끄투
끄투코리아 - 자동 입력 사용 시 단어 입력 방법을 '우회 미사용'으로 설정 시 'game_input' 검사에 의해 감지될 수 있습니다. (참고: https://gitlab.com/-/snippets/2548135)
뮤직끄투
끄투리오 - 자동 입력 사용 시 단어 입력 방법을 반드시 '입력 시뮬레이션, Win32 메시지 기반'으로 설정하실 것을 추천합니다. (참고: https://gitlab.com/-/snippets/2554781)

프로그램 실행 모습

메인 창

설정 창

아이콘 출처

Waiting icon by Icons8
Search More icon by Icons8
Broom icon by Icons8
error icon by Icons8
Attack icon by Icons8
Skull icon by Icons8
mission icon by Icons8
Warning icon by Icons8

의존성 및 관련 프로젝트

CefSharp - .NET용 Chromium Embedded Framework 구현체
Npgsql - .NET용 PostgreSQL 접속 및 데이터 제공 라이브러리
Serilog - 현재 사용중인 .NET용 로깅 라이브러리
NLog - 또 다른 .NET용 로깅 라이브러리
log4net - 또 또 다른 .NET용 로깅 라이브러리
MySqlConnector - .NET용 MySQL 접속 및 데이터 제공 라이브러리
글자로 놀자! 끄투 온라인

MySQL 또는 MariaDB 사용 시 주의사항

MySQL 또는 MariaDB 사용 시 데이터베이스의 Character Set과 Collation이 각각 utf8mb4와 utf8mb4_general_ci로 설정되었는지 확인해 주세요.

특히, 만약 사용 중이신 MySQL의 버전이 8.0.1 이상인 경우, Default Collation이 utf8mb4_0900_ai_ci이기에, 반드시 Collation을 변경해 주셔야 합니다. (utf8mb4_0900_ai_ci에 존재하는 치명적인 한글 처리 문제점은 여기에서 더 읽어보실 수 있습니다)

다음과 같은 명령으로 utf8 데이터베이스를 생성할 수 있습니다:

CREATE DATABASE <데이터베이스 이름> CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

또는 이미 존재하는 데이터베이스 및 테이블을 바꿀 수도 있습니다:

데이터베이스:

ALTER DATABASE <데이터베이스 이름> CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

테이블:

ALTER TABLE <데이터베이스 이름> CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

이미 데이터베이스를 기본 설정으로 만드셨다면, 데이터베이스와 모든 테이블에 대하여 각각 캐릭터 셋을 바꿔 주셔야 합니다.

예시: 데이터베이스 이름이 'autokkutu'인 경우

ALTER DATABASE autokkutu CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE word_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE attackword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE endword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE reverse_attackword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE reverse_endword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE kkutu_attackword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE kkutu_endword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE kkt_attackword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
ALTER TABLE kkt_endword_list CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

hsheric0210 / AutoKkutu