AI Translation Free

Guide utilisateur AITranslation Free

AITranslation Free traduit le fichier de langue anglais d'un plugin installé vers une locale cible, à la demande d'un administrateur. Cette édition est prévue pour les traductions ponctuelles de fichiers. Elle ne traduit pas le chat des joueurs et n'inclut pas la commande de traduction en masse de Pro.

Prérequis

• Un serveur Rust sous Oxide ou Carbon.
• Le fichier AITranslation Free 0.1.2 provenant de l'archive produit correspondante.
• Votre propre jeton API OpenAI avec du crédit disponible.
• Un fichier source sous oxide/lang/en/<NomDuPlugin>.json.

Le propriétaire du serveur fournit le jeton et assume les frais OpenAI. Free et Pro sont deux produits distincts et mutuellement exclusifs. Ne les installez pas simultanément. Si les deux fichiers sont présents, Pro prend la priorité et Free se décharge.

Installation

1. Arrêtez le serveur ou déchargez une ancienne version d'AITranslation Free.
2. Placez AITranslation.cs dans le répertoire des plugins du serveur.
3. Démarrez ou rechargez le plugin pour générer sa configuration.
4. Ajoutez votre jeton OpenAI dans OpenAIToken, dans la configuration protégée.
5. Vérifiez les limites locales avant de lancer une traduction.

La configuration doit rester accessible uniquement aux opérateurs de confiance. Le jeton n'est jamais écrit dans les journaux du plugin.

Première traduction

Depuis la console du serveur ou RCON :

aitfree.translateplugin MyPlugin fr

La commande lit oxide/lang/en/MyPlugin.json, valide le nom du plugin, la locale, le JSON source et les limites configurées, puis place une requête dans la file. Seules les valeurs anglaises sélectionnées, la langue cible et les instructions fournisseur sont envoyées à OpenAI. Aucune requête n'est réalisée avant l'exécution d'une commande autorisée.

Lorsque la réponse est complète et valide, le plugin vérifie les clés, les valeurs texte, les placeholders et la taille avant de préparer le résultat. La version précédente est conservée sous <NomDuPlugin>.json.aitranslation.bak et des fichiers supplémentaires protègent le remplacement en cours.

Commandes et permission

La console serveur, RCON et les administrateurs Rust peuvent exécuter ces commandes. Accordez aitranslation.admin uniquement à une connexion de confiance qui doit pouvoir déclencher une traduction payante.

Configuration

La configuration suivie pour la version 0.1.2 utilise gpt-5.6-luna comme valeur par défaut de Model. Le modèle reste configurable : vérifiez sa disponibilité et son tarif actuels avant d'activer des requêtes.

Les principales limites locales sont :

Temperature et Prompt restent lisibles pour les anciennes configurations, mais ne sont pas envoyés dans la requête fournisseur actuelle.

Confidentialité et diagnostics

AITranslation Free ne traite jamais le chat des joueurs. Les journaux peuvent contenir l'opération, le nom du plugin, la locale, des compteurs et des codes d'erreur bornés. Ils ne contiennent ni jeton API, ni prompt, ni texte traduit, ni corps de réponse du fournisseur.

Les réponses incorrectes, incomplètes, refusées, trop volumineuses, contenant des clés supplémentaires ou manquantes, des valeurs non textuelles ou des placeholders modifiés sont rejetées. Une réponse sans comptabilité fournisseur exploitable est également refusée.

Restauration

Avant de réessayer un remplacement interrompu :

1. Déchargez AITranslation Free.
2. Inspectez le fichier cible, sa copie .aitranslation.bak et tout fichier .aitranslation.rollback.
3. Restaurez manuellement la copie connue comme valide si nécessaire.
4. Supprimez les éléments de restauration seulement après vérification du résultat.
5. Rechargez le plugin et relancez une petite traduction.

Le plugin bloque tout nouveau remplacement tant que des éléments de restauration non résolus sont présents.

Limitations connues

• La qualité des traductions et la disponibilité du fournisseur restent hors du contrôle du plugin.
• L'opérateur doit surveiller l'usage et le coût OpenAI en plus des limites locales.
• Une commande traduit un plugin vers une locale ; la traduction en masse et le chat sont réservés à Pro.
• 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 Free, la version d'Oxide ou Carbon, la forme de la commande, la locale cible et le code d'erreur expurgé. Ne publiez jamais le jeton OpenAI ni le contenu des fichiers de langue.