Virtuoso

📯 Virtuoso

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

[![Virtuoso Promo][video-thumbnail]][video-promo]

🎬 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][trumpet-chart].

🔗 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 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][pocket] 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][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][discord] for advice, testing, and moral support

Download the mod on or check out the code behind it on [GitHub][github].

Enjoy your performance, virtuoso. 📯

[discord]:

[github]:

[pocket]::

[trumpet-chart]:

[video-thumbnail]:

[video-promo]: