Running BlockAssist with Cursor

This guide shows non-technical users how to set up and run BlockAssist on macOS using Cursor, an AI-powered code editor with an integrated chat assistant.

Prerequisites

Make sure you have essential deverloper tools installed by using the commands below, depending on your operating system (OS).

Windows (WSL 2)

Run this command inside your WSL 2 terminal

sudo apt update && sudo apt install -y build-essential curl git zip unzip

Linux

Run this command inside your Ubuntu terminal:

sudo apt update && sudo apt install -y build-essential curl git zip unzip

macOS

Run this command inside your macOS terminal:

xcode-select --install

Step 1 — Install Cursor

Go to the Cursor website and click Download.

Step 2 — Set up your Workspace

Open the Cursor app and, on the welcome screen, click "Clone repo".

1. Select GitHub from the dropdown and paste https://github.com/gensyn-ai/blockassist/

2. Pick a local folder where the code will be downloaded.

Once the download finishes, Cursor will open your blockassist local folder.

Step 3 — Install Dependencies

You only need to do this once. To record additional episodes, skip to Running BlockAssist.

You should be able to see the "Chat" panel of Cursor on the right side of the screen. If you don’t see the Chat panel, press ctrl+L (Windows/Linux) or cmd+L (macOS).

In the chat window, enter the following prompt:

help me install the right dependencies for my operating system according to README.md

Cursor will now guide you through the installation steps of various dependencies needed to run BlockAssist. At the end, you should see a message saying the installation is complete.

macOS Users: You will need to give Cursor permission to minimize the Minecraft AI assistant window while you play the game. To do this, go to System Settings > Privacy & Security > Accessibility and set the toggle next to Cursor to ON.

Troubleshooting

If you see any errors while trying to install or run BlockAssist, Cursor may be able to help you fix the issue and get unblocked.

Otherwise, you can go to the troubleshooting guides for your respective operating system by clicking the cards below:

Windows (WSL 2)

Linux

macOS

Handling Errors in Cursor

To help you understand and fix an error you see in your Terminal, go to the Chat panel on the right and enter the following prompt:

Help me fix this error

• Make sure that Cursor AI can see the error, by clicking on Add Context in the chat box and then selecting Terminal(s)

• Alternatively, you can also copy and paste the error you see to the chat next to the prompt above.

If you don't see an error but BlockAssist isn't working as expected, you can also ask Cursor to look at your log files. Try using this prompt:

Look at my logs folder and see if there are any errors preventing BlockAssist from running as expected

You can then follow the recommendations from Cursor to help you fix any issues and get unblocked.

If you need additional support, you can open a ticket or visit our Discord.