🎸 Musician (Busker Script)

A fully featured busking script for RedM (VORP Core) with rhythm minigame and tipping system.

✨ Features

🎸 Rhythm Minigame

• Guitar Hero Style - 4-track rhythm game (Keys 1-4)
• Streak System - Build streaks for higher score multiplier (up to 4x)
• Trap Notes (black bars) - Black notes with red borders = Game ends immediately with 0 score!

🔊 Audio System

• Audio Synchronization - Music synced between all players
• Distance-Based Volume - Volume fades with distance
• Volume Control - Players can adjust local playback volume

⚙️ Difficulty Levels

Choose your challenge - higher risk = higher reward!

Difficulty	Speed	Trap Chance	Max. Reward
Easy	Slow (3.0s)	0%	$2.00
Medium	Normal (2.0s)	20%	$5.00
Hard	Fast (1.0s)	40%	$10.00

💰 Economy Integration

• Performance Based - Better play = higher tip
• Reward Caps - Each difficulty has a maximum
• NPC Tipping - NPCs can stop and tip you

---

📥 Installation

1. Make sure these resources are installed:
   • vorp_core
   • vorp_inventory
2. Copy mulderdev_musician to your resources folder
3. Add the guitar item to database:

INSERT INTO `items` (`item`, `label`, `limit`, `can_remove`, `type`, `usable`) VALUES
('guitar', 'Guitar', 1, 1, 'item_standard', 1);

4. Add ensure mulderdev_musician to your server.cfg

---

⚙️ Configuration

Difficulty & Rewards

Config.Difficulties = {
    easy = { 
        label = "Easy", 
        speed = 3.0,        -- Fall time in seconds
        rate = 1500,        -- Spawn rate (ms)
        multiplier = 1.0, 
        maxReward = 2.0, 
        trapChance = 0.0    -- No trap notes
    },
    medium = { 
        label = "Medium", 
        speed = 2.0, 
        rate = 1000, 
        multiplier = 1.5, 
        maxReward = 5.0, 
        trapChance = 0.2    -- 20% trap chance
    },
    hard = { 
        label = "Hard", 
        speed = 1.0, 
        rate = 700, 
        multiplier = 2.0, 
        maxReward = 10.0, 
        trapChance = 0.4    -- 40% trap chance
    },
}

Adding Custom Songs

1. Place your .mp3 files in the html/sounds/ folder
2. Add them in config.lua:

Config.Songs = {
    { label = "My Song", file = "mysong.mp3", duration = 180 },
    -- More songs here...
}

Important

File names must match exactly!

---

🎮 Usage

1. Use item - Use a guitar from your inventory
2. Menu - A menu appears:
   • Choose a Song
   • Choose a Difficulty
   • Set Volume
3. Play
   • Hit the red notes (Keys 1-4) when they reach the bottom line
   • AVOID the black trap notes!
4. Reward - Finish the song for your tip!

---

🔧 Troubleshooting

Problem	Solution
No audio?	Check volume slider. Check .mp3 files in html/sounds/
Stuck in animation?	Use command /stopbusk
Script error?	Check F8 console for details

---

📋 Requirements

• VORP Core
• VORP Inventory