HZ-TextUi

Qu'est-ce que HZ-TextUi ?

Tous les serveurs font tourner le même target. La même boîte blanche, les mêmes trois points, le même prompt que les joueurs regardent depuis des années.

HZ-TextUi, c'est ce target, à vos couleurs.

C'est un target et TextUI 3D pour FiveM qui répond aux API que vos scripts appellent déjà, et qui met l'apparence de chaque prompt d'interaction sous votre contrôle — depuis un éditeur dans votre panel admin, pas un fichier de config que vous modifiez à l'aveugle.

Vos scripts ne changent pas

HZ-TextUi répond aux API ox_target, qtarget et qb-target : 24 exports, mêmes noms, mêmes arguments. Installez-le, ne supprimez rien, ne réécrivez rien.

Certains scripts vérifient la présence de la ressource par son nom au lieu d'appeler l'export. Pour ceux-là, deux ressources vides de compatibilité sont livrées dans le package — ox_target et qb-target. Déplacez-en une dans vos ressources et même ces scripts démarrent.

Le prompt est dessiné par le jeu

Aucune page web ne peint votre interaction. La touche, le libellé et la liste d'options sont du texte et des sprites natifs dans le monde 3D.

Le seul HTML de la ressource est un réticule transparent qui ne prend jamais le focus. Le joueur garde le contrôle complet du jeu pendant qu'il vise — il n'y a aucun moment où la souris est capturée par une interface.

Vous le dessinez vous-même

Le TextUI Designer se trouve dans votre panel admin — le panel hz_lib, rubrique TextUI. Tout le reste de HZ-TextUi fonctionne sans lui.

29 formes

Huit pour la pastille du libellé, onze pour le bouton de touche, dix pour le pin dans le monde. Une par élément.

16 presets, rendus en direct

5 presets d'apparence complète — glow, chamfer, hexagon, outline, soft — et 11 presets de couleur, tous rendus dans une galerie par-dessus une vraie image de jeu, pour que vous voyiez chacun avant de cliquer.

Et tout le reste

Fond, glow, coins, bordure, marge intérieure, et une zone HTML/CSS libre pour aller plus loin. À la publication, les sprites sont reconstruits en PNG, et les joueurs les reçoivent après un redémarrage de hz_textui.

Les 5 couleurs de texte — la lettre de la touche, le libellé, le compteur et les deux lignes d'option — s'appliquent à chaud, sans redémarrage. L'éditeur lui-même parle 7 langues.

Visez, puis molette ou clic

Maintenez la touche et un pin dans le monde devient un prompt.

Une seule option : elle se valide avec E. Plusieurs : le joueur utilise la molette pour en surligner une, ou laisse apparaître un curseur souris natif et clique dessus. Aucun focus NUI dans les deux cas — la caméra reste à lui. Les sous-menus descendent et reviennent.

Là où un modèle de visée se justifie : HZ-Cook pose quatre bacs à ingrédients, deux bouteilles de sauce et une spatule sur la même tablette, tous sans collision pour que les joueurs ne butent pas dedans. Sélectionner ce qui est dessiné à l'écran, et pouvoir élargir aimRadius, c'est la différence entre attraper le bac et attraper la table en dessous.

Ça tourne quand ça s'affiche

La boucle de détection est créée à l'appui sur la touche et détruite au relâchement. Rien ne scanne le monde tant que la touche n'est pas enfoncée.

Agnostique au framework

ox_core, QBX, ESX et ND_Core sont détectés automatiquement pour les filtres groups et job, et il tourne aussi en standalone. 11 convars couvrent la touche, le réticule et le rayon de visée — et les noms de convars ox_target sont lus en repli, pour qu'un serveur qui migre depuis lui garde ses réglages.

Compatibilité

• Frameworks — ESX, QBCore, QBox, ox_core, ND_Core, Standalone
• Répond à l'API de — ox_target, qtarget, qb-target
• Requiert — ox_lib
• TextUI Designer — nécessite hz_lib, le panel admin HZ. Le target, lui, non
• Mises à jour — à vie

Documentation complète : hzscripts.com/docs/hz-textui