# Music Marker (FiveM ESX)

Resource care porneste un MP3 si afiseaza o animatie cu bari colorate
sincronizata REAL pe muzica (foloseste Web Audio API - AnalyserNode
pentru a citi frecventele audio in timp real).

## Cum functioneaza

1. Cand jucatorul intra in markerul de la coordonatele
   `381.7529, -1076.4215, 29.4927` -> porneste MP3-ul si apar barile
   colorate pe centru jos al ecranului.
2. Barile se misca real pe muzica:
   - bara rosie  -> bas (frecvente joase)
   - bara violet -> treble (frecvente inalte)
3. Cand MP3-ul se termina -> animatia dispare automat.
4. Daca jucatorul reintra in marker dupa ce s-a terminat -> reporneste.

## Instalare

1. Pune folderul `music_marker` in `resources/`-ul serverului tau.
2. **IMPORTANT:** Inlocuieste `ui/sound/music.mp3` cu MP3-ul tau.
   - Pastreaza acelasi nume (`music.mp3`), sau modifica in `ui/script.js`
     linia: `new Audio(\`https://cfx-nui-${RES}/ui/sound/music.mp3\`)`
   - MP3-ul inclus acum este un fisier silent de 1 secunda doar ca
     placeholder.
3. Adauga in `server.cfg`:
   ```
   ensure music_marker
   ```
4. Restart la server / `refresh` + `start music_marker`.

## Configurare

In `client.lua` poti modifica:

```lua
local markerCoords = vector3(381.7529, -1076.4215, 29.4927)
local markerRange = 1.5  -- distanta de la care se activeaza
```

In `ui/style.css` poti modifica pozitia barilor:

```css
.loader {
    bottom: 60px;       -- distanta de la marginea de jos
    left: 50%;          -- centrat orizontal
}
```

In `ui/script.js` poti modifica sensibilitatea barilor:

```js
const FREQ_INDICES = [2, 5, 9, 14, 20, 28]; -- ce frecvente citeste fiecare bara
const MAX_HEIGHT = 50;                       -- inaltime maxima in px
analyser.smoothingTimeConstant = 0.7;        -- 0..1, cat de "lin" se misca
```

## Note

- Resursa **nu are nevoie** de ESX functional pentru animatie/audio,
  dar asteapta `es_extended` sa fie pornit inainte sa activeze loop-ul
  (ca sa nu interfereze cu loadingul jucatorului).
- Audio-ul ruleaza doar local pentru jucatorul care intra in marker
  (NU este sincronizat intre jucatori). Daca vrei sa-l auda toti, asta
  necesita logica server-side cu broadcast la toti clientii din zona.
- Markerul este desenat cu `DrawMarker` (cilindru rosu).
