📯 Virtuoso

Virtuoso is a complete overhaul of the bugle, transforming it from a simple novelty into a fully playable, dynamic brass instrument.

🎬 Click the image link above to watch the promo video!

📚 Table of Contents

• 🚀 Features
• 🔧 How It Works
• 🔗 Compatibility
• 🛠️ Installation
• ❓ FAQ
• 📌 Planned Features
• 💬 Feedback / Issues
• 🎖️ Credits

🚀 Features

• 🎶 Dynamic pitch control based on your character’s view angle
• 🔢 Realistic harmonic series modeled after a true bugle
• 🎺 Valve inputs expand your range, enabling full chromatic capability
• 🌐 Multiplayer support allows every note you play to be heard exactly as intended
• 📈 Real-time harmonic guide overlay for performance and learning
• 📡 Smooth network sync using Photon, with minimal bandwidth usage

🔧 How It Works

Virtuoso maps traditional brass playing mechanics to intuitive in-game controls:

• 🎯 Look up or down to choose your pitch — each vertical angle corresponds to a harmonic partial in the brass series. Use default key V to toggle the UI.
• 🎼 Tilt slightly left or right to bend your pitch — perfect for vibrato, glides, and emotional expressiveness.
• 🎺 Use valve key combinations to simulate trumpet fingering, expanding your playable range. By default:
  • Z for valve 1
  • X for valve 2
  • C for valve 3

Want to study the basics or see real trumpet fingerings? Check out this Trumpet Fingering Chart & Guide.

🔗 Compatibility

• Requires PEAK
• Works in multiplayer when all players have the mod
• Compatible with other audio mods unless they override bugle audio behavior directly

🛠️ Installation

Install via Thunderstore using your favorite mod manager, or extract the plugin manually into your game's BepInEx/plugins folder.

❓ FAQ

Q: Can I play real songs with this?
A: Yes! Virtuoso emulates real bugle and trumpet playing. Check out How It Works to learn more.

Q: Do other players hear what I'm playing?
A: Yes! For other players with the mod, pitch and expression are fully synchronized across the network using a custom Photon integration.

Q: Can I form a band with my buddies?
A: You can! Each player can grab a bugle and jam in perfect sync. Try out PocketBugle for an easy way to get started — spawn your own bugle anytime and start tooting together.

📌 Planned Features

• 🎨 Custom trumpet model
• 🔊 Multiple brass tones
• ⚙️ More configuration options
• 🎛️ UI overhaul
• ✨ Additional sound expression

💬 Feedback / Issues

Have feedback, questions, or found a bug? Open an issue on GitHub. I'd love to hear your ideas!

🎖️ Credits

• 🦐 Developed, with love, by your local shrimp guy Matthew Ondash
• 🪚 Built with BepInEx, Harmony, Photon, and Unity
• 💖 Special thanks to the PEAK Modding Community for advice, testing, and moral support

Download the mod on Thunderstore or check out the code behind it on GitHub.

Enjoy your performance, virtuoso. 📯