This project so far is the result of thousands of hours of endless reasearch, trials and errors, and just the simple goal of eliminating loneliness from minecraft as much as possible. If you liked my work, please consider donating so that I can continue to work on this project in peace and can actually prove to my parents that my work is making a difference. (Also not having to ask for pocket money from mom).
Just know that I won't ever give up on this project.
If anyone is interested on the underlying algorithms I am working on for increased intelligence for the minecraft bot, feel free to check out this repository:
https://github.com/shasankp000/AI-Tricks
I am open to suggestions/improvements, if any. (Obviously there will be improvements from my own end).
The footages for the bot conversation and config manager here in the github page is a bit outated. Check the modrinth page and download the mod to stay updated.
A minecraft mod which aims to add a "second player" into the game which will actually be intelligent.
Ever felt lonely while playing minecraft alone during that two-week phase? Well, this mod aims to solve that problem of loneliness, not just catering to this particular use case, but even (hopefully in the future) to play in multiplayer servers as well.
Please note that this is not some sort of a commercialised AI product. This project is just a solution to a problem many Minecraft players have faced and do continue to face.
I had to add that statement up there to prevent misunderstandings.
This mod relies on the internal code of the Carpet mod, please star the repository of the mod: https://github.com/gnembon/fabric-carpet (Giving credit where it's due)
This mod also relies on the ollama4j project. https://github.com/amithkoujalgi/ollama4j
Fully implemented pathfinding for the bot.Collision and entity detection(detects entites around it and looks at it).Interaction with the world environment in general.Reinforcement Learning.- More environment triggers for RL to work
- If the bot dies or is killed off while it was engaged in an action, the code might throw an error on the bot respawn. Temporary fix is a game restart (or server restart).
Will be fixed in upcoming patch.
- The removeArmor command doesn't work (yet).
- From this github page, just download from the releases section or follow the steps in usage section to build and test.
- Modrinth: https://modrinth.com/mod/ai-player/ [Recommended as the github version is often unstable]
- Curseforge: Will upload soon after a few more patches and updates.
So after a lot of research and painful hours of coding here's the new update!
-
Fixed previous bugs.
-
Switched to a much lighter model (llama3.2) for conversations, RAG and function calling
-
A whole lot of commands
-
Reinforcement Learning (Q-learning).
-
Theortically Multiplayer compatible (just install the dependencies on server side), as carpet mod can run on servers too, but I have not tested it yet. Feedback is welcome from testers on this.
-
Theoretically the mod should not require everyone to install it on multiplayer, it should be a server-sided one, haven't tested this one yet, feedback is welcome from testers.
Bot can now interact with it's envrionment based on "triggers" and then learn about it's situation and try to adapt.
The learning process is not short, don't expect the bot to learn how to deal with a situation very quickly, in fact if you want intelligent results, you may need hours of training(Something I will focus on once I fix some more bugs, add some more triggers and get this version out of the alpha stage)
To start the learning process:
/bot spawn <botName> training
Right now the bot only reacts to hostile mobs around it, will add more "triggers" so that the bot responds to more scenarios and learns how to deal with such scenarios in upcoming updates
A recording of what this verison does :
Spawn command changed.
/bot spawn <bot> <mode: training or play>, if you type anything else in the mode parameter you will get a message in chat showing the correct usage of this command
/bot use-key <W,S, A, D, LSHIFT, SPRINT, UNSNEAK, UNSPRINT> <bot>
/bot release-all-keys <bot> <botName>
/bot look <north, south, east, west>
/bot detectDangerZone // Detects lava pools and cliffs nearby
/bot getHotBarItems // returns a list of the items in it's hotbar
/bot getSelectedItem // gets the currently selected item
/bot getHungerLevel // gets it's hunger levels
/bot getOxygenLevel // gets the oxygen level of the bot
/bot equipArmor // gets the bot to put on the best armor in it's inventory
/bot removeArmor // work in progress.
1. Make sure you still have ollama installed.
2. In cmd or terminal type `ollama pull nomic-embed-text (if not already done).
3. Type `ollama pull llama3.2`
4. Type `ollama rm gemma2 (if you still have it installed)
5. Type `ollama rm llama2 (if you still have it installed)
6. If you have run the mod before go to your .minecraft folder, navigate to a folder called config, and delete a file called settings.json5
Then make sure you have turned on ollama server. After that launch the game.
Type /configMan in chat and select llama3.2 as the language model, then hit save and exit.
Then type /bot spawn <yourBotName> <training (for training mode, this mode won't connect to language model) and play (for normal usage)
For the nerds : How does the bot learn?
It uses an algorithm called Q-learning which is a part of reinforcement learning.
A very good video explanation on what Q-learning is :
Sucessfully implemented the intellgence update.
So, for the tech savvy people, I have implemented the following features.
LONG TERM MEMORY: This mod now features concepts used in the field AI like Natural Language Processing (much better now) and something called
Retrieval Augmented Generation (RAG).
How does it work?
Well:
We convert the user input, to a set of vector embeddings which is a list of numbers.
Then physics 101!
A vector is a representation of 3 coordinates in the XYZ plane. It has two parts, a direction and a magnitude.
If you have two vectors, you can check their similarity by checking the angle between them.
The closer the vectors are to each other, the more similar they are!
Now if you have two sentences, converted to vectors, you can find out whether they are similar to each other using this process.
In this particular instance I have used a method called cosine similarity
Where you find the similarity using the formula
(x, y) = x . y / |x| . |y|
where |x| and |y| are the magnitudes of the vectors.
So we use this technique to fetch a bunch of stored conversation and event data from an SQL database, generate their vector embeddings, and then run that against the user's prompt. We get then further sort on the basis on let's say timestamps and we get the most relevant conversation for what the player said.
Pair this with function calling. Which combines Natural Language processing to understand what the player wants the bot to do, then call a pre-coded method, for example movement and block check, to get the bot to do the task.
Save this data, i.e what the bot did just now to the database and you get even more improved memory!
To top it all off, Gemma 2 8b is the best performing model for this mod right now, so I will suggest y'all to use gemma2.
In fact some of the methods won't even run without gemma2 like the RAG for example so it's a must.
Successfully managed to spawn a "second player" bot.
Added basic bot movement.
botmovement.webm
Implemented basic bot conversation
bandicam.2024-07-19.11-12-07-431.webm
Added a mod configuration menu (Still a work in progress)
2024-07-22.02-36-49.mp4
Implemented intermediate XZ pathfinding for the bot
2024-07-27_14-16-32.mp4
Implemented Natural Language Processing for the bot to understand the intention and context of the user input and execute methods Can only understand if you want the bot to go some coordinates.
https://vimeo.com/992051891?share=copy
Implemented nearby entity detection
2024-07-31.14-52-47.mp4
For playing the game, download the jar file either from modrinth or the releases section and go directly to step 6.
For users who have used the mod before, transitioning to version 1.0.2-hotfix-3
1. Go to your game folder (.minecraft)/config and you will find a settings.json5 file.
Delete that
2.(If you have run the previous 1.0.2 version already then) again go back to your .minecraft. you will find a folder called "sqlite_databases". Inside that is a file called memory_agent.db
3. Delete that as well.
4. Install the models, mistral, llama2 and nomic-embed-text
5.Then run the game
6. Inside the game run /configMan to set the language model to llama2.
Then spawn the bot and start talking!
Step 1. Download Java 17.
This project is built on java 17 to support carpet mod's updated API.
Go to: https://bell-sw.com/pages/downloads/#jdk-21-lts
Click on Download MSI and finish the installation process. [Windows]
For linux users, depending on your system install openjdk-21-jdk package.
Step 2. Download IntelliJ idea community edition.
https://www.jetbrains.com/idea/download/?section=windows
Step 3. Download the project.
If you have git setup in your machine already you can just clone the project to your machine and then open it in intellij
Or alternatively download it as a zip file, extract it and then open it in intellij
Step 4. Configure the project SDK.
Click on the settings gear.
Go to Project Structure
Configure the SDK here, set it to liberica 21
Step 5. Once done wait for intellij to build the project sources, this will take a while as it basically downloads minecraft to run in a test version.
If you happen to see some errors, go to the right sidebar, click on the elephant icon (gradle)
And click on the refresh button, besides the plus icon. Additionally you can go to the terminal icon on the bottom left
And type ./graldew build
Step 6. Setup ollama.
Go to https://ollama.com/
Download based on your operating system.
After installation, run ollama from your desktop. This will launch the ollama server.
This can be accessed in your system tray
Now open a command line client, on windows, search CMD or terminal and then open it.
Depending on your specs, you can download a language model and then configure in the project to use it.
For now, in the terminal, type 
In this example we are going with the phi3 model.
For the updated version 1.0.2, you will need to download the llama2 model: ollama pull llama2
And another model nomic-embed-text: ollama pull nomic-embed-text
Without llama2, intelligence will be very low Without nomic-embed-text, the mod will crash.
I do intend to add an option in the mod to change and configure models within the game GUI.
Once done. Go to the next step.
Step 7. Go to the files section
Click on the ollamaClient
Go to line 199.
2024-07-21.13-34-42.mp4
Remove the current model type, then follow the video and set it to OllamaModelType.PHI3
Although intelliJ autosaves but press CTRL+S to save.
Step 8. Finally click on the gradle icon again in the right sidebar.
Fine the runClient task, and double click it to run minecraft with the mod.
This section is to describe the usage of the mod in-game
Main command
/bot
Sub commands:
spawm <bot> This command is used to spawn a bot with the desired name. ==For testing purposes, please keep the bot name to Steve==.
walk <bot> <till> This command will make the bot walk forward for a specific amount of seconds.
go_to <bot> <x> <y> <z> This command is supposed to make the bot go to the specified co-ordinates, by finding the shortest path to it. It is still a work in progress as of the moment.
send_message_to <bot> <message> This command will help you to talk to the bot.
teleport_forward <bot> This command will teleport the bot forward by 1 positive block
test_chat_message <bot> A test command to make sure that the bot can send messages.
detect_entities <bot> A command which is supposed to detect entities around the bot
Example Usage:
/bot spawn Steve
The above command changes credits go to Mr. Álvaro Carvalho
And yes since this mod relies on carpet mod, you can spawn a bot using carpet mod's commands too and try the mod. But if you happen to be playing in offline mode, then I recommend using the mod's in built spawn command.