🚀 Despliegue en Railway (3 pasos)

1. Fork o Clone este repositorio

git clone https://github.com/Dubbxd/minechamp.git
cd minechamp

2. Despliega en Railway

1. Ve a Railway.app y crea una cuenta
2. Click en "New Project"
3. Selecciona "Deploy from GitHub repo"
4. Elige el repositorio Dubbxd/minechamp
5. Railway detectará automáticamente el Dockerfile y comenzará el build

3. Configura las Variables de Entorno

En el Dashboard de Railway, ve a la pestaña Variables y configura:

Variables Esenciales

Variables Opcionales

Configuración según tu Plan de Railway

Railway Hobby Plan (Gratis - 512MB-1GB RAM):

MEMORY_MIN=512M
MEMORY_MAX=1G
MAX_PLAYERS=5
VIEW_DISTANCE=6

Railway Pro Plan (2GB-8GB RAM):

MEMORY_MIN=2G
MEMORY_MAX=4G
MAX_PLAYERS=20
VIEW_DISTANCE=12

Deploy and Host

About Hosting

MineChamp es un servidor de Minecraft 1.21.11 completamente configurado y optimizado para ejecutarse en Railway.app. Este template proporciona una solución lista para usar que elimina la complejidad de configurar un servidor de Minecraft desde cero.

El servidor viene preconfigurado con:

• Java 21 Runtime optimizado para mejor rendimiento
• Docker containerizado para despliegues consistentes y portables
• Variables de entorno para configuración flexible sin tocar archivos
• Optimizaciones JVM (Aikar's Flags) para mejor gestión de memoria
• Reinicio automático ante fallos para máxima disponibilidad

Railway proporciona hosting en la nube con recursos escalables, facturación por uso, y TCP Proxy automático para que tu servidor sea accesible desde cualquier cliente de Minecraft.

Why Deploy

¿Por qué elegir este template?

🚀 Despliegue instantáneo: En menos de 5 minutos tendrás un servidor de Minecraft funcional, sin necesidad de conocimientos técnicos avanzados.

💰 Económico y escalable: Railway ofrece un plan gratuito para empezar y puedes escalar recursos según tus necesidades. Solo pagas por lo que usas.

🔧 Fácil configuración: Todas las configuraciones importantes están expuestas como variables de entorno. No necesitas editar archivos de configuración complejos.

✅ Compatible con todos los launchers: Funciona con Mojang oficial, TLauncher, MultiMC, y cualquier otro launcher de Minecraft.

🔄 Actualizaciones simples: Solo actualiza el server.jar, haz commit y Railway redesplegará automáticamente.

📊 Monitoreo incluido: Railway proporciona logs en tiempo real, métricas de CPU/RAM y alertas sin configuración adicional.

🛡️ Persistencia de datos: Soporte para volúmenes para que tu mundo no se pierda entre deployments.

Common Use Cases

Casos de uso comunes

🎮 Servidor privado para amigos

• Perfecto para jugar con amigos sin preocuparte por hosting o configuración
• Configura whitelist para mantenerlo privado
• Escala recursos según la cantidad de jugadores

🏫 Servidor educativo

• Ideal para aulas y grupos de estudio
• Control total sobre configuración y comandos
• Fácil administración desde los logs de Railway

🎯 Servidor de pruebas

• Testea mods, plugins o configuraciones
• Crea y destruye servidores fácilmente
• Sin compromisos de hosting a largo plazo

🌐 Servidor comunitario pequeño

• Perfecto para comunidades de 5-20 jugadores
• Configurable para diferentes modos de juego
• Económico para proyectos personales

💼 Servidor de desarrollo

• Desarrolla y prueba configuraciones de Minecraft
• Fácil integración con Git para control de versiones
• Deployments automatizados

Dependencies for

Deployment Dependencies

Este template tiene las siguientes dependencias para desplegar correctamente:

Dependencias del Sistema:

• Docker: Railway utiliza el Dockerfile incluido para construir el contenedor
• Git: Para clonar y versionar tu configuración

Dependencias de Runtime:

• Java 21 (Eclipse Temurin): Runtime incluido en el contenedor Docker
• Bash: Para ejecutar el script de inicio (start.sh)
• Alpine Linux: Sistema operativo base ligero del contenedor

Dependencias del Proyecto:

• server.jar: Archivo del servidor de Minecraft 1.21.11 (incluido)
• eula.txt: Aceptación de EULA de Minecraft (incluido)
• server.properties: Configuración del servidor (incluido)
• start.sh: Script de inicio optimizado (incluido)

Dependencias de Railway:

• Cuenta de Railway: Gratuita o de pago según necesidades
• GitHub Repository: Para desplegar desde tu repositorio
• TCP Proxy: Railway lo proporciona automáticamente para el puerto 25565

Opcional:

• Railway Volume: Para persistencia de datos del mundo
• Custom Domain: Si deseas un dominio personalizado (requiere plan Pro)

Todas las dependencias críticas están incluidas en este template. Solo necesitas una cuenta de Railway y hacer clic en "Deploy" para empezar.

🌐 Conectarse al Servidor

Configurar TCP Proxy en Railway

Paso importante antes de conectarte:

1. En tu proyecto de Railway, ve a la pestaña "Networking"
2. En la sección "Public Networking", busca "Connect to your service over TCP using a proxied domain and port"
3. Railway generará automáticamente un TCP Proxy (ejemplo: turntable.proxy.rlwy.net:21751)
4. Asegúrate de que el puerto mapeado sea 25565 (el puerto de Minecraft)
5. Copia la dirección completa del TCP Proxy

Conectarse desde Minecraft

1. Railway te habrá asignado un TCP Proxy (ejemplo: turntable.proxy.rlwy.net:21751)
2. Abre Minecraft 1.21.11
3. Multijugador → Añadir Servidor
4. Dirección del servidor: Pega el TCP Proxy que copiaste
   • Ejemplo: turntable.proxy.rlwy.net:21751
   • NO uses el dominio HTTP (ej: minechamp.devchefs.mx) - no funciona para Minecraft
5. ¡Juega!

⚠️ Importante

• ✅ USA: El dominio TCP Proxy (turntable.proxy.rlwy.net:PUERTO)
• ❌ NO USES: El dominio HTTP/HTTPS (tudominio.devchefs.mx)
• 🔌 Puerto interno: Siempre debe ser 25565 (puerto estándar de Minecraft)
• 🌐 Puerto externo: Railway lo asigna automáticamente (puede variar)

⚙️ Personalización

Cambiar el Nombre del Servidor

Edita server.properties y modifica:

motd=Tu Nombre de Servidor Aquí

O usa la variable de entorno MOTD en Railway (recomendado).

Modificar Configuración

Edita los archivos según tus necesidades:

• server.properties - Configuración principal
• bukkit.yml - Spawn y chunks
• spigot.yml - Optimizaciones

Después de editar:

git add .
git commit -m "Update configuration"
git push

Railway redesplegará automáticamente.

🔧 Comandos de Administración

En los logs de Railway puedes ejecutar:

/op               # Dar permisos de operador
/whitelist add    # Añadir a lista blanca
/gamemode creative         # Cambiar a modo creativo
/time set day              # Cambiar a día
/difficulty peaceful       # Cambiar dificultad
/stop                      # Detener servidor

💾 Persistencia de Datos

⚠️ Importante: Para mantener tu mundo entre deployments:

1. Ve a tu proyecto en Railway
2. Settings → Volumes
3. Añade un volumen montado en /minecraft/world

💰 Optimizar Costos en Railway

Configuración Económica Recomendada

Para reducir el consumo de recursos y costos:

1. Ajusta la Memoria RAM

MEMORY_MIN=512M
MEMORY_MAX=1G

• Usar solo la RAM necesaria reduce el consumo de recursos
• Para 2-5 jugadores: 1GB es suficiente
• Para 10-20 jugadores: 2GB recomendado

2. Reduce la Distancia de Visión

VIEW_DISTANCE=6
SIMULATION_DISTANCE=6

• Menor distancia = menos chunks cargados = menos CPU/RAM
• VIEW_DISTANCE=6 es aceptable para juego normal
• VIEW_DISTANCE=10 solo para servidores grandes

3. Limita Jugadores Máximos

MAX_PLAYERS=10

• Cada jugador consume CPU y RAM
• Sé realista con la cantidad esperada

4. Desactiva el Servidor cuando no se Use

Railway cobra por tiempo de ejecución:

• Opción 1: Detén manualmente el servidor desde Railway Dashboard
• Opción 2: Usa el comando /stop en los logs
• Opción 3: Configura un horario de uso (requiere scripts externos)

5. Optimiza las Configuraciones del Servidor

En server.properties:

# Reduce carga de entidades
spawn-animals=true (pero limita con plugins)
spawn-monsters=true (considera peaceful en horas vacías)
entity-broadcast-range-percentage=80

# Optimiza chunks
view-distance=6
simulation-distance=6

En spigot.yml:

world-settings:
  default:
    mob-spawn-range: 4
    entity-activation-range:
      animals: 16
      monsters: 24
      raiders: 32

6. Usa el Plan Hobby Eficientemente

Railway Hobby Plan incluye:

• $5 USD de crédito mensual gratuito
• Suspensión automática tras inactividad (configurable)
• Para uso casual (20-40 horas/mes) puede ser gratis

7. Monitorea el Uso

• Revisa las métricas de Railway regularmente
• Identifica picos de consumo
• Ajusta configuración según patrones de uso

Estimación de Costos

Ejemplo - Servidor Casual (1GB RAM, 30 horas/mes):

• Costo aproximado: $2-4 USD/mes
• Ideal para jugar con amigos los fines de semana

Ejemplo - Servidor Regular (2GB RAM, 100 horas/mes):

• Costo aproximado: $8-12 USD/mes
• Para comunidades pequeñas activas

Ejemplo - Servidor 24/7 (2GB RAM, 730 horas/mes):

• Costo aproximado: $15-25 USD/mes
• Para servidores públicos permanentes

💡 Tip Pro: Combina Railway con un bot de Discord que inicie/detenga el servidor automáticamente cuando los jugadores lo necesiten.

🐛 Solución de Problemas

El servidor no inicia:

• Revisa los logs en Railway
• Verifica las variables de entorno
• Asegúrate que MEMORY_MAX no exceda tu plan

No puedo conectarme:

• Confirma que el servidor esté "Active"
• Usa Minecraft 1.21.11 exactamente
• Dominio completo: tudominio.railway.app:25565

Lag o bajo rendimiento:

MEMORY_MAX=1G
VIEW_DISTANCE=6
MAX_PLAYERS=10

🔒 Seguridad

Whitelist (Servidor Privado)

En server.properties:

white-list=true

Luego en logs de Railway:

/whitelist add jugador1

🔄 Actualizar Minecraft

1. Descarga nuevo server.jar
2. Reemplaza el archivo
3. Commit y push
4. Railway redesplegará automáticamente

📝 Especificaciones

• Versión: Minecraft 1.21.11 Vanilla
• Java: OpenJDK 21
• Optimizaciones: Aikar's JVM Flags
• Puerto: 25565

👨‍💻 Desarrollador

Dubbxd

• GitHub: @Dubbxd
• Proyecto: MineChamp

🛠️ Tecnologías Utilizadas

• Minecraft Server: Vanilla 1.21.11
• Java Runtime: Eclipse Temurin 21 (OpenJDK)
• Contenedor: Docker Alpine Linux
• Platform: Railway.app
• Optimización: Aikar's JVM Flags

📊 Características del Template

✅ Despliegue automático con un click
✅ Variables de entorno configurables
✅ Optimizado para recursos limitados
✅ Compatible con launchers alternativos
✅ Reinicio automático ante fallos
✅ Logs en tiempo real
✅ Soporte para persistencia de datos

Repositorio: https://github.com/Dubbxd/minechamp
¡Servidor listo en 5 minutos! 🚂⛏️