BlockAssist is an AI assistant that learns from its user’s actions in Minecraft. The assistant appears in-game with you, starting with only basic knowledge of the game’s commands. As you play, it learns how to assist you in building, learning directly from your actions. It shows an early demo of assistance learning - a new paradigm for aligning agents to human preferences across domains.
Steps:
Follow setup instructions below
Play Minecraft episodes and complete the building goal in the shortest time possible. This will help train the best assistant models.
Share your progress with the community by posting your gameplay videos, stats, and Hugging Face uploads on Discord and X. Track your participation on the leaderboard.
You do not need a copy of Minecraft to play! BlockAssist includes a free version.
You will be prompted to log in through your browser (http://localhost:3000). If you have previously logged in, this step will be skipped. Otherwise, use the browser window that opens to log in.
Play Minecraft
Once the Minecraft windows have loaded, the Python script will ask you to press ENTER.
Go to the first Minecraft window that opened (the other will be minimized on macOS). Click the window and press ENTER to allow it to capture your inputs. Complete the structure in-game, then return to your terminal and press ENTER to end the session.
Training
A model will now be trained and submitted to Hugging Face and to Gensyn’s smart contract.
Review logs
If you reach this stage in the logging window and can see a transaction in the block explorer, your submission has succeeded.
Logging window:
[2025-07-28 05:03:48,955][blockassist.globals][INFO] - Successfully uploaded model to HuggingFace: h-grieve/blockassist-bc-bellowing_pouncing_horse_1753675374 with size 20.00 MB
The program will then end. Please close any Minecraft windows if they remain open.
Configuration
BlockAssist uses Hydra for configuration management. You can modify settings in the config.yaml file or override them via command-line arguments.
episode_count — Controls the number of episodes. If episode_count is greater than 1, a new episode will start each time you press ENTER during session recording.
num_training_iters — Controls the number of training iterations across all recorded episodes.
Testing & Contributing
Linting / Testing
This project relies on Ruff for formatting/linting. To format imports, run:
ruff check --select I --fix .
Telemetry
This repository uploads telemetry to Gensyn services. To disable telemetry, export:
export DISABLE_TELEMETRY=1
Note: If you turn off telemetry, your contributions may not be counted towards the BlockAssist leaderboard.
