https://github.com/arviisoft/basic-level-system
🎮 A simple yet elegant XP & Leveling System for Discord bots using discord.js and a lightweight database. Designed to provide users with an engaging ranking experience through visually appealing rank cards and leaderboard displays.
https://github.com/arviisoft/basic-level-system
basic-level-system discord discord-js json-database level level-system system
Last synced: about 1 month ago
JSON representation
🎮 A simple yet elegant XP & Leveling System for Discord bots using discord.js and a lightweight database. Designed to provide users with an engaging ranking experience through visually appealing rank cards and leaderboard displays.
- Host: GitHub
- URL: https://github.com/arviisoft/basic-level-system
- Owner: ArviiSoft
- License: mit
- Created: 2025-06-08T15:03:53.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-08T15:06:23.000Z (about 1 year ago)
- Last Synced: 2025-06-18T07:02:38.139Z (about 1 year ago)
- Topics: basic-level-system, discord, discord-js, json-database, level, level-system, system
- Language: JavaScript
- Homepage: https://discord.gg/uzPUNrrhH2
- Size: 435 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🎮 Discord Basic Level System
A simple yet elegant **XP & Leveling System** for Discord bots using `discord.js` and a lightweight database. Designed to provide users with an engaging ranking experience through visually appealing rank cards and leaderboard displays.
---
## 🚀 Features
- 🧾 XP & Level Tracking
- 🎖️ Rank Card Generation (Image-based)
- 🏆 Leaderboard System
- 📦 Easy to Set Up & Modify
- 🔧 No external database needed
---
## 📂 Project Structure
```
📁 Discord Basic Level System
├── 📁 commands
│ ├── 📄 seviye.js # Shows individual user's XP and level
│ └── 📄 seviye-tablosu.js # Displays top XP holders
├── 📁 events
│ └── 📄 messageCreate.js # XP gain logic on messages
├── 📄 config.json # Configuration file
├── 📄 index.js # Bot main file
└── 📄 package.json # Node.js dependencies
```
---
## 🛠️ Installation
1. **Clone the repository:**
```bash
git clone https://github.com/ArviiSoft/basic-level-system.git
cd basic-level-system
```
2. **Install dependencies:**
```bash
npm install
```
---
## 💡 How It Works
| Action | Result |
|-------------------|------------------------------|
| User sends a msg | +1 XP (with cooldown system) |
| Use `/seviye` | See your rank card |
| Use `/seviye-tablosu` | See the top XP holders |
Rank cards and leaderboards are automatically generated using dynamic image rendering for a clean and anime-themed aesthetic.
---
## 🖼️ Screenshots
### 🔹 Rank Card Example
---
## 📌 Requirements
- Node.js v16+
- Required packages in `package.json` (like `discord.js`, `canvas`, etc.)
---
## 👤 Author
Made with ❤️ by [ArviS](https://discord.gg/uzPUNrrhH2)
---
## 📄 License
MIT License — feel free to use, modify and distribute!