*Free!*

🎶 mad-musicgame is a simple rhythm-based mini-game for FiveM. Players press the correct keys as they fall, aiming to hit enough notes to succeed. It can be used for different performance types, including guitar, singing, and dancing; the UI adapts dynamically based on the performance type, with custom intro text, visual cues, and matching sound effects for each type.

The mini-game includes customisable difficulty settings, such as speed, allowed mistakes, and required score, making it flexible for different gameplay scenarios. It can be used on its own or integrated into other resources for more interactive experiences.

While mad-musicgame works as a standalone mini-game, it's also a core part of 🎭 mad-perform! If you're looking to expand player interactions, mad-perform lets players take the stage - playing the guitar, singing, or dancing - while attracting dynamic crowds and earning rewards. Together, they create a fully interactive performance system, bringing more depth and immersion to your server.

Preview

Watch on YouTube.

Documentation

Follow the link to the Docs.

How to use

To start the mini-game, use the export exports['mad-musicgame']:start like so:

exports['mad-musicgame']:start({
    lives = 3, -- How many letters the player can miss.
    speed = 0.3, -- How fast the letters fall down.
    maxScore = 4, -- How many letters the player has to type to win.
    letters = {'W', 'A', 'S', 'D'}, -- Optional. Defaults to all letters.
    performanceType = 'guitar' -- 'guitar', 'singing', 'dancing'.
}, function(result)
    if result then
        print("success")
        -- Minigame success
    else
        print("fail")
        -- Minigame failure
    end
end)