YES-BD2

도구를 열고 버튼 하나만 누르면 브라운더스트2 일일 콘텐츠가 끝납니다.

Important

플레이어는 Releases에서 yes-bd2-win32-online-setup.exe를 내려받아 설치하세요. Source code와 초록색 Code → Download ZIP은 소스 코드이며 설치 파일이 아닙니다.

브라운더스트2 PC 버전(데스크톱 앱) 전용입니다. 모바일과 에뮬레이터는 지원하지 않습니다.

먼저 게임 언어를 중국어 간체(简体中文)로 바꿔 주세요. 도구는 게임 화면의 글자를 읽어서 동작하기 때문에 지금은 중국어 간체만 읽을 수 있습니다. 다른 언어도 곧 지원합니다. 도구 자체 화면은 5개 언어를 지원하며, 도구의 설정 → 언어에서 바꿀 수 있습니다.

면책 조항

무료·오픈소스: Python, 이미지 인식, OCR, UI 자동화를 배우기 위한 개인 프로젝트이며 비용이 들지 않습니다.
화면을 보고 마우스만 움직임: 게임 메모리나 게임 파일을 읽거나 바꾸지 않습니다.
본인 책임: 자동화 도구는 게임이나 플랫폼의 이용 약관을 위반할 수 있습니다. 계정 제한·정지·보상 회수의 위험은 사용자가 집니다.
비공식: 브라운더스트2의 개발사, 운영사, 플랫폼과 아무런 관계가 없습니다.
영리 이용 금지: 대리 진행, 스크립트 판매, 유료 대행 등 영리 목적의 이용을 허용하지 않습니다.

기능

일일 일괄 실행: 길드, 마이홈, 주점, 단골 성석, 빠른 사냥, 무료 뽑기, 쓰지 않는 장비, 재련, 여신상, 거울전쟁, 이벤트 전투, 퀘스트 보상, 패스, 우편, 이벤트 보상을 버튼 하나로 순서대로.
주간 파밍: 스토리팩에서 흡수·소집·제압을 자동으로 쓰고, 한 주 분량을 매일 나눠서 진행.
일일 교역 파밍: 구매, 요리, 판매 달력에 따른 판매. 남길 수량은 직접 정합니다.
주간 일괄 실행: 아케이드 메뉴, 마이홈 인기도, 장비 제작, 종말의 서.
분신 데스크톱: 게임이 별도 창의 독립된 데스크톱에서 실행되어 마우스와 키보드를 그대로 쓸 수 있습니다.
마물 추적자: F8로 내 전투를 한 번 녹화하면, 이후 매 턴의 순서·배치·스킬을 녹화한 대로 맞춘 뒤 싸웁니다.
오늘 리포트: 오늘 무엇을 실행했는지, 무엇이 왜 실패했는지 한눈에.

특징

확실하지 않으면 누르지 않음: 화면을 확실히 인식했을 때만 클릭합니다. 막히면 홈으로 돌아가거나 멈춥니다.
과금 없음: 유료 스태미나, 다이아, 유료 아이템은 절대 건드리지 않습니다. 무료 횟수를 다 쓰면 멈춥니다.
지켜볼 필요 없음: 끝나면 Windows 알림으로 알려 줍니다.
자동 업데이트: 실행할 때마다 새 버전을 확인하므로 다시 받을 필요가 없습니다.
1080p·2K·4K: 16:9라면 모두 사용할 수 있습니다.

3단계로 시작

Releases에서 yes-bd2-win32-online-setup.exe(약 5 MB)를 받아 설치합니다. 설치 중에 나머지를 내려받으므로 인터넷에 연결해 두세요. "Windows의 PC 보호" 창이 뜨면 추가 정보 → 실행을 누르세요(설치 파일에 코드 서명이 없어 새 버전에서는 이 경고가 나옵니다).
게임 언어를 중국어 간체로, 그래픽을 FHD로 설정합니다.
도구를 열고 일일 일괄 실행을 누릅니다. 게임이 꺼져 있으면 켤지 먼저 물어봅니다.

실행 중에도 PC를 쓰고 싶다면 분신 데스크톱에서 실행을 누르세요(Windows Pro 필요, 처음 한 번 설정).

다른 화면


일일 설정: 실행할 항목을 체크	교역 파밍: 사고, 만들고, 팔기	파밍: 한 주 진행 상황을 한눈에

_{마물 추적자: 매 턴의 순서·배치·스킬을 내가 녹화한 대로}

_{스크린샷은 중국어 간체 화면입니다.}

실행 전 주의

화면 잠금, 화면 끄기, 절전 모드를 쓰지 말고 게임 창도 최소화하지 마세요.
GPU 필터, 샤프닝, FPS 표시, 녹화 오버레이 등 화면 위에 겹치는 것은 끄세요.
일반 모드는 마우스를 사용하므로 실행 중에는 PC를 조작하지 마세요. 함께 쓰려면 분신 데스크톱을 사용하세요.
실행할 때마다 관리자 권한을 요청합니다(Windows가 한 번 묻습니다). "예"를 누르세요.

문제가 생기면

상황	해결 방법
게임을 찾지 못함	먼저 게임을 켜세요. 기본 위치가 아닌 곳에 설치했다면 아래 "소스로 실행"의 경로 설정을 참고하세요
화면을 인식하지 못함	게임 언어가 중국어 간체인지, 16:9인지, 게임을 가리는 것이 없는지 확인하세요
특정 항목이 계속 실패함	오늘 리포트에서 실패 원인과 스크린샷을 확인하고 Issues에 알려 주세요

오늘 리포트의 스크린샷이 가장 도움이 됩니다. 게임 계정 정보가 보일 수 있으니 올리기 전에 확인하세요.

분신 데스크톱 설정 방법

분신 데스크톱은 게임을 별도의 독립된 데스크톱 창에서 실행하므로, PC를 그대로 쓸 수 있고 마우스와 키보드를 뺏기지 않습니다.

필요한 것

Windows 10/11 Pro, Enterprise, Education. Home에서는 쓸 수 없습니다.
Windows의 '원격 데스크톱 서비스'가 있고 사용 안 함이 아닐 것. 분신은 이 PC가 원격 데스크톱으로 자기 자신에 접속하는 방식이라, 최적화·경량화 도구나 경량화된 Windows에서는 자주 바뀌어 있습니다. 도구가 먼저 확인하며, 사용 안 함이면 '대신 켜기'를 누르면 됩니다(다른 PC는 접속할 수 없음).
Windows 계정 비밀번호(Microsoft 계정이면 Microsoft 비밀번호). PIN은 안 됩니다.

처음 한 번

홈에서 '분신 데스크톱에서 실행' → '처음 설정'을 누르고, Windows 확인 창에서 '예'.
Microsoft 계정으로 Windows Hello 로그인만 허용한 PC라면 '대신 끄기'를 누르라고 안내합니다.
다시 '분신 데스크톱에서 실행' → '이동'을 누르고, Windows 확인 창에서 '예'.
로그인 창에 Windows 계정 비밀번호(PIN 아님)를 입력하고 '내 자격 증명 기억'에 체크하면 다음부터는 입력하지 않아도 됩니다.
분신 창이 열리면 게임과 일일 콘텐츠가 자동으로 시작되고, 진행 상황은 도구에서 봅니다. 최소화해도 계속 실행되며, X로 닫으면 분신이 끝나고 안의 게임과 도구도 함께 닫힙니다.

그만 쓰려면: 설정 → '분신 데스크톱 되돌리기' → '되돌리기'.

자주 있는 문제

상황	해결 방법
로그인 실패, 비밀번호가 틀림	PIN이 아니라 계정 비밀번호 입력. Microsoft 계정은 Microsoft 비밀번호. Windows Hello만 허용이면 먼저 '대신 끄기'
'516' 또는 '서버에 대한 원격 액세스를 사용할 수 없음 / 원격 컴퓨터가 꺼져 있음'	분신에 연결하지 못한 것이며 비밀번호 문제가 아닙니다. 순서대로: 도구를 다시 열고 다시 누르기 → PC 재시작 후 다시 시도(설정 직후에는 자주 필요) → 최적화·경량화 도구나 RDP Wrapper를 쓴 PC에서는 안 될 수 있습니다. 그래도 안 되면 `%LOCALAPPDATA%\bd2-auto\clone-desktop\viewer.log`을 첨부해 Issues에 알려 주세요
분신 프로그램이 사라짐	백신이 삭제했을 수 있습니다: `%LOCALAPPDATA%\bd2-auto\clone-desktop`을 신뢰 목록에 추가하고 다시 '처음 설정'
PC가 종료되지 않음	먼저 X로 분신 창을 닫거나, 작업 관리자 → '사용자'에서 프로세스가 적은 같은 이름의 사용자를 로그아웃

어떤 파일을 받나요

파일	설명
`yes-bd2-win32-online-setup.exe`	이 파일을 고르세요. 약 5 MB, 나머지는 설치 중에 내려받으며 보통 더 빠름
`yes-bd2-win32-Full-setup.exe`	오프라인용 전체 설치 파일, 용량이 큼. 설치 중에 인터넷을 쓸 수 없을 때만

GitHub가 자동으로 붙이는 Source code 압축 파일과 yes-bd2-win32.zip은 설치 파일이 아니므로 받지 않아도 됩니다.

소스로 실행(개발자용)

소스로 실행하면 자동 업데이트되지 않습니다. git pull로 직접 업데이트하세요.

git clone https://github.com/nobell001/YES-BD2.git
cd YES-BD2
py -3.12 -m venv .venv
.\.venv\Scripts\pip install -r requirements.txt
.\start.bat

게임이 기본 위치에 없으면 실행 전에 다음을 설정합니다.

$env:OK_BD2_LAUNCHER_PATH = "C:\Path\To\Browndust2Starter.exe"
$env:OK_BD2_GAME_PATH = "D:\Path\To\BrownDust II.exe"

의존성은 pyproject.toml과 uv.lock이 기준이며, requirements*.txt는 uv로 내보낸 파일이니 직접 수정하지 마세요.

.\scripts\run_checks.ps1 -Mode Focused -Tests tests.test_pvp_task   # 영향받는 테스트만
.\scripts\run_checks.ps1 -Mode Final                                # 커밋 전 전체 검사

자세한 내용(중국어): 아키텍처 · 릴리스 체크리스트 · PyAppify 릴리스 과정

감사의 말

YES-BD2는 GodRaymond233/ok-bd2를 바탕으로 만들었고, 프레임워크와 원클릭 업데이트는 ok-script에서 왔습니다. 다음 분들께도 감사드립니다.

BD2DB: 게임 내 명칭과 데이터
bilibili의 時樂淵님: 교역 파밍 판매표
BetterGI, ChildStream: 분신 데스크톱 방식과 화면 창
JZPPP/MaaBD2: 맵 채집 경로 참고

도구의 "정보" 페이지에 모든 감사의 말이 있습니다. 서드파티 의존성과 소재는 THIRD_PARTY_NOTICES.md를 참고하세요.

라이선스

코드는 GPL-3.0(ok-bd2와 동일)으로 공개합니다. 게임 이름, 스크린샷, 아이콘, UI 소재의 권리는 각 권리자에게 있습니다.

nobell001/YES-BD2

프로젝트 문서