mineral

El paquete MineRL Python

Paquete de Python que proporciona entornos de gimnasio fáciles de usar y acceso a datos para agentes de capacitación en Minecraft.

¿Tienes curiosidad por ver qué ha hecho la gente con MineRL? Vea esta página donde recopilamos proyectos usando MineRL. ¿Tienes un proyecto usando MineRL (proyecto académico o de pasatiempo divertido)? ¡Edite este archivo, agregue enlaces a sus proyectos y cree un PR!

Para comenzar con MineRL, consulte los documentos aquí.

️ Actualización sobre los datos de MineRL-v0 el 17 de junio de 2024

Los espejos de datos originales para MineRL-v0 están inactivos (por ejemplo, datos originales MineRLObtainDiamond-v0 ). Hemos subido copias de los conjuntos de datos primarios a este registro de Zenodo para que la gente pueda encontrarlos: https://zenodo.org/records/12659939

Versiones MineRL

MineRL consta de tres versiones únicas, cada una con un conjunto de características ligeramente diferente. Vea la comparación completa aquí.

• v1.0: [Código][Documentos] Esta versión que estás viendo. Necesario para los modelos OpenAI VPT y la competencia MineRL BASALT 2022.
• v0.4: [Código][Docs] Versión utilizada en las competencias 2021 (Diamond y BASALT). Admite el conjunto de datos MineRL-v0 original. Instalar con pip install minerl==0.4.4
• v0.3: [Código][Documentos] Versión utilizada antes de 2021, incluidas las dos primeras competencias MineRL (2019 y 2020). Admite el conjunto de datos MineRL-v0 original. Instalar con pip install minerl==0.3.7

Instalación

Instale los requisitos (se requiere Java JDK 8. Mac puede requerir pasos adicionales) y luego instale MineRL con

 pip install git+https://github.com/minerllabs/minerl

Uso básico

Se puede utilizar de forma muy parecida a cualquier entorno de gimnasio:

 import gym
import minerl

# Uncomment to see more logs of the MineRL launch
# import coloredlogs
# coloredlogs.install(logging.DEBUG)

env = gym . make ( "MineRLBasaltBuildVillageHouse-v0" )
obs = env . reset ()

done = False
while not done :
    ac = env . action_space . noop ()
    # Spin around to see what is around us
    ac [ "camera" ] = [ 0 , 3 ]
    obs , reward , done , info = env . step ( ac )
    env . render ()
env . close ()

Consulte la documentación para obtener más ejemplos y notas.

Cambios importantes en la v1.0

• Nueva versión de Minecraft (11.2 -> 16.5)
• Resolución más grande por defecto (64x64 -> 640x360)
• Espacio de acción casi humano: no más acciones craft y smelt . Solo control de GUI y mouse (la acción de la cámara mueve el mouse).
• El espacio de observación es solo de píxeles, no más observación de inventario de forma predeterminada.