📘 Tài liệu kỹ thuật & Hướng dẫn sử dụng chính thức

Hướng Dẫn Setup Thông Số Chạy Auto Chi Tiết

Từng bước thiết lập tiện ích Chrome Extension, kích hoạt bản quyền, chuẩn hóa cấu trúc Google Sheet, cài cầu nối Apps Script Bridge, cấu hình Telegram Bot báo động đòn đánh và bật giả lập sinh học chống ban.

Mục lục nhanh: 1. Cài Extension 2. Kích hoạt License 3. Cấu trúc Google Sheet 4. Apps Script Bridge 5. Telegram Bot Alert 6. Chống Ban Sinh Học 7. Tự động đăng nhập 8. Test Dry-Run & Bắn Thật
Bước 1

📦 Cài Đặt Extension Vào Trình Duyệt

Tiện ích chạy trực tiếp trên các trình duyệt Chromium (Chrome, Microsoft Edge, Cốc Cốc, Brave) trên cả hệ điều hành Windows và macOS.

💡 File cài đặt: Bạn sẽ nhận được file đóng gói travian-wave-commander-v1.0.0.zip từ Telegram @namnguyen63 hoặc tải từ bộ cài phát hành.
  1. Giải nén file ZIP: Nhấp chuột phải vào file travian-wave-commander-v1.0.0.zip → chọn Extract Here hoặc Giải nén ra thư mục (ví dụ đặt tên thư mục là TravianAuto).
  2. Mở trang Quản lý Tiện ích: Mở Chrome/Edge, gõ vào thanh địa chỉ:
    chrome://extensions
  3. Bật chế độ nhà phát triển: Gạt công tắc "Chế độ dành cho nhà phát triển" (Developer mode) ở góc trên bên phải màn hình sang BẬT (ON).
  4. Tải tiện ích: Nhấp vào nút "Tải tiện ích đã giải nén" (Load unpacked) ở góc trên bên trái, sau đó trỏ đến đúng thư mục TravianAuto vừa giải nén.
  5. Ghim icon: Bấm vào biểu tượng mảnh ghép trên thanh công cụ trình duyệt và Ghim (Pin) icon Wave Commander (Vendor: Soneg) để mở popup bất cứ lúc nào.
Bước 2

🔐 Kích Hoạt License Bản Quyền (Ed25519)

Mỗi tài khoản game được cấp một License Key ký số riêng biệt. License này gắn chặt với Tên tài khoản (Account Name), Server / World và Thời hạn sử dụng.

Mẫu License Key ký số hợp lệ
TW1-eyJ2IjoxLCJjdXN0b21lcklkIjoiUENELVZJUCIsImFjY291bnROYW1lIjoiUENEI1ZOIiwid29ybGQiOiJ0czMxLngzLmV1cm9wZSIsInBsYW4iOiJwcmVtaXVtIiwiaXNzdWVkQXQiOiIyMDI2LTA5LTA5VDA0OjUxOjM0Ljg4MVoiLCJleHBpcmVzQXQiOiIyMDI3LTA5LTA5VDA0OjUxOjM0Ljg4MVoiLCJub25jZSI6ImNiYzllOTgzMzk2NDEyMGQ0Zjg0ZDQyMTdlM2MyN2U1In0.G5k-VGcTPqJTPEmYhOqEwkLvlFlh_2C4kY2pb0hskYI48nqIpTZytTV7uhQMELFMVwZtls--4h8TnTK-5IBYBw

Cách dán và kích hoạt:

  1. Bấm mở icon Extension → chuyển sang Tab ⚙️ Cài Đặt.
  2. Tìm ô Mã Bản Quyền (License Key) → bấm nút "Dán" hoặc nhấn Ctrl + V dán chuỗi license vào.
  3. Bấm nút "Lưu cấu hình".
  4. Kiểm tra kết quả: Ở góc trên của Popup, Badge sẽ chuyển từ "Chưa kích hoạt" sang "ĐÃ KÍCH HOẠT" kèm đầy đủ tên nick game, server mục tiêu và số ngày còn lại.
⚠️ Lưu ý quan trọng: Tên tài khoản trong License phải trùng khớp 100% (không phân biệt hoa/thường nhưng phải đúng ký tự) với cột Account trong file Google Sheet.
Bước 3

📊 Cấu Trúc Google Sheet Chuẩn

File Google Sheet là nơi bạn hoặc chỉ huy liên minh lên danh sách các đợt lệnh bắn sóng. Tiện ích sẽ đọc trực tiếp dữ liệu từ Sheet này.

Bảng quy định 23 cột chuẩn của Sheet:

Cột Tên Cột Loại Ví Dụ Giải Thích Chi Tiết
A STT Tùy chọn 1 Số thứ tự để dễ nhìn.
B Account Bắt buộc PCD#VN Tên tài khoản game (phải khớp với tên trong License Key).
C Làng xuất phát Tùy chọn 01.CAP Tên làng nguồn để ghi nhớ.
D | E X nguồn | Y nguồn Bắt buộc -10 | 25 Toạ độ làng bắn. Tiện ích dùng toạ độ này để tự động chuyển đúng làng!
F Mục tiêu Tùy chọn Enemy WW Tên làng địch / mục tiêu.
G | H X đích | Y đích Bắt buộc -149 | -1 Toạ độ đích đến cần tấn công.
I Loại Bắt buộc attack / raid / reinforce Loại lệnh gửi quân (attack = Tấn công thường, raid = Cướp phá, reinforce = Viện trợ).
J .. T t1 .. t11 Bắt buộc t1=100, t8=4 Số lượng lính từng chủng loại. t8 là Xe bắn đá (Catapult), t7 là Xe đục thành (Ram).
U Time xuất phát Bắt buộc 14:59:00 Thời gian xuất phát (định dạng HH:MM:SS hoặc YYYY-MM-DD HH:MM:SS).
V Time chạm Tùy chọn 15:30:00 Thời gian chạm mục tiêu để kiểm tra.
W Trạng thái Bắt buộc Chờ Để chạy, điền là Chờ. Tiện ích khi gửi xong sẽ tự đổi thành Đã gửi hoặc Lỗi.
🔗 Mở quyền chia sẻ Sheet: Trên file Google Sheet, bấm nút Chia sẻ (Share) ở góc trên bên phải → chọn "Bất kỳ ai có đường liên kết" (Anyone with the link) quyền Người xem (Viewer) hoặc Người chỉnh sửa (Editor).

Cách dán link vào Tool: Mở trang tính Google Sheet của bạn trên trình duyệt, copy toàn bộ URL trên thanh địa chỉ (ví dụ: https://docs.google.com/spreadsheets/d/1BxiMVs0XR.../edit#gid=0) và dán vào ô Link Google Sheet trong Tab Cài Đặt, sau đó bấm "Đồng bộ Sheet".

Bước 4

⚡ Cài Đặt Google Apps Script Bridge (Tùy Chọn Khuyên Dùng)

Nếu bạn muốn tiện ích tự động ghi kết quả ngược về Sheet (đánh dấu dòng đó thành Đã gửi kèm thời gian chính xác mili-giây hoặc ghi nhận Lỗi: Thiếu lính), bạn hãy cài đặt cầu nối Apps Script Bridge này.

  1. Trên file Google Sheet của bạn, trên thanh menu bấm: Tiện ích mở rộng (Extensions) → Apps Script.
  2. Xóa hết code mặc định trong trình soạn thảo, copy toàn bộ đoạn mã bên dưới và dán vào:
Code.gs — Google Apps Script Bridge
// Google Apps Script Web App Bridge cho Travian Wave Commander function doGet(e) { try { var p = e.parameter || {}; var action = p.action || 'read'; var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); if (action === 'mark') { var row = parseInt(p.row, 10); var status = p.status || 'Đã gửi'; var detail = p.detail || ''; if (row >= 2) { sheet.getRange(row, 23).setValue(status); // Cột W: Trạng thái if (detail) sheet.getRange(row, 24).setValue(detail); // Cột X: Ghi chú } return ContentService.createTextOutput(JSON.stringify({ ok: true, row: row, status: status })) .setMimeType(ContentService.MimeType.JSON); } return ContentService.createTextOutput(JSON.stringify({ ok: true })) .setMimeType(ContentService.MimeType.JSON); } catch (err) { return ContentService.createTextOutput(JSON.stringify({ ok: false, error: err.toString() })) .setMimeType(ContentService.MimeType.JSON); } }
  1. Bấm nút Triển khai (Deploy) ở góc trên bên phải → chọn Tùy chọn triển khai mới (New deployment).
  2. Tại mục Chọn loại (Select type), bấm biểu tượng bánh răng ⚙️ và chọn Ứng dụng web (Web app).
  3. Quan trọng:
    • Mục Thực thi dưới dạng (Execute as): Chọn Tôi (Me).
    • Mục Ai có quyền truy cập (Who has access): Chọn Bất kỳ ai (Anyone).
  4. Bấm Triển khai (Deploy) và cấp quyền truy cập tài khoản Google nếu có hỏi.
  5. Copy link URL dạng: https://script.google.com/macros/s/AKfycb.../exec và dán vào ô Link Google Apps Script Bridge trong Tab Cài Đặt của tiện ích.
Bước 5

🚨 Cấu Hình Telegram Bot Cảnh Báo Tấn Công (Tab Monitor)

Hệ thống tự động phát hiện đòn địch bay tới làng và gửi tin nhắn cảnh báo tức thì về Telegram cá nhân hoặc Group chat liên minh.

5.1. Tạo Telegram Bot (Lấy Bot Token):

  1. Mở ứng dụng Telegram, tìm kiếm bot có tên @BotFather (có dấu tích xanh xác nhận).
  2. Bấm Start và gõ lệnh: /newbot.
  3. Nhập tên cho Bot (ví dụ: My Travian Alert).
  4. Nhập username cho Bot kết thúc bằng chữ bot (ví dụ: mytravian_alert_bot).
  5. BotFather sẽ trả về chuỗi HTTP API Token dạng:
    7123456789:ABCdefGHIjklMNOpqrsTUVwxyz123456789

5.2. Lấy Chat ID hoặc Group ID:

  • Nhận báo tin nhắn cá nhân: Tìm bot @userinfobot trên Telegram, bấm Start. Bot sẽ gửi lại cho bạn một số ID (ví dụ: 123456789). Nhớ bấm Start bot vừa tạo ở bước 5.1 trước!
  • Nhận báo tin nhắn vào Nhóm liên minh: Mời Bot vừa tạo vào Group chat của liên minh, sau đó add bot @getidsbot vào để lấy Group ID (thường có dấu trừ phía trước, ví dụ: -1001234567890).

5.3. Cài đặt vào Extension & Thử nghiệm (Test Alert):

  1. Mở popup tiện ích → chuyển sang Tab 🚨 Monitor.
  2. Dán Token vào ô Telegram Bot Token.
  3. Dán ID vào ô Chat ID hoặc Group ID.
  4. Điền Tiền tố (Prefix), ví dụ: [TWC-Alert].
  5. Bấm nút "🔔 Test Alert (Gửi thử)". Nếu cấu hình đúng, Telegram của bạn sẽ reo chuông và nhận được tin nhắn thử nghiệm ngay lập tức!
  6. Bấm "💾 Lưu Cấu Hình Monitor" và gạt công tắc "Bật tự động quét đòn tấn công" sang BẬT.
Bước 6

🛡️ Cấu Hình Chống Ban & Giờ Ngủ Sinh Học

Travian theo dõi hành vi cày cuốc 24/7 và click chuột lặp đi lặp lại. HumanAutoT cung cấp hệ sinh thái giả lập con người đỉnh cao.

Thông số Gợi ý cài đặt Cơ chế bảo vệ
Bật giờ ngủ sinh học BẬT (ON) Tự động tạm ngừng Farm List, Hero, Tiệc CP trong lúc ngủ để không cày đêm bất thường.
Giờ ngủ & Thức dậy 23:30 đến 06:30 Khung giờ nghỉ ngơi mô phỏng lịch sinh hoạt của người chơi thực tế.
Độ lệch ngủ (Sleep Drift) ±20 phút Mỗi ngày tiện ích tự động lệch ngẫu nhiên vài chục phút, không bao giờ ngủ/dậy đúng boong từng phút cố định.
Nghỉ giải lao (Coffee break) BẬT (ON) Cứ sau 2.5 giờ hoạt động sẽ tự nghỉ 20 phút (mô phỏng người rời máy đi ăn uống, nghỉ ngơi).
Giả lập thao tác con người BẬT (ON) Ngập ngừng ngẫu nhiên 0.8s - 2.5s trước khi bấm nút; click lệch tâm nút 20%-80%; gõ phím từng ký tự.
Ngoại lệ Bắn Sóng BẬT (ON) Nếu đến giờ xuất phát của lệnh Bắn Sóng quan trọng trên Sheet, tool vẫn tự động bắn kể cả đang trong giờ ngủ.
Bước 7

🔐 Tự Động Đăng Nhập Lại (Auto-Relogin)

Khi phiên chơi bị hết hạn hoặc văng ra màn hình đăng nhập, tiện ích sẽ tự động điền lại tài khoản để không làm gián đoạn kế hoạch.

  1. Vào Tab ⚙️ Cài Đặt → cuộn tới thẻ 🔐 Tự Động Đăng Nhập Lại.
  2. Gạt công tắc sang BẬT (ON).
  3. Điền đúng Tên đăng nhập (Username) và Mật khẩu (Password) của nick game.
  4. Bấm "Lưu đăng nhập" (Dữ liệu lưu trữ cục bộ an toàn 100% trên máy của bạn).
  5. Bấm "⚡ Thử đăng nhập" để kiểm tra cơ chế điền tự động.
🛡️ Cơ chế chống bẫy Captcha: Nếu game xuất hiện bài kiểm tra Captcha giải bằng tay, tiện ích sẽ ngay lập tức dừng lại và hiển thị cảnh báo để bảo vệ nick của bạn an toàn tuyệt đối, không bị hệ thống quét spam.
Bước 8

⚡ Kiểm Tra An Toàn (Dry-Run) & Bắn Thật

Trước khi đến giờ tác chiến thật, bạn nên dùng chế độ mô phỏng để an tâm tuyệt đối.

🛡️ Chế Độ Test Dry-Run (Mô Phỏng)

Khi bật Dry-Run hoặc bấm nút "🛡️ Test" trên từng dòng: Tool sẽ tự mở tab, chọn đúng làng nguồn, điền toạ độ và quân số, chuyển sang Bước 2 xác nhận để bạn nhìn tận mắt nhưng KHÔNG bấm nút gửi quân thật. Cực kỳ an toàn khi test lệnh mới!

⚡ Bắn Thật Ngay (Live Send)

Khi Auto-Pilot bật (hoặc bấm nút "⚡ Bắn"): Đúng giờ xuất phát, tiện ích tự động click nút xác nhận màu xanh để quân đội lên đường chính xác từng mili-giây.

Đã sao chép vào bộ nhớ tạm ✓