Miniplayer

The Mini Player is a compact floating widget that appears on screen when the player connects to the Headphones device. It allows full playback control without opening the music app, so the player can keep playing while doing anything else in-game.

---

Activation

The Mini Player appears automatically when switching to the Headphones device from within the music app. It disappears when the headphones device is disconnected.

---

What It Shows

The widget displays the current track's cover art, title, artist, a live progress bar with elapsed and total time, and a row of playback controls.

---

Controls

Button	Action
⏮ Skip Back	Goes to the previous track (or restarts the current one if past 3 seconds).
▶ / ⏸ Play / Pause	Toggles playback.
⏭ Skip Forward	Advances to the next track in the queue.
☰ Queue	Expands or collapses a mini queue panel below the player showing all upcoming tracks. The currently playing track is highlighted with a pulsing dot.
⊘ Cursor Off	Visible only when cursor mode is active. Deactivates the cursor without pressing the keybind.

---

Mouse / Cursor Mode

By default the Mini Player is visible but not interactive — game controls remain fully active. To interact with the player, the cursor mode must be toggled on.

Default keybind: F6 (configurable in config/_config.lua via Config.MouseKey, and rebindable by each player from the GTA keybinds menu).

Pressing the key while the Mini Player is visible:

• Activates the cursor and locks camera movement, allowing the player to click buttons and drag the widget.

The ⊘ Cursor Off button inside the widget also deactivates cursor mode — useful because F6 does not fire while NUI focus is active.

---

Repositioning

While cursor mode is active, the player can click and drag the header area of the Mini Player to reposition it anywhere on screen. The position is saved automatically when the drag ends and persists across sessions — the widget reappears in the same spot next time.