Chat Bot (Discord và Telegram)

Chat bot kết nối Lords Bot với bot Discord hoặc Telegram của riêng bạn. Từ chat, bạn có thể xem tài khoản nào đang trực tuyến, khởi động và dừng tài khoản, lấy nhật ký và ảnh chụp màn hình, và nhận cảnh báo như khóa truy cập hết hạn. Thành viên Bang hội cũng có thể dùng Ngân hàng Bang hội từ chat.

Cách hoạt động #

1. Tạo bot của riêng bạn trên Discord hoặc Telegram và sao chép token của nó.
2. Kết nối: dán token vào Lords Bot và bấm Kết Nối (Connect).
3. Chọn đoạn chat: gửi !set trong kênh hoặc nhóm bạn muốn dùng. Bạn sẽ trở thành quản trị viên của chat bot.
4. Sử dụng: điều khiển tài khoản bằng lệnh, nhận cảnh báo, và cho Bang hội dùng ngân hàng từ chat.

Thiết lập chat bot #

Mở Cài Đặt > Tùy Chọn > Cài đặt khác (Settings > Options > Other Settings) trong cửa sổ chính và chuyển đến tab Chat Bot. Sau đó làm theo các bước cho Discord hoặc Telegram.

Discord #

1. Vào https://discord.com/developers/applications và tạo một ứng dụng mới.
2. Mở trang Bot của ứng dụng và sao chép token của bot. Hãy giữ bí mật token này.
3. Trên cùng trang đó, bật Message Content Intent. Lords Bot cần nó để đọc lệnh. Lưu thay đổi. Nếu nó đang tắt, Lords Bot sẽ dừng và báo lỗi nhắc bạn bật nó lên.
4. Trong Lords Bot, dán token vào Bot Token:, chọn Discord và bấm Kết Nối.
5. Khi trạng thái hiện Discord đã kết nối (Discord Connected), bấm Thêm bot vào Discord (Add Bot to Discord) và thêm bot vào máy chủ của bạn.

Mẹo: Nếu Discord báo tích hợp “requires code grant”, hãy quay lại developer portal và tắt tùy chọn OAuth2 code grant của bot.

Telegram #

1. Mở https://t.me/BotFather trong Telegram và gửi /newbot.
2. Chọn một tên, rồi một username kết thúc bằng bot. BotFather sẽ gửi cho bạn token của bot.
3. Gửi /setprivacy cho BotFather, chọn bot của bạn, và chọn Disable. Việc này cho phép bot đọc các tin nhắn bắt đầu bằng ! trong nhóm.
4. Trong Lords Bot, dán token vào Bot Token:, chọn Telegram và bấm Kết Nối.
5. Khi trạng thái hiện Telegram đã kết nối (Telegram Connected), bấm Thêm bot vào Telegram (Add Bot to Telegram) và thêm bot vào nhóm của bạn.

Riêng với Telegram, bạn có thể đánh dấu Dùng Proxy? (Use Proxy?) và chọn một proxy cho kết nối của chat bot.

Gán đoạn chat #

Lệnh chỉ hoạt động sau khi bạn liên kết bot với một đoạn chat:

1. Trong kênh Discord hoặc nhóm Telegram bạn muốn dùng, gửi !set (hoặc /set).
2. Bot trả lời Đã gán nhóm thành công! (Group assigned successfully!)

Đoạn chat nơi bạn gửi set giờ là đoạn chat của chat bot, và bạn là quản trị viên của nó. Chỉ quản trị viên mới dùng được các lệnh chat bot, và chỉ trong đoạn chat đó. Trên Discord, các lệnh còn xuất hiện dưới dạng lệnh gạch chéo (slash command) trong máy chủ đó sau khi bạn gửi set.

Quản trị viên của chat bot (người đã gửi set) không giống với người dùng được ủy quyền của Ngân hàng Bang hội. Những người đó được thêm riêng cho từng ngân hàng trong tab Người được ủy quyền (Authorized Users).

Để chuyển chat bot sang đoạn chat khác, gửi /cleargroup trong đoạn chat hiện tại, hoặc bấm Xóa dữ liệu (Clear Data) trong tab Chat Bot, rồi gửi lại set trong đoạn chat mới.

Các nút khác trong tab Chat Bot #

Mục	Tác dụng
Ngắt kết nối (Disconnect)	Ngắt kết nối chat bot.
Xem nhật ký (View Log)	Hiện nhật ký kết nối của chat bot. Hãy xem khi trạng thái báo Đã xảy ra lỗi, kiểm tra nhật ký (Something went wrong, check log).
Xóa dữ liệu	Quên đoạn chat và quản trị viên đã gán.
Đăng phiên bản mới lên chat (Post new versions in chat)	Đăng số phiên bản mới lên chat một lần khi có bản cập nhật. Mặc định: bật.
Ô thông tin	Hiện ID chat (Chat ID), ID quản trị (Admin ID) và, trên Discord, ID Bang hội (Guild ID), tức máy chủ của bạn.

Nếu chat bot không kết nối được, nó sẽ thử lại sau 15 giây rồi mỗi lần chờ lâu hơn, tối đa 5 phút một lần. Token sai, hoặc Message Content Intent của Discord đang tắt, sẽ làm nó dừng và báo lỗi thay vì thử lại.

Lệnh #

Chỉ quản trị viên của chat bot mới dùng được các lệnh này, trong đoạn chat đã gán bằng set. Lệnh có thể bắt đầu bằng /, ! hoặc ,. Trên Discord chúng cũng là lệnh gạch chéo, và ô tài khoản sẽ gợi ý tên tài khoản khi bạn gõ.

Trên Discord, lệnh gạch chéo chỉ hiện với thành viên máy chủ có quyền Quản lý máy chủ (Manage Server). Để hiện cho vai trò khác, mở Cài đặt máy chủ > Tích hợp (Server Settings > Integrations), chọn bot của bạn và cho phép vai trò đó. Ô tài khoản tìm theo bất kỳ phần nào của tên hoặc phần đầu IGG ID, và cho biết mỗi tài khoản có đang chạy không. Nếu một lệnh không dùng được, chỉ bạn thấy câu trả lời.

Trên Telegram, nhấn nút menu / cạnh ô nhập tin nhắn để chọn lệnh. Gửi /start, /stop, /restart, /info, /log hoặc /shortlog mà không kèm tài khoản thì bot sẽ trả lời bằng một nút cho mỗi tài khoản; nhấn vào một nút để chạy lệnh cho tài khoản đó.

Nếu ai đó không phải quản trị viên dùng lệnh, bot sẽ trả lời Bạn không có quyền dùng lệnh đó (You are not authorized to use that command). Ở bất kỳ đoạn chat nào khác, bot trả lời Lệnh Quản Trị chỉ dùng được trong đoạn chat đã dùng lệnh /Set. (Admin Commands can only be used in the chat where: /Set was used.) Ngoại lệ là /setcastle, quản trị viên có thể dùng lệnh này trong bất kỳ đoạn chat nào có bot.

Ngân hàng Bang hội trong chat #

Ngân hàng Bang hội có thể trả lời lệnh trong bất kỳ kênh Discord hay nhóm Telegram nào có chat bot của bạn, không chỉ đoạn chat quản trị. Lặp lại các bước sau cho từng ngân hàng.

Thêm ngân hàng vào đoạn chat (quản trị viên) #

Trong nhóm chat, gửi /setcastle kèm tên hoặc IGG ID của tài khoản ngân hàng, ví dụ /setcastle MyBank. Bot trả lời Tài khoản được chỉ định cho nhóm (Account Assigned to Chat). Để gỡ, gửi /unsetcastle MyBank trong đoạn chat quản trị của chat bot.

Đăng ký làm người dùng ngân hàng (từng người chơi) #

Mỗi người chơi liên kết tài khoản Discord hoặc Telegram của mình với tên trong game một lần:

1. Trong nhóm chat, gửi một lệnh ngân hàng như !bal. (Dùng tiền tố của ngân hàng nếu nó đã được đổi khác !.)
2. Bot trả lời Vui lòng gửi cho ngân hàng: kèm một lệnh như !reguser 123456789.
3. Gửi đúng lệnh đó cho ngân hàng trong game, qua chat Bang hội hoặc thư. Ngân hàng trả lời Đã đăng ký tài khoản mạng xã hội (Social account registered).
4. Gửi lại !bal trong nhóm chat. Bạn sẽ nhận được số dư của mình.

Giờ bạn có thể dùng mọi lệnh ngân hàng mà cấp bậc của bạn cho phép ngay từ chat. Để hủy liên kết, gửi !unreguser cho ngân hàng trong game. Xem Lệnh Ngân hàng Bang hội để biết danh sách đầy đủ.

Lưu ý: Lệnh chat bot được đọc trước. Một lệnh ngân hàng trùng tên với lệnh chat bot, như !stop, sẽ được coi là lệnh chat bot khi gửi trong chat. Hãy gửi những lệnh ngân hàng đó trong game.

Thông báo tài khoản #

Chat bot có thể đăng cảnh báo tài khoản lên đoạn chat quản trị. Bật chúng cho từng tài khoản: mở cửa sổ của tài khoản và vào Cài Đặt > Tổng Quan > Nâng Cao (Settings > General > Advanced), rồi đến nhóm Chat Bot. Bạn có thể dùng Cài đặt chung hoặc một mẫu để thiết lập nhiều tài khoản cùng lúc.

Tùy chọn	Nội dung được đăng
Đăng trạng thái lên Chatbot (Post Status in Chatbot)	Bật cảnh báo chat bot cho tài khoản này.
Khóa truy cập hết hạn (Access Key Expiry)	Khi khóa truy cập hết hạn, được làm mới, hoặc không làm mới được.
Thay đổi trạng thái kết nối (Connection Status Change)	Khi tài khoản ngoại tuyến (một lần mỗi lần mất kết nối), khi nó trở lại, và lần kết nối đầu tiên sau khi bạn khởi động nó.
Chỉ khi ngoại tuyến quá (phút) (Only after offline for (min))	Lớn hơn 0 thì chờ số phút này rồi mới đăng là tài khoản ngoại tuyến; kết nối lại trong thời gian đó sẽ không đăng gì. 0 đăng ngay.
Đăng nhập nơi khác (Other Login)	Khi có người khác đăng nhập vào tài khoản.
Trạng thái lịch trình (Schedule Status)	Khi một khoảng nghỉ theo lịch trình bắt đầu và kết thúc, và khi tài khoản đăng nhập trong lúc nghỉ để kiểm tra nhiệm vụ.
Sắp đạt giới hạn RSS (Nearing RSS limit)	Khi lương thực, đá, gỗ, quặng hoặc vàng đạt 4 tỷ, gần với giới hạn của game.
Đăng hợp quân / tấn công đến (Post incoming rallies / attacks)	Khi có hợp quân hoặc đợt tấn công nhắm vào lâu đài, kèm tag admin. Mỗi đợt tấn công một thông báo: thông báo tiếp theo chỉ đến khi tháp canh đã trống.
Tải thống kê lên (Upload Stats)	Đăng các báo cáo thống kê mà tài khoản này lưu (thống kê quà, danh sách Bang hội và thống kê Đại Hội Bang Phái, được bật trong trang Bang hội) dưới dạng file vào đoạn chat nơi tài khoản này được thêm bằng /setcastle. Chưa làm bước đó thì sẽ không có gì được đăng. Khi bật tùy chọn này, lệnh ngân hàng !stats all gửi từ đoạn chat đó cũng tải báo cáo lên dưới dạng file. Cài đặt chung và mẫu không thay đổi tùy chọn này: hãy bật nó ở từng tài khoản.

Khi Đăng trạng thái lên Chatbot đang bật, một số cảnh báo luôn được đăng, ví dụ khi tài khoản bị cấm hoặc bị đình chỉ, hoặc khi đạt giới hạn tài khoản của bạn.

Các cảnh báo đến cùng lúc được gửi thành một tin nhắn. Khi nhiều tài khoản có cùng một cảnh báo, nó được đăng một lần với danh sách tài khoản bên dưới.