feat: phase 3 redesign, game images, auth system, vm guides, service isolation
Some checks failed
Deploy Multi-VM / Deploy VM Web (push) Has been cancelled
Deploy Multi-VM / Deploy VM Auth (push) Has been cancelled
Deploy Multi-VM / Deploy Game Servers (docker-compose.fusionfall.yml, VM_FUSIONFALL_HOST, VM_FUSIONFALL_SSH_KEY, VM_FUSIONFALL_USER, fusionfall) (push) Has been cancelled
Deploy Multi-VM / Deploy Game Servers (docker-compose.maple2.yml, VM_MAPLE2_HOST, VM_MAPLE2_SSH_KEY, VM_MAPLE2_USER, maple2) (push) Has been cancelled
Deploy Multi-VM / Deploy Game Servers (docker-compose.minecraft.yml, VM_MINECRAFT_HOST, VM_MINECRAFT_SSH_KEY, VM_MINECRAFT_USER, minecraft) (push) Has been cancelled
Deploy Multi-VM / Deploy Game Servers (docker-compose.retro.yml, VM_RETRO_HOST, VM_RETRO_SSH_KEY, VM_RETRO_USER, retro) (push) Has been cancelled

- Redesign all internal pages to warm/gold aesthetic (catalog, game detail,
  documentary, about, donate, community, guides, contact, server-status,
  login, profile, admin, not-found)
- Add real cover images for all 4 games via Strapi CMS with getImageUrl helper
- Integrate NextAuth v5 with Authentik OIDC authentication
- Add new public pages: community, guides, contact, server-status
- Add new protected pages: login, profile, admin dashboard
- Remove legacy AFC/MercadoPago system entirely
- Add Docker Compose split files for service isolation (main, auth, fusionfall, nier)
- Add OpenFusion VM deployment configs (config.vm.ini, systemd service, README-VM)
- Add NieR Reincarnation server guide and desktop client guide
- Add architecture docs for multi-VM deployment
- Add healthcheck, SSE, contact, newsletter, admin API routes
- Add reusable UI components, skeleton loaders, activity feed, bookmark system
- Update deployment and game server documentation
This commit is contained in:
consultoria-as
2026-04-28 05:15:38 +00:00
parent ea142501fa
commit 449c02eadc
151 changed files with 10053 additions and 2312 deletions

View File

@@ -2,6 +2,169 @@
Guia de setup, operacion y troubleshooting de cada servidor de juegos.
---
## NieR Reincarnation
### Resumen
| Dato | Valor |
|------|-------|
| Emulador | [MariesWonderland](https://github.com/BillyCool/MariesWonderland) |
| Lenguaje | C# / .NET 10 |
| Puertos | 80 (HTTP assets), 443 (gRPC HTTP/2) |
| Base de datos | In-memory (master + user data en archivos) |
| RAM | ~1 GB |
| Estado | Alpha — gameplay basico funcional |
### Archivos
```
servers/nier-reincarnation/
├── MariesWonderland/ # Repo clonado de GitHub
│ ├── src/ # Codigo fuente .NET 10
│ ├── scripts/
│ │ └── patcher.ipynb # Google Colab APK patcher
│ └── tests/
├── Dockerfile # Multi-stage: build .NET 10 + runtime
└── .dockerignore
```
### Setup Inicial
#### 1. Clonar el repositorio
```bash
cd servers/
git clone https://github.com/BillyCool/MariesWonderland.git nier-reincarnation/MariesWonderland
```
#### 2. Extraer datos del cliente original
Se necesitan los datos del cliente original de NieR Reincarnation:
- **AssetDatabase**: assets extraidos del APK/data del juego
- **MasterDatabase**: datos maestros del juego
Colocar estos directorios en un volumen Docker accesible por el contenedor.
#### 3. Configurar el servidor
Editar `appsettings.Production.json`:
```json
{
"Server": {
"Paths": {
"AssetDatabase": "/data/assets",
"MasterDatabase": "/data/master",
"ResourcesBaseUrl": "http://play.consultoria-as.com/aaaaaaaaaaaaaaaaaaaaaaaa"
},
"Data": {
"LatestMasterDataVersion": "20240404193219",
"UserDataPath": "/data/users"
}
}
}
```
**IMPORTANTE**: `ResourcesBaseUrl` debe tener **exactamente 43 caracteres** despues del host.
#### 4. Parchear el APK del cliente
1. Abrir [Google Colab](https://colab.research.google.com/)
2. Subir `scripts/patcher.ipynb`
3. Configurar:
- `protocol`: `http` o `https`
- `server_host`: `play.consultoria-as.com`
- `server_port`: dejar vacio
4. Ejecutar y descargar el APK parcheado
#### 5. Desplegar
```bash
cd docker
docker compose -f docker-compose.nier.yml up -d
```
### Conexion de cliente
1. Instalar el APK parcheado en un dispositivo Android o emulador
2. Asegurarse de que el dispositivo pueda alcanzar `play.consultoria-as.com:80/443`
3. Iniciar el juego
### Troubleshooting
- **"No se conecta al servidor"**: Verificar que los puertos 80/443 estan abiertos y que el servidor escucha en 0.0.0.0
- **"ResourcesBaseUrl invalido"**: La URL debe tener exactamente 43 caracteres despues del host
- **"Error de gRPC"**: Verificar que la red soporte HTTP/2 en el puerto 443
- **APK no parcheado correctamente**: Revisar que el hostname no sea mas largo que el original en `global-metadata.dat`
---
## Dragon Ball Online
### Resumen
| Dato | Valor |
|------|-------|
| Emulador | [DBO Global](https://github.com/dboglobal/DBOGLOBAL) |
| Lenguaje | C++ (Visual Studio / Windows) |
| Puertos | 22000-22010 (auth, char, chat, game, etc.) |
| Base de datos | MariaDB / MySQL |
| RAM | ~2 GB |
| Estado | En configuracion — requiere VM Windows |
### Archivos
```
servers/dragonball-online/
├── DBOGLOBAL/ # Repo clonado de GitHub (C++)
├── sql/ # Scripts de inicializacion de DB
└── Dockerfile.placeholder # Placeholder — requiere Windows
```
### Setup Inicial
#### 1. Clonar el repositorio
```bash
cd servers/
git clone https://github.com/dboglobal/DBOGLOBAL.git dragonball-online/DBOGLOBAL
```
#### 2. Compilar el servidor
**NOTA**: DBO Global requiere Windows y Visual Studio para compilar.
Requisitos:
- Windows 10/11 o Windows Server
- Visual Studio 2019+ (con soporte C++ y MFC)
- MariaDB o MySQL
Pasos:
1. Abrir `DBOGLOBAL.sln` en Visual Studio
2. Compilar en modo Release
3. Los binarios se generan en `Release/`
#### 3. Configurar la base de datos
```bash
# En la VM con MariaDB
cd docker
docker compose -f docker-compose.dbo.yml up -d dbo-mariadb
# Ejecutar scripts SQL de inicializacion
```
#### 4. Configurar el servidor
Editar los archivos de configuracion del servidor DBO para apuntar a:
- DB_HOST: la IP de la VM con MariaDB
- Puertos publicos: 22000-22010
### Conexion de cliente
1. Descargar el cliente DBO Global
2. Configurar el launcher para apuntar a `play.consultoria-as.com:22000`
3. Crear una cuenta (o usar la cuenta por defecto)
### Servidores privados alternativos
Si DBO Global no funciona, existen otros servidores privados activos:
- DBO Galaxy
- DBOG Revival
- DBO Crisis
- DBO Hope
- DBO Omega
### Troubleshooting
- **"No compila en Linux"**: DBO Global requiere Windows/MFC. Considerar usar Wine o una VM Windows dedicada.
- **"No se conecta a la DB"**: Verificar que MariaDB este corriendo y que las credenciales sean correctas.
- **"Cliente no se conecta"**: Verificar que todos los puertos 22000-22010 esten abiertos en el firewall.
---
## OpenFusion (FusionFall)
### Resumen
@@ -26,12 +189,12 @@ servers/openfusion/
### Configuracion
Variables de entorno en `docker-compose.dev.yml`:
- `OPENFUSION_SHARD_IP`: IP publica del servidor (default: 192.168.10.234)
- `OPENFUSION_SHARD_IP`: IP publica del servidor (default: 192.168.10.96)
- `OPENFUSION_MOTD`: Mensaje del dia
### Conexion de cliente
1. Descargar el cliente FusionFall
2. Usar el launcher de OpenFusion apuntando a `192.168.10.234:23000`
2. Usar el launcher de OpenFusion apuntando a `192.168.10.96:23000`
### Troubleshooting
- **"Connection refused"**: Verificar que el contenedor esta corriendo y los puertos estan mapeados
@@ -87,8 +250,8 @@ Descargar [MapleStory2-XML v1.2.1](https://github.com/MS2Community/MapleStory2-X
```bash
cp servers/maple2/.env.example servers/maple2/.env
# Editar con las IPs correctas:
# GAME_IP=192.168.10.234
# LOGIN_IP=192.168.10.234
# GAME_IP=192.168.10.96
# LOGIN_IP=192.168.10.96
```
#### 5. Verificar .dockerignore
@@ -118,7 +281,7 @@ docker compose -f docker-compose.maple2.yml up -d
### Conexion de cliente
1. Tener el cliente de MapleStory 2 instalado
2. El cliente debe apuntar a `192.168.10.234:20001` (Login Server)
2. El cliente debe apuntar a `192.168.10.96:20001` (Login Server)
3. Las IPs se configuran en `servers/maple2/.env` (`GAME_IP`, `LOGIN_IP`)
### Troubleshooting
@@ -180,7 +343,7 @@ El primer inicio toma 5-10 minutos porque:
### Conexion de cliente
1. Instalar [FTB App](https://www.feed-the-beast.com/app), MultiMC, ATLauncher, o Prism Launcher
2. Instalar modpack **FTB Evolution** version 1.29.1
3. Multiplayer > Add Server: `192.168.10.234:25565`
3. Multiplayer > Add Server: `192.168.10.96:25565`
### Fix: Watchdog crash en primer inicio
Con 200+ mods, el mod Hexerei tarda mas de 60 segundos generando recetas al iniciar, lo que activa el watchdog de Minecraft. Se resuelve con `MAX_TICK_TIME: -1` en las variables de entorno del compose.
@@ -230,7 +393,7 @@ Variables de entorno en `docker-compose.dev.yml`:
### Conexion de cliente
1. Descargar [sm64coopdx](https://github.com/coop-deluxe/sm64coopdx) (requiere compilar con la misma ROM)
2. Abrir sm64coopdx → Join → Direct Connection
3. Ingresar `play.consultoria-as.com:7777` (o `192.168.10.234:7777` en LAN)
3. Ingresar `play.consultoria-as.com:7777` (o `192.168.10.96:7777` en LAN)
### Mods incluidos
El build incluye mods bundled del repositorio: character-select, star-road, arena, day-night-cycle, sm74.
@@ -289,7 +452,7 @@ Todos los jugadores deben usar el **mismo emulador** y el **mismo ROM** (se veri
1. Descargar [gopher64](https://github.com/gopher64/gopher64) o RMG
2. Tener el ROM de Mario Party
3. Netplay → Server: seleccionar "Custom"
4. Ingresar `play.consultoria-as.com:45000` (o `192.168.10.234:45000` en LAN)
4. Ingresar `play.consultoria-as.com:45000` (o `192.168.10.96:45000` en LAN)
5. Un jugador crea sala, los demás se unen
### Troubleshooting