🎸 Musician (Busker Script)

Ein vollständiges Straßenmusik-Script für RedM (VORP Core) mit Rhythmus-Minispiel und Trinkgeld-System.

✨ Features

🎸 Rhythmus-Minispiel

• Guitar Hero Style - 4-Spur Rhythmus-Spiel (Tasten 1-4)
• Streak-System - Baue Serien auf für höheren Score-Multiplikator (bis 4x)
• Trap-Noten (schwarze Balken) - Schwarze Noten mit rotem Rand treffen = Spiel sofort vorbei mit 0 Punkten!

🔊 Audio-System

• Audio-Synchronisation - Musik ist zwischen Spielern synchronisiert
• Distanz-basierte Lautstärke - Lautstärke nimmt mit Entfernung ab
• Lautstärke-Regler - Spieler können lokale Lautstärke im Menü einstellen

⚙️ Schwierigkeitsgrade

Wähle deine Herausforderung - höheres Risiko = höhere Belohnung!

Schwierigkeit	Geschwindigkeit	Trap-Chance	Max. Belohnung
Einfach	Langsam (3.0s)	0%	$2.00
Mittel	Normal (2.0s)	20%	$5.00
Schwer	Schnell (1.0s)	40%	$10.00

💰 Wirtschafts-Integration

• Leistungsbasiert - Je besser du spielst, desto höher das Trinkgeld
• Belohnungs-Limits - Jede Schwierigkeit hat ein Maximum
• NPC-Trinkgeld - NPCs können stehen bleiben und tippen

---

📥 Installation

1. Stelle sicher, dass folgende Resources installiert sind:
   • vorp_core
   • vorp_inventory
2. Kopiere mulderdev_musician in deinen resources Ordner
3. Füge das guitar Item zur Datenbank hinzu:

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

4. Füge ensure mulderdev_musician zu deiner server.cfg hinzu

---

⚙️ Konfiguration

Schwierigkeiten & Belohnungen

Config.Difficulties = {
    easy = { 
        label = "Einfach", 
        speed = 3.0,        -- Fallzeit in Sekunden
        rate = 1500,        -- Spawn-Rate (ms)
        multiplier = 1.0, 
        maxReward = 2.0, 
        trapChance = 0.0    -- Keine Trap-Noten
    },
    medium = { 
        label = "Mittel", 
        speed = 2.0, 
        rate = 1000, 
        multiplier = 1.5, 
        maxReward = 5.0, 
        trapChance = 0.2    -- 20% Trap-Chance
    },
    hard = { 
        label = "Schwer", 
        speed = 1.0, 
        rate = 700, 
        multiplier = 2.0, 
        maxReward = 10.0, 
        trapChance = 0.4    -- 40% Trap-Chance
    },
}

Eigene Songs hinzufügen

1. Platziere deine .mp3 Dateien im html/sounds/ Ordner
2. Füge sie in config.lua hinzu:

Config.Songs = {
    { label = "Mein Song", file = "meinsong.mp3", duration = 180 },
    -- Weitere Songs hier...
}

Wichtig

Dateinamen müssen exakt übereinstimmen!

---

🎮 Nutzung

1. Item benutzen - Benutze eine guitar aus deinem Inventar
2. Menü - Ein Menü erscheint:
   • Wähle einen Song
   • Wähle eine Schwierigkeit
   • Stelle Lautstärke ein
3. Spielen
   • Triff die roten Noten (Tasten 1-4) wenn sie die untere Linie erreichen
   • VERMEIDE die schwarzen Trap-Noten!
4. Belohnung - Beende den Song für dein Trinkgeld!

---

🔧 Fehlerbehebung

Problem	Lösung
Kein Audio?	Lautstärke-Slider prüfen. .mp3 Dateien in html/sounds/ prüfen
In Animation stecken?	Befehl /stopbusk verwenden
Script-Fehler?	F8-Konsole auf Details prüfen

---

📋 Voraussetzungen

• VORP Core
• VORP Inventory