🤖 Create Minecraft bots with a powerful, stable, and high level Python API.
Project description
🤖 Create Minecraft bots with a powerful, stable, and high level Python API.
About • Key Features • How To Use • Install • Credits • License
About 📬
Lodestone is an incredibly powerful and flexible framework for building Minecraft bots of all kinds. Whether you’re new to Minecraft bot development or a seasoned pro, Lodestone provides all the tools you need to bring your bot ideas to life. Let’s dive into how to get up and running with Lodestone.
Features
- Supports Minecraft 1.8, 1.9, 1.10, 1.11, 1.12, 1.13, 1.14, 1.15, 1.16, 1.17, 1.18, 1.19 and 1.20.1.
- Entity knowledge and tracking.
- Block knowledge. You can query the world around you. Milliseconds to find any block.
- Physics and movement - handle all bounding boxes
- Attacking entities and using vehicles.
- Inventory management.
- Crafting, chests, dispensers, enchantment tables.
- Digging and building.
- Miscellaneous stuff such as knowing your health and whether it is raining.
- Activating blocks and using items.
- Chat.
Getting Started 🏁
[!IMPORTANT] Some parts of the code are still in development and do not work!
All instalation instructons and documentation can be found here but here is the general idea.
Install To start building a Lodestone based bot, you first have to install the lodestone, package. run the following command to install the package: '''pip install lodestone'''
💡 If you already have the lodestone package installed you can skip this step, you only need to install lodestone for the bot to work. Create a bot.py Create the following bot.py file in your project’s root directory: '''import lodestone
bot = lodestone.createBot( host='localhost', username='Bot', )'''
With the above configuration, Lodestone will create a bot with the name bot that joins the java server localhost (localy run server). Other Lodestone bot creation configurations can be found Here. Run your bot After coding your very own Minecraft bot you can simply run the following command to start the bot!: Terminal
can be python3 on some systems
python bot.py
And run the next or next dev command specified in package.jsonto start developing the project! 🎉 Sign in Lastly, if your not already signed in bot will ask you to sign in using Microsoft by default. The message will look something like this: '''It seems you are not logged in, please go to https://microsoft.com/link and enter the following code: ********'''
after you sucsessfully sign in in to your account account the bot will be created. Full auth configurations can be found here.
Arguments & Options 📄
[!IMPORTANT] Not changing some of these settings will result in the bot not working. 🛑
[!WARNING] Do not share your Minecraft info to anyone. 🔒
How to use the arguments
The command line arguments available are:
--email
: The Minecraft Email the bot will log into (use a name and no password for a cracked account). 📧--password
: The password for your account (if not using cracked). 🔑--host
: The IP address or hostname of the Minecraft server. 🖥--port
: The port number the Minecraft server is listening on. Default is 25565. ⚡--auth
: The authentication method your account requires (mojang/microsoft/cracked). Default is "microsoft". 🔐--version
: Minecraft version to use when connecting to a server. Default is auto. 🕹--check_timeout
: How often in milliseconds the bot checks if it is still logged into the server. Default is 600000 (10 minutes). ⏱--viewer_port
: The local port to run the viewer server on so you can visually see what the bot is doing. Default is 8000. 👀--quit_on_low_health
: Disconect the bot if the bot is on low health. Default is "True". 👤--low_health_threashold
: How low the health must be for the bot to quit. Default is "10". 👤--armor_equip
: If the bot needs to equip all available armor. Default is "True". 👤
🚀 GitHub Codespaces (run the bot in the cloud)
[!IMPORTANT] If the console gets spammed with random data, try changing the version from false to a version you know is supported by the server.
- Copy this code to you clipboard and run it once the terminal is available
python -m opendeliverybot
- Open GitHub CodeSpaces below
Contributors ❤️
Name | Helped With | GitHub | Discord |
---|---|---|---|
Katzengott | fishing bot and cactus bot | @Katzengott | edelkatze |
Roadmap
- Add config.json file
- Add click
- Change to use as Pip package for better use
- Add Discord integration
- Add Lava Caster (request by @givenbakerad on Discord)
- Add Custom code runner (a way for users to test their own bot code in a nice and simple way)
MineFlayer 🚀
Mineflayer is a complex library that allows you to control Minecraft accounts through a powerful, stable, and high-level JavaScript API
Discord
Credits
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for lodestone-0.1.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d8ba4bacaef2852ec525fdb7d3bbba7aa616880eebe432394f84452f348e33d2 |
|
MD5 | a5e345b3d34fa06cd50438065266314b |
|
BLAKE2b-256 | 3f43033295dcbea46aaa76ee1a4ad9928bc56c4c63e207d6d1fefa6a4745ef84 |