{"id":49527561,"url":"https://github.com/yupick/mc-simple","last_synced_at":"2026-05-02T04:03:37.337Z","repository":{"id":337950170,"uuid":"1155855298","full_name":"Yupick/mc-simple","owner":"Yupick","description":"Servidor Minecraft Java basado en Paper con sistema RPG, economía integrada y soporte multicliente para Java y Bedrock. Ideal para jugadores que buscan una experiencia inmersiva y divertida en Minecraft.","archived":false,"fork":false,"pushed_at":"2026-03-28T18:57:41.000Z","size":75792,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-28T20:41:29.685Z","etag":null,"topics":["bedrock-edition","community","economy-siystem","gaming","java-edition","minecraft","minecraft-server","multiclient","multipalyer","open-source","paper","plugins","rpg"],"latest_commit_sha":null,"homepage":"https://mc.nightslayer.com.ar","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yupick.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-12T01:24:28.000Z","updated_at":"2026-03-28T18:57:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Yupick/mc-simple","commit_stats":null,"previous_names":["yupick/mc-simple"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/Yupick/mc-simple","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yupick%2Fmc-simple","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yupick%2Fmc-simple/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yupick%2Fmc-simple/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yupick%2Fmc-simple/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yupick","download_url":"https://codeload.github.com/Yupick/mc-simple/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yupick%2Fmc-simple/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32522253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bedrock-edition","community","economy-siystem","gaming","java-edition","minecraft","minecraft-server","multiclient","multipalyer","open-source","paper","plugins","rpg"],"created_at":"2026-05-02T04:03:11.454Z","updated_at":"2026-05-02T04:03:37.328Z","avatar_url":"https://github.com/Yupick.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎮 Instalador de Servidor Minecraft Paper\n\nSistema completo para instalar y gestionar un servidor de Minecraft Paper con interfaz de línea de comandos.\n\n## 📋 Requisitos\n\nAntes de ejecutar el instalador, asegúrate de tener instalados:\n\n```bash\n# Ubuntu/Debian\nsudo apt update\nsudo apt install curl jq openjdk-21-jre-headless screen\n\n# O verifica qué tienes instalado\ncurl --version\njq --version\njava --version\nscreen --version\n```\n\n## 🚀 Instalación Rápida\n\n1. **Ejecuta el instalador:**\n   ```bash\n   ./install-paper.sh\n   ```\n\n2. **Sigue el asistente interactivo:**\n   - Selecciona la versión de Minecraft (desde 1.19 en adelante)\n   - Decide si instalar plugins de compatibilidad:\n     - **ViaVersion**: permite que jugadores con versiones anteriores/posteriores se conecten\n     - **Geyser + Floodgate**: permite que jugadores de Bedrock Edition se conecten\n\n3. **El instalador creará:**\n   - ✅ Carpeta `server/` con el servidor\n   - ✅ Carpeta `server/plugins/` para plugins\n   - ✅ Script `server/manage-control.sh` para gestionar el servidor\n   - ✅ Archivos de configuración (`eula.txt`, `server.properties`)\n\n## 🎛️ Gestión del Servidor\n\nUna vez instalado, navega a la carpeta del servidor:\n\n```bash\ncd server\n```\n\n### Comandos Disponibles\n\n```bash\n# Iniciar el servidor (se ejecuta en segundo plano)\n./manage-control.sh start\n\n# Detener el servidor de forma segura\n./manage-control.sh stop\n\n# Reiniciar el servidor\n./manage-control.sh restart\n\n# Ver los logs en tiempo real\n./manage-control.sh logs\n# IMPORTANTE: Presiona Ctrl+A y luego D para salir sin cerrar el servidor\n\n# Abrir cliente de consola para enviar comandos\n./manage-control.sh console\n\n# Ver estado del servidor\n./manage-control.sh status\n\n# Ver ayuda\n./manage-control.sh help\n```\n\n## 💻 Cliente de Consola\n\nEl cliente de consola te permite enviar comandos al servidor sin usar un cliente gráfico:\n\n```bash\n./manage-control.sh console\n```\n\nUna vez dentro:\n- Escribe comandos **sin** el `/` inicial\n- Ejemplos:\n  ```\n  minecraft\u003e list\n  minecraft\u003e give Player diamond 64\n  minecraft\u003e tp Player 0 64 0\n  minecraft\u003e say ¡Hola a todos!\n  minecraft\u003e weather clear\n  ```\n- Escribe `exit` o `quit` para salir (el servidor sigue corriendo)\n\n## 📊 Características\n\n### ✨ Servidor\n- **Ejecución en segundo plano**: El servidor corre continuamente\n- **Optimización**: Flags de Aikar para mejor rendimiento\n- **RAM configurable**: 1GB mín, 4GB máx (editable en manage-control.sh)\n- **RCON habilitado**: Puerto 25575, contraseña: `minecraft`\n\n### 🔌 Plugins Opcionales\n1. **ViaVersion**\n   - Permite compatibilidad entre diferentes versiones de Minecraft\n   - Los jugadores con versiones anteriores o posteriores pueden conectarse\n\n2. **Geyser + Floodgate**\n   - Permite que jugadores de Bedrock Edition (consolas, móviles) se conecten\n   - Puerto Bedrock predeterminado: 19132 (UDP)\n\n### 🎮 Gestión Avanzada\n- **Logs en tiempo real**: Ve qué sucede en el servidor sin interferir\n- **Detención segura**: Guarda el mundo antes de cerrar\n- **Reinicio rápido**: Para aplicar cambios de configuración\n\n## 📝 Configuración\n\n### Editar propiedades del servidor\n```bash\nnano server/server.properties\n```\n\nPropiedades importantes:\n- `server-port=25565` - Puerto del servidor\n- `max-players=20` - Máximo de jugadores\n- `gamemode=survival` - Modo de juego predeterminado\n- `difficulty=easy` - Dificultad\n- `online-mode=true` - Verificación de cuentas de Mojang\n- `rcon.password=minecraft` - Contraseña RCON\n\n### Ajustar RAM del servidor\n```bash\nnano server/manage-control.sh\n```\n\nBusca y modifica:\n```bash\nMIN_RAM=\"1G\"    # RAM mínima\nMAX_RAM=\"4G\"    # RAM máxima\n```\n\n## 🔧 Solución de Problemas\n\n### El servidor no inicia\n```bash\n# Verifica que Java esté instalado\njava --version\n\n# Revisa los logs\ncd server\n./manage-control.sh logs\n```\n\n### Screen no encontrado\n```bash\nsudo apt install screen\n```\n\n### Puerto ya en uso\n```bash\n# Verifica qué usa el puerto 25565\nsudo lsof -i :25565\n\n# Cambia el puerto en server.properties\nnano server/server.properties\n# Modifica: server-port=25566\n```\n\n### Problemas con Geyser (Bedrock)\n- Asegúrate de que el puerto UDP 19132 esté abierto\n- Verifica la configuración en `server/plugins/Geyser-Spigot/config.yml`\n\n## 🌐 Conectarse al Servidor\n\n### Java Edition\n1. Abre Minecraft Java Edition\n2. Multijugador → Añadir servidor\n3. Dirección: `tu-ip:25565` (o tu puerto configurado)\n\n### Bedrock Edition (si Geyser está instalado)\n1. Abre Minecraft Bedrock\n2. Servidores → Añadir servidor\n3. Dirección: `tu-ip`\n4. Puerto: `19132`\n\n## 📁 Estructura de Archivos\n\n```\nmc-paper/\n├── install-paper.sh          # Script de instalación\n├── README.md                 # Este archivo\n└── server/                   # Carpeta del servidor (creada al instalar)\n    ├── paper-X.XX-XXX.jar   # Servidor Paper\n    ├── manage-control.sh     # Script de gestión\n    ├── eula.txt             # EULA aceptado\n    ├── server.properties    # Configuración del servidor\n    ├── plugins/             # Carpeta de plugins\n    │   ├── ViaVersion.jar   # (opcional)\n    │   ├── Geyser-Spigot.jar # (opcional)\n    │   └── floodgate-spigot.jar # (opcional)\n    ├── world/               # Mundo principal (generado)\n    ├── world_nether/        # Nether (generado)\n    ├── world_the_end/       # End (generado)\n    └── logs/                # Logs del servidor (generado)\n```\n\n## 🔐 Seguridad\n\n- **Cambia la contraseña de RCON** en `server.properties`\n- **Configura el firewall** para permitir solo puertos necesarios:\n  ```bash\n  sudo ufw allow 25565/tcp  # Java\n  sudo ufw allow 19132/udp  # Bedrock (si usas Geyser)\n  ```\n- **Habilita whitelist** si es un servidor privado:\n  ```\n  ./manage-control.sh console\n  minecraft\u003e whitelist on\n  minecraft\u003e whitelist add NombreJugador\n  ```\n\n## 📚 Recursos Útiles\n\n- [Paper MC](https://papermc.io/) - Sitio oficial\n- [ViaVersion](https://viaversion.com/) - Compatibilidad de versiones\n- [GeyserMC](https://geysermc.org/) - Compatibilidad Bedrock/Java\n- [Aikar's Flags](https://docs.papermc.io/paper/aikars-flags) - Optimización JVM\n\n## 📄 Licencia\n\nEste script es de código abierto. El servidor Paper y los plugins tienen sus propias licencias.\n\n---\n\n## 🌿 Flujo de Desarrollo (GitFlow)\n\nEste proyecto usa **GitFlow** para gestión ordenada de versiones y desarrollo.\n\n### 📌 Estructura de Ramas\n\n- **`main`**: Código en producción, 100% estable\n- **`develop`**: Rama de integración, último código desarrollado\n- **`feature/*`**: Nuevas funcionalidades\n- **`release/*`**: Preparación de versiones  \n- **`hotfix/*`**: Correcciones urgentes en producción\n\n### 🚀 Contribuir\n\n1. **Fork** del repositorio\n2. **Crear feature branch**:\n   ```bash\n   git checkout develop\n   git checkout -b feature/mi-funcionalidad\n   ```\n3. **Commits con convención**:\n   ```bash\n   git commit -m \"feat(scope): descripción\"\n   ```\n4. **Push y Pull Request**:\n   ```bash\n   git push origin feature/mi-funcionalidad\n   ```\n   Crear PR hacia `develop` en GitHub\n\n### 📝 Convención de Commits\n\n- `feat`: Nueva funcionalidad\n- `fix`: Corrección de bug\n- `docs`: Documentación\n- `style`: Formato, estilos\n- `refactor`: Refactorización\n- `perf`: Mejora de rendimiento\n- `test`: Tests\n- `chore`: Mantenimiento, configuración\n\n### 📦 Versionado\n\nUsamos [Semantic Versioning](https://semver.org/lang/es/): `vMAJOR.MINOR.PATCH`\n\n- **MAJOR**: Cambios incompatibles\n- **MINOR**: Nueva funcionalidad compatible\n- **PATCH**: Correcciones de bugs\n\nVer [CHANGELOG.md](CHANGELOG.md) para historial completo.\n\n---\n\n**¿Necesitas ayuda?** Revisa los logs del servidor con `./manage-control.sh logs` o ejecuta `./manage-control.sh status` para ver el estado actual.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyupick%2Fmc-simple","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyupick%2Fmc-simple","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyupick%2Fmc-simple/lists"}