{"id":34882003,"url":"https://github.com/oomrconrado/pycraft","last_synced_at":"2026-02-04T19:01:36.396Z","repository":{"id":328543269,"uuid":"1075793021","full_name":"OOMrConrado/PyCraft","owner":"OOMrConrado","description":"An intuitive tool to create and manage Minecraft vanilla and modded servers","archived":false,"fork":false,"pushed_at":"2026-01-02T19:31:34.000Z","size":997,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-01-03T00:28:26.014Z","etag":null,"topics":["curseforge-api","fabric","forge","minecraft","minecraft-server","minecraft-server-software","modrinth-api","pycraft","python"],"latest_commit_sha":null,"homepage":"https://pycraft-web.vercel.app","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OOMrConrado.png","metadata":{"files":{"readme":"README.es.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-10-14T02:07:18.000Z","updated_at":"2026-01-02T19:32:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/OOMrConrado/PyCraft","commit_stats":null,"previous_names":["oomrconrado/pycraft"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/OOMrConrado/PyCraft","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OOMrConrado%2FPyCraft","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OOMrConrado%2FPyCraft/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OOMrConrado%2FPyCraft/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OOMrConrado%2FPyCraft/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OOMrConrado","download_url":"https://codeload.github.com/OOMrConrado/PyCraft/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OOMrConrado%2FPyCraft/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29092984,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T03:31:03.593Z","status":"ssl_error","status_checked_at":"2026-02-04T03:29:50.742Z","response_time":62,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["curseforge-api","fabric","forge","minecraft","minecraft-server","minecraft-server-software","modrinth-api","pycraft","python"],"created_at":"2025-12-26T02:18:34.291Z","updated_at":"2026-02-04T19:01:36.391Z","avatar_url":"https://github.com/OOMrConrado.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PyCraft - Minecraft Server Manager\n\n**Español** | [English](README.md)\n\n**Una herramienta intuitiva para crear y gestionar servidores de Minecraft vanilla y con modpacks**\n\nPyCraft simplifica la creación de servidores de Minecraft, permitiéndote descargar, configurar e iniciar servidores vanilla o con modpacks de forma automática. Con soporte para Forge, Fabric, NeoForge, Quilt, y búsqueda integrada de modpacks de Modrinth.\n\n---\n\n## Características\n\n### Gestión de Servidores\n- **Servidores Vanilla**: Crea servidores Minecraft vanilla con un solo clic\n- **Servidores con Mods**: Instala y gestiona servidores con Forge, Fabric, NeoForge o Quilt\n- **Instalación de Modpacks**: Busca e instala modpacks de servidor directamente desde Modrinth y CurseForge\n- **Modpacks de Cliente**: Navega y encuentra modpacks para tu launcher de Minecraft\n- **Configuración Automática**: EULA aceptado y server.properties configurado automáticamente\n- **Reinicio Rápido**: Estado del servidor mantenido tras detener/crash para reinicio instantáneo\n\n### Interfaz\n- **UI Moderna**: Interfaz limpia construida con PySide6 (framework Qt)\n- **Sidebar Organizado**: Navegación fácil con secciones dedicadas para:\n  - Inicio\n  - Servidor Vanilla\n  - Servidor con Mods\n  - Modpacks de Cliente\n  - Gestión (Java y Modpacks)\n  - Configuración\n- **Consola en Tiempo Real**: Consola de 500 líneas con resaltado de sintaxis\n- **Enlaces Rápidos**: Acceso directo a GitHub, Modrinth, CurseForge\n\n### Características Avanzadas\n- **Gestión de Java**: Detección e instalación automática de Java con compatibilidad de versiones\n- **Detección de Crashes**: Detección automática de crashes con acceso directo a logs y reportes de crash\n- **Editor de Config**: Editor integrado de server.properties (habilitado tras primera ejecución)\n- **Feedback Visual**: Animaciones de botones e indicadores de estado\n- **Operaciones Thread-safe**: Gestión confiable del servidor con threading apropiado\n\n---\n\n## Instalación\n\n### Requisitos Previos\n- **Python 3.8+** instalado\n- **Java 17+** (o será instalado automáticamente)\n- **Windows 10/11** (Linux y macOS compatibles)\n\n### Pasos de Instalación\n\n1. **Clona el repositorio:**\n```bash\ngit clone https://github.com/OOMrConrado/PyCraft.git\ncd PyCraft\n```\n\n2. **Crea un entorno virtual:**\n```bash\npython -m venv .venv\n.venv\\Scripts\\activate  # En Windows\nsource .venv/bin/activate  # En Linux/macOS\n```\n\n3. **Instala las dependencias:**\n```bash\npip install -r requirements.txt\n```\n\n4. **Ejecuta la aplicación:**\n```bash\npython main.py\n```\n\n---\n\n## Uso Rápido\n\n### Crear un Servidor Vanilla\n\n1. Abre PyCraft\n2. Ve a **\"Servidor Vanilla\"** en el sidebar\n3. Selecciona **\"Crear Servidor Nuevo\"**\n4. Busca y selecciona una versión de Minecraft\n5. Elige una carpeta de destino\n6. Haz clic en **\"Descargar e Instalar Servidor\"**\n7. Una vez completado, haz clic en **\"Iniciar Servidor\"**\n8. El servidor generará `server.properties` en la primera ejecución\n9. Usa el botón **\"Config\"** para personalizar la configuración del servidor\n\n### Instalar un Modpack de Servidor\n\n1. Ve a **\"Servidor con Mods\"** en el sidebar\n2. Selecciona **\"Instalar Servidor\"**\n3. Busca tu modpack favorito (ej: \"Create\", \"ATM9\")\n4. Selecciona el modpack y la versión\n5. Elige una carpeta de destino\n6. Haz clic en **\"Instalar Modpack\"**\n7. PyCraft descargará y configurará todo automáticamente\n8. Haz clic en **\"Iniciar Servidor\"** cuando esté listo\n\n### Gestionar un Servidor Existente\n\n1. En **\"Servidor con Mods\"**, selecciona **\"Ejecutar Servidor\"**\n2. Elige la carpeta del servidor\n3. PyCraft detectará automáticamente el tipo (Forge/Fabric/NeoForge/Quilt)\n4. Haz clic en **\"Iniciar Servidor\"**\n5. Envía comandos a través de la consola\n6. Usa **\"Config\"** para editar las propiedades del servidor (tras primera ejecución)\n\n### Navegar Modpacks de Cliente\n\n1. Ve a **\"Modpacks de Cliente\"** en el sidebar\n2. Elige el proveedor (Modrinth o CurseForge)\n3. Busca un modpack\n4. Haz clic en **\"Open\"** para visitar la página del modpack\n5. Descarga e instala a través del launcher oficial (CurseForge App o Modrinth)\n\n---\n\n## Tecnologías\n\n- **Python 3.x**\n- **PySide6** - Framework GUI moderno basado en Qt\n- **QtAwesome** - Biblioteca de iconos para una interfaz hermosa\n- **Requests** - Comunicación con APIs\n- **Threading** - Operaciones asíncronas para UI fluida\n\n---\n\n## Estructura del Proyecto\n\n```\nPyCraft/\n├── main.py              # Punto de entrada\n├── docs/                # Documentación\n│   ├── en/             # Documentación en inglés\n│   └── es/             # Documentación en español\n├── src/\n│   ├── core/           # Lógica de negocio\n│   │   ├── api.py      # Manejadores de API (Minecraft, Modrinth)\n│   │   └── download.py # Sistema de descargas\n│   ├── managers/       # Gestores de recursos\n│   │   ├── java/       # Detección e instalación de Java\n│   │   ├── server/     # Gestión de servidores\n│   │   └── modpack/    # Instalación de modpacks\n│   ├── gui/            # Interfaz gráfica\n│   │   └── main_window.py  # UI principal\n│   └── utils/          # Utilidades\n└── PyCraft-Files/      # Assets (logo, iconos)\n```\n\nPara información detallada de la arquitectura, ver [docs/es/STRUCTURE.md](docs/es/STRUCTURE.md)\n\n---\n\n## Vista General de la Interfaz\n\n### Navegación por Sidebar\n- **Inicio**: Página de bienvenida con enlaces rápidos\n- **Servidor Vanilla**: Crea y gestiona servidores vanilla\n- **Servidor con Mods**: Instala y ejecuta servidores con mods\n- **Modpacks de Cliente**: Instala modpacks para tu launcher\n- **Sección de Gestión**:\n  - **Java**: Gestiona instalaciones de Java\n  - **Modpacks**: Visualiza y gestiona modpacks de cliente instalados\n- **Configuración**: Ajustes de la aplicación e información\n\n### Características de la Consola\n- Salida del servidor en tiempo real\n- Resaltado de sintaxis (errores, advertencias, info)\n- Buffer de 500 líneas para logs completos\n- Entrada de comandos con prefijo `/`\n- Feedback visual al enviar comandos\n\n### Manejo de Crashes\n- Detección automática de crashes\n- Diálogo modal con información del crash\n- Enlaces directos a:\n  - Carpeta de logs del servidor\n  - Carpeta de reportes de crash\n- Servidor listo para reiniciar inmediatamente\n\n---\n\n## Contribuir\n\nLas contribuciones son bienvenidas. Por favor lee [docs/es/CONTRIBUTING.md](docs/es/CONTRIBUTING.md) para conocer los detalles del proceso y el código de conducta.\n\n### Pasos para Contribuir\n\n1. Fork el proyecto\n2. Crea tu rama de feature (`git checkout -b feature/AmazingFeature`)\n3. Commit tus cambios (`git commit -m 'Add some AmazingFeature'`)\n4. Push a la rama (`git push origin feature/AmazingFeature`)\n5. Abre un Pull Request\n\n---\n\n## Licencia\n\nEste proyecto está bajo la Licencia MIT. Ver [LICENSE](LICENSE) para más detalles.\n\n---\n\n## Autor\n\n**Conrado Gómez**\n- GitHub: [@OOMrConrado](https://github.com/OOMrConrado)\n- Email: conradogomez556@gmail.com\n\n---\n\n## Agradecimientos\n\n- [Mojang](https://www.minecraft.net/) - Por Minecraft\n- [Modrinth](https://modrinth.com/) - Por su excelente API de modpacks\n- [CurseForge](https://www.curseforge.com/) - Por su plataforma y API de modpacks\n- [PySide6](https://www.qt.io/qt-for-python) - Por el framework Qt\n- [QtAwesome](https://github.com/spyder-ide/qtawesome) - Por la biblioteca de iconos\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foomrconrado%2Fpycraft","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foomrconrado%2Fpycraft","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foomrconrado%2Fpycraft/lists"}