Vereya: Take Full Python Control of Your Minecraft Player
If you have ever wanted to drive your Minecraft character with code instead of a keyboard, Vereya is the add-on you have been waiting for. This Fabric-based mod exposes a comprehensive Python API that lets you start and stop the game, read the player's position and orientation, grab RGB screenshots of the current view, and inspect a 3D grid of nearby blocks. Originally a port of the Malmo project to newer Minecraft releases, Vereya has since been heavily rewritten and now stands as its own tool, purpose-built for researchers, students, and hobbyists exploring AI in games.
What Vereya Lets You Do
The core idea is simple: your Python script becomes the player. With the bundled tagilmo library, you can toggle between manual control and script control by pressing the Enter key, so you are never locked out of your own world. The API covers a surprising amount of ground:
- Start and stop the game directly from a script
- Read the player's exact position and facing direction
- Capture an RGB image of whatever the player is looking at
- Pull a 3D grid of blocks around the player
- Identify the block at the center of the screen
- Craft items through a simplified, GUI-free workflow
Two example scripts ship with the mod to show off these capabilities. One agent crafts whatever you ask for via a chat command, and another roams the world hunting for block types it has not seen before. A video demonstration even shows an AI agent obtaining a diamond on peaceful difficulty, which is a great illustration of how far the API can take you.
Supported Versions and Loader Requirements
Minecraft 1.21 and Fabric
Vereya requires the Fabric Loader and Fabric API to be installed before the mod will run. Only the Minecraft 1.21 version is actively maintained, so older builds may lack the latest features and bugfixes. If you are planning a project, stick with 1.21 to avoid surprises.
A Note on Alpha Status
The mod is currently in alpha and has only been tested in single-player. Some methods may not behave correctly when running on a server, and the example agents cannot fight yet. Keep those limitations in mind when designing experiments, and check the project's GitHub pages for issues and feature requests.
For players who prefer a frictionless setup, the foxygame.net launcher offers one-click installation of Vereya, handling the Fabric dependencies and version matching automatically so you can jump straight into scripting.
How to Install Vereya
Getting started is straightforward if you follow the right order. First, install the Fabric Loader for Minecraft 1.21 through the official installer. Next, drop the Fabric API jar into your mods folder. Then place the Vereya mod file alongside it and launch the Fabric profile. Finally, install the tagilmo Python library on your system so your scripts can talk to the game.
When you are ready to download Vereya, always grab the latest release from the official repository rather than a mirror, since the mod is updated frequently and older copies may be incompatible with current Fabric builds. Once everything is in place, launch a world, press Enter to hand control to your script, and watch your Python agent take over.
Why It Matters for AI Research
Vereya for Minecraft fills a niche that few mods address: a clean, scriptable bridge between a modern game client and a general-purpose programming language. Whether you are teaching reinforcement learning concepts, prototyping a block-finding agent, or just curious how your code handles a creeper encounter, the API gives you the observability and control you need without hacking the game's internals.
Because the launcher at foxygame.net keeps Vereya and its Fabric dependencies updated automatically, you spend less time troubleshooting version mismatches and more time writing agents that actually do something interesting in the world.
Final Thoughts
Vereya is not a gameplay mod in the traditional sense. It is a toolkit, and like any toolkit its value depends on what you build with it. The combination of position tracking, visual capture, block grids, and simplified crafting makes it one of the most practical ways to bring Python automation into Minecraft 1.21. Install Fabric, set up tagilmo, and give your player a brain made of code.