Sistema Dinámico de Generación Automática de archivos de configuración de mapas para Quake 3 Arena CPMA
🌐 Sitio oficial de CPMA: https://playmorepromode.com/
🌐 Maked with love by https://yimgame.github.io/
- 🤖 Auto-detección de modos de juego: Detecta automáticamente modos nuevos sin configuración manual
- 🎯 Clasificación inteligente: Identifica automáticamente si un modo usa
fraglimit,caplimito formato especial - 📊 Stats dinámicos: Muestra todos los modos encontrados, no solo una lista fija
- 🎨 Tarjetas auto-generadas: Crea interfaces de configuración para modos desconocidos
- ♾️ Extensibilidad infinita: Soporta cualquier modo que aparezca en archivos
.arena
- 🔍 Escanea automáticamente todos los archivos .pk3 en baseq3
- 📋 Parsea archivos .arena y extrae metadata de mapas
- 🎯 Clasifica mapas por tipo automáticamente
- ⚙️ Interfaz web responsive para configurar parámetros
- 💾 Genera archivos de configuración listos para usar
- 👁️ Previsualización en tiempo real antes de generar
- 🪟 Ventana GUI nativa (no necesitas navegador)
- 🔌 Detección automática de puerto disponible (5000-5009)
- 🌐 Acceso por LAN con IP detectada automáticamente
- ☑️ Checkboxes por mapa para incluir/excluir; los excluidos se exportan con
minplayers -1(banned) si no quieres jugarlo o esta mal seteado en el.arena(ej. CTF sin banderas)
Preconfigurados con valores optimizados:
- FFA - Free For All
- CTF / CTFS - Capture The Flag / Strawberry
- Tourney / 1v1 / DA - Duelos
- Team / TDM - Team Deathmatch
- CA - Clan Arena
- FT - Freeze Tag
- HM - HoonyMode
- RA / RA3 - Rocket Arena
- NTF - No Team Flags
- 2v2 - Two vs Two
- FTAG - Flag Tag
Y cualquier modo nuevo que aparezca en tus archivos .arena será detectado y configurado automáticamente.
- Ejecutable independiente con interfaz gráfica propia
- No necesitas abrir el navegador manualmente
- Ventana nativa de Windows con la aplicación embebida
- Más profesional y fácil de usar
- Archivo:
dist\Q3MapConfigGenerator.exe
- Inicia un servidor web local
- Debes abrir manualmente el navegador
- Útil si prefieres usar tu navegador favorito
- Archivos:
app.pyorun.batorun_exe.bat
¡La forma más fácil! Ventana propia con la aplicación integrada
- Haz doble clic en
run_gui.bato ejecuta directamentedist\Q3MapConfigGenerator.exe - La aplicación se abrirá en su propia ventana
- ¡No necesitas abrir el navegador!
- Haz doble clic en
run_exe.bat(versión solo servidor) - Abre tu navegador en: http://localhost:5000
-
Asegúrate de tener Python 3.8+ instalado
-
Instala las dependencias:
pip install -r requirements.txt- Ejecuta la aplicación:
python app.pyO simplemente haz doble clic en run.bat
- Abre tu navegador en: http://localhost:5000
-
Configurar Rutas (primera vez):
- Haz clic en el botón de configuración (⚙️)
- Ingresa la ruta de tu carpeta baseq3 de Quake 3
- Ingresa la ruta donde quieres guardar los archivos generados
- Guarda la configuración
-
Haz clic en "Escanear Archivos .pk3" para analizar todos los mapas
-
Configura los parámetros para cada tipo de mapa:
- Min Players: Número mínimo de jugadores
- Max Players: Número máximo de jugadores
- Fraglimit/Caplimit: Límite de frags o capturas
- Timelimit: Límite de tiempo en minutos
-
Usa "Previsualizar" para ver cómo quedará el archivo
-
Haz clic en "Generar Archivo" para crear la configuración
Los archivos se guardan en: G:\Games\Quake3\cpma\cfg-maps\
Modos individuales:
ffamaps.txt- Mapas Free For All1v1maps.txt- Mapas 1v1 / Dueltourneymaps.txt- Mapas Tourneydamaps.txt- Mapas Duel Arenahmmaps.txt- Mapas HoonyMode2v2maps.txt- Mapas 2 vs 2
Modos de equipo:
teammaps.txt- Mapas Teamtdmmaps.txt- Mapas Team Deathmatchctfmaps.txt- Mapas Capture The Flagctfsmaps.txt- Mapas CTF Strawberryntfmaps.txt- Mapas No Team Flagsftagmaps.txt- Mapas Flag Tag
Modos especiales:
camaps.txt- Mapas Clan Arenaftmaps.txt- Mapas Freeze Tagmamaps.txt- Mapas Rocket Arena
El programa busca archivos con esta estructura dentro de los .pk3:
{
map "ASSault"
longname "Levelord®'s ASSault"
bots "Sarge Hunter Klesk Anarki"
fraglimit 17
timelimit 17
type "ffa team tourney"
}
Modos de 1-4 jugadores:
- FFA - Free For All
- 1v1 / Tourney - Duelo 1vs1
- DA - Duel Arena
- HM - HoonyMode
- 2v2 - Two vs Two
Modos de equipo:
- Team - Equipo genérico
- TDM - Team Deathmatch
- CTF - Capture The Flag
- CTFS - CTF Strawberry
- NTF - No Team Flags
- FTAG - Flag Tag
Modos especiales:
- CA - Clan Arena
- FT - Freeze Tag
- RA - Rocket Arena
- RA3 - Rocket Arena 3 (formato especial con arena field)
El generador v2.0 utiliza un sistema de clasificación automática:
if "ctf" in mode_name:
→ Usa caplimit (formato CTF)
elif mode_name in ["duel", "1v1", "2v2", "tourney"]:
→ Usa fraglimit (formato Duel)
elif mode_name == "ra3":
→ Usa roundlimit + arena field (formato RA3)
else:
→ Usa fraglimit (formato FFA por defecto)- Modo
"zombies"→ Detectado como FFA →zombiesmaps.txtcon fraglimit - Modo
"megactf"→ Detectado como CTF →megactfmaps.txtcon caplimit - Modo
"arena2024"→ Detectado como FFA →arena2024maps.txtcon fraglimit
- Backend: Python 3.13 + Flask 3.1.2
- Frontend: HTML5 + CSS3 + Vanilla JavaScript
- GUI: PyWebView (EdgeWebView2)
- Parser: Expresiones regulares + zipfile
- Build: PyInstaller 6.18.0
- Auto-Detection Engine: Sistema de clasificación dinámica
Ver CHANGELOG.md para el historial completo de versiones.
¡Las contribuciones son bienvenidas! Si tienes ideas para mejorar el generador:
- Fork el repositorio
- Crea una rama para tu feature (
git checkout -b feature/AmazingFeature) - Commit tus cambios (
git commit -m 'Add some AmazingFeature') - Push a la rama (
git push origin feature/AmazingFeature) - Abre un Pull Request
Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para más detalles.
Desarrollado con amor por GitHub Copilot (Claude Sonnet 4.5)
🤖 AI-Powered Development for the Quake 3 Community
Just coding 4 fun !!!
⚡ Q3 Map Config Generator v2.0 ⚡
Making Quake 3 CPMA server configuration effortless since 2026