Octera
Tài liệu
Octera hoạt động với lệnh gạch chéo (/command) và lệnh văn bản dùng tiền tố của máy chủ bạn (mặc định là .). Gần như mọi thứ cũng có thể cấu hình từ bảng điều khiển web.
.help <command> (ví dụ .help ban, .help eco) để xem một lệnh làm gì kèm ví dụ thật — hoặc .help <category> cho cả một nhóm. <command> help vẫn dùng được.Máy chủ Premium: trang Premium trên bảng điều khiển (thanh bên → Cài đặt) cho bạn thấy toàn cảnh gói đăng ký của máy chủ — gói nào, ngày gia hạn và ai đang trả tiền — kèm nút nâng cấp và quản lý ngay tại đó.
Tiền tố & trợ giúp
.help timeout/prefix set: ?/disable economy music warnKiểm duyệt
/timeout @user 10m spammingall dọn sạch kênh (và khóa kênh trong lúc dọn nếu kênh lớn), một con số sẽ xóa bấy nhiêu tin nhắn gần nhất, còn một khoảng thời gian (ví dụ 7d, 2mo) sẽ xóa trong khoảng đó. Thêm một người dùng để chỉ xóa tin nhắn của họ. Lưu ý: Discord không cho phép bot xóa hàng loạt tin nhắn cũ hơn 14 ngày..purge 50 · .purge 2mo · .purge allBảo mật
/security let-in @friend/lockdown end gỡ khóa và khôi phục lại tất cả./lockdown allTheo dõi độ nóng, bộ lọc raid & cổng vào, xác minh và captcha đều được cấu hình trên bảng điều khiển.
Cấp độ
Kinh tế
.games vẫn dùng được như một lối tắt.).buy lucky coin 3Vai trò & thành viên
/role add roles:@VIP @Booster user:@someone duration:7dTự động hóa
Automations (bảng điều khiển → Utilities → Automations) là các quy tắc kiểu “khi điều này xảy ra thì làm điều kia”: chọn một điều kiện kích hoạt (một tin nhắn được đăng, một biểu tượng cảm xúc được thả, một thành viên tham gia, một vai trò được thêm hoặc gỡ), thêm điều kiện tùy chọn (kênh, vai trò, từ khóa, tuổi tài khoản), rồi chạy tối đa 10 hành động theo thứ tự — gửi tin nhắn, embed hoặc DM, thêm hoặc gỡ vai trò, thả cảm xúc, xóa tin nhắn, hoặc mở một chủ đề. Bắt đầu từ các mẫu dựng sẵn như Welcomer, Keyword auto-reply và Auto-thread — tối đa 50 mỗi máy chủ, miễn phí.
Auto Send (bảng điều khiển → Utilities → Auto Send) đăng một tin nhắn lặp lại theo chu kỳ hoặc hằng ngày vào một giờ UTC cố định — chọn những ngày trong tuần nó chạy, thêm khung giờ gửi tùy chọn, bật chống ngập (bỏ qua một lượt gửi khi tin nhắn cuối của bot vẫn đang là mới nhất), hoặc gửi nó dưới dạng embed.
Sinh nhật
MM-DD hoặc YYYY-MM-DD. Thêm năm sinh nếu bạn muốn được chúc mừng cả tuổi./birthday set 10-12 · /birthday set 1993-12-16Bật thông báo trên bảng điều khiển (Tiện ích → Sinh nhật): chọn kênh, tùy chỉnh nội dung và nếu muốn thì trao một vai trò sinh nhật cho ngày hôm đó.
Thành tựu
Thiết lập chúng trên bảng điều khiển (Thành tựu): bật tính năng này để có sẵn một bộ khởi đầu, rồi thêm thành tựu của riêng bạn — mục tiêu đơn hoặc theo bậc Đồng → Kim cương dựa trên tin nhắn, lượt thả cảm xúc, thời gian thoại, chủ đề, lượt boost, lượt tham gia giveaway, lượt mua trong cửa hàng và sinh nhật, mỗi loại đều có thể kèm phần thưởng vai trò và thông báo mở khóa.
Lời mời
/invites user member: @friendTinh chỉnh trên bảng điều khiển (Lời mời): bỏ qua các tài khoản vừa lập như tài khoản ảo và tự động trao vai trò thưởng ở các mốc lời mời.
Giveaway
/giveaway create để có trình hướng dẫn từng bước./giveaway start duration: 1d prize: Nitro winners: 2Trình chỉnh sửa Giveaway trên bảng điều khiển còn đi xa hơn — lên lịch hoặc lặp lại giveaway, đặt điều kiện tham gia và lượt tham gia thưởng thêm, trao vai trò cho người thắng, tùy biến embed và lưu lại các mẫu cài sẵn.
Ticket
Tạo bảng ticket trên bảng điều khiển (module Tickets). Thành viên mở ticket từ nút trên bảng; nhân sự nhận và đóng ticket. Khi đóng, bản ghi hội thoại được lưu và đăng lại, kèm liên kết View Online Transcript để đọc ngay trong trình duyệt.
Tiện ích
/voice rename name: Gaming · /voice lockKênh thoại tạm thời (bảng điều khiển → Utilities → Voice) hoạt động theo kiểu vào-là-tạo: chọn một hoặc nhiều kênh thoại trung tâm, thành viên nào vào đó sẽ có kênh riêng ngay bên cạnh — và kênh đó tự động bị xóa khi không còn ai.
Chỉ dành cho người vận hành: /nuke channels, /nuke category và /restart là các lệnh bảo trì bị khóa cứng trong mã nguồn cho người vận hành bot — đội ngũ của máy chủ không thể chạy chúng.
Thông báo
Nhận thông báo mỗi khi một nhà sáng tạo đăng bài. Trên bảng điều khiển (Socials), hãy thêm nguồn cho YouTube, Twitch, Kick, TikTok, Reddit (bài mới của một subreddit), Podcast (tập mới từ nguồn RSS của một chương trình) hoặc bất kỳ URL Custom RSS nào — Octera đăng video mới, bài mới, tập mới và các buổi lên sóng vào kênh bạn chọn, kèm tin nhắn tùy chỉnh.
Nhạc
Phát nhạc trong kênh thoại với hàng chờ gọn gàng — không cần mời thêm bot nào khác. (Premium.)
Tìm bài hát theo tên, hoặc dán một liên kết — SoundCloud, Bandcamp, một podcast, một đài phát thanh trực tuyến, hoặc một URL âm thanh trực tiếp. Octera đọc được hầu hết các trang âm thanh và cho bạn biết bản nhạc đến từ đâu.
YouTube không khả dụng. YouTube chặn các yêu cầu phát đến từ nhà cung cấp dịch vụ lưu trữ — nơi mọi bot Discord đều chạy — nên liên kết YouTube bị từ chối thay vì được phát. Tìm theo tên bài hát vẫn hoạt động và sẽ phát từ các nguồn ở trên. Liên kết Spotify và Apple Music thì không bot nào phát được, vì âm thanh của chúng được mã hóa; hãy gửi tên bài hát thay vì liên kết.
.queue và .pause vẫn hoạt động.)Dịch thuật
Những thành viên không chung ngôn ngữ vẫn có thể trò chuyện trong cùng một kênh. Không ai phải làm gì khác thường: ai muốn đọc một tin nhắn thì thả cảm xúc lá cờ của ngôn ngữ mình, và Octera đăng bản dịch bằng ngôn ngữ đó ngay bên dưới.
/translate text text: where is the meeting to: Spanish/translate live from: Chinese to: EnglishThả cờ quốc gia. Thả biểu tượng cờ mà Octera nhận ra vào bất kỳ tin nhắn nào và nó sẽ trả lời kèm bản dịch. Nhiều người cùng thả một lá cờ vẫn chỉ tạo ra một câu trả lời, còn thả biểu tượng khác thì không có gì xảy ra.
Cả kênh. Trên bảng điều khiển, bạn có thể chọn một kênh và các ngôn ngữ được dùng trong đó, tối đa năm ngôn ngữ. Octera tự xác định mỗi tin nhắn cần dịch theo chiều nào, nên một người nói tiếng Tây Ban Nha và một người nói tiếng Anh cứ thế trò chuyện. Tin nhắn vốn đã ở một trong các ngôn ngữ đã liệt kê sẽ không bao giờ bị đăng lại bằng chính ngôn ngữ đó. Cách này hợp với kênh thường xuyên có hai ngôn ngữ song song; còn với nhu cầu thi thoảng thì thả cờ tiết kiệm hơn nhiều.
Dịch trực tiếp. Dành cho một người tham gia cuộc trò chuyện bằng ngôn ngữ họ không nói. Họ chạy /translate live một lần và mọi thứ họ gõ cũng được đăng bằng ngôn ngữ kia, cho đến khi họ chạy /translate off hoặc im lặng một lúc. Chủ máy chủ có thể tắt tính năng này trên bảng điều khiển.
Dịch thuật chạy trên một dịch vụ dịch bên ngoài, nên chủ máy chủ chỉ cần thiết lập một lần ở trang Dịch thuật trên bảng điều khiển. Khi chưa kết nối dịch vụ nào, trang sẽ nói rõ điều đó và không có gì được dịch. Các lần dịch lặp lại cùng một tin nhắn được lấy từ bộ nhớ đệm và không tốn phí, và bạn có thể đặt hạn mức ký tự hằng tháng cho cả máy chủ.
Sao lưu
Chụp lại cấu trúc máy chủ của bạn — vai trò, kênh, quyền và thiết lập — ngay từ bảng điều khiển. Thao tác khôi phục sẽ tạo lại những gì bị thiếu mà không xóa những gì đã có. Bản sao lưu không bao giờ bao gồm tin nhắn hay lịch sử trò chuyện.
Hướng dẫn: biến trong tin nhắn
Ở bất cứ đâu Octera viết một tin nhắn, bạn đều có thể chèn một biến — một chỗ giữ ngắn dạng {name} tự điền vào khi tin nhắn thật sự được gửi. Chúng hoạt động trong tin nhắn chào mừng và tạm biệt, embed, tự động trả lời, tag, tự động gửi, bảng reaction role, bảng ticket và hơn thế nữa — cùng một tên gọi ở mọi nơi.
Welcome {user.mention} to **{server}** — you're member #{server.members}!Viết bằng dấu chấm hoặc bằng dấu ngoặc đều được; cả hai là một: {user.name} = {user(name)}.
Thành viên
| Biến | Điền vào bằng |
|---|---|
| {user} | Tên của họ |
| {user.mention} | Một lượt @ping thật |
| {user.name} | Tên người dùng của họ |
| {user.nick} | Biệt danh của họ trong máy chủ này (tên người dùng nếu họ chưa đặt biệt danh) |
| {user.id} | ID Discord của họ |
| {avatar} | Ảnh đại diện của họ — thả vào ô ảnh hoặc ảnh thu nhỏ |
| {user.color} | Màu tên của họ, ví dụ #a93bf0 |
| {user.top_role} | Tên vai trò cao nhất của họ |
| {user.joinstamp} | Thời điểm họ tham gia, dưới dạng số dấu thời gian |
| {user.timestamp} | Thời điểm tài khoản của họ được tạo, dưới dạng số dấu thời gian |
{target} hoạt động y hệt với người đầu tiên được @nhắc đến trong một lệnh (nếu không có thì lấy người chạy lệnh) — rất tiện trong tag: {target.mention}, {target.avatar}.
Máy chủ & kênh
| Biến | Điền vào bằng |
|---|---|
| {server} | Tên máy chủ |
| {server.members} | Số thành viên |
| {server.ordinal} | Số thành viên dưới dạng thứ hạng — “thứ 42” |
| {server.icon} | Biểu tượng máy chủ — dùng được ở ô ảnh hoặc ảnh thu nhỏ |
| {server.id} | ID máy chủ |
| {server.description} | Mô tả máy chủ |
| {channel} | Tên kênh |
| {channel.mention} | Một liên kết #channel bấm được |
Hình ảnh từ biến
Các ô ảnh, ảnh thu nhỏ, biểu tượng tác giả và biểu tượng chân trang đều nhận một biến thay cho liên kết — nhờ vậy embed chào mừng có thể hiển thị chính ảnh đại diện của thành viên mới:
{avatar} vào ô thumbnail của embed chào mừng và mọi người mới vào đều thấy ảnh của chính mình ở góc. {server.icon} cũng hoạt động y như vậy.Mỗi ô đó cũng nhận một liên kết https:// thông thường, hoặc một lần Upload… thẳng từ máy tính của bạn — Octera lưu ảnh và dùng một liên kết vĩnh viễn, nên nó sẽ hoạt động mãi.
Điều nên biết
- Một biến không tồn tại sẽ được ghép với biến gần giống nhất thay vì báo lỗi — nếu có thứ gì hiển thị lạ, hãy đối chiếu chính tả với các bảng ở trên.
- Biến được điền vào lúc tin nhắn được gửi đi, nên bản xem trước trong bảng điều khiển sẽ hiển thị văn bản thô
{name}. - Tag và lệnh tùy chỉnh bổ sung logic lên trên những thứ này — xem cách dựng lệnh tag.
Vận hành máy chủ: những điều kỳ quặc của Discord đáng biết
Có vài thứ trong Discord hoạt động theo kiểu trông như lỗi nhưng thật ra không phải — hầu như chủ máy chủ nào cũng vướng phải vào lúc này hay lúc khác. Không điều nào trong số đó do Octera gây ra; cách khắc phục đều nằm trong chính cài đặt của Discord.
Tên người dùng hiển thị sai màu
Discord tô màu tên bằng vai trò cao nhất có màu. Vai trò để ở Mặc định (không màu) vốn được bỏ qua, nên một vai trò không màu mà bạn giữ trên cùng — thường là để tách riêng bạn trong danh sách thành viên — sẽ nhường màu lại cho một vai trò thấp hơn.
Đôi khi thì không. Discord vẫn giữ lại dữ liệu màu cũ của một vai trò ngay cả khi vai trò đó hiện ra là không màu, nên tên thành viên vẫn bị kẹt ở màu sai.
Buộc Discord đọc lại vai trò:
- Mở Cài đặt Máy chủ → Vai trò, chọn vai trò bị ảnh hưởng rồi vào Hiển thị.
- Đặt về Đơn sắc, chọn một màu nhìn thấy được rồi lưu lại.
- Mở lại chính vai trò đó, đặt về Mặc định (không màu) và lưu lại lần nữa.
- Nhấn Ctrl + R để tải lại Discord.
Vai trò giờ được tính là thực sự không màu: nó vẫn nằm trên cùng và vẫn hiển thị thành viên riêng, còn màu tên sẽ do vai trò kế tiếp bên dưới có màu đảm nhận.
Vương miện chủ sở hữu cạnh tên bạn đã biến mất
Vương miện biến mất khi một trong các vai trò của bạn bật cả hai tùy chọn sau cùng lúc:
- quyền Quản trị viên, và
- Hiển thị riêng thành viên của vai trò này tách khỏi các thành viên trực tuyến.
Để giữ vai trò của chính bạn hiển thị riêng ở trên cùng và lấy lại vương miện:
- Mở Cài đặt Máy chủ → Vai trò và chọn vai trò cá nhân đang được hiển thị riêng của bạn.
- Tắt Administrator cho vai trò đó — vẫn giữ bật Display role members separately.
- Nhấn Ctrl + R để tải lại Discord.
Hướng dẫn: dựng lệnh tag
Tag là những lệnh tiền tố tùy chỉnh do chính bạn viết, chạy bằng TagScript — một ngôn ngữ tạo mẫu nhỏ gọn với biến, logic, phép toán, yếu tố ngẫu nhiên và các khối điều khiển (xóa tin nhắn kích hoạt, gửi câu trả lời qua DM, thả cảm xúc, giới hạn theo vai trò, đính kèm embed và nhiều thứ khác). Mọi biến tin nhắn cũng dùng được ở đây.
Tạo một tag
Dùng /tag (hoặc bảng điều khiển → Tiện ích → Tag). Đặt tên và nội dung cho nó. Thành viên gọi nó bằng tiền tố của bạn, ví dụ .rules.
/tag name: hello content: Hey {user(mention)}, welcome to {server(name)}! 👋Chạy .hello → Chào @You, chào mừng đến với Octera! 👋
Biến
Mọi biến tin nhắn đều dùng được trong tag — {user.mention}, {server}, {avatar} và những biến còn lại. Tag còn có thêm vài biến riêng:
| Biến | Trả về |
|---|---|
| {args} | Toàn bộ nội dung gõ sau lệnh. {args(1)} = từ đầu tiên, {args(2)} = từ thứ hai… |
| {target(mention)} | Người được @nhắc đến đầu tiên trong tin nhắn (nếu không có thì lấy người chạy lệnh) — cùng các thuộc tính như {user} |
| {uses} | Số lần tag đã chạy |
| {unix} | Dấu thời gian unix hiện tại |
Logic, toán học & ngẫu nhiên
| Khối | Chức năng |
|---|---|
| {if(a==b):yes|no} | Điều kiện. Toán tử: == != > < >= <= |
| {any(a==b|c==d):yes|no} | any/or và all/and trên nhiều điều kiện |
| {math:2*(3+4)} | Phép toán (+ - * / % ^) |
| {random:a~b~c} | Chọn ngẫu nhiên một mục (phân tách bằng ~ hoặc ,) |
| {range:1-100} | Số nguyên ngẫu nhiên trong một khoảng |
| {=(name):value} | Đặt một biến; đọc lại sau bằng {name} |
| {lower} {upper} {replace(a,b):text} {length:text} | Công cụ xử lý văn bản |
Khối điều khiển (có tác dụng phụ)
| Khối | Tác dụng |
|---|---|
| {delete} | Xóa tin nhắn đã kích hoạt tag |
| {dm} | Gửi câu trả lời vào DM của người chạy lệnh |
| {react:✅,🎉} | Thả cảm xúc vào câu trả lời · {reactu:✅} thả vào tin nhắn kích hoạt |
| {redirect:#channel} | Gửi câu trả lời sang một kênh khác |
| {require(@Role)} / {blacklist(@Role)} | Chỉ cho phép / không bao giờ cho phép những vai trò hoặc kênh này dùng tag |
| {embed(title):Hi}{embed(description):...} | Dựng một embed đầy đủ (tiêu đề, mô tả, màu, ảnh, ảnh thu nhỏ, chân trang, trường) |
| {silent} | Chạy các tác vụ phụ của tag mà không gửi văn bản nào |
Ví dụ có lời giải
Hộp góp ý — xóa lệnh gốc, đăng một embed gọn gàng vào kênh:
{delete}{redirect:#suggestions}{embed(title):💡 Suggestion from {user(name)}}{embed(description):{args}}{embed(color):#a855f7}Tung đồng xu kèm thả cảm xúc:
{user(mention)} flips… **{random:Heads~Tails}**! {react:🪙}Thông báo chỉ dành cho nhân viên — giới hạn theo vai trò, không DM ai, đăng thẳng vào một kênh:
{require(@Staff):You can't use this.}{redirect:#announcements}📢 {args}Lời chào cá nhân hóa dùng mục tiêu được nhắc đến:
{=(msg):Welcome {target(mention)} — you're member #{server(member_count)}!}{if({args}==):Mention someone to welcome them.|{msg}}