01- Configuración de Servidor para programar con Minecraft y Python - Curso 2019

 https://www.youtube.com/watch?v=kBLZ_jaNwkI&list=PLMCmWXQNbp0zjrIDy91hY5Y8_291JGC9j&index=1

Tutorial de Configuración de Servidor para Programar con Minecraft y Python

Este tutorial te guiará paso a paso para configurar un servidor de Minecraft que pueda ser controlado mediante Python. Podrás colocar bloques, enviar mensajes de chat, manipular entidades e incluso construir estructuras automáticamente con código.

Requisitos Previos

Antes de comenzar, asegúrate de tener instalado:

  • Minecraft Java Edition (se recomienda la versión 1.12.2 por su mejor compatibilidad)

  • Python 3 (se recomienda 3.10 o superior)

  • Java 8 (necesario para algunas herramientas)

Elección del Método

Existen dos métodos principales para configurar un servidor de Minecraft con Python:

MétodoCaso de usoComponentes principales
Servidor Spigot/Forge + plugin RaspberryJuiceServidores multijugador, enseñanza en LANSpigot/Forge, RaspberryJuice, librería mcpi
Raspberry Jam Mod (un jugador/LAN)Juego individual, inicio rápidoForge, Raspberry Jam Mod, librería mcpi

A continuación nos centraremos en el Método 1 (Servidor Spigot + RaspberryJuice), ya que es más estable en entornos multijugador y de enseñanza en red.

Paso 1: Instalar Python y la librería mcpi

  1. Descarga e instala Python 3 desde python.org. Durante la instalación, marca obligatoriamente la casilla "Add Python to PATH", de lo contrario los comandos no funcionarán después.

  2. Abre el símbolo del sistema (en Windows presiona Win + R, escribe cmd) y verifica la instalación:

    text
    python --version

  3. Instala la librería mcpi:

    text
    pip install mcpi

    Si la descarga es lenta, puedes intentar usar un mirror o descargarla con otra herramienta.

Librería alternativa: mcpi-e es una bifurcación mejorada de mcpi que admite entornos multiusuario. Si planeas usarla en un servidor multijugador, considera instalarla: pip install mcpi-e.

Paso 2: Montar un servidor Spigot

Si ya tienes un servidor Spigot, puedes saltar este paso.

  1. Visita el sitio oficial de SpigotMC para obtener la herramienta BuildTools.

  2. Ejecuta BuildTools para generar el archivo jar del servidor Spigot.

  3. Coloca el archivo jar generado en una carpeta dedicada (por ejemplo, minecraft-server).

  4. Ejecuta el archivo jar por primera vez; se generarán los archivos de configuración automáticamente. Luego edita eula.txt y cambia eula=false por eula=true.

Paso 3: Instalar el plugin RaspberryJuice

RaspberryJuice es el puente central entre Python y Minecraft. Escucha en el puerto 4711 las instrucciones enviadas por los scripts de Python.

  1. Descarga el plugin RaspberryJuice (archivo .jar) desde la página de recursos de SpigotMC o desde GitHub.

  2. Crea un directorio plugins en la carpeta del servidor (si aún no existe).

  3. Coloca el archivo .jar de RaspberryJuice dentro de la carpeta plugins.

  4. Inicia el servidor. Si la instalación fue exitosa, verás un mensaje similar a RaspberryJuice cargándose en el registro de inicio.

Nota sobre la red: RaspberryJuice usa el puerto 4711, no el 25565 predeterminado de Minecraft. Si tu servidor tiene firewall, deberás abrir ambos puertos.

Paso 4: Escribir y ejecutar tu primer script en Python

Crea un archivo Python, por ejemplo hola_minecraft.py:

python
from mcpi.minecraft import Minecraft

# Conectar al servidor
mc = Minecraft.create("127.0.0.1", 4711)

# Enviar un mensaje al chat
mc.postToChat("¡Hola desde Python!")

# Obtener la posición del jugador y colocar un bloque de piedra al lado
x, y, z = mc.player.getTilePos()
mc.setBlock(x + 1, y, z, 1)  # 1 representa el bloque de piedra

Cómo ejecutarlo: en la línea de comandos ejecuta python hola_minecraft.py. Si todo funciona correctamente, verás el mensaje en el chat del juego y aparecerá un bloque de piedra junto al jugador.

Punto clave: el puerto utilizado para la conexión debe ser el 4711, que es el puerto de escucha del plugin RaspberryJuice, no el 25565 del servidor de Minecraft en sí.

Paso 5: Verificar la configuración

Puedes probar cada funcionalidad con el siguiente fragmento de código:

python
from mcpi.minecraft import Minecraft

mc = Minecraft.create("IP_del_servidor", 4711)

# Prueba 1: enviar mensaje al chat
mc.postToChat("§a¡Conexión con Python exitosa!")  # §a significa verde

# Prueba 2: obtener posición del jugador
pos = mc.player.getTilePos()
print(f"Posición actual: X={pos.x}, Y={pos.y}, Z={pos.z}")

# Prueba 3: colocar un bloque
mc.setBlock(pos.x, pos.y - 1, pos.z, 1)  # Coloca piedra bajo los pies

# Prueba 4: ejecutar comando del servidor
mc.runCommand("time set day")

Problemas Comunes y Soluciones

Conexión rechazada (Connection Refused)

La causa más frecuente es que el plugin RaspberryJuice no está instalado o no se cargó correctamente, por lo que el puerto 4711 no está abierto. Verifica que el plugin esté en la carpeta plugins y revisa el registro de inicio del servidor para ver si aparece el mensaje de carga.

Problema de identificación del jugador en servidores multijugador

Si tu servidor tiene varios jugadores, mc.player.getTilePos() puede devolver por defecto la posición del primer jugador, no la tuya. La solución es usar la librería mcpi-e y pasar el nombre del jugador al crear la conexión:

python
from mcpi_e.minecraft import Minecraft
mc = Minecraft.create("IP_del_servidor", 4711, "tu_nombre_de_jugador")

Así te aseguras de que el script opere sobre el personaje correcto.

Conexión remota en red local

Si tu script de Python se ejecuta en otra computadora y el servidor está en otra máquina:

  1. Cambia la dirección en Minecraft.create() por la IP local del servidor (por ejemplo, 192.168.1.8).

  2. Asegúrate de que el firewall del servidor permita las conexiones entrantes en el puerto 4711.

El script se ejecuta pero no ocurre nada en el juego

Verifica que:

  • Estás conectado al servidor correcto (no a un mundo de un solo jugador).

  • El jugador está dentro del mundo (no en la pantalla de menú).

  • El bloque que intentas colocar no está ocupado por otro bloque o entidad.

Con esto ya tienes tu servidor de Minecraft listo para programar con Python. A partir de aquí puedes explorar la API de mcpi para crear desde simples construcciones hasta verdaderos proyectos automatizados. ¡Buena programación.



Configuración de un Servidor de Minecraft para Programar con Python

Basado en el método clásico con Spigot + RaspberryJuice + Minecraft Tools

Este tutorial te enseñará paso a paso cómo montar tu propio servidor de Minecraft Java Edition para poder programar con Python. Con pocas líneas de código podrás construir bardas gigantes, esferas, castillos y mucho más en segundos.

¿Qué podrás hacer?

Con este método, un pequeño programa en Python puede convertirse en una barda de cuatro lados, y simplemente cambiando algunos números (material, altura y tamaño), el resultado cambia por completo. También verás cómo hacer un contador que después de 10 segundos elimina todo lo creado, para poder reutilizar el mundo sin reiniciarlo.

Idea central: Minecraft + Python son de las mejores herramientas para aprender a programar.

Requisitos Previos

Antes de empezar, necesitas tener instalado:

  1. Minecraft Java Edition (NO la edición de Windows 10, iPad, etc.). En este tutorial se usa la versión de Windows, pero también funciona en Mac.

  2. Java instalado. Verifícalo abriendo el Símbolo del sistema (CMD) y escribiendo:

    text
    java -version

    Debe mostrar algo como 1.8.0. Si no aparece, necesitas instalar Java.

  3. Python 3 instalado. Verifícalo con:

    text
    python --version

Si cumples con estos tres requisitos, estás listo para comenzar.

Paso 1: Crear la carpeta del servidor

Crea una carpeta donde guardarás todos los archivos del servidor. Por ejemplo:

text
C:\minecraft-con-python-2019

Puedes ponerla donde quieras, pero ahí vivirá todo el proyecto.

Paso 2: Descargar Spigot

  1. Ve a getbukkit.org (o la página oficial de descargas de Spigot).

  2. Descarga la versión más reciente de Spigot (en el tutorial original era la 1.14.4).

  3. Aparecerá una advertencia porque es un archivo ejecutable; es un archivo seguro, dale clic en Keep (Conservar).

  4. Coloca el archivo spigot-1.14.4.jar dentro de tu carpeta del servidor.

Paso 3: Descargar Minecraft Tools

  1. Ve a nuestrastart.com/programming-with-minecraft (o busca "Minecraft Tools for Python").

  2. Descarga los archivos correspondientes a tu sistema operativo (en el tutorial, Windows).

  3. Coloca el archivo comprimido en la misma carpeta del servidor.

Nota: necesitarás WinRAR, WinZip o algún programa similar para extraerlo.

Paso 4: Instalar el servidor por primera vez

  1. Ejecuta el archivo spigot-1.14.4.jar con Java (doble clic).

    • Si se abre con WinRAR por error, ábrelo con Java explícitamente.

  2. Espera un par de minutos. Se generarán:

    • La carpeta logs

    • El archivo eula.txt

    • El archivo server.properties

Paso 5: Aceptar el contrato (EULA)

  1. Abre eula.txt con un editor de texto (Notepad++ o el Bloc de notas).

  2. Cambia:

    text
    eula=false

    por:

    text
    eula=true

  3. Guarda el archivo.

Paso 6: Ejecutar el servidor por segunda vez

  1. Vuelve a ejecutar el spigot-1.14.4.jar.

  2. Espera otros minutos. Se generarán todos los archivos nuevos del servidor.

  3. Verifica en el Administrador de tareas que el servidor esté corriendo.

  4. Cuando termine de generarse todo, finaliza la tarea del servidor para detenerlo por ahora.

Paso 7: Crear el archivo de inicio (start_server.bat)

Este archivo arrancará el servidor con la cantidad de RAM asignada.

  1. Crea un archivo de texto cualquiera y ábrelo con un editor de texto.

  2. Escribe las siguientes dos líneas (para 1 GB de RAM, suficiente para uso personal):

    bat
    java -Xmx1024M -Xms1024M -jar spigot-1.14.4.jar
pause

    • -Xmx1024M = RAM máxima (1024 MB = 1 GB)

    • -Xms1024M = RAM mínima

    • pause = mantiene la ventana abierta para interactuar con la consola

  3. Guarda como start_server.bat (en "Guardar como tipo" selecciona Todos los tipos para que conserve la extensión .bat).

  4. Guárdalo en la carpeta del servidor.

  5. Puedes borrar el archivo de texto temporal que usaste al inicio.

Si vas a compartir el servidor con varias personas, asigna más RAM (por ejemplo, 2 o 4 GB).

Paso 8: Extraer Minecraft Tools e instalar los archivos

  1. Extrae el archivo minecraft-tools.zip en su propia carpeta (por ejemplo, minecraft-tools).

  2. Abre la carpeta extraída. Verás dos archivos importantes:

    • install

    • minecraft_python

  3. Arrastra esos dos archivos a la carpeta principal del servidor.

  4. Entra en la carpeta server → plugins de Minecraft Tools.

  5. Arrastra los cuatro archivos raspberryjuice a la carpeta plugins de tu servidor.

    • El más importante es RaspberryJuice, que permite ejecutar comandos con Python.

  6. Ya puedes borrar la carpeta minecraft-tools (ya no la necesitas).

Paso 9: Instalar la API de Minecraft para Python

  1. En la carpeta del servidor, busca el archivo install que arrastraste antes.

  2. Haz doble clic. Se abrirá una ventana.

  3. Si dice "Successfully installed Minecraft Python", la instalación fue exitosa.

  4. Presiona cualquier tecla para cerrar.

API = Application Programming Interface. Permite que programas escritos en Python se comuniquen con el servidor de Minecraft.

Paso 10: Crear un perfil en Minecraft para la versión correcta

Es importante que tu cliente de Minecraft use la misma versión que el servidor (1.14.4), porque si Minecraft se actualiza, podría dejar de ser compatible.

  1. Abre Minecraft Java Edition.

  2. Ve a Instalaciones (Installations).

  3. Verás el perfil "Latest Release" (que se actualiza automáticamente). No lo uses.

  4. Haz clic en Nuevo (New) y crea un perfil:

    • Nombre: Python con Minecraft 1.14.4

    • Versión: 1.14.4

    • Resolución: automática

    • Directorio: por defecto

  5. Crea el perfil.

  6. En la pantalla de Play, selecciona ese perfil y haz clic en Jugar.

Paso 11: Arrancar el servidor y conectarte

  1. Ve a la carpeta del servidor y haz doble clic en start_server.bat.

  2. Aparecerá una ventana con muchas líneas. Espera a que termine de cargar (verás un mensaje de agradecimiento al final).

  3. En Minecraft, ve a Multijugador → Agregar servidor:

    • Nombre: Mi servidor

    • Dirección: localhost

  4. Verás las barritas verdes indicando que el servidor está activo. Haz clic en Join y entra al mundo.

Paso 12: Obtener permisos de operador y modo creativo

  1. Ve a la ventana de la consola del servidor.

  2. Escribe:

    text
    op TuNombreDeUsuario

    (reemplaza con tu nombre de usuario de Minecraft)

  3. Ahora en el juego escribe:

    text
    /gamemode creative

    Así podrás volar y tendrás acceso a todos los bloques.

Paso 13: Crear tu primer script en Python

  1. Dentro de la carpeta del servidor, crea una carpeta llamada python-scripts.

  2. Abre IDLE (el editor que viene con Python).

  3. Crea un nuevo archivo y pega un código de prueba, por ejemplo, para generar una esfera:

    python
    from mcpi.minecraft import Minecraft

mc = Minecraft.create("localhost", 4711)
pos = mc.player.getTilePos()

# Genera una esfera de radio 20
radio = 20
for x in range(-radio, radio + 1):
    for y in range(-radio, radio + 1):
        for z in range(-radio, radio + 1):
            if x**2 + y**2 + z**2 <= radio**2:
                mc.setBlock(pos.x + x, pos.y + y, pos.z + z, 1)

  4. Guarda el archivo como esfera_prueba_1.py dentro de python-scripts.

  5. Ejecuta el script presionando F5.

  6. ¡Verás una esfera gigante construida al instante en tu mundo!

Paso 14: Detener y reiniciar el servidor

Para detener el servidor:

  • Cierra la ventana de la consola del servidor.

  • Verás que Minecraft pierde la conexión (es normal, acabas de apagar el servidor).

  • Puedes salir de Minecraft.

Para reiniciar el servidor:

  1. Abre de nuevo start_server.bat y espera a que cargue.

  2. Abre Minecraft con tu perfil 1.14.4.

  3. Entra a Multijugador y haz clic en Join en tu servidor.

  4. Listo, de vuelta al mundo.

Ejemplos de lo que puedes lograr

  • Bardas gigantes: cambiando solo 3 números (material, altura y tamaño).

  • Cubos huecos: bases para castillos a los que luego puedes añadir ventanas y adornos.

  • Contadores automáticos: que después de 10 segundos borran lo creado, para reutilizar el mundo sin reiniciar el servidor.

  • Esferas, torres, estructuras complejas: imposibles de hacer a mano en tan poco tiempo.

Consejos finales

  • Usa 1 GB de RAM si vas a experimentar tú solo; más si vas a compartir el servidor.

  • Mantén siempre tu perfil de Minecraft en la misma versión que el servidor.

  • Guarda tus scripts en la carpeta python-scripts para tenerlos organizados.

  • Si algo no funciona, revisa que RaspberryJuice esté cargado en el servidor y que el puerto 4711 esté disponible.

Con esto ya tienes todo listo para empezar a crear tus propios scripts y aprender a programar mientras construyes cosas increíbles en Minecraft. ¡A programa



Comentarios

Publicar un comentario

Entradas más populares de este blog