Compatibility
Minecraft: Java Edition
Platforms
Supported environments
75% of ad revenue goes to creators
Support creators and Modrinth ad-free with Modrinth+Creators
Details
Read this section please.
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.
Buy me a coffee
https://buymeacoffee.com/shasankp000
Paypal
Current stage of the mod
Since the new semester in my college has started this month, I am gonna be under really heavy pressure, since I have to study 9 subjects in total. Don't worry though I won't stop working on this project, it's just that the updates will be quite slower.
It's understandable if y'all leave by then or give up on this project, so, I won't mind. :))
Thank you all from the core of my heart for the support so far. I never imagined we would come this far.
Latest Update: 21/3/2025 at 12:55 PM IST (Indian Standard Time)
Please have patience while waiting for updates. Since I am the only guy working on this project, it does take me time to address all the issues/add in new features.
Changelog v1.0.4-release+1.20.6
- Updated codebase for 1.20.6 compatibility.
- Optimized codebase by removing redundant codes and unused imports.
(previous version 1.0.4-beta-1 fixed server sided compatibility fully)
Upcoming changes.
- Introduce goal based reinforcement learning(You give the bot a goal and it will try to learn based on how to best achieve the goal you give).
- Switch to Deep-Q learning instead of traditonal q-learning (TLDR: use a neural network instead of a table)
- Create custom movement code for the bot for precise movement instead of carpet's server sided movement code.
- Give the bot a sense of it's surroundings in more detail (like how we can see blocks around us in game) so that it can take more precise decisions. Right now it has knowledge of what blocks are around it, but it doesn't know how those blocks are placed around it, in what order/shape. I intend to fix that.
- Implement human consciousness level reasoning??? (to some degree maybe) (BIG MAYBE)
Current bugs in this version :
- The removeArmor still command doesn't work (yet).
Mod description
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.
And the best part? You can run completely offline language models based on your computer's specifications.
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.
What does this mod do?
This mod so far adds in a second spawnable player(or bot) via the carpet mod, and you can talk to it through a large language model via ollama completely offline on your pc and so far I have integrated reinforcement learning for the bot to interact and learn from it's environment in the context of "reflex actions".
Goal based learning will be added soon in upcoming updates.
This mod also relies on the owo-lib mod for configuration handling.
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
Installation Requirements
Requires Fabric api latest version.
Requires owo-lib version as stated in the dependency section
Requires Carpet mod version as stated in the dependency section
Sample video of the mod (as of the version 1.0.3-alpha-1)
Changelog video (as of the current version 1.0.3-alpha-2)
better and faster reflex actions, reduced training time.
Youtube tutorial soon
How to setup this mod.
Step 1: Download Java 21.
This project is built on java 21 and will need java 21 to run.
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: 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
Step 3: Now open a command line client, on windows, search CMD or terminal and then open it.
1. In cmd or terminal type `ollama pull nomic-embed-text (if not already done).
2. Type `ollama pull llama3.2`
3. Type `ollama rm gemma2 (if you still have it installed) (for previous users only)
4. Type `ollama rm llama2 (if you still have it installed) (for previous users only)
5. 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 (for previous users only)
Then make sure you have turned on ollama server.
Step 4: Download the dependencies
Step 5: Launch the game.
Step 6: Type /configMan in chat and select llama3.2 as the language model, then hit save and exit.
Step 7: Then type /bot spawn <yourBotName> <training (for training mode, this mode won't connect to language model) and play (for normal usage)
Important
Also remember that if you are using this mod, it's best to create a modpack for it's own as it will require you to run ollama server in the background every time you launch the game itself. Ollama server itself doesn't consume much memory so you should be fine.
Within the game
Main command
/bot
Sub commands:
A lot of the commands have been changed since the last version. Please check changelog of the latest version.
Example Usage:
/bot spawn Steve training
The above command syntax 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.