🎮 minecraft-kit

[

Minecraft mod: tracks data, offers themes and settings to customize

📥 Download

1. Download the latest release from the link above
2. Extract the archive (WinRAR / 7-Zip)
3. Run python main.py (or see Usage below)
4. Configure settings in config.yaml

Running

Alright, got it downloaded? Sweet. Here's how to get it running.

1. Make sure you have Python 3.11+ installed.
2. Open a terminal in the extracted directory.
3. Run python engine.py. This will start the mod.
4. Configure your overlay and settings in the config.yaml file.

Requirements

You'll need a few Python packages. Luckily, it's easy to install 'em.

• pip install -r requirements.txt
• This will install stuff like PyYAML and Pillow.

Config

The config.yaml file lets you tweak everything. Here's an example:

overlay:
 enabled: true
 font_size: 16
 color: [255, 255, 255]
 position: [10, 50]

crosshair:
 enabled: true
 color: [255, 0, 0]
 size: 15

hotkeys:
 toggle_overlay: "f10"
 some_action: "ctrl+shift+a"

pixel_detection:
 threshold: 20
 target_color: [100, 150, 200]
 region: [100, 100, 200, 200]

ports:
 http_port: 8080
 websocket_port: 8081

Contributing

Want to help out? Awesome!

• Fork the repo.
• Make your changes.
• Submit a pull request.

Please follow the existing code style. Also, add tests if you're adding new features.

Highlights

Here's what's packed in:

• Screen analysis: figures out what's on your screen.
• Overlay: displays custom info on top of the game.
• Crosshair: custom crosshair overlay.
• Pixel detection: detects specific colors on the screen.
• Hotkey automation: triggers actions with hotkeys.
• Configuration: tweak all settings in the config.yaml file.

FAQ

The overlay isn't showing up. What's wrong?

Make sure it's enabled in the config. Also, check if your game is running in windowed or borderless windowed mode. Sometimes fullscreen messes things up.

Can I change the font used in the overlay?

Not yet, but it's on the TODO list! WIP: add custom font support.

---

🔥 New features coming soon!