Aller au contenu
← Toute la documentation

/// 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

  1. Vérifiez la version installée

    Ce guide décrit AI Translation Pro 2.1.0. Le configurateur doit utiliser cette même version.

  2. 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.

  3. 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 JSONOpenAIToken
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 JSONChatConfiguration → Enabled
Features 21
Providers
Valeur JSON
Chemin JSONFeatures → Providers
Profil du chat
Texte

Nom du profil fournisseur dans Providers utilisé pour traduire le chat admissible.

Chemin JSONFeatures → ChatProfile
Profil des fichiers
Texte

Nom du profil fournisseur dans Providers utilisé pour les fichiers de langue.

Chemin JSONFeatures → FileProfile
Contexte du serveur
Texte

Contexte commun du serveur ajouté aux instructions de traduction ; modifier ce texte renouvelle les traductions suivies.

Chemin JSONFeatures → Context
Langue source des fichiers
Texte

Langue des fichiers source lang/<code>/<plugin>.json pour la maintenance native ; en par défaut.

Chemin JSONFeatures → SourceLocale
Canaux à traduire
Liste
Chemin JSONFeatures → 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 JSONFeatures → 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 JSONFeatures → ChatCacheSeconds

Minimum : 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 JSONFeatures → FileMemorySeconds

Minimum : 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 JSONFeatures → MaxCacheEntries

Minimum : 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 JSONFeatures → KeysPerRequest

Minimum : 1 · Maximum : 50

Caractères par lot
Nombre entier

Taille maximale en caractères d’un lot de clés envoyé au fournisseur.

Chemin JSONFeatures → BatchCharacters

Minimum : 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 JSONFeatures → PreviewHours

Minimum : 1 · Maximum : 72

Budget quotidien estimé
Nombre

Budget quotidien estimé dans la devise choisie ; 0 désactive cette limite locale.

Chemin JSONFeatures → DailyCostBudget

Minimum : 0 · Maximum : 1000000000

Budget mensuel estimé
Nombre

Budget mensuel estimé dans la devise choisie ; 0 désactive cette limite locale.

Chemin JSONFeatures → MonthlyCostBudget

Minimum : 0 · Maximum : 1000000000

Devise des tarifs
Texte

Devise commune des tarifs et budgets affichés ; aucune conversion automatique n’est effectuée.

Chemin JSONFeatures → 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 JSONFeatures → 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 JSONFeatures → 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 JSONFeatures → 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 JSONFeatures → 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 JSONFeatures → 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 JSONLangFilesConfiguration → 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 JSONLangFilesConfiguration → TimeBetweenRequestsInSeconds

Minimum : 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 JSONLimits → MaxQueued

Minimum : 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 JSONLimits → MaxConcurrent

Minimum : 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 JSONLimits → MaxRequestsPerMinute

Minimum : 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 JSONLimits → MaxRequestsPerDay

Minimum : 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 JSONLimits → DailyTokenBudget

Minimum : 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 JSONLimits → MaxRetries

Minimum : 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 JSONLimits → MaxLanguageFileCharacters

Minimum : 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 JSONLimits → MaxProviderResponseCharacters

Minimum : 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 JSONLimits → MaxChatCharacters

Minimum : 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 JSONLimits → MaxChatLocalesPerMessage

Minimum : 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 JSONLimits → ChatSenderCooldownSeconds

Minimum : 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 JSONLimits → MaxBulkPlugins

Minimum : 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 JSONPrivacy → 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 JSONPrivacy → PlayerNotice
UIConfiguration 5
Activer le panneau /ait
Activé / désactivé

Affiche le panneau /ait ; les commandes texte restent utilisables lorsqu’il est masqué.

Chemin JSONUIConfiguration → Enabled
Modèle actif
Texte

Choisit une clé existante dans les modèles de cette configuration ; chaque modèle conserve ses propres personnalisations.

Chemin JSONUIConfiguration → Template
Message avec IQChat
Texte

Message montré par le panneau lorsque IQChat gère le chat et ses réglages de traduction.

Chemin JSONUIConfiguration → IQChatNotice
Templates
Valeur JSON
Chemin JSONUIConfiguration → 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 JSONUIConfiguration → PresentationMode

Valeurs 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 JSONChatConfiguration → 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 JSONChatConfiguration → 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 JSONChatConfiguration → Model → MaxTokens

Minimum : 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 JSONChatConfiguration → 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 JSONFeatures → Glossary → Preserve
Preferred
Valeur JSON
Chemin JSONFeatures → 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 JSONLangFilesConfiguration → 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 JSONLangFilesConfiguration → 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 JSONLangFilesConfiguration → Model → MaxTokens

Minimum : 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 JSONLangFilesConfiguration → 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

  1. Installez AITranslationPro.cs sur Rust sous Oxide ou Carbon. Free et Pro ne doivent pas fonctionner ensemble.
  2. 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.
  3. 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 joueurEffet
/aitOuvrir le panneau de langue et de traduction
/ait on / /ait offActiver ou refuser la traduction
/ait lang fr / /ait autoChoisir une langue ou suivre celle du client
/ait originalAfficher ou masquer le texte original
/ait statusConsulter 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 consoleEffet
ait.files scan MyPlugin frVoir les traductions à créer ou actualiser
ait.files prepare MyPlugin frPréparer un aperçu privé ; appels facturés
ait.files listRetrouver 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.

Guide de configuration et d’envoi →