Skip to content

MineMentor is an AI-powered assistant bot for Minecraft servers that provides instant answers to players' in-game questions. Whether you need crafting recipes, gameplay tips, or strategies, MineMentor is always ready to help!

License

Notifications You must be signed in to change notification settings

gautamxgambhir/MineMentor

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MineMentor Logo

MineMentor: AI-Powered Minecraft Assistant Bot

Python Flask Status License Together-AI Minecraft

What is MineMentor?

MineMentor is an AI-powered assistant bot for Minecraft servers that provides instant answers to players' in-game questions. Whether you need crafting recipes, gameplay tips, or strategies, MineMentor is always ready to help!

Features

  • AI-Powered Responses: Uses Together AI to generate real-time responses to Minecraft-related queries.
  • Continuous Movement: Automatically moves in a square pattern to avoid AFK kicks.
  • Quick Command Responses: Uses the ? prefix for quick in-game queries.
  • Auto-Reconnect: If disconnected, MineMentor will attempt to reconnect automatically.
  • Customizable Bot Name: You can change the bot’s display name when launching.

How It Works

  • The bot listens for messages in the chat.
  • When a player asks a question using the ? prefix, MineMentor processes it.
  • It sends the query to Together AI for an accurate response.
  • The bot replies directly in the chat, ensuring a seamless experience.
  • Meanwhile, it keeps moving to prevent being kicked from the server.

Where to Get It?

MineMentor is open-source and available on GitHub:

🔗 GitHub Repository

Installation and Setup

1. Clone the repository:

 git clone https://github.com/gautamxgambhir/MineMentor.git

2. Install dependencies:

cd MineMentor
pip install -r requirements.txt

3. Install Node.js dependencies:

npm install

4. Set up API keys

  • Obtain a Together AI API Key from Together AI.
  • Store the API key in an .env file:
API_KEY=your_together_api_key

5. Configure Server Connection

  • Open bot.py and modify the following variables to match your server:
server_host = "your.server.ip"
server_port = your_server_port

6. Run the bot:

python bot.py

Usage

In-Game Commands

  • Use the ? prefix followed by your question.
  • Example:
    • ?How do I craft a diamond sword? → The bot will reply with the recipe.
    • ?Where do I find Netherite? → The bot will provide an answer.
  • The bot continuously moves to avoid being kicked for inactivity.

Dependencies

Contributing

Contributions are welcome! To contribute:

  • Fork the repo.
  • Create a new branch (git checkout -b feature-branch).
  • Commit changes (git commit -m "Added new feature").
  • Push to the branch (git push origin feature-branch).
  • Open a pull request.

License

This project is licensed under the MIT License.

Contact

About

MineMentor is an AI-powered assistant bot for Minecraft servers that provides instant answers to players' in-game questions. Whether you need crafting recipes, gameplay tips, or strategies, MineMentor is always ready to help!

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages