🐺 Werewolf Discord Bot - 桔梗 | Shiroku

Bot Discord game Soi Má (Werewolf) được viết bằng TypeScript với Discord.js v14 <(")

🔗 Invite • 🚀 Commands • ⚙️ Installation • 📝 Configuration • 📄 License

Warning

📢⚠️❗
EN: This application is currently distributed for free on GitHub and is open source under the Shiroku Bot License.
🚫 Do not modify or redistribute it with advertising, or use it for commercial purposes.

VI: Ứng dụng này hiện đang được phát hành miễn phí trên GitHub và là mã nguồn mở theo Giấy phép Shiroku Bot.
🚫 Không được chỉnh sửa hoặc phân phối lại với mục đích quảng cáo, hoặc sử dụng cho mục đích thương mại.

Tip

Vào server Discord để được hỗ trợ về bot

---

🔗 Invite the Bot to Your Server

👉 Invite the Bot

🚀 Commands

🏠 Room Management

Command	Description	Permission
/masoi-create	Tạo phòng chơi mới	Everyone
/clear-room	Xóa phòng chơi hiện tại	Host/Admin
/status	Xem trạng thái phòng và người chơi	Everyone
/settings	Cài đặt game (roles, time, etc.)	Host/Admin

👥 Player Management

Command	Description	Permission
/masoi-join	Tham gia phòng chơi	Everyone
/masoi-leave	Rời khỏi phòng chơi	Everyone
/masoi-kick @user	Kick người chơi khỏi phòng	Host/Admin

🎮 Game Control

Command	Description	Permission
/masoi-start	Bắt đầu game Ma Sói	Host/Admin

Xem đầy đủ slash command tại thư mục /commands

---

⚙️ Cài Đặt & Chạy

📋 Requirements

• Node.js v18.0.0 hoặc cao hơn
• npm hoặc yarn
• Discord Bot Token (Tạo bot tại đây)

🔧 Installation Steps

git clone https://github.com/MegumiKatou02/werewolf-discord.git
cd werewolf-discord-bot

npm install
# or
yarn install

cp .env.example .env

npm run dev:deploy
# or
npx tsx deploy-commands.ts

npm run dev
# or
npm run dev:watch

---

📝 Cấu Hình

⚙️ Bot Permissions

Bot cần các permissions sau trên Discord:

• View Channels
• Send Messages
• Send Messages in Threads
• Embed Links
• Attach Files
• Read Message History
• Use Slash Commands
• Add Reactions
• Use External Emojis
• Everything

---

🛠️ Development

📁 Project Structure

📦 werewolf-discord-bot
├── 📂 commands/          # Slash commands
├── 📂 core/              # Game logic & room management  
├── 📂 types/             # TypeScript type definitions
├── 📂 utils/             # Utility functions
├── 📂 data/              # Roles data
...
├── 📂 dist/              # Compiled JavaScript
├── 📄 package.json       # Dependencies & scripts
├── 📄 tsconfig.json      # TypeScript configuration
└── 📄 .env.example       # Environment template

Scripts

npm run dev          # Chạy với file Javascript sau khi build
npm run deploy       # Deploy command và chạy file Javascript
npm run dev:ts       # Chạy file ts mà không cần build
npm run dev:watch    # Chạy file ts và có hot-reload
npm run lint         # Check code style

---

🤝 Contributing

📋 How to Contribute

1. Fork repository này
2. Tạo branch cho feature: git checkout -b feature/amazing-feature
3. Code và test kỹ
4. Commit: git commit -m 'Add amazing feature'
5. Push: git push origin feature/amazing-feature
6. Tạo Pull Request

---

⚠️ QUAN TRỌNG - Bản Quyền & Sử Dụng

Đọc file Shiroku Bot License

---

© 2025 Yukiookii. All rights reserved.