Aide d’interaction et raccourcis — MrPoulpi UI

Afficher l’aide « Appuyez sur [E] » et une barre de raccourcis clavier avec MrPoulpi UI, depuis le client ou le serveur.

Deux éléments à afficher pendant le jeu, sans prendre le focus : le joueur garde le contrôle de son personnage.

Aide d’interaction

Une ligne « Appuyez sur [E] pour … », en haut à gauche par défaut (Config.Layout.hint).

exports.mrpoulpi_ui:ShowHint('E', 'pour ouvrir le coffre')
exports.mrpoulpi_ui:HideHint()

Argument	Description
`key`	Touche affichée. Par défaut `E`.
`text`	Texte après la touche.
`prefix`	Remplace « Appuyez sur ».

ShowHint accepte aussi une table : { key = 'G', text = 'pour fouiller', prefix = 'Maintenez' }. Un nouvel appel remplace l’aide affichée.

Exemple avec une zone

local shown = false

CreateThread(function()
    while true do
        local near = #(GetEntityCoords(PlayerPedId()) - vec3(215.8, -810.1, 30.7)) < 2.0
        if near and not shown then
            exports.mrpoulpi_ui:ShowHint('E', 'pour ouvrir le garage')
            shown = true
        elseif not near and shown then
            exports.mrpoulpi_ui:HideHint()
            shown = false
        end
        Wait(near and 0 or 500)
    end
end)

Afficher l’aide seulement quand l’état change évite d’envoyer un message à l’interface à chaque image.

Barre de raccourcis

Une rangée de touches avec leur rôle, en bas à droite par défaut (Config.Layout.keybinds).

exports.mrpoulpi_ui:SetKeybinds({
    { key = 'E', label = 'Utiliser', active = true },
    { key = 'F', label = 'Entrer' },
    { key = 'G', label = 'Ouvrir' },
    { key = 'X', label = 'Annuler' }
})

exports.mrpoulpi_ui:SetKeybindActive('F', true)
exports.mrpoulpi_ui:HideKeybinds()

Champ	Description
`key`	Touche affichée. Une entrée sans `key` est ignorée.
`label`	Rôle de la touche.
`active`	`true` met la touche en avant.

SetKeybindActive(key, active) change la mise en avant d’une touche sans redessiner la barre ; active absent vaut true.

Depuis le serveur

exports.mrpoulpi_ui:ShowHint(source, 'E', 'pour parler au vendeur')
exports.mrpoulpi_ui:HideHint(source)

exports.mrpoulpi_ui:SetKeybinds(source, { { key = 'E', label = 'Acheter' } })
exports.mrpoulpi_ui:HideKeybinds(source)

Savoir ce qui est affiché

IsHintVisible() et IsKeybindsVisible() (client) renvoient true si l’élément est affiché. RefreshUI() redessine la fenêtre, l’aide et la barre en cours.