English Version

See here

Giới thiệu chung

Chào mừng bạn đến với Bot Nối Từ Discord, một bot thú vị và tương tác được thiết kế để nâng cao sự tham gia của người dùng trong máy chủ Discord của bạn! Bot này được phát triển bằng ngôn ngữ JavaScript, sử dụng thư viện discord.js để tích hợp với Discord.

Bot Nối Từ Là Gì?

Bot Nối Từ là một bot độc đáo cho phép người dùng tham gia vào trò chơi nối từ, trong đó các từ phải được kết nối dựa trên chữ cái cuối cùng của từ trước. Đây là một cách tuyệt vời để thử thách bạn bè và kiểm tra kỹ năng từ vựng trong khi vui vẻ trên máy chủ của bạn.

Tính Năng Chính

Trò Chơi Nối Từ: Tham gia vào trò chơi trong đó người chơi phải nối từ với nhau. Yêu cầu là từ mới phải bắt đầu bằng chữ cái cuối cùng của từ trước!
Tương Tác Thực Thời: Bot phản hồi nhanh chóng với các lệnh, đảm bảo trải nghiệm mượt mà và thú vị cho tất cả người dùng.
Cài Đặt Dễ Dàng: Được xây dựng bằng JavaScript và discord.js, bot dễ dàng thiết lập và tích hợp vào máy chủ của bạn.

Ví Dụ Về Các Lệnh

!!noitu – Bắt đầu trò chơi mới.
!!resetnoitu – Cài đặt lại trò chơi.
Sẽ cập nhật thêm...

Cài đặt

Tải Project từ GitHub về máy:
- Cách 1: Từ trang của dự án trên GitHub:
  - Truy cập trang GitHub của dự án.
  - Nhấp vào nút "Code" và chọn "Download ZIP" để tải về toàn bộ mã nguồn dưới dạng file ZIP.
  - Truy cập vào thư mục chứa file tải xuống
  - Giải nén file ZIP vào thư mục mong muốn trên máy tính của bạn.
  - Tìm hiểu cách giải nén
- Cách 2: Sử dụng Git để clone repository:
  - Mở terminal hoặc command prompt.
  - Điều hướng đến thư mục nơi bạn muốn lưu dự án.
  - Chạy lệnh sau để clone repository:
```
git clone <URL_repository>
```
    (Thay <URL_repository> bằng URL của repository trên GitHub, ví dụ: https://github.com/username/repository.git).
  - Di chuyển vào thư mục dự án vừa được clone:
```
cd <tên_thư_mục>
```
    (Thay <tên_thư_mục> bằng tên thư mục của dự án).
Cài đặt IDE hoặc Text Editor:
- Sử dụng Text Editor Visual Studio Code (VS Code):
  - Tải và cài đặt từ trang web chính thức Visual Studio Code.
  - Cài đặt các tiện ích mở rộng cần thiết để hỗ trợ phát triển JavaScript.
  - Xem chi tiết cách cài đặt VS Code tại đây.
  - Khuyến khích sử dụng VS Code vì nó dễ sử dụng :))
- Sử dụng các Text Editor hoặc IDE khác nếu bạn thấy phù hợp:
  - WebStorm
  - Sublime Text
  - Atom
  - Brackets
  - Eclipse
  - Notepad++
Cài đặt môi trường:
- Cài đặt Node.js:
  - Tải và cài đặt Node.js từ trang web chính thức Node.js. Chọn phiên bản LTS (Long Term Support) để đảm bảo tính ổn định.
  - Kiểm tra cài đặt Node.js bằng cách mở terminal hoặc command prompt và gõ lệnh:
```
node -v
```
    và
```
npm -v
```
  - Đảm bảo rằng các phiên bản của Node.js và npm (Node Package Manager) đã được cài đặt thành công.
  - Tham khảo thêm về cách cài đặt môi trường tại đây
Truy cập dự án trên VS Code:
- Cách 1:
  - Mở Visual Studio Code (VS Code).
  - Chọn "File" từ menu trên cùng.
  - Chọn "Open Folder...".
  - Điều hướng đến thư mục chứa dự án mà bạn đã tải về hoặc clone từ GitHub.
  - Chọn thư mục dự án và nhấp vào "Select Folder" (hoặc "Open" trên macOS).
  - Dự án của bạn sẽ được mở trong VS Code.
- Cách 2:
  - Kéo và thả thư mục dự án từ File Explorer (Windows) hoặc Finder (macOS) vào cửa sổ VS Code.
  - VS Code sẽ tự động mở thư mục dự án và hiển thị nội dung của nó trong giao diện.
- Cách 3:
  - Mở terminal tích hợp trong VS Code bằng cách nhấn Ctrl + `` (hoặc Cmd + `` trên macOS).
  - Sử dụng lệnh cd để điều hướng đến thư mục chứa dự án.
```
cd <tên_thư_mục>
```
  - Chạy lệnh sau để mở thư mục dự án trong VS Code:
```
code .
```
  - Dự án sẽ được mở trong một cửa sổ mới của VS Code.
- Cách 4:
  - Mở File Explorer (Windows) hoặc Finder (macOS).
  - Điều hướng đến thư mục chứa dự án.
  - Nhấp chuột phải vào thư mục dự án.
  - Chọn "Open with Code" từ menu.
  - Thư mục dự án sẽ được mở trong VS Code.
- Tìm hiểu thêm về cách sử dụng VS Code

Chỉnh sửa trạng thái

Truy cập vào file bot.mjs

Chỉnh sửa trạng thái (status) của bot:
- Trạng thái:
  - status: 'online': Bot hoạt động bình thường (xanh lá).
  - status: 'idle': Bot không hoạt động hoặc đang chờ đợi (vàng).
  - status: 'dnd': Bot bận, không muốn bị làm phiền (đỏ).
  - status: 'invisible': Bot ẩn, không hiển thị trạng thái trực tuyến.
- Hoạt động:
  - type: ActivityType.Playing: Bot đang chơi một trò chơi.
  - type: ActivityType.Listening: Bot đang nghe một thứ gì đó.
  - type: ActivityType.Watching: Bot đang theo dõi một cái gì đó.
  - type: ActivityType.Streaming: Bot đang phát trực tiếp.
  - type: ActivityType.Competing: Bot đang tham gia vào một cuộc thi hoặc sự kiện.
- Custom Status:
  - name: Tên trạng thái bạn muốn hiển thị, ví dụ: "waiting for love".
  - type: Loại hoạt động của trạng thái, thay thế với một trong các giá trị sau:
    - ActivityType.Playing để chơi một trò chơi.
    - ActivityType.Listening để nghe một cái gì đó.
    - ActivityType.Watching để theo dõi một cái gì đó.
    - ActivityType.Streaming để phát trực tiếp.
    - ActivityType.Competing để tham gia vào một cuộc thi hoặc sự kiện.
  - url: URL để sử dụng khi type là ActivityType.Streaming. Nếu không phải Streaming, trường này có thể bỏ trống.

client.user.setPresence({
  status: 'idle', // Thay thế với trạng thái bạn muốn: 'online', 'idle', 'dnd', 'invisible'
  activities: [{
      name: 'waiting for love', // Thay thế với tên trạng thái bạn muốn hiển thị
      type: ActivityType.Watching, // Thay thế với loại hoạt động bạn muốn: PLAYING, LISTENING, WATCHING, STREAMING, COMPETING
      url: '' // Thêm URL nếu loại hoạt động là STREAMING, nếu không thì để trống
  }],
});

Lấy và thay thế TOKEN

Lấy TOKEN Discord

Truy cập vào Discord Developer Portal.
Đăng nhập bằng tài khoản Discord của bạn nếu chưa đăng nhập.
Chọn ứng dụng bot của bạn từ danh sách các ứng dụng.
Vào phần Bot trong menu bên trái.
Nhấp vào nút Copy dưới mục TOKEN để sao chép TOKEN của bạn. Lưu ý: Đừng chia sẻ TOKEN này với bất kỳ ai vì nó có thể cho phép người khác điều khiển bot của bạn.

Bật các Intent cần thiết

Trong cùng trang của ứng dụng bot, chuyển đến phần Bot.
Tìm mục Privileged Gateway Intents.
- Presence Intent:
  - Bật Presence Intent để bot có thể nhận các sự kiện cập nhật trạng thái người dùng.
  - Chú ý: Khi bot của bạn đạt 100 hoặc nhiều hơn server, việc bật tính năng này sẽ yêu cầu xác minh và phê duyệt từ Discord. Xem thêm chi tiết tại đây.
- Server Members Intent:
  - Bật Server Members Intent để bot có thể nhận các sự kiện liên quan đến thành viên trong server.
  - Chú ý: Khi bot của bạn đạt 100 hoặc nhiều hơn server, việc bật tính năng này sẽ yêu cầu xác minh và phê duyệt từ Discord. Xem thêm chi tiết tại đây.
- Message Content Intent:
  - Bật Message Content Intent để bot có thể nhận nội dung tin nhắn trong hầu hết các tin nhắn.
  - Chú ý: Khi bot của bạn đạt 100 hoặc nhiều hơn server, việc bật tính năng này sẽ yêu cầu xác minh và phê duyệt từ Discord. Xem thêm chi tiết tại đây.

Thay thế TOKEN vào mã nguồn

Mở tệp mã nguồn của bot (ví dụ: bot.mjs).
Tìm dòng chứa client.login('YOUR_BOT_TOKEN');.
Thay thế 'YOUR_BOT_TOKEN' bằng TOKEN mà bạn đã sao chép từ Discord Developer Portal:

client.login('YOUR_BOT_TOKEN'); // Thay thế YOUR_BOT_TOKEN thành token bot của bạn

Cách mời bot vào server Discord

1. Tạo URL mời bot

Truy cập vào Discord Developer Portal.
Đăng nhập bằng tài khoản Discord của bạn nếu chưa đăng nhập.
Chọn ứng dụng bot của bạn từ danh sách các ứng dụng.
Trong menu bên trái, chọn OAuth2.
Chọn tab URL Generator dưới phần OAuth2.

2. Cấu hình quyền và phạm vi

Chọn phạm vi (Scopes):
- Đánh dấu chọn bot. Đây là phạm vi cần thiết để thêm bot vào server.
Chọn quyền (Bot Permissions):
- Trong phần Bot Permissions, chọn các quyền mà bot của bạn cần để hoạt động. Ví dụ:
  - Send Messages: Để gửi tin nhắn.
  - Read Message History: Để đọc lịch sử tin nhắn.
  - Manage Messages: Để quản lý tin nhắn (xóa, ghim, v.v.).
  - View Channels: Để xem các kênh.
  - Attach Files: Để gửi tệp đính kèm.
  - Add Reactions: (Phản ứng) thêm biểu cảm vào các tin nhắn trong các kênh mà bot có quyền truy cập.
  - Chọn các quyền khác nếu cần.
  - Khuyến khích chọn quyền Administrator

3. Tạo và sao chép URL

Sau khi đã cấu hình các phạm vi và quyền, cuộn xuống dưới để thấy URL mời bot được tạo ra.
Sao chép URL này.

4. Mời bot vào server

Mở một trình duyệt web và dán URL mà bạn đã sao chép vào thanh địa chỉ.
Bạn sẽ được yêu cầu chọn server nơi bạn muốn mời bot vào.
Chọn server từ danh sách thả xuống mà bạn có quyền quản lý (quyền quản trị hoặc quyền tương đương).
Nhấp vào Authorize để gửi lời mời bot.
Hoàn tất quá trình bằng cách giải CAPCHA nếu có yêu cầu.

5.Kiểm tra quyền của bot

Đảm bảo bot có đủ quyền truy cấp vào các kênh.
Đảm bảo bot có thể xem tin nhắn,thêm phản ứng,...

Mở Terminal và cài đặt npm packages trên Visual Studio Code

1. Mở Terminal trong Visual Studio Code

Mở Visual Studio Code:
- Khởi động Visual Studio Code từ Desktop hoặc từ menu Start (Windows) / Applications (macOS).
Mở Terminal:
- Cách 1: Sử dụng phím tắt:
  - Nhấn `Ctrl + `` (phím backtick, nằm ngay dưới phím Esc trên bàn phím) để mở terminal.
- Cách 2: Sử dụng menu:
  - Vào menu Terminal ở thanh công cụ trên cùng.
  - Chọn New Terminal từ danh sách thả xuống.

2. Cài đặt npm packages

Xác nhận Node.js và npm đã được cài đặt:
- Trong terminal, gõ các lệnh sau để kiểm tra phiên bản Node.js và npm:
```
node -v
npm -v
```
- Nếu bạn thấy thông tin phiên bản, có nghĩa là Node.js và npm đã được cài đặt. Nếu không, bạn cần cài đặt Node.js từ trang web chính thức.
Điều hướng đến thư mục dự án:
- Sử dụng lệnh cd để điều hướng đến thư mục chứa dự án của bạn. Ví dụ:
```
cd đường_dẫn_tới_thư_mục_dự_án
```
Cài đặt các package cần thiết:
- Đảm bảo rằng bạn đã có một tệp package.json trong thư mục dự án. Tệp này chứa danh sách các package mà bạn cần cài đặt.
- Chạy lệnh sau để cài đặt tất cả các package được liệt kê trong package.json:
```
npm install
```
- Nếu bạn muốn cài đặt một package cụ thể, sử dụng lệnh:
```
npm install tên-package
```
  Ví dụ, để cài đặt discord.js, bạn sẽ chạy:
```
npm install discord.js
```
Kiểm tra các package đã cài đặt:
- Các package sẽ được cài đặt trong thư mục node_modules và danh sách các package sẽ được cập nhật trong tệp package.json và package-lock.json.

3. Kiểm Tra Hoạt Động

Kiểm Tra Các Package Đã Cài:
- Bạn có thể kiểm tra các package đã được cài đặt bằng lệnh:
```
npm list
```
- Lệnh này sẽ liệt kê tất cả các package và phiên bản của chúng.
Kiểm Tra Phiên Bản Node.js và npm:
- Để đảm bảo bạn đang sử dụng phiên bản Node.js và npm đúng, bạn có thể kiểm tra phiên bản của chúng bằng các lệnh sau:
```
node -v
npm -v
```

Hướng Dẫn Sử Dụng Terminal Để Chạy Bot Discord Bằng Node.js Trên VS Code

1. Mở Dự Án và Terminal

Mở VS Code:
- Khởi động Visual Studio Code trên máy tính của bạn.
Mở Dự Án:
- Mở dự án bot Discord của bạn bằng cách chọn File -> Open Folder... và điều hướng đến thư mục chứa dự án.
Mở Terminal:
- Nhấn tổ hợp phím `Ctrl + `` (dấu huyền) để mở Terminal trong VS Code.
- Hoặc bạn có thể mở Terminal bằng cách vào menu Terminal -> New Terminal.

2. Chạy Bot Discord

Chuyển Đến Thư Mục Dự Án:
- Nếu bạn chưa ở trong thư mục dự án của mình, hãy sử dụng lệnh cd trong Terminal để chuyển đến thư mục chứa dự án:
```
cd đường_dẫn_đến_thư_mục_dự_án
```
Chạy Bot Bằng Node.js:
- Để khởi chạy bot Discord, bạn sử dụng lệnh node để chạy file chính của bot.File chính là bot.mjs Ví dụ:
```
node bot.mjs
```
  hoặc
```
node .
```
- Sau khi lệnh này được thực thi, bot của bạn sẽ hoạt động và bạn sẽ thấy thông báo trạng thái trong Terminal (nếu bot được cấu hình để in ra các trạng thái khi chạy).

3. Kiểm Tra Hoạt Động Của Bot

Kiểm Tra Thông Báo Từ Bot:
- Trong Terminal, bạn sẽ thấy các dòng thông báo khi bot của bạn khởi chạy thành công, chẳng hạn như:
```
Ready!
Bot Started
Logged in as BotName#1234!
```
Kết Nối Bot Với Server Discord:
- Đảm bảo rằng bạn đã thêm bot của mình vào server Discord bằng cách tạo một URL mời và cấp quyền cho bot.
- Khi bot chạy thành công, nó sẽ bắt đầu hoạt động trên server mà bạn đã mời nó vào.
Dừng Bot:
- Nếu bạn muốn dừng bot, bạn có thể nhấn tổ hợp phím Ctrl + C trong Terminal.

4. Debug và Xử Lý Lỗi

Kiểm Tra Lỗi:
- Nếu bot không hoạt động như mong đợi hoặc gặp lỗi, các thông báo lỗi sẽ xuất hiện trong Terminal. Bạn có thể kiểm tra lỗi để biết cần sửa lỗi nào.
Chỉnh Sửa Mã Lỗi:
- Nếu gặp lỗi, hãy chỉnh sửa mã trong file bot của bạn, sau đó chạy lại lệnh node bot.mjs để khởi động lại bot.

5. Tự Động Chạy Bot (Optional)

Nếu bạn muốn bot của mình tự động chạy lại khi có thay đổi, bạn có thể sử dụng công cụ như nodemon. Để cài đặt nodemon, hãy chạy lệnh:
```
npm install -g nodemon
```
Sau đó, bạn có thể khởi động bot bằng lệnh
```
nodemon bot.mjs
```
Lệnh này sẽ tự động khởi động lại bot mỗi khi bạn thay đổi mã.

Kết quả

Sau khi chạy node . trên Termina ở VS Code thì bạn sẽ thấy bot online.
Chạy lệnh !!noitu để cài đặt,
Chạy lệnh !!resetnoitu để reset nối từ.

Nguồn - Copyright

Nguồn từ điển
Dictionary source
Thanks for the documentation

FAQ

Cách mở Terminal trên VS Code

Xem hướng dẫn [tại đây](https://youtu.be/cDsXZ_PEDGk?si=k8pnks03kRx8-0QS)

Cách cài VS Code

Xem hướng dẫn [tại đây](https://www.youtube.com/results?search_query=c%C3%A1ch+c%C3%A0i+vs+code+%2F+how+to+install+vs+code)

Cách cài môi trường

Xem hướng dẫn [tại đây](https://www.youtube.com/results?search_query=c%C3%A1ch+c%C3%A0i+%C4%91%E1%BA%B7t+m%C3%B4i+js+%2F+how+to+install+js+inviroment)

Cách host bot (bot online 24/7)

Các hosting
- Sử dụng Máy Chủ (Server) Cá Nhân (ví dụ:máy tính của bạn,...)
  - Máy tính cá nhân: Bạn có thể chạy bot Discord từ máy tính cá nhân của mình. Điều này yêu cầu bạn phải giữ máy tính của mình bật và kết nối với internet 24/7
    - Ưu điểm: Không mất phí hosting.
    - Nhược điểm: Máy tính cần phải chạy liên tục.
- Sử dụng Dịch Vụ Hosting Cloud
  - Ưu điểm: Không cần phải chạy trên máy mà chạy trên cloud.
  - Nhược điểm: Cần phải trả phí (có vài hosting miễn phí)
- Sử dụng Dịch Vụ VPS (Virtual Private Server)
  - Ưu điểm: Tùy chỉnh cao, tài nguyên riêng, khả năng mở rộng, ổn định và tin cậy, quyền truy cập root.
  - Nhược điểm: Chi phí cao, yêu cầu quản lý server và kiến thức kỹ thuật, cần tối ưu hóa, rủi ro bảo mật nếu không bảo trì đúng cách.
- Cách host
  - Tham khảo cách host bot discord free
  - Tham khảo hosting bot discord free

Phiên bản

Version	Nội dung	Date
1.0.0	New Upload	22/08/2024

Nền tảng hỗ trợ

Nền tảng	Có	Không
IOS		❌
Android		❌
Window	✔️
MacOS	✔️
Linux	✔️

Name		Name	Last commit message	Last commit date
Latest commit History 28 Commits
text		text
LICENSE		LICENSE
README (ENG).md		README (ENG).md
README.md		README.md
bot.mjs		bot.mjs

License

khoi321/bot-discord-noi-tu

Folders and files

Latest commit

History

Repository files navigation