AI Translation Pro

Guide d’utilisation d’AITranslation Pro

AITranslation Pro traduit un fichier de langue de plugin, un ensemble borné de fichiers de plugins chargés, ou le chat global admissible des joueurs ayant explicitement accepté. Il utilise le chat global natif et peut employer la mise en forme de BetterChat lorsque ce plugin facultatif est présent.

Prérequis

• Un serveur Rust sous Oxide ou Carbon.
• Le fichier AITranslation Pro 1.1.2 provenant de l’archive du produit correspondant.
• Votre propre clé API OpenAI et du crédit disponible chez le fournisseur.
• Des fichiers source anglais pour la traduction de fichiers.
• BetterChat uniquement pour son circuit facultatif de mise en forme.

L’administrateur fournit la clé et prend en charge les frais OpenAI. Free et Pro sont deux produits distincts et mutuellement exclusifs : ne les installez pas et ne les exécutez pas ensemble. Pro est prioritaire et décharge Free si les deux fichiers sont présents.

Installation

1. Arrêtez le serveur ou déchargez l’ancienne version d’AITranslation Pro.
2. Retirez AITranslation Free s’il est installé.
3. Placez AITranslationPro.cs dans le répertoire des plugins du serveur.
4. Démarrez ou rechargez le plugin pour créer sa configuration.
5. Renseignez OpenAIToken dans la configuration serveur protégée.
6. Vérifiez l’information de confidentialité, les permissions et les limites locales avant d’activer les traductions.

Réservez l’accès au fichier de configuration aux administrateurs de confiance. La clé n’est pas écrite dans les journaux du plugin.

Traduction de fichiers

Traduire un plugin vers une ou plusieurs langues :

aitpro.translateplugin MyPlugin fr de

Traduire un ensemble borné de fichiers de langue de plugins chargés :

ait.translateallplugins fr de

La traduction lit les textes anglais sélectionnés, valide les noms de plugins, les langues, le JSON source et les limites locales, puis met les tâches en attente. Seuls les textes anglais sélectionnés, les langues cibles et les instructions du fournisseur sont envoyés à OpenAI.

Chaque réponse complète doit contenir exactement les clés attendues et des valeurs textuelles dont les paramètres de substitution sont préservés. Un résultat valide est préparé avant remplacement. Le précédent fichier cible est conservé sous <PluginName>.json.aitranslation.bak ; d’autres fichiers de récupération de transaction peuvent être disponibles si le remplacement échoue.

Consentement au chat

Le chat d’un joueur reste local tant qu’il n’exécute pas explicitement :

/ait.chat on

Un choix inconnu ou un échec de stockage est traité comme un refus. Un échec d’enregistrement est signalé sans prétendre que le choix a changé. Le chat d’équipe et les autres canaux non globaux sont transmis sans modification.

Pour un message global admissible, l’expéditeur et les destinataires traduits doivent avoir aitranslationpro.chat.use et un consentement enregistré. Pro envoie le texte du chat global admissible, la langue cible et les instructions du fournisseur à OpenAI. Si la traduction échoue, les destinataires concernés reçoivent le message original.

Commandes et permissions

Référence de configuration

La configuration suivie de la version 1.1.2 utilise gpt-5.6-luna comme Model par défaut pour les fichiers et le chat. Le modèle est configurable ; vérifiez sa disponibilité et son prix actuels auprès d’OpenAI avant d’activer les requêtes.

Temperature, Prompt et LangFilesConfiguration.TimeBetweenRequestsInSeconds restent lisibles pour les anciennes configurations, mais ne sont pas utilisés pour créer les requêtes actuelles.

Confidentialité et diagnostics

Les clés, les textes traduits, le chat des joueurs, les prompts et les corps de réponse du fournisseur ne sont pas journalisés. Les diagnostics contiennent des détails d’opération, des identifiants, des langues, des quantités et des codes d’erreur bornés.

Les réponses malformées, incomplètes, refusées, trop volumineuses ou structurellement incorrectes sont rejetées. Les réponses destinées aux fichiers doivent conserver toutes les clés et tous les paramètres de substitution. Les réponses de chat doivent contenir l’unique champ traduit attendu et conserver les marqueurs de mise en forme.

Vérifiez l’information configurable destinée aux joueurs et obtenez les autorisations légales ou opérationnelles locales nécessaires avant d’activer le traitement externe du chat.

BetterChat

BetterChat est facultatif. Lorsqu’il est disponible, Pro utilise son API de mise en forme ; sinon, Pro utilise le chat global natif. L’ordre dynamique des hooks BetterChat n’a pas été validé sur un serveur réel lors de la validation finale enregistrée. Testez cette combinaison sur un serveur hors production avant de vous y fier.

Récupération

Avant de réessayer un remplacement de fichier ayant échoué :

1. Déchargez AITranslation Pro.
2. Vérifiez le fichier cible, sa copie .aitranslation.bak et tout fichier de récupération .aitranslation.rollback.
3. Restaurez manuellement la copie fiable si nécessaire.
4. Ne supprimez les fichiers de récupération non résolus qu’après avoir confirmé que la cible est correcte.
5. Rechargez Pro et lancez une petite traduction de fichier.

Le plugin bloque un nouveau remplacement tant que des fichiers de récupération non résolus sont présents.

Limites connues

• La qualité de traduction et la disponibilité du fournisseur ne dépendent pas du plugin.
• L’administrateur doit surveiller l’utilisation et les coûts OpenAI en complément des limites locales.
• La traduction du chat concerne uniquement le chat global admissible sur consentement.
• La mise en forme BetterChat est facultative et l’ordre de ses hooks en conditions réelles reste non vérifié.
• Aucune requête OpenAI réelle n’a été exécutée pendant la validation finale enregistrée.

Assistance

Utilisez la section d’assistance Codefling. Indiquez la version d’AITranslation Pro, la version Oxide ou Carbon, la présence éventuelle de BetterChat, la commande ou le circuit de chat et un code d’erreur expurgé. Ne publiez jamais la clé OpenAI, le chat des joueurs ou le contenu des fichiers de langue.

Cette traduction française est dérivée du guide anglais du dépôt AITranslation Pro, au commit 5925403f204b372ed92ec0478d59e65c29b1faeb. Elle ne revendique aucun comportement supplémentaire.