/// PIMPMYRUST PLUGIN
AI Translation Pro
Guide des réglages de AI Translation Pro pour cette version. Vérifiez la fiche du plugin avant de l'utiliser sur votre serveur.
Préparer votre fichier
- Vérifiez la version installée
Ce guide décrit AI Translation Pro 2.1.0. Le configurateur doit utiliser cette même version.
- Récupérez les réglages
Cliquez sur Importer, puis Depuis mon serveur. Choisissez les fichiers et confirmez leur chargement. Sélectionner un serveur ne remplace pas le document ouvert. Vous pouvez aussi importer des fichiers de cet appareil ou une configuration depuis Mes projets.
- Modifiez et envoyez
Ajustez les réglages, corrigez les erreurs, puis utilisez Envoyer pour transmettre les fichiers au serveur choisi. Un conflit bloque l’envoi jusqu’à votre décision. Vous pouvez toujours exporter seulement les fichiers dont vous avez besoin.
Les envois au serveur disposent de sauvegardes privées. Enregistrer conserve votre travail dans Mes projets ; cette action n’envoie rien au serveur. Un téléchargement permet aussi de reprendre sans connexion.
Réglages de cette version
Général 1
- Clé OpenAI de secours
- Texte · obligatoire
Ancienne clé conservée pour les configurations existantes. Le profil OpenAI l’utilise uniquement si sa propre clé est vide.
Chemin JSON
OpenAIToken
Traduction du chat 1
- Activer la traduction du chat
- Activé / désactivé · obligatoire
Autorise la traduction du chat dans les canaux sélectionnés, sous réserve des permissions et choix des joueurs.
Chemin JSON
ChatConfiguration → Enabled
Features 21
- Providers
- Valeur JSON
Chemin JSON
Features → Providers - Profil du chat
- Texte
Nom du profil fournisseur dans Providers utilisé pour traduire le chat admissible.
Chemin JSON
Features → ChatProfile - Profil des fichiers
- Texte
Nom du profil fournisseur dans Providers utilisé pour les fichiers de langue.
Chemin JSON
Features → FileProfile - Contexte du serveur
- Texte
Contexte commun du serveur ajouté aux instructions de traduction ; modifier ce texte renouvelle les traductions suivies.
Chemin JSON
Features → Context - Langue source des fichiers
- Texte
Langue des fichiers source lang/<code>/<plugin>.json pour la maintenance native ; en par défaut.
Chemin JSON
Features → SourceLocale - Canaux à traduire
- Liste
Chemin JSON
Features → ChatChannels - Langues proposées aux joueurs
- Liste
Langue proposée dans le panneau joueur, dans cet ordre ; au plus 24 codes valides sont retenus.
Chemin JSON
Features → PlayerLanguages - Durée du cache du chat (secondes)
- Nombre entier
Durée de réutilisation d’une traduction de chat ; 0 désactive ce cache.
Chemin JSON
Features → ChatCacheSecondsMinimum : 0 · Maximum : 86400
- Durée de la mémoire des fichiers (secondes)
- Nombre entier
Durée de conservation des traductions mémorisées par clé de fichier ; 0 désactive cette mémoire.
Chemin JSON
Features → FileMemorySecondsMinimum : 0 · Maximum : 31536000
- Entrées du cache
- Nombre entier
Nombre maximal d’entrées de traduction mises en cache ; 0 coupe la mise en cache.
Chemin JSON
Features → MaxCacheEntriesMinimum : 0 · Maximum : 20000
- Clés par requête
- Nombre entier
Nombre maximal de clés de langue regroupées dans une requête native de fichier.
Chemin JSON
Features → KeysPerRequestMinimum : 1 · Maximum : 50
- Caractères par lot
- Nombre entier
Taille maximale en caractères d’un lot de clés envoyé au fournisseur.
Chemin JSON
Features → BatchCharactersMinimum : 256 · Maximum : 20000
- Validité d’un aperçu (heures)
- Nombre entier
Durée de disponibilité d’un aperçu privé avant expiration ; l’application reste une action explicite.
Chemin JSON
Features → PreviewHoursMinimum : 1 · Maximum : 72
- Budget quotidien estimé
- Nombre
Budget quotidien estimé dans la devise choisie ; 0 désactive cette limite locale.
Chemin JSON
Features → DailyCostBudgetMinimum : 0 · Maximum : 1000000000
- Budget mensuel estimé
- Nombre
Budget mensuel estimé dans la devise choisie ; 0 désactive cette limite locale.
Chemin JSON
Features → MonthlyCostBudgetMinimum : 0 · Maximum : 1000000000
- Devise des tarifs
- Texte
Devise commune des tarifs et budgets affichés ; aucune conversion automatique n’est effectuée.
Chemin JSON
Features → Currency - Activer le pont IQChat
- Activé / désactivé
Autorise les demandes confiées par le pont TranslationAPI facultatif à Pro ; IQChat garde ses permissions et préférences.
Chemin JSON
Features → IQChatBridgeEnabled - Détecter la langue du message
- Activé / désactivé
Demande une traduction même entre joueurs réglés sur la même langue de client ; cela peut accroître les appels.
Chemin JSON
Features → AutoDetectSourceLanguage - Signaler les fichiers à actualiser
- Activé / désactivé
Surveille les plugins chargés déjà suivis et signale les fichiers de langue devenus à actualiser.
Chemin JSON
Features → WatchLoadedPlugins - Préparer automatiquement les mises à jour (appels facturés)
- Activé / désactivé
Prépare automatiquement, avec appels potentiellement facturés, les mises à jour détectées ; l’application reste manuelle.
Chemin JSON
Features → AutoPrepareUpdates - Intercepter la sortie BetterChat
- Activé / désactivé
Activé : traduit la sortie de BetterChat après ses filtres. Désactivé : utilise le traitement historique OnBetterChat. Rechargez Pro après modification. Les filtres réseau exécutés après Pro et le relais Rust+ ont des limites détaillées dans le guide.
Chemin JSON
Features → BetterChatNetworkInterception
Fichiers de langue 2
- Activer la traduction des fichiers
- Activé / désactivé · obligatoire
Autorise la traduction de fichiers d’un plugin et les lots bornés par les utilisateurs habilités. Le désactiver coupe ce circuit de fichiers, pas la traduction du chat.
Chemin JSON
LangFilesConfiguration → Enabled - Délai historique entre requêtes (inutilisé)
- Nombre · obligatoire
Champ hérité conservé à l’import ; Pro 2.0 utilise la file et les limites communes plutôt que ce délai.
Chemin JSON
LangFilesConfiguration → TimeBetweenRequestsInSecondsMinimum : 0.1 · Maximum : 60
Limites locales des requêtes 12
- Requêtes en attente maximales
- Nombre entier · obligatoire
Borne le nombre de requêtes de fichiers et de chat en attente. Les nouvelles tâches sont refusées lorsque la file commune est pleine.
Chemin JSON
Limits → MaxQueuedMinimum : 1 · Maximum : 256
- Requêtes simultanées maximales
- Nombre entier · obligatoire
Borne le nombre de requêtes simultanément envoyées au fournisseur pour les fichiers et le chat.
Chemin JSON
Limits → MaxConcurrentMinimum : 1 · Maximum : 8
- Requêtes par minute
- Nombre entier · obligatoire
Limite localement les requêtes admises par minute pour les traductions de fichiers et de chat.
Chemin JSON
Limits → MaxRequestsPerMinuteMinimum : 1 · Maximum : 300
- Requêtes par jour
- Nombre entier · obligatoire
Limite localement les requêtes admises par jour pour les fichiers et le chat. Surveillez aussi l’utilisation chez le fournisseur.
Chemin JSON
Limits → MaxRequestsPerDayMinimum : 1 · Maximum : 20000
- Budget local quotidien de tokens
- Nombre entier · obligatoire
Limite les réservations locales quotidiennes de tokens pour les fichiers et le chat. Cette estimation n’est ni un plafond monétaire ni une limite du compte fournisseur.
Chemin JSON
Limits → DailyTokenBudgetMinimum : 1000 · Maximum : 100000000
- Nouvelles tentatives après erreur temporaire
- Nombre entier · obligatoire
Autorise ce nombre de nouvelles tentatives après une erreur temporaire admissible du fournisseur. Utilisez 0 pour désactiver les nouvelles tentatives.
Chemin JSON
Limits → MaxRetriesMinimum : 0 · Maximum : 3
- Limite de caractères des fichiers de langue
- Nombre entier · obligatoire
Borne le fichier source dans Features.SourceLocale et le résultat traduit ; un contenu trop long n’est pas appliqué.
Chemin JSON
Limits → MaxLanguageFileCharactersMinimum : 1024 · Maximum : 500000
- Limite de caractères de la réponse fournisseur
- Nombre entier · obligatoire
Refuse les réponses du fournisseur dépassant cette limite de caractères au lieu de les analyser ou de les appliquer.
Chemin JSON
Limits → MaxProviderResponseCharactersMinimum : 1024 · Maximum : 1000000
- Limite de caractères du message de chat
- Nombre entier · obligatoire
Exclut les messages trop longs de la traduction payante ; les destinataires concernés reçoivent le message original.
Chemin JSON
Limits → MaxChatCharactersMinimum : 32 · Maximum : 2000
- Langues cibles par message de chat
- Nombre entier · obligatoire
Borne le nombre de langues cibles facturables issues d’un message admissible, quel que soit le canal activé.
Chemin JSON
Limits → MaxChatLocalesPerMessageMinimum : 1 · Maximum : 16
- Délai par expéditeur en secondes
- Nombre entier · obligatoire
Impose ce délai minimal entre deux déclenchements de traduction payante du chat par le même expéditeur.
Chemin JSON
Limits → ChatSenderCooldownSecondsMinimum : 1 · Maximum : 60
- Plugins examinés par commande de lot
- Nombre entier · obligatoire
Borne l’ensemble des plugins chargés examinés par ait.translateallplugins. Ce n’est pas une limite de requêtes par minute.
Chemin JSON
Limits → MaxBulkPluginsMinimum : 1 · Maximum : 500
Confidentialité et consentement 2
- Exiger un consentement explicite
- Activé / désactivé · obligatoire
Exige /ait on avant la traduction du chat. Désactiver permet l’activation automatique aux joueurs autorisés ; /ait off reste prioritaire.
Chemin JSON
Privacy → RequireExplicitConsent - Information de confidentialité des joueurs
- Texte · obligatoire
Message affiché aux joueurs au sujet du traitement externe et de /ait ; ce texte ne vaut pas consentement.
Chemin JSON
Privacy → PlayerNotice
UIConfiguration 5
- Activer le panneau /ait
- Activé / désactivé
Affiche le panneau /ait ; les commandes texte restent utilisables lorsqu’il est masqué.
Chemin JSON
UIConfiguration → Enabled - Modèle actif
- Texte
Choisit une clé existante dans les modèles de cette configuration ; chaque modèle conserve ses propres personnalisations.
Chemin JSON
UIConfiguration → Template - Message avec IQChat
- Texte
Message montré par le panneau lorsque IQChat gère le chat et ses réglages de traduction.
Chemin JSON
UIConfiguration → IQChatNotice - Templates
- Valeur JSON
Chemin JSON
UIConfiguration → Templates - Présentation du panneau
- Choix
Modèle fourni (native) ou copie personnalisée (pimpmycui). La bêta 2.1.0 utilise PimpMyCUI et ses pages JSON dans les deux cas. Modifiez le modèle dans « Panneau joueur » ; ce réglage ne change pas la fenêtre utilisée.
Chemin JSON
UIConfiguration → PresentationModeValeurs possibles : native, pimpmycui
Réglages du modèle de chat 4
- Modèle OpenAI
- Texte · obligatoire
Modèle hérité utilisé comme valeur de repli du profil OpenAI pour ce circuit ; un modèle renseigné dans le profil prend priorité.
Chemin JSON
ChatConfiguration → Model → Model - Température historique (inutilisée)
- Nombre · obligatoire
Champ hérité conservé à l’import ; les requêtes Pro 2.0 ne lisent pas cette valeur.
Chemin JSON
ChatConfiguration → Model → Temperature - Limite de tokens de réponse
- Nombre entier · obligatoire
Plafonne le nombre de tokens de réponse demandés pour ce type de traduction. Une limite trop basse peut produire une réponse incomplète, rejetée par le plugin.
Chemin JSON
ChatConfiguration → Model → MaxTokensMinimum : 64 · Maximum : 16384
- Prompt historique (inutilisé)
- Texte · obligatoire
Conservé pour compatibilité ; les requêtes actuelles utilisent des instructions fixes, donc modifier ce prompt n’a aucun effet.
Chemin JSON
ChatConfiguration → Model → Prompt
Glossary 2
- Termes à conserver
- Liste
Terme à conserver tel quel dans les traductions ; la casse et les limites de mots sont respectées.
Chemin JSON
Features → Glossary → Preserve - Preferred
- Valeur JSON
Chemin JSON
Features → Glossary → Preferred
Réglages du modèle de fichiers 4
- Modèle OpenAI
- Texte · obligatoire
Modèle hérité utilisé comme valeur de repli du profil OpenAI pour ce circuit ; un modèle renseigné dans le profil prend priorité.
Chemin JSON
LangFilesConfiguration → Model → Model - Température historique (inutilisée)
- Nombre · obligatoire
Champ hérité conservé à l’import ; les requêtes Pro 2.0 ne lisent pas cette valeur.
Chemin JSON
LangFilesConfiguration → Model → Temperature - Limite de tokens de réponse
- Nombre entier · obligatoire
Plafonne le nombre de tokens de réponse demandés pour ce type de traduction. Une limite trop basse peut produire une réponse incomplète, rejetée par le plugin.
Chemin JSON
LangFilesConfiguration → Model → MaxTokensMinimum : 64 · Maximum : 16384
- Prompt historique (inutilisé)
- Texte · obligatoire
Conservé pour compatibilité ; les requêtes actuelles utilisent des instructions fixes, donc modifier ce prompt n’a aucun effet.
Chemin JSON
LangFilesConfiguration → Model → Prompt
Instructions du plugin
AI Translation Pro 2.1.0
Pour télécharger le plugin, connectez-vous avec un compte qui y a accès.
Traduisez les fichiers de langue de vos plugins et proposez aux joueurs un chat traduit dans leur langue. Pro comprend un panneau /ait, trois présentations et des profils distincts pour le chat et les fichiers.
Installation
- Installez
AITranslationPro.cssur Rust sous Oxide ou Carbon. Free et Pro ne doivent pas fonctionner ensemble. - Dans Traduction, choisissez votre fournisseur, puis renseignez sa clé et un modèle disponible sur votre compte. Les options avancées permettent de séparer le chat et les fichiers.
- Exportez
AITranslationPro.json, ou envoyez-le depuis PimpMyRust si le serveur est connecté en SFTP/RCON. Rechargez le plugin après modification.
Le plugin accepte les configurations 1.1.4. Le configurateur peut y ajouter les nouveaux réglages avec une action explicite ; vos valeurs et propriétés supplémentaires restent conservées. Sélectionnez LTS 1.1.4 pour modifier un serveur resté sur cette version.
Fournisseurs
OpenAI, DeepL, Gemini, OpenRouter, Anthropic et un endpoint personnalisé au format Chat Completions sont pris en charge. Chaque profil conserve sa clé, son modèle, son délai HTTP et un profil de secours facultatif. DeepL n’exige pas de modèle. Les disponibilités et tarifs dépendent de votre compte fournisseur.
OpenAIToken reste une clé de secours : le profil OpenAI l’utilise si sa propre clé est vide. Les anciens champs Prompt, Temperature et TimeBetweenRequestsInSeconds restent lisibles pour la migration ; les nouvelles traductions utilisent le contexte et le glossaire de Features.
Le propriétaire du serveur paie les appels fournisseur. Renseignez les tarifs de votre profil avant d’utiliser les budgets monétaires estimés. Les limites locales ne remplacent pas un plafond de facturation chez le fournisseur.
Joueurs et chat
Accordez aitranslationpro.chat.use aux joueurs concernés et aitranslationpro.admin aux administrateurs. Par défaut, chaque joueur doit activer sa participation. Un refus explicite reste prioritaire si vous désactivez l’exigence de consentement. Le fournisseur reçoit le texte à traduire ; la clé reste sur le serveur.
| Commande joueur | Effet |
|---|---|
/ait | Ouvrir le panneau de langue et de traduction |
/ait on / /ait off | Activer ou refuser la traduction |
/ait lang fr / /ait auto | Choisir une langue ou suivre celle du client |
/ait original | Afficher ou masquer le texte original |
/ait status | Consulter ses réglages et son accès |
/ait test [texte] | Tester pour soi, administrateur uniquement |
/ait.chat on|off|status reste accepté. Global est actif par défaut ; Team, Clan, Local et Cards peuvent aussi être sélectionnés. Permissions, consentement et destinataires sont contrôlés avant traduction et livraison. Après cinq secondes sans résultat, l’original prend le relais. La détection automatique de la langue peut augmenter le nombre d’appels.
BetterChat et IQChat
BetterChat est facultatif et reste installé sans modification. Features.BetterChatNetworkInterception choisit son mode d’intégration :
- Activé, par défaut : traduit la sortie de BetterChat après ses filtres. Rust+ conserve l’original. Un filtre réseau ponctuel exécuté après la capture peut ne pas conserver sa décision lors de l’envoi traduit ; testez les autres plugins qui bloquent des destinataires.
- Désactivé : traduit via
OnBetterChat, puis livre le message. Un hook ultérieur remplaçant le dictionnaire ou terminant la chaîne peut ne pas être respecté. Les messages Team pris en charge ne rejoignent pas le relais Rust+.
Rechargez Pro après un changement. ait.status indique le mode actif. Le pont IQChat est facultatif : évitez de traduire le même message avec plusieurs plugins. Avec IQChat, /ait renvoie vers ses réglages.
Fichiers de langue
La source est oxide/lang/<langue source>/<Plugin>.json, ou le dossier Carbon équivalent. La langue source est en par défaut. Les fichiers sont des objets JSON de textes en UTF-8. Variables et termes protégés sont vérifiés avant remplacement ; les corrections manuelles ne sont pas écrasées silencieusement.
| Commande console | Effet |
|---|---|
ait.files scan MyPlugin fr | Voir les traductions à créer ou actualiser |
ait.files prepare MyPlugin fr | Préparer un aperçu privé ; appels facturés |
ait.files list | Retrouver les aperçus et leur état |
ait.files preview <id> | Lire un aperçu préparé |
ait.files apply <id> | Appliquer l’aperçu sélectionné |
ait.files restore <id> | Restaurer la version sauvegardée |
ait.files discard <id> | Abandonner un aperçu |
ait.files lock MyPlugin fr protège les valeurs existantes ; adopt adopte un fichier après contrôle de sa correspondance avec les textes sources. aitpro.translateplugin MyPlugin fr et ait.translateallplugins fr appliquent directement leur résultat : utilisez prepare pour le relire avant application. Le suivi des plugins signale les fichiers à actualiser sans appel fournisseur par défaut.
Traduction depuis le Hub
Connectez le serveur en SFTP/RCON, puis choisissez Traduire avec l’IA depuis ses fichiers de langue. Sélectionnez les plugins et les langues, vérifiez les fichiers, puis confirmez la traduction. Le plugin utilise votre fournisseur, votre langue source, votre contexte, votre glossaire et vos budgets. La préparation peut entraîner des frais chez le fournisseur ; le Hub n’en affiche pas d’estimation lorsqu’il ne peut pas les calculer.
Vérifiez l’aperçu avant de l’appliquer. Les corrections manuelles sont conservées. Après application, Restaurer reste disponible jusqu’à la date affichée, selon PreviewHours — 24 heures par défaut. Si le fichier a été modifié depuis, la restauration est refusée pour préserver ces changements. Un résultat incertain se vérifie sans relancer la traduction. Le simulateur du chat n’affiche pas de tarif pour un profil qu’il ne sait pas chiffrer.
Panneau joueur et aperçu
Le panneau /ait de la version 2.1.0 utilise PimpMyCUI 1.4.0 et ses pages publiées séparément. Installez AITranslationPro.cs, PimpMyCUI.cs et les fichiers du ZIP aux chemins indiqués, notamment oxide/data/PimpMyCUI/plugin-pages/aitranslationpro/manifest.json et les packages qu’il référence. Conservez le manifeste et ses packages ensemble. Rechargez les plugins après installation. Une dépendance ou une page indisponible ferme ce parcours ; les commandes /ait on, off, lang, auto, original et status restent disponibles. Aucun ancien panneau natif n’est ouvert à sa place.
Dans Panneau joueur, choisissez Glass Cards, Field Radio ou Compact Console. Le configurateur prépare la page et son cadre commun ; sans destination personnalisée, le plugin utilise la publication par défaut. Dans Interfaces en jeu, une page Traduction peut aussi rejoindre votre propre fenêtre. Le runtime relie cette page au fournisseur AITranslationPro et garde les permissions, le consentement et les réglages sous le contrôle du plugin.
Modifier dans l’éditeur CUI ouvre la copie éditable de cette page. Appliquez pour reprendre la modification dans la configuration ; fermer sans appliquer préserve la copie précédente. Le ZIP exporte les publications et les sources nécessaires à leur réédition. Installer seulement un projet éditable ne publie pas son interface en jeu.
Les textes de la page sont éditables ; les messages de commande du plugin restent en anglais et cette édition ne crée pas de fichier Lang propre. Les drapeaux sont des images PNG déclarées, les icônes natives gardent leur identité. L’aperçu ne lance aucune commande du serveur. Vérifiez le rendu, les polices et les interactions dans Rust.
Cache et diagnostic
Le cache du chat et la mémoire des fichiers évitent de retraduire les mêmes textes. ait.cache.clear les vide sans supprimer les préférences des joueurs. ait.status affiche les profils, l’état et les compteurs. Les limites de requêtes, de file et de tokens restent actives même sans budget monétaire.
Installer les fichiers
Avec un serveur connecté, cliquez sur Envoyer dans le configurateur. Le résultat indique si les fichiers ont été envoyés et si le plugin a été rechargé. Sans RCON, rechargez le plugin depuis votre panneau serveur après l’envoi.
Sans serveur connecté : Conservez une copie des fichiers actuels. Placez chaque fichier exporté dans le dossier indiqué avant l’export, ou reprenez les chemins du ZIP. Ne placez pas les données ou les traductions dans le dossier config.
Suivez les instructions du plugin ci-dessus pour ses dépendances et son rechargement. L’export ne connecte pas le site à votre serveur.