PimpMyCUI

PimpMyCUI

Installez le runtime gratuit 1.4.0 pour afficher en jeu vos interfaces créées dans l’éditeur. Les réglages du plugin utilisent le format de configuration 1.1.0.

Éditeur actuel et version installée

Cette fiche conserve le contrat de PimpMyCUI 1.1.0. L’éditeur et sa bibliothèque ont évolué : certaines fenêtres, pages et données dynamiques requièrent 1.4.0 et des capacités supplémentaires. Vérifiez la version minimale et les capacités déclarées par le package avant toute installation. Ouvrir l’éditeur ne met pas à jour le plugin de votre serveur.

Pour le parcours actuel, ouvrez Interfaces en jeu, puis le guide Fenêtres de serveur. Fenêtre → Apparence règle le format 16:9 ou Carré et la taille 60–100 %. Les pages remplissent le cadre ; les images contenues conservent leurs proportions. Ajouter une page → Page vide permet de créer votre contenu dans l’éditeur CUI, puis de revenir à la même fenêtre.

Les vidéos des quatre leçons conservent le parcours autonome enregistré en octobre 2026. Leurs libellés et captures ne représentent pas tous les contrôles Fenêtre/Page actuels ; les guides écrits distinguent ces parcours.

Créer une interface autonome que les joueurs peuvent ouvrir

1. Ouvrez PimpMyCUI Editor et créez vos écrans.
2. Sélectionnez l’écran à ouvrir. Dans Propriétés, trouvez Ouverture par commande et cliquez sur Ajouter une commande.
3. Saisissez une commande sans slash, par exemple menu. Ajoutez une permission ou un groupe autorisé. Pour un accès public, choisissez explicitement Tous les joueurs (groupe default).
4. Testez les boutons et la navigation avec Tester. Il ne vérifie pas les permissions, les conflits de commandes ni le rendu sur votre serveur Rust.
5. Dans Télécharger, choisissez Exporter le projet pour conserver une copie éditable, puis Exporter le package pour le fichier destiné au serveur.

Plusieurs commandes peuvent ouvrir le même écran. Une seule permission ou un seul groupe de la liste suffit ; les droits sont vérifiés à chaque appel, sans exception pour les administrateurs. Ajouter une commande n’accorde aucun droit et ne crée aucun groupe. PimpMyCUI enregistre les nouvelles permissions pimpmycui.* ; les autres plugins enregistrent leurs propres permissions.

Pour un /menu privé, choisissez pimpmycui.menu puis accordez ce droit côté serveur :

oxide.grant user <steam-id> pimpmycui.menu

Les commandes commencent par une lettre minuscule, acceptent minuscules, chiffres, _ et -, et comptent 32 caractères maximum. pimpmycui est réservé. Une commande accepte au plus 16 permissions uniques et 16 groupes uniques ; un package accepte 32 commandes et l’ensemble installé, 128.

Dans ce parcours autonome, les Données initiales fournissent les textes, nombres ou booléens fixes utilisés par l’écran. Un nom tel que player.name est une clé à plat, pas un objet imbriqué. Les arguments chat ne modifient pas ces valeurs et ne permettent pas d’ouvrir l’interface pour quelqu’un d’autre. Un champ de modèle ne devient pas une donnée en temps réel par son seul nom : l’intégration doit l’alimenter. Les composants actuels qui proposent Source → Donnée native utilisent uniquement les informations offertes par leur runtime compatible. Les exemples du navigateur ne prouvent pas la lecture de données réelles du serveur.

Installer le package exporté

Pour une installation manuelle :

1. Choisissez une version compatible sur la fiche PimpMyCUI, puis installez PimpMyCUI.cs dans le dossier habituel des plugins Oxide ou Carbon.
2. Ajoutez le package exporté complet à la liste packages de oxide/data/PimpMyCUI/packages.json (ou au dossier de données Carbon correspondant). Conservez les packages existants ; ne remplacez pas leur liste par un seul export.
3. Lancez pimpmycui.admin reload, vérifiez son résultat puis exécutez pimpmycui.admin list.
4. Testez la commande chat avec un joueur autorisé et un joueur non autorisé. Vérifiez navigation, fermeture et boutons en jeu avant une utilisation publique.

Avec un serveur connecté, Installer sur la fiche envoie le plugin par SFTP. Enregistrer conserve votre source dans votre compte. Télécharger conserve une copie locale sans transfert ni activation. Dans Interfaces en jeu, ce menu propose Projet modifiable ou Installation serveur · ZIP ; l’archive contient aussi les configurations liées et ses instructions INSTALL.txt. Fusionnez cui/registry-additions.json au registre existant par identifiant, sans écraser les autres interfaces. Le bouton Envoyer prépare une opération séparée. Pour une fenêtre avec des configurations liées, le parcours actuel passe par le projet enregistré complet dans Mes projets. Lisez les résultats de transfert et d’activation séparément ; sans confirmation d’activation, ne considérez pas l’interface comme active.

Les doublons de commande, écrans cibles absents ou conflits avec un autre plugin font refuser le rechargement. PimpMyCUI ne remplace pas les commandes d’un autre plugin. Un refus conserve les packages actifs en mémoire, mais une interface déjà ouverte peut devoir être rouverte si l’activation a fermé sa session. validate et diagnose inspectent la mémoire ; seul reload relit le fichier.

Interfaces fournies par un plugin

Dans le contrat 1.1.0 documenté ici, PimpMyCUI prend aussi en charge les interfaces produites par CustomRewards avec la composition Rendu natif (native-match). Leur disposition se règle dans CustomRewards ; ces documents générés côté serveur ne se modifient pas dans Studio. Un package de l’éditeur reste utilisable seulement si sa version minimale et ses capacités sont prises en charge par le runtime installé.

Les pages liées proposées dans le parcours actuel choisissent une configuration, une version et un contexte précis. Le contenu et les actions métier restent fournis par leur plugin. Retirer une page ne supprime pas sa configuration ; les menus et commandes d’un plugin tiers ne sont pas remplacés implicitement.

Intégration d’un plugin

Contrôlez les réponses de PimpMyCUI_GetContract et PimpMyCUI_GetRenderingContract sur la version installée avant d’utiliser ses capacités. Le contrat de rendu utilise notamment PimpMyCUI_RegisterDocument puis PimpMyCUI_OpenDocument pour les documents d’un plugin propriétaire ; les retours OnPimpMyCUIEvent et OnPimpMyCUIClosed restent liés à leur session et à leur propriétaire. Un champ JSON ou un nom de hook saisi dans l’éditeur ne crée pas cette intégration. Ne traitez pas le succès d’un aperçu local comme une autorisation serveur.

Configuration du runtime

Le configurateur du runtime modifie oxide/config/PimpMyCUI.json, pas le package de l’interface :

• Actions serveur approuvées (trustedPackageHashes) : ID du package → son sha256 intégré. L’approbation autorise cette version exacte à exécuter les actions de boutons dans la console serveur. Vérifiez les commandes avant de les approuver. Ce n’est pas l’empreinte du fichier JSON téléchargé.
• Interfaces désactivées (disabledPackages) : IDs des packages qui ne doivent pas s’ouvrir, y compris par commande chat joueur. Retirer un ID autorise de nouveau l’ouverture, sans accorder de permission ni supprimer le package installé.

Les deux collections sont vides par défaut et acceptent 128 entrées maximum. Les IDs correspondent exactement aux packages : minuscules, chiffres, . ou -, en commençant par une lettre, sur 64 caractères maximum. L’import/export conserve les champs de configuration inconnus.

Le serveur peut gérer ces réglages sans modifier le fichier à la main :

pimpmycui.admin trust <package-id> <sha256-intégré-au-package>
pimpmycui.admin disable <package-id>
pimpmycui.admin enable <package-id>

Ces changements sont sauvegardés avant confirmation et conservés au rechargement du plugin. Si l’écriture échoue, les réglages actifs restent inchangés. Un JSON de configuration invalide reste intact et bloque l’administration et l’ouverture des packages : corrigez le fichier, puis rechargez le plugin.

Ouvrir une interface n’approuve pas ses boutons. Leurs permissions, délais et dépendances de providers restent vérifiés. Si une modification de l’interface ou des commandes chat change son empreinte, approuvez le nouveau hash avant de lancer ses actions console serveur. Réservez pimpmycui.admin aux administrateurs de confiance.

Pour ce plugin gratuit, l’éditeur et le configurateur fonctionnent sans compte. Le brouillon automatique reste dans ce navigateur ; conservez aussi votre projet exporté. Le guide de l’éditeur détaille l’enregistrement des projets et leur installation sur un serveur connecté. L’aperçu navigateur et la compilation hors ligne Oxide/Carbon ne constituent pas une validation en jeu.