Installation — MrPoulpi UI

Installer MrPoulpi UI : dossier, ordre du server.cfg, permission du menu de démonstration et premier essai en jeu.

Étapes

Copiez le dossier dans resources sans le renommer : mrpoulpi_ui. Les exports et les events portent ce nom.
Ajoutez la ressource à server.cfg, après votre framework et avant les scripts qui l’utilisent :
```
ensure es_extended
ensure mrpoulpi_ui
ensure mon_garage
```
Donnez l’accès au menu de démonstration à votre staff. Les groupes admin, superadmin et god l’ont déjà ; pour un autre groupe ou un joueur précis :
```
add_ace group.moderator mrpoulpi_ui.menu allow
```
Réglez au moins la langue (Config.Locale) et les entreprises (Config.Companies.list) dans shared/config.lua.
Redémarrez le serveur, ou faites ensure mrpoulpi_ui dans la console.

Premier essai

En jeu, ouvrez le menu avec /uimenu ou F7. Il teste chaque élément séparément :

Section	Boutons
Notifications	Succès, Info, Alerte, Erreur, Annonce, Média
Fenêtres	Saisie, Confirmation, Choix
Entreprise	Ouverture, Fermeture, Annonce
Interface	Aide, Touches (chaque clic affiche puis masque), Serveur

Les boutons de notification, d’entreprise et d’interface laissent le menu ouvert pour enchaîner les essais. Le bouton Serveur vérifie qu’une action part bien vers le serveur et revient avec une notification.

Utiliser la ressource dans un script

Aucune déclaration n’est nécessaire : appelez les exports.

exports.mrpoulpi_ui:Notify('Véhicule rangé dans le garage', 'success')

exports.mrpoulpi_ui:Notify(source, 'Véhicule rangé dans le garage', 'success')

Pour que vos scripts démarrent après la ressource, ajoutez-la aux dépendances de leur manifeste :

dependency 'mrpoulpi_ui'

Remplacer les notifications du framework

Pour que toutes les notifications du serveur prennent ce style, redirigez la fonction de votre framework.

Dans es_extended/client/functions.lua :

function ESX.ShowNotification(message, notifyType, length)
    exports.mrpoulpi_ui:Notify(message, notifyType, length)
end

Dans qb-core/client/functions.lua :

function QBCore.Functions.Notify(text, texttype, length)
    local message = type(text) == 'table' and text.text or text
    exports.mrpoulpi_ui:Notify(message, texttype == 'primary' and 'info' or texttype, length)
end

Qbox envoie ses notifications avec exports.qbx_core:Notify, qui s’appuie sur ox_lib. Le plus simple est d’appeler exports.mrpoulpi_ui:Notify dans vos propres scripts et de laisser les notifications de Qbox telles quelles.

Un type inconnu (par exemple primary) est remplacé par Config.Notify.defaultType.

Mise à jour

Gardez une copie de shared/config.lua, shared/locales.lua et des deux fichiers hooks.lua.
Remplacez le dossier par la nouvelle version.
Reportez vos modifications. Le changelog indique les nouvelles options à ajouter dans shared/config.lua.