Wiki & Tài Liệu Hướng Dẫn

Tải trọn bộ phần mềm bot

Tải bộ cài đặt bot từ một trong giải pháp phân phối dưới đây. File ZIP chứa toàn bộ cấu hình, updater và công cụ quản lý.

Giải nén vào thư mục gốc C:\

Giải nén toàn bộ tệp tin trực tiếp vào thư mục gốc ổ đĩa C:\. Không lồng trong các thư mục con khác.

Xác minh đường dẫn chạy bot

Hãy đảm bảo file quản lý chính nằm chính xác tại: C:\Bot Manager RP v2\ManagerBot.exe. Nếu sai đường dẫn, các liên kết cấu hình sẽ bị lỗi không tải được.

Chạy AutoUpdate.exe

Chạy file AutoUpdate.exe bên trong thư mục bot để tự động cập nhật lên phiên bản mới nhất.

Tải công cụ lấy HWID

Tải công cụ chính thức để khởi tạo khóa phần cứng máy tính của bạn.

Khởi chạy & Lấy HWID

Mở tệp GetHWIDkeyFBH_Protected.exe, nhập thông tin liên lạc và ấn "Get HWID". Chờ thông báo hiển thị chữ "Completed".

Đặt tệp Key vào thư mục bot

Nhắn tin mã HWID cho lập trình viên qua Telegram @NewBieT để nhận file bản quyền. Sau khi nhận được tệp key, chép tệp vào đường dẫn: C:\Bot Manager RP v2\.

Đặc Tả Chi Tiết Các Cột Trong LoginData.txt

Mở file C:\Bot Manager RP v2\LoginData.txt và điền tài khoản. Ngăn cách mỗi cột bằng đúng ký tự TAB (\t). Các cột từ 8 đến 15 là không bắt buộc.

Quy Tắc Chỉ Số Slot AccNo

Mỗi chỉ số slot quy định vai trò của tài khoản đó khi chạy trên máy PlayStation:

• 1: Tài khoản chính chơi game. (Bắt buộc phải pair và tích chọn LoginedPS. Sẽ được tự động đăng nhập đầu tiên).
• 2 – 10: Các tài khoản phụ chơi game trên cùng máy console đó.
• 98: Tài khoản phụ để kích hoạt PlayStation Plus chung (Chế độ Plus Mode).
• 99: Tài khoản game bản quyền Digital dùng để active game chính cho các acc phụ.
• ⚠️ Các giá trị slot từ 11 đến 89 là không hợp lệ và sẽ báo lỗi khi nạp dữ liệu.

Định Dạng Tên Gọi Sbnumber

Hệ thống tự động biên dịch mã Sbnumber từ PSNo (số máy PS) và AccNo (số slot) theo công thức: sb{PSNo:D2}{AccNo:D2} (tự động điền đủ 2 chữ số):

Mẫu Dòng Cấu Hình Mẫu

Cấu hình tối thiểu (8 cột ngăn cách bằng TAB):

1	1	[email protected]	password123	GAUTHSECRET123	[email protected]	eapass456	EAGAUTHSECRET

Đầy đủ PsnID + RefreshToken (10 cột):

1	1	[email protected]	password123	GAUTHSECRET123	[email protected]	eapass456	EAGAUTHSECRET	PlayerOne	eyJhbGci...

Đầy đủ cấu hình liên kết CustomRP (14 cột):

1	99	[email protected]	pass999	[email protected]	eapass	DigiGamer	bc60a7123456	80fd6184abcd1234	abc123RPkey==	0

Nạp Dữ Liệu Vào Manager

Vào tab Acc Manage, click Load LoginData. Đối với các tài khoản đã đăng nhập sẵn trên máy PS, tích chọn Logged In để bỏ qua, sau đó nhấn Save để lưu và nạp cấu hình.

Tài liệu hướng dẫn cũ bổ sung

Ngoài ra còn có đường link tài liệu hướng dẫn cũ để bạn tham khảo thêm: docs.google.com/spreadsheets

Cách 1: Lấy Token và Liên Kết Tự Động (Khuyến nghị)

Trong ManagerBot, chọn dòng tài khoản cần liên kết rồi click AutoGetToken. Trình quản lý sẽ tự khởi chạy trình duyệt, điền thông tin và đi qua 2FA. Vui lòng giữ nguyên chuột, không chạm vào máy trong lúc này. Sau khi RefreshToken được tạo xong, click PairToken để hoàn tất liên kết.

Nếu Pairing tự động bị lỗi hoặc bạn đang cấu hình bot từ một máy tính khác từ xa:

1. Click nút GenURL. Hệ thống sẽ tự động tạo một đường link đăng nhập PlayStation và copy vào khay nhớ tạm.
2. Mở trình duyệt web của bạn, dán link đó vào và đăng nhập tài khoản PSN của bạn thủ công.
3. Đăng nhập xong, trang web sẽ trắng hoặc chuyển hướng. Hãy copy toàn bộ **đường link URL chuyển hướng** trên thanh địa chỉ.
4. Quay lại ManagerBot, click GetToken và dán đường link vừa copy vào. Đợi token hiện ra rồi nhấn PairToken.

Cách 3: PairAccID (Liên kết qua PIN & AccountID)

Ideal for manual pairings and working around automated browser block screens:

• Đầu tiên, điền mã **NPSSO Token** (xem hướng dẫn lấy mã ở bên dưới).
• Trên máy PS, vào mục Remote Play Connection Settings -> Add Device để hiện mã PIN 8 số trên màn hình.
• Trên ManagerBot, click PairAccID. Bot sẽ tự động lấy Account ID từ PSN ID thông qua mã NPSSO, tự điền mã PIN và hoàn thành liên kết.

Cân chỉnh cài đặt hệ thống máy PS

Để đảm bộ dò điểm ảnh và động cơ nhận dạng OCR chuẩn xác, bạn cần cấu hình các thông số sau trên máy PS của mình:

• Ngôn ngữ hệ thống bắt buộc phải đặt là English (tiếng Anh).
• Nếu sử dụng máy PS hệ Châu Á (nút O là OK mặc định), hãy vào cài đặt hệ thống đổi nút bấm sao cho nút X đóng vai trò làm nút OK (confirm).
• Đảm bảo ô Enable Remote Play đã được tích chọn trong phần cài đặt kết nối.
• Cài đặt tỷ lệ hiển thị màn hình Display Area về mức Tối thiểu (Minimum).
• Tên tài khoản mạng PSN và ký tự hiển thị chỉ được dùng bảng chữ cái tiếng Anh thông thường.

Thông số phần cứng máy tính PC khuyến nghị

Để vận hành quy mô lớn (hỗ trợ cày ổn định lên đến 32 luồng máy PS đồng thời), cấu hình khuyến nghị gồm:

Tổng quan & Các Checkbox Kích hoạt

Công cụ CustomRP Scheduler tự động hóa việc khởi chạy và ngắt tiến trình bot dựa theo giờ chỉ định riêng lẻ cho mỗi máy PS. Mỗi PS vận hành một vòng lặp quản lý độc lập. Để kích hoạt tính năng này, hãy chọn các checkbox tương ứng sau trên bảng điều khiển Manager:

• ✅ Tích chọn Use CustomRP (biến isUseCustomRP)
• ✅ Tích chọn Schedular CustomRP (biến Schedular2)
• ✅ Tích chọn IsUse ở danh sách của máy PS cần kích hoạt
• ✅ Tích chọn IsLoop ở danh sách của máy PS cần kích hoạt

Định dạng Cột & Khung Giờ Chạy (BotSchedularPlayTime)

Cài đặt chuỗi lịch biểu trong tùy chọn cấu hình. Các cột dữ liệu bắt buộc phải ngăn cách bằng phím TAB (\t). Cấu trúc đầy đủ gồm 8 cột: 1 cột tên slot và 7 cột các ngày trong tuần (từ Chủ Nhật đến Thứ Bảy):

sbname\t[Sun]\t[Mon]\t[Tue]\t[Wed]\t[Thu]\t[Fri]\t[Sat]

Định dạng Ca giờ chạy: mode_HH:MM-HH:MM

• mode: Số hiệu ScriptMode (xem bảng tra cứu mã bên dưới).
• HH:MM-HH:MM: Thời điểm bật - Thời điểm ngắt. (Lưu ý: Không dùng mốc giờ 24:00 hoặc 00:00).
• Chạy nhiều ca trong ngày: Ngăn cách các ca giờ bằng ký tự gạch đứng |.

Example Config:

💡 sb0101: Every day from 09:00–10:00, run ScriptMode 1 (PlayUnlock, 3 matches).
💡 sb0199: Every day at 00:01–00:02 run mode 31 (Activate digital account); at 10:00–10:01 run mode 32 (Deactivate digital account). Both run exactly once per day.

Bảng tra cứu mã hoạt động ScriptMode

Mã mode chỉ định cụ thể hành vi xử lý của bot trong suốt ca giờ chạy (Ví dụ: 22_12:00-15:00 để chạy Rivals + Champions).

Lưu trữ nhật ký chạy ca đặc biệt

Để ghi nhớ xem một tác vụ đặc biệt (mode từ 30 đến 39) đã thực hiện trong ngày hay chưa, Manager ghi chép lịch sử vào file: C:\Bot Manager RP v2\SpecialScriptLastRun.txt

File Layout (Tab separated):

sb0199_31\t2026-04-02\nsb0199_32\t2026-04-02

How to Force Re-run a Special Mode:

• Open SpecialScriptLastRun.txt in Notepad.
• Delete the line corresponding to the mode you want to re-run (e.g., delete the sb0199_31 line).
• Save the file. The scheduler will automatically catch up and run the job on the next poll.
• Or, delete the entire file to force reset special modes for all accounts.

Mô hình phân chia độ ưu tiên & Vòng lặp

Mỗi chu kỳ 1 giây, bộ lập lịch sẽ rà soát và xếp thứ tự lệnh xử lý như sau:

1️⃣ Lệnh chạy bù (Chạy bù các Mode đặc biệt 30-39 chưa chạy hôm nay. Chỉ chạy khi KHÔNG có bot nào đang chạy trên máy PS này)
       ↓
2️⃣ Ca chạy hiện hành (Khung giờ cày thường đang mở. Sẽ xếp hàng chờ nếu đang có bot chạy sẵn)
       ↓
3️⃣ Nghỉ ngơi (Không có lịch chạy nào đang mở. Status Manager báo: "NoAcc in this playtime")

Loop State Reference:

Ánh xạ tài khoản Plus / Digital (sb98 / sb99)

Các tài khoản Plus (Ví dụ: sb0198) và Digital phụ (Ví dụ: sb0199) không cần cấu hình ca lịch chạy riêng biệt. Lập lịch sẽ tự động **đồng bộ và kế thừa cấu hình lịch chạy** của tài khoản chính sb{PS}01 trên cùng máy cày PS đó. Lập lịch tự xử lý cơ chế map ngầm này trong background và không cần thiết lập thêm.

Những lưu ý tích hợp quan trọng

• Single Instance Enforcement: Only one bot instance runs per PS machine at a time. The scheduler enforces this lock.
• ScriptMode 0: If no mode number prefix is defined in the slot, the bot runs with the default checkbox flags checked in the Manager UI.
• Auto-Exit: The stopTime is automatically passed to the bot executable as a runtime argument. The bot closes itself when the time is reached, eliminating manual process kills.
• API Configuration Forwarding: Key settings (such as API keys and price thresholds) are forwarded automatically from the current Manager config database.
• No Spaces in Delimiters: Ensure your scheduler configuration uses strict Tabs and not spaces. Some text editors automatically convert Tabs to spaces, which will break the scheduler parsing.

Quản lý API tập trung

ManagerBot quản lý và phân phối thẻ API tập trung cho các bot rảnh rỗi. Khác với phiên bản cũ khi các bot tự kết nối, phương pháp tập trung này giúp cân bằng tải tốt hơn và bảo mật hơn.

Cấu hình API slot: Để thêm slot, điền trang web (DGN/UBuy), User ID và API Key. Hệ thống sẽ tự động tạo ID để theo dõi.

Cài đặt ưu tiên & Vòng lặp

• Thứ tự ưu tiên: ManagerBot quét các slot API từ trên xuống dưới. Thay đổi độ ưu tiên bằng cách chọn dòng và dùng các nút **Move Up** / **Move Down**. Luồng quét chỉ được lưu sau khi bạn nhấn nút **Save API Config**.
• Thời gian chờ truy vấn (Poll Timeout): Thiết lập chu kỳ lặp (tính bằng mili-giây) để định cấu hình tần suất ManagerBot truy vấn dữ liệu từ DGN/UBuy.
• Cơ chế định tuyến bỏ qua trùng thẻ (Smart IgnoreHash Routing): Nếu kéo được thẻ nhưng bot được phân công trước đó đã mua từ chính khách hàng này, hệ thống sẽ tự động chuyển thẻ sang bot khác, tránh việc lặp lại mã ignore hash trùng lặp.

Cài đặt giới hạn hàng ngày

Quy định số lượng thẻ tối đa bot có thể mua thành công mỗi ngày cho cả chế độ thường và chế độ Vòng lặp (Cycle). Khi đạt giới hạn, Manager sẽ gửi tín hiệu NO_API để bot nghỉ ngơi. Giới hạn tự động reset trên toàn hệ thống vào lúc nửa đêm (00:00) mà không cần khởi động lại.

Auditing & Fail Reason Mapping

Track logs under the dedicated API Logs window. You can filter historical records by Date (e.g. 2026-04-11.json) and bot name. If a bot fails a purchase, specific codes (e.g. OutBid, Expired, TM_MaxTarget) are logged and reported back to DGN/UBuy.

Động cơ vận hành Worker & Bảo vệ hệ thống

• Vòng lặp mua nhanh (Multi-Buy Loop): Trong chế độ cycle API, bot sẽ nhanh chóng thử mua tối đa 5 lần liên tiếp trong một đợt API burst mà không cần chờ Manager phản hồi.
• Xác thực thời gian OCR thông minh: Khi có nhiều thẻ giống hệt nhau trên thị trường, bot sử dụng công cụ OCR để đối chiếu chính xác bộ đếm giờ hết hạn trên màn hình console với mốc thời gian của máy chủ.
• Thử lại thông minh (Smart Retries): Nếu thời gian hết hạn không khớp, bot tự động nhấn D-Pad sang phải (tối đa 4 lần) để quét các thẻ bên cạnh, đảm bảo mua đúng thẻ do API gửi.
• Tự động giải phóng (Watchdog Recovery): Nếu bot bị crash trong quá trình phân tích thẻ, mã khóa API sẽ tự động được giải phóng cưỡng chế sau đúng 3 phút.

Giải thích các checkbox nâng cao

Trận Rivals & Xác thực OCR PSN ID

Trên máy tính mới cấu hình, bạn cần kiểm tra xem tất cả PSN Online ID có được nhận diện chính xác bằng OCR hay không. Nếu OCR nhận diện sai PSN ID, hệ thống sẽ không nhận diện được tài khoản và không thể ghép trận tự động.

Tạo lại MatchData khi đổi tài khoản

Tại sao tài khoản bot mới bị kẹt lặp đi lặp lại ở menu L2?

Hãy kiểm tra xem tài khoản đã được mở chợ trên console chưa. Bot luôn tự động treo bán lại thẻ trong danh sách chuyển nhượng trước khi bắt đầu trận đấu. Nếu chợ trên console bị khóa, bot sẽ bị kẹt. Hãy bật ObjectUnlock2 để làm nhiệm vụ mở khóa chợ.

Quy trình mở khóa chợ WebApp: Tài khoản mới tinh cần hoàn thành 2 objective (New Begin, Venturing Out) qua ObjectUnlock2. Sau đó chạy hàng ngày 3 trận Squad Battle (tích chọn PlayUnlock, set UnlockMatch = 3 và MatchLimit = 3).

Chức năng của tab Acc Manage

Tab **Acc Manage** dùng để load thông tin tài khoản phục vụ cho AccLogin (đăng nhập acc phụ vào máy PS4), hỗ trợ tự động lấy Account ID từ PSN ID, và hỗ trợ copy nhanh url để pair.

Tích disableLoop khi pairing

Bot quản lý file pair ở riêng từng thư mục slot. Nếu bạn thực hiện pair thủ công khi các bot khác đang chạy, hãy tích chọn **disableLoop** trên ManagerBot trước để tránh xung đột ghi đè file cấu hình.

Phím điều khiển (Control Keys)

Tất cả các nút ở bảng Control là gửi lệnh nhấn nút đến tất cả các bot đang chạy. Bạn có thể bỏ tích **Select** ở các máy PS không muốn nhận lệnh.