Minecraft-Launchpad Bridge

A real-time bridge that transforms your Novation Launchpad into a physical HUD for Minecraft.

[WARNING] This project was developed approximately one year ago and is specifically designed for the Novation Launchpad Mini. As I no longer have the hardware available for testing, I cannot guarantee full compatibility with current versions or other Launchpad models.

Features

• 8x8 Grid Dashboard:
  • Health Matrix: Visual representation of your HP that shrinks and changes color.
  • Directional Compass: A perimeter LED that indicates North/South/East/West.
  • Proximity Radar: Nearby players appear as dots on your grid relative to you.
• Side Bar: Experience (XP) progress bar.
• Top Row: Hunger/Food level indicator.
• High Performance: Optimized UDP networking and minimal device flickering.

Installation

1. Minecraft Mod (Java/Forge)

1. Copy the contents of minecraft_mod/mackackos_mod/ to your Forge development environment.
2. Install the mod into your Minecraft instance.

2. Python Bridge

1. Install Python 3.11+.

2. Install dependencies:

   pip install -r python_bridge/requirements.txt

3. Configure your settings in python_bridge/config.json.

4. Run the bridge:

   python python_bridge/minecraft_connection.py

Configuration

Edit python_bridge/config.json:

• target_username: Your Minecraft username.
• port: UDP port (default: 5005).
• led_color_xp: Color code for the XP bar.

Technology Stack

• Java: Minecraft Forge API for data extraction.
• Python: launchpad_py for MIDI control.
• Networking: UDP (User Datagram Protocol) for low-latency updates.

Contributing

Since I no longer have a Launchpad Mini to test this project, I would love for the community to help keep it alive! If you fix a bug, update it for a newer Minecraft version, or add support for other Launchpad models, please feel free to open a Pull Request.

Let's make this project work for as many people as possible!

License

This project is licensed under the MIT License - see the LICENSE file for details.

Developed by:

 ███▄ ▄███▓ ▄▄▄       ▄████▄   ██ ▄█▀▄▄▄       ▄████▄   ██ ▄█▀ ▒█████  
▓██▒▀█▀ ██▒▒████▄    ▒██▀ ▀█   ██▄█▒▒████▄    ▒██▀ ▀█   ██▄█▒ ▒██▒  ██▒
▓██    ▓██░▒██  ▀█▄  ▒▓█    ▄ ▓███▄░▒██  ▀█▄  ▒▓█    ▄ ▓███▄░ ▒██░  ██▒
▒██    ▒██ ░██▄▄▄▄██ ▒▓▓▄ ▄██▒▓██ █▄░██▄▄▄▄██ ▒▓▓▄ ▄██▒▓██ █▄ ▒██   ██░
▒██▒   ░██▒ ▓█   ▓██▒▒ ▓███▀ ░▒██▒ █▄▓█   ▓██▒▒ ▓███▀ ░▒██▒ █▄░ ████▓▒░
░ ▒░   ░  ░ ▒▒   ▓▒█░░ ░▒ ▒  ░▒ ▒▒ ▓▒▒▒   ▓▒█░░ ░▒ ▒  ░▒ ▒▒ ▓▒░ ▒░▒░▒░ 
░  ░      ░  ▒   ▒▒ ░  ░  ▒   ░ ░▒ ▒░ ▒   ▒▒ ░  ░  ▒   ░ ░▒ ▒░  ░ ▒ ▒░ 
░      ░     ░   ▒   ░        ░ ░░ ░  ░   ▒   ░        ░ ░░ ░ ░ ░ ░ ▒  
       ░         ░  ░░ ░      ░  ░        ░  ░░ ░      ░  ░       ░ ░  
                     ░                        ░                        

Mackacko