KimiXP es un bot de Discord desarrollado en Python, enfocado en sistemas de experiencia, niveles, perfiles y administración de servidores.
El proyecto es Open Source y está pensado para que otras personas puedan utilizarlo, aprender de su código, modificarlo y contribuir a su desarrollo.
🚧 KimiXP se encuentra en desarrollo activo. Algunas partes del proyecto pueden cambiar con el tiempo.
- ✨ Características
- 📁 Estructura del proyecto
⚠️ Antes de instalar- 🚀 Instalación
- 🛠️ Desarrollo
- 🤝 Contribuir
- 🛟 Soporte
- 🐛 Reportar errores
- 📜 Licencia
- 👤 Desarrollador
- 📌 Estado del proyecto
- 💙 Gracias
| Característica | Descripción |
|---|---|
| ⬆️ Sistema de XP y niveles | Gana experiencia y sube de nivel |
| 👤 Perfiles de usuario | Visualiza tu perfil y estadísticas |
| 🏆 Sistema de rangos | Desbloquea rangos según tu nivel |
| ⚙️ Administración | Comandos para moderar y gestionar el servidor |
| 🗄️ Base de datos | Persistencia de datos con SQLite |
| 🔧 Configuración | Variables de entorno para fácil configuración |
| 🧩 Arquitectura modular | Cogs para organizar comandos |
| 🔓 Código abierto | Modifica y contribuye libremente |
KimiXP/
├── cogs/ # Comandos y funcionalidades
│ ├── leveling.py # Sistema de niveles y experiencia
│ ├── profile.py # Perfiles de usuario
│ ├── admin.py # Comandos de administración
│ └── help.py # Sistema de ayuda
│
├── database/ # Lógica de base de datos
│ ├── database.py # Conexión y operaciones
│ └── schema.sql # Esquema de tablas
│
├── utils/ # Funciones auxiliares
│ └── config.py # Configuración y variables
│
├── main.py # Punto de entrada
├── requirements.txt # Dependencias
├── .env.example # Variables de entorno de ejemplo
├── LICENSE # Licencia GPL-3.0
├── CONTRIBUTING.md # Guía de contribución
└── README.md # Este archivo
La estructura puede cambiar a medida que KimiXP siga evolucionando.
KimiXP está desarrollado principalmente para personas que tengan conocimientos básicos de Python, Git y bots de Discord.
No necesitas ser un experto para utilizarlo, pero algunas partes pueden requerir conocimientos técnicos y configuración manual.
| Tema | Descripción |
|---|---|
| 🐍 Python | Lenguaje base del proyecto |
| 🌿 Git | Control de versiones |
| ⚙️ Variables de entorno | Configuración sensible (.env) |
| 🤖 Discord API | Bots y aplicaciones de Discord |
| 📦 pip | Instalación de paquetes |
| 🖥️ Consola | Configuración básica del sistema |
💡 Si estás empezando, puedes utilizar KimiXP como una oportunidad para aprender.
Si tienes Git instalado:
git clone https://github.com/WemphiraOrg/KimiXP.git
cd KimiXPTambién puedes descargar el repositorio directamente como archivo ZIP desde GitHub.
Dentro de la carpeta de KimiXP:
pip install -r requirements.txtEsto instalará todas las librerías necesarias para ejecutar el proyecto.
Dependencias principales:
discord.py— Librería para la API de Discordpython-dotenv— Gestión de variables de entorno- Otras dependencias en
requirements.txt
Copia .env.example y crea un archivo llamado .env:
# En Windows (PowerShell)
Copy-Item .env.example .env
# En Linux/macOS
cp .env.example .envEjemplo de configuración (.env):
DISCORD_TOKEN=tu_token_aquíCompleta las variables necesarias para ejecutar KimiXP.
🔒 Importante: Nunca publiques tu token de Discord, contraseñas, claves API u otros datos sensibles. El archivo
.envno debería subirse al repositorio.
Una vez configurado todo:
python main.pySi la configuración es correcta, KimiXP iniciará y se conectará a Discord.
KimiXP utiliza una arquitectura modular para mantener sus diferentes funciones separadas.
| Directorio | Propósito |
|---|---|
cogs/ |
Comandos y funcionalidades principales |
database/ |
Lógica de base de datos |
utils/ |
Funciones auxiliares y configuración |
Si quieres añadir una nueva funcionalidad, intenta mantener esta organización para que el proyecto siga siendo fácil de entender y mantener.
Las contribuciones son bienvenidas y ayudan a mejorar KimiXP.
Puedes contribuir de diferentes maneras:
- 🐛 Reportando errores
- 💡 Proponiendo nuevas funciones
- 📝 Mejorando la documentación
- 🔧 Corrigiendo errores
- ⚡ Optimizando el código
- 🔀 Creando Pull Requests
- 💬 Ayudando a otros usuarios
Consulta las Issues abiertas para encontrar tareas en las que puedas colaborar.
Si es tu primera contribución, busca Issues con la etiqueta good first issue.
Antes de realizar cambios, revisa CONTRIBUTING.md para conocer las reglas y el proceso de contribución.
¡Toda contribución es bienvenida! ❤️
Si tienes alguna duda, encontraste un fallo o quieres proponer una idea, puedes unirte al servidor oficial de soporte de KimiXP en Discord:
🔗 https://discord.gg/sZyhRvzdx6
En el servidor podrás:
- ❓ Hacer preguntas y resolver dudas
- 🐛 Reportar fallos y recibir ayuda
- 💡 Proponer nuevas ideas y funcionalidades
- 👥 Conocer a otras personas que utilizan el proyecto
Si encuentras un problema con KimiXP, primero comprueba:
- ✅ Que estás utilizando una versión actualizada
- ✅ Que configuraste correctamente las variables de entorno
- ✅ Que instalaste todas las dependencias
- ✅ Que el problema no haya sido reportado anteriormente
Si el problema continúa, puedes abrir un Issue explicando qué ocurrió y, si es posible, incluyendo los errores que aparecen en la terminal.
⚠️ No publiques tokens, contraseñas ni información privada en un Issue.
KimiXP está disponible bajo la licencia GNU General Public License v3.0 (GPL-3.0).
Puedes consultar los términos completos en el archivo LICENSE.
BrunoDevPe
Desarrollador principal de KimiXP.
🟢 En desarrollo activo.
KimiXP continuará recibiendo mejoras, correcciones y nuevas funciones.
La estructura y algunas características pueden cambiar durante el desarrollo.
Gracias a todas las personas que utilizan, prueban, reportan errores o contribuyen a KimiXP.
El proyecto empezó como una idea y continúa creciendo gracias al desarrollo y a la comunidad.
KimiXP — Open Source Discord Bot
Hecho con 💙 por BrunoDevPe