Civita

Civita is a multifunctional and lightweight Discord bot built with TypeScript.
It’s designed to be fast, modular, and easy to maintain — providing essential utilities, moderation tools, and fun features for your Discord community.

✨ Features

🧹 Moderation — Kick, ban, mute and manage your server with ease.
🎉 Fun & Games — Engage users with AI, QOTD(questions of the day), and other fun commands.
⚙️ Customizable — Easily configurable settings via /setup command.
🚀 Lightweight & Fast — Optimized with TypeScript for performance and maintainability.

🧰 Tech Stack

📦 Installation

Prerequisites

Node.js v18 or later
Discord Bot Token (create one here)
PnPm
Google GenAI Key (create one here)

Setup

# Clone the repository
git clone https://git.optimihost.com/NaChlorid/civita.git
cd civita

# Install dependencies
pnpm install

# Configure environment variables
cp .env.example .env
# Edit .env and add your Discord bot token

# Build the project
pnpm run build

# Start the bot
npx dist/index.js

⚙️ Configuration

Your .env file should look like this:

DISCORD_TOKEN=(DISCORD TOKEN)
GEMINI_API_KEY=(GOOGLE GENAI KEY)
DISCORD_CLIENT_ID=(DISCORD APPLICATION ID)

DATABASE_HOST=127.0.0.1
DATABASE_PORT=3306
DATABASE_USER=(DATABASE USER)
DATABASE_PASSWORD=(DATABASE PASSWORD)
DATABASE_NAME=(DATABASE NAME)

You can also customize command prefixes, logging options, and more depending on your setup.

🧑‍💻 Development

To start a development environment:

pnpm run dev

🧱 Project Structure

civita/
├── src/
│   ├── commands/
│   ├── events/
│   ├── utils/
│   └── index.ts
├── .env.example
├── package.json
├── tsconfig.json
└── README.md

🧩 Contributing

Contributions are welcome! Feel free to fork this repository and submit a pull request. Make sure your code follows the existing style and passes all lint checks before submitting.

🪪 License

This project is licensed under the MIT License. See the LICENSE file for details.

💬 Support

If you encounter issues or have suggestions, please open an issue on GitHub. You can also reach out via the Discord server (if available).

Civita — simple, modular, and made to elevate your Discord experience.

2.7 KiB Raw Blame History Unescape Escape