📯 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. 📯

Changelog

[0.3.1] - 2025-08-12

Fixed

• Version number and changelog

[0.3.0] - 2025-08-12

Added

• New event-based core behaviours
• Custom behaviour disconnects on bugle drop
• Acceptable ranges for numeric config entries
• HarmonicSmoothMult and PitchSmoothMult config entries

Removed

• UILoadInterval config entry

Changed

• Reorganized and restructured core implementation
• UI now loads without direct polling
• Default key for ToggleUIKey config entry is now U

Fixed

• Compatibility with PEAK version .1.21.a 4587d11a2
• AudioSource properly stops on pause in offline mode
• AudioSource properly stops when not tooting

[0.2.2] - 2025-08-05

Fixed

• Initial bend position now properly resets only when your own bugle starts tooting

[0.2.1] - 2025-08-05

Changed

• Reverted vertical angle smoothing to previous value

Removed

• Disabled pitch smoothing

[0.2.0] - 2025-08-05

Added

• Slight pitch smoothing

Changed

• Volume no longer immediately resets to zero at the start of a toot
• Connects sync on first toot instead of via polling
• Slightly increased vertical angle smoothing for selecting partials

Removed

• ConnectInterval config entry (no longer used)

[0.1.1] - 2025-08-04

Changed

• Updated README

[0.1.0] - 2025-08-02

Added

• Total bugle overhaul