mineral

O pacote MineRL Python

Pacote Python que fornece ambientes de academia fáceis de usar e acesso a dados para agentes de treinamento no Minecraft.

Curioso para ver o que as pessoas fizeram com o MineRL? Veja esta página onde coletamos projetos usando MineRL. Tem um projeto usando MineRL (projeto acadêmico ou de hobby divertido)? Edite este arquivo, adicione links aos seus projetos e crie um PR!

Para começar com o MineRL, confira a documentação aqui!

️ Atualização sobre os dados do MineRL-v0 em 17 de junho de 2024

Os espelhos de dados originais do MineRL-v0 estão inativos (por exemplo, dados originais MineRLObtainDiamond-v0 ). Carregamos cópias dos conjuntos de dados primários neste registro Zenodo para que as pessoas possam encontrá-los: https://zenodo.org/records/12659939

Versões do MineRL

MineRL consiste em três versões exclusivas, cada uma com conjuntos de recursos ligeiramente diferentes. Veja a comparação completa aqui.

• v1.0: [Código][Docs] Esta versão que você está vendo. Necessário para os modelos OpenAI VPT e a competição MineRL BASALT 2022.
• v0.4: [Código][Docs] Versão utilizada nas competições de 2021 (Diamond e BASALT). Suporta o conjunto de dados MineRL-v0 original. Instale com pip install minerl==0.4.4
• v0.3: [Código][Docs] Versão usada antes de 2021, incluindo as duas primeiras competições MineRL (2019 e 2020). Suporta o conjunto de dados MineRL-v0 original. Instale com pip install minerl==0.3.7

Instalação

Instale os requisitos (é necessário Java JDK 8. O Mac pode exigir etapas adicionais) e, em seguida, instale o MineRL com

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

Uso Básico

Pode ser usado como qualquer ambiente de academia:

 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 ()

Verifique a documentação para mais exemplos e notas.

Principais mudanças na v1.0

• Nova versão do Minecraft (11.2 -> 16.5)
• Resolução maior por padrão (64x64 -> 640x360)
• Espaço de ação quase humano: chega de ações craft e smelt . Apenas GUI e controle do mouse (a ação da câmera move o mouse).
• O espaço de observação é composto apenas por pixels, sem mais observação de inventário por padrão.