- ⚡ Lightning Fast: Feels instant, even with tons of features!
- 🧩 Plug & Play Modular: Add new features as simply as drag-and-drop.
- 🗄️ Data Your Way: Works with MySQL, MongoDB, or simple JSON.
- 🦄 Extreme Customization: Change all settings in one
.envfile—no headaches!
Use MongoDB, MySQL, or JSON—effortless to switch. Perfect for any deployment style.
Every feature is a tidy module. Install, remove, or upgrade with zero pain. Minimal bloat, max power.
Tweak bot prefixes, owner, DB, experimental flags, and more via
.env.
git clone https://github.com/nat9h/Katsumi.git
cd Katsuminpm installcp .env.example .env| Variable | Description | Default |
|---|---|---|
| MYSQL_HOST | MySQL database host | localhost |
| MYSQL_PORT | MySQL database port | 3306 |
| MYSQL_USER | MySQL username | root |
| MYSQL_PASSWORD | MySQL password | password |
| MYSQL_DATABASE | MySQL database name | baileys |
| BOT_SESSION_NAME | Session storage identifier | session |
| BOT_PREFIXES | Command prefixes (comma-separated) | !,.,? |
| USE_MONGO | Enable MongoDB storage (true/false) | false |
| MONGO_URI | MongoDB connection URI | mongodb://localhost:27017/database |
- Production:
npm start
- Development (auto-reload):
npm run dev
- Using PM2:
npm run pm2
Every plugin = a single .js file.
Example: ping.js — shows latency & server info.
import os from "os";
import { performance } from "perf_hooks";
export default {
name: "ping",
description: "Displays bot response speed and server info",
command: ["ping", "p"],
permissions: "all",
hidden: false,
category: "info",
cooldown: 0,
async execute(m) {
const start = performance.now();
const ram = (os.totalmem() / Math.pow(1024, 3)).toFixed(2) + " GB";
const freeRam = (os.freemem() / Math.pow(1024, 3)).toFixed(2) + " GB";
await m.reply(
`🚀 *PONG!*
⏱️ Response Time: ${(performance.now() - start).toFixed(2)}ms
💻 CPU: ${os.cpus().length} Core(s)
📦 RAM: ${freeRam} / ${ram}
🆙 Uptime: ${Math.floor(os.uptime() / 86400)} days`
);
},
};or
import os from "os";
import { performance } from "perf_hooks";
export default {
name: "ping",
description: "Displays bot response speed and server info",
command: ["ping", "p"],
permissions: "all",
hidden: false,
category: "info",
cooldown: 0,
execute: async (m) => {
const start = performance.now();
const ram = (os.totalmem() / Math.pow(1024, 3)).toFixed(2) + " GB";
const freeRam = (os.freemem() / Math.pow(1024, 3)).toFixed(2) + " GB";
await m.reply(
`🚀 *PONG!*
⏱️ Response Time: ${(performance.now() - start).toFixed(2)}ms
💻 CPU: ${os.cpus().length} Core(s)
📦 RAM: ${freeRam} / ${ram}
🆙 Uptime: ${Math.floor(os.uptime() / 86400)} days`
);
},
};Result:
🚀 PONG!
⏱️ Response Time: 12.34ms
💻 CPU: 8 Core(s)
📦 RAM: 3.21 GB / 16.00 GB
🆙 Uptime: 15 days
| Option | Description | Example/Values |
|---|---|---|
| command | Plugin triggers | ["ping", "p"] |
| permissions | Who can use | "all", "admin", "owner" |
| category | Help menu group | "info", "utils", ... |
| cooldown | Cooldown in seconds | 0 (no cooldown) |
| group | Enable in groups? | true/false |
| private | Enable in private chat? | true/false |
- Lint:
npm run lint
- Prettier:
npm run prettier