Tài liệu

Hướng dẫn sử dụng

Tất cả những gì bạn cần để cài đặt, cấu hình và chạy Hachi từ file thực thi.

Sao chép Markdown

Trên trang này

Tổng quan
Cấu trúc gói
Thiết lập lần đầu
Chính sách Proxy
Cài đặt
Tính năng
Danh sách kiểm tra
Lỗi thường gặp
Tổng quan
Sao chép

Hướng dẫn này dành cho người dùng cuối chạy Hachi từ file thực thi đã build. Giải thích cách chuẩn bị thư mục release, các file cần cung cấp, cách hoạt động của từng tính năng, nơi lưu file output và các lỗi thường gặp kèm cách xử lý nhanh.

Hướng dẫn này giả định người dùng chạy Hachi bằng cách khởi động file EXE, không phải chạy từ mã nguồn.

Cấu trúc gói
Sao chép

Giữ các mục này trong cùng thư mục gốc với file EXE. Nếu thư mục chưa tồn tại, Hachi có thể tự tạo khi chạy lần đầu — nhưng nên chuẩn bị sẵn cấu trúc đầy đủ.

Hachi.exefile thực thi chính
hachi-files/file đầu vào & cấu hình
hachi-caches/
hachi-extensions/
logs/log runtime
output/kết quả task
Thiết lập lần đầu
Sao chép

File đầu vào bắt buộc (trong hachi-files/)

accounts.txt

Các dòng tài khoản định dạng cookie hoặc username:password

proxies.txt

Bắt buộc khi bật Use Proxies

mails.txt

Dành cho Add Mail và Generate Recoverable

recovery.txt

Dành cho Recovery Backsec

config.json

Tự động tạo và cập nhật bởi Settings

Định dạng đầu vào

accounts.txt (tính năng cookie)

username:password:cookie1:cookie2

accounts.txt (Get Cookie)

username:password

mails.txt

email

email|email_password|token|client_id

recovery.txt (đầy đủ)

username/password/cookie/email/email_password/token/client_id

recovery.txt (domain tùy chỉnh)

username/password/cookie/email/email_password

Chính sách Proxy
Sao chép

# Accepted format

http://user1:pass1@127.0.0.1:8080

socks5://abc:xyz@10.0.0.5:1080

Port phải từ 1 đến 65535.

Các dòng không hợp lệ bị chặn trước khi chạy task.

Nếu bật Use HTTP/3, chỉ proxy socks5 được chấp nhận.

Chạy Proxy Test trước khi chạy các tính năng khối lượng lớn.

Cài đặt cơ bản
Sao chép

Cấu hình các giá trị này trong Settings trước khi chạy bất kỳ tính năng nào.

threads

số worker song song

max_retries

giới hạn retry mỗi request

request_timeout

giây trước khi timeout

delay_between_retrys

giây giữa các lần retry

rate_limit_delay

giây khi bị rate limit

use_proxies

bật/tắt dùng proxy

use_http3

chỉ socks5 nếu bật

captcha_solver_provider

tên nhà cung cấp

bypass_cookie_after_*

tùy chọn auto-bypass

Profile khởi đầu an toàn (mạng không ổn định)

threads

= 3–5

max_retries

= 3

request_timeout

= 20

rate_limit_delay

= 30–60

Tính năng
Sao chép

21 trong 21 tính năng

Tạo tài khoản

Tạo tài khoản hàng loạt. Hỗ trợ chế độ bình thường và dưới 13 tuổi.

Yêu cầu

Proxy bật và hợp lệ

Đã cấu hình nhà cung cấp captcha solver

Đã cấu hình API key

Đầu ra

output/generator/success.txtlogs/generator.log

Tạo có khả năng khôi phục

Quy trình đầy đủ: tạo tài khoản, thêm mail, bypass tùy chọn, lưu thông tin khôi phục.

Yêu cầu

mails.txt

Proxy bật và hợp lệ

Đã cấu hình captcha solver

Đầu ra

output/gen_recoverable/success.txtoutput/gen_recoverable/recovery.txtoutput/gen_recoverable/dead.txt

Khôi phục (Backsec)

Kiểm tra trạng thái cookie, khôi phục tài khoản dead qua email reset, tùy chọn bypass cookie đã khôi phục.

Yêu cầu

recovery.txt đúng định dạng

Proxy bật và hợp lệ

Đã cấu hình captcha solver

Đầu ra

output/backsec/valid.txtoutput/backsec/recovered.txtoutput/backsec/recovery.txtoutput/backsec/failed.txt

Lấy Cookie

Đăng nhập bằng username/password để lấy session cookie mới.

Yêu cầu

accounts.txt định dạng username:password

Proxy bật và hợp lệ

Đã cấu hình captcha solver

Đầu ra

output/get_cookie/valid.txtoutput/get_cookie/invalid.txtoutput/get_cookie/failed.txt

Bypass Cookie

Làm mới cookie tài khoản để cải thiện khả năng sử dụng phiên và tránh khóa vùng.

Yêu cầu

accounts.txt định dạng cookie

Khuyến nghị dùng proxy

Đầu ra

output/bypass_cookie/success.txtoutput/bypass_cookie/dead.txtoutput/bypass_cookie/failed.txt

Lưu ý quan trọng

Dùng proxy khớp với vị trí tạo tài khoản (VD: proxy UK cho tài khoản tạo ở UK).

Nếu đăng nhập từ browser không có proxy, TẮT "Use Proxies" khi bypass trừ khi bạn chắc chắn proxy nào cần dùng.

Kiểm tra Cookie

Phân loại cookie: hợp lệ, không hợp lệ, bị cấm hoặc cần xác minh khuôn mặt.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/cookie_checker/valid.txtoutput/cookie_checker/invalid.txtoutput/cookie_checker/banned.txt

Kiểm tra Cookie V2

Engine kiểm tra thay thế, không cần proxy.

Yêu cầu

accounts.txt định dạng cookie

Đầu ra

output/cookie_checker_v2/valid.txtoutput/cookie_checker_v2/invalid.txtoutput/cookie_checker_v2/banned_or_face_verify.txt

Kiểm tra Email/Tuổi

Kiểm tra trạng thái email (đã xác minh/chờ/không) và nhóm tuổi (dưới hoặc trên 13).

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/email_age_checker/email_verified.txtoutput/email_age_checker/age_13_minus.txtoutput/email_age_checker/age_13_plus.txt

Thêm Mail

Liên kết email với tài khoản. Có thể tạo các dòng sẵn sàng khôi phục.

Yêu cầu

accounts.txt định dạng cookie

mails.txt đã chuẩn bị

Proxy tùy chọn

Đầu ra

output/addmail/success.txtoutput/addmail/recovery.txtoutput/addmail/blocked.txt

Gỡ liên kết Mail

Xóa email liên kết khỏi tài khoản hàng loạt.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/unmail/success.txtoutput/unmail/dead.txtoutput/unmail/failed.txt

Thay đổi Ngày sinh

Thay đổi ngày sinh tài khoản hàng loạt. Hỗ trợ ngày tùy chỉnh hoặc chế độ dưới 13.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/change_birthdate/success.txtoutput/change_birthdate/already_under13.txt

Thay đổi Mật khẩu

Thay đổi mật khẩu tài khoản hàng loạt với tùy chọn bypass sau khi đổi.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/change_password/success.txtoutput/change_password/dead.txtoutput/change_password/wrong_pass.txt

Thay đổi Tên hiển thị

Thay đổi tên hiển thị dùng prefix và logic đặt tên cấu hình được.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/change_displayname/success.txtoutput/change_displayname/cooldown.txt

Thêm bạn

Thao tác bạn bè ở hai chế độ: thêm tài khoản mục tiêu hoặc thêm lẫn nhau.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/add_friend/success.txtoutput/add_friend/already_friends.txtoutput/add_friend/dead.txt

Theo dõi người dùng

Cho tất cả tài khoản theo dõi một mục tiêu. Nhập username hoặc user_id.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Username hoặc user_id mục tiêu

Đầu ra

output/follow_user/success.txtoutput/follow_user/already_following.txtoutput/follow_user/captcha.txt

Chặn người dùng

Chạy chặn chéo giữa tập tài khoản với xử lý rate-limit động.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Ít nhất hai tài khoản hợp lệ

Đầu ra

output/block_user/success.txtoutput/block_user/already_blocked.txt

Tạo Gamepass

Tạo một gamepass mỗi tài khoản và áp dụng giá.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/create_gamepass/success.txtoutput/create_gamepass/no_universe.txt

Kích hoạt lại tài khoản

Thực hiện kích hoạt lại tài khoản hàng loạt.

Yêu cầu

accounts.txt định dạng cookie

Proxy tùy chọn

Đầu ra

output/reactive_account/success.txtoutput/reactive_account/dead.txt

Kiểm tra Proxy

Lấy mẫu proxy ngẫu nhiên và kiểm tra kết nối/IP.

Yêu cầu

proxies.txt đúng định dạng

Đầu ra

output/proxy_test/working.txtoutput/proxy_test/failed.txt

Xuất kết quả

Chuyển đổi file output sang TXT, CSV hoặc JSON.

Yêu cầu

Các file output không trống từ các task đã hoàn thành

Đầu ra

export/<feature>.txtexport/<feature>.csvexport/<feature>.json

Cài đặt

Kiểm soát hành vi runtime và cấu hình nhà cung cấp. Tự động lưu.

Yêu cầu

Không cần file thêm

Đầu ra

hachi-files/config.json
Danh sách kiểm tra
Sao chép

Xác thực whitelist thành công

File đầu vào tồn tại và đúng định dạng

Danh sách proxy hợp lệ nếu bật proxy

Đã cấu hình nhà cung cấp và API key captcha

Số luồng đặt ở mức an toàn cho máy/mạng của bạn

Lỗi thường gặp
Sao chép

Whitelist / Xác thực

Payload expired.

Đồng hồ hệ thống không đồng bộ. Chạy với quyền Admin: sc config w32time start= auto & net start w32time & w32tm /config /manualpeerlist:time.google.com /syncfromflags:manual /update & w32tm /resync /rediscover

Key not found.

Key trống hoặc độ dài không hợp lệ. Nhập lại key đúng như đã cấp.

Incomplete or malformed response from server.

Phản hồi từ máy chủ xác thực thiếu các trường đã ký. Thử lại sau, kiểm tra endpoint và xác nhận đang dùng bản build mới nhất.

Invalid signature.

Kiểm tra chữ ký phản hồi thất bại. Khởi động lại app, kiểm tra giờ hệ thống và tải lại bản build sạch.

Response timed out.

Timestamp phản hồi quá cũ so với giờ local. Đồng bộ ngày/giờ Windows và thử lại.

Time error.

Không khớp xác thực time-hash. Sửa đồng hồ và múi giờ hệ thống, rồi thử lại.

HWID error.

HWID hash không khớp khi xác thực. Chạy trên máy gốc đã đăng ký và tránh dùng công cụ giả mạo HWID.

An error occurred during verification.

Lỗi runtime/mạng/crypto khi xác thực. Kiểm tra internet, firewall/AV chặn và thử lại trên mạng ổn định.

Failed to load saved key.

Registry key bị hỏng, không đọc được hoặc giải mã thất bại. App tự xóa key lỗi — nhập lại key của bạn.

Đầu vào & Định dạng file

<file> not found

File cần thiết bị thiếu trong hachi-files/. Tạo file còn thiếu với tên và encoding đúng.

<file> is empty

File tồn tại nhưng không có dòng nào dùng được. Thêm các mục hợp lệ và chạy lại.

Invalid format: expected username:password:cookie1:cookie2

Dòng tài khoản sai định dạng cho task dựa trên cookie. Đảm bảo mỗi dòng có username, password và đầy đủ phần cookie.

Invalid format: expected username:password

Dòng đầu vào Get Cookie sai định dạng. Chỉ dùng username và password cho task Get Cookie.

Proxy & Mạng

This feature requires proxies. Enable 'Use Proxies' in settings first.

Task cần proxy nhưng use_proxies đang TẮT. Bật Use Proxies và cung cấp danh sách proxy hợp lệ.

No proxy has been loaded yet.

File proxy thiếu hoặc trống trong khi proxy là bắt buộc. Điền vào hachi-files/proxies.txt các mục hợp lệ.

Invalid proxy format. Expected protocol://user:pass@host:port

Ít nhất một dòng proxy sai định dạng. Sửa mọi dòng proxy theo đúng định dạng yêu cầu.

Invalid proxy port. Port must be 1–65535

Giá trị port nằm ngoài phạm vi hợp lệ. Thay bằng port số hợp lệ.

HTTP/3 requires socks5:// proxies.

Use HTTP/3 bật nhưng proxy không phải socks5. Chuyển sang danh sách socks5://... hoặc tắt HTTP/3.

Rate limited

Roblox hoặc endpoint đang throttle. Giảm số luồng, tăng rate_limit_delay và thử lại sau.

Task & Runtime

dead / Cookie is dead / Invalid / Dead

Cookie hết hạn, bị thu hồi hoặc không hợp lệ. Chạy lại Get Cookie, rồi thử lại task mục tiêu.

Session blocked / blocksession

Roblox đã chặn session/challenge flow hiện tại. Thử lại với proxy/device profile khác và giảm concurrency.

Incorrect password

Mật khẩu trong đầu vào không khớp với mật khẩu thực. Sửa thông tin đăng nhập và chạy lại.

Already under 13 / already_under13

Tài khoản đã có ngày sinh dưới 13 tuổi. Đây là trạng thái kết thúc bình thường — xem danh mục output riêng.

Cooldown — display name updates throttled

Cooldown đổi tên hiển thị của Roblox đang active. Bỏ qua tài khoản này; thử lại sau khi hết cooldown.

No universes found — account has no experiences

Tạo Gamepass cần một universe có sẵn. Tạo/publish một experience trước, rồi chạy lại.

Username not found

Username mục tiêu không tồn tại hoặc bị sai chính tả. Kiểm tra username hoặc dùng user_id số.

Already friends / Already following / Request already pending

Trạng thái xã hội đã đạt được. Không phải lỗi nghiêm trọng — kiểm tra danh mục output tương ứng.

Missing challenge headers / Missing rblx-challenge-id header

Phản hồi challenge handshake không đầy đủ. Thử lại với proxy sạch và giảm traffic.

Unsupported challenge / Unknown challenge

Gặp loại challenge Roblox mới hoặc chưa hỗ trợ. Báo cáo để cập nhật module trong phiên bản tiếp theo.

Captcha Solver

No captcha solver API key configured

Đã chọn nhà cung cấp nhưng thiếu API key. Đặt API key trong Settings và lưu.

Captcha solver balance is zero

Tài khoản solver không có số dư. Nạp tiền cho nhà cung cấp và chạy lại.

Failed to get solver balance

API nhà cung cấp không truy cập được hoặc thông tin xác thực không hợp lệ. Kiểm tra key, mạng và trạng thái nhà cung cấp.

Browser solver is not prepared for provider

Extension solver chưa được khởi tạo trước các worker thread. Đảm bảo bước chuẩn bị thành công khi khởi động task; khởi động lại task sau khi sửa cấu hình.

Captcha proxy is required and must be different from login proxy

yescaptcha/omocaptcha cần proxy captcha riêng. Cung cấp proxy thứ hai khác với proxy login/gen/recovery.

Captcha waves exceed max configured

Độ phức tạp captcha vượt giới hạn wave đã cấu hình. Tăng browser_captcha_max_waves_to_solve hoặc thử lại sau.

Failed to solve POW within the timeout period.

Bước Proof-of-Work hết thời gian. Tăng browser_captcha_solve_timeout, giảm tải và thử lại.

Captcha final answer was not received within the timeout period.

Browser solver không hoàn thành trong thời gian cho phép. Tăng timeout và giảm số luồng.

Rostile verification failed

Token Rostile không được trả về hoặc bị từ chối. Thử lại với proxy khác và mạng ổn định.

Khôi phục & Mail

Dead token

Token/session mail API không hợp lệ (Microsoft Graph hoặc custom mail API). Làm mới thông tin mail/token và cập nhật các dòng recovery.

Send code failed / Request recovery failed

Recovery API từ chối request — thường do rate limit/challenge/session. Thử lại với concurrency thấp hơn và proxy hợp lệ; kiểm tra thông tin đăng nhập email.

Unexpected recovery state

Luồng trạng thái backend thay đổi hoặc tài khoản không ở giai đoạn recovery dự kiến. Kiểm tra lại trạng thái tài khoản và báo cáo nếu vấn đề tiếp diễn.