Skip to content

GDBLE v0.4.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 02:08
· 47 commits to master since this release

GDBLE v0.4.0

๐ŸŽ‰ What's New

A modern Bluetooth Low Energy (BLE) plugin for Godot 4, completely rewritten in Rust.

โœจ Key Features

  • Real-time Device Discovery: Devices appear instantly as they're found during scanning
  • Async Non-blocking: All operations run asynchronously without affecting game frame rate
  • Modern Architecture: Built with Rust and btleplug for excellent performance and stability
  • Signal-driven API: Clean event system using Godot signals
  • Debug Mode: Optional detailed logging for development and troubleshooting
  • Multi-device Support: Connect and manage multiple BLE devices simultaneously

๐Ÿ”ง Core Functionality

  • ๐Ÿ” Device scanning with real-time discovery
  • ๏ฟฝ Device connection management
  • ๐Ÿ”Ž Automatic service and characteristic discovery
  • ๐Ÿ“– Read characteristic values
  • โœ๏ธ Write data (with/without response)
  • ๐Ÿ”” Subscribe to notifications for real-time data

๐Ÿ“ฆ Installation

  1. Download gdble-release.zip
  2. Extract to your Godot project's addons folder
  3. Restart Godot Editor
  4. Start using GDBLE in your project!

๐ŸŒ Platform Support

  • โœ… Windows 10+ (x86_64)
  • โœ… macOS 10.15+ (Universal Binary: Intel + Apple Silicon)
  • ๐Ÿšง Linux (In Development)

๐Ÿ“š Documentation

๐Ÿ”— Links

๐Ÿ’ก Quick Example

var bluetooth_manager = BluetoothManager.new()
add_child(bluetooth_manager)

bluetooth_manager.device_discovered.connect(func(info):
    print("Found: ", info.get("name"))
)

bluetooth_manager.initialize()
bluetooth_manager.start_scan(10.0)

๐Ÿ™ Acknowledgments

Built with btleplug and godot-rust


Full Changelog: https://github.com/Fantety/GodotBLE/compare/v0.4.0