📖 Manuale utente interattivo · v1.14.0

Hai installato GameStringer.
E adesso?

Questa guida ti accompagna dal primo avvio al primo gioco tradotto, passo per passo — la stessa strada che farai dentro l'app, spiegata prima. Dieci capitoli, cinque minuti di lettura, zero termini oscuri.

// Traduzione più intelligente

Traduzioni più intelligenti, che si correggono da sole

Contesto visivo, una revisione automatica della traduzione e una memoria che ragiona per significato. Tutto opzionale, e possibile anche in locale con Ollama.

👁️ Contesto visivo (VLM)

Traduzione con contesto visivo (VLM): l'AI vede lo schermo e traduce col contesto, risolvendo le parole ambigue (es. "Chest" = forziere o petto). Locale (Ollama) o OpenAI/Gemini

🪞 Traduzioni auto-correttive

Passaggio auto-correttivo (Reflection): una seconda passata opzionale rivede e rifinisce la traduzione su glossario, tono e coerenza — solo dove serve

🧠 Memoria semantica (RAG)

Memoria semantica (RAG): Translation Memory e glossario abbinati per significato tramite embedding locali, per una terminologia coerente in tutto il gioco

⚡ Live più fluida

Traduzione live più fluida ed elaborazione nativa degli screenshot (ritaglio/ridimensionamento prima della chiamata AI)

🔌 Più provider pronti all'uso

Più provider pronti all'uso: DeepL, Groq, Cerebras, Cohere, Together, Fireworks, Hugging Face, Azure Translator, DashScope, LibreTranslate, Lingva, MyMemory

// 01 · Primo avvio

I primi 5 minuti

Al primo avvio GameStringer ti chiede tre cose, in quest'ordine. Nessuna è complicata, e nessuna tocca i tuoi giochi.

Crea il tuo profilo

Scegli un nome e una password. Il profilo tiene insieme le tue impostazioni, i progetti e la Translation Memory. Puoi crearne più d'uno (per esempio uno per persona, o uno per lingua di lavoro).

💡 Salva la recovery key di 12 parole: è l'unico modo per recuperare la password.

Segui il tutorial di benvenuto

Un breve wizard ti mostra le aree principali dell'app e include il passo "Come si traduce un gioco". Puoi saltarlo e riaprirlo quando vuoi dalla pagina Guida dentro l'app.

Lascia che la libreria si riempia da sola

GameStringer rileva automaticamente i giochi installati da Steam, Epic, GOG, EA, Ubisoft, Amazon, itch.io, Humble, Game Jolt e Big Fish. In pochi secondi vedrai le copertine nella pagina Libreria.

💡 Un gioco non compare? Puoi aggiungerlo a mano scegliendo la sua cartella dal disco.
// 02 · L'interfaccia

La mappa dell'app in 60 secondi

La sidebar è divisa in quattro aree colorate — gli stessi colori che vedi in tutta l'app e su questo sito. Clicca una voce per scoprire a cosa serve.

Core

Benvenuto nella mappa

Questa è una replica della sidebar reale di GameStringer. Seleziona una voce a sinistra: qui appare cosa fa e quando ti serve.

// 03 · Configura l'AI

Scegli chi traduce: locale o cloud

Prima della prima traduzione serve almeno un "cervello". Le strade sono due, e puoi cambiare idea in qualsiasi momento.

100% locale · gratis

Ollama sul tuo PC

Apri Ollama / AI nella sidebar: il wizard installa Ollama e scarica un modello. Consigliato per iniziare: TranslateGemma (55 lingue, gratis, i testi non lasciano mai il tuo computer). Con poca RAM: HY-MT (~1 GB).

Cloud · API key

Provider cloud

Vai in Impostazioni → chiavi API e incolla la chiave del provider scelto. Gemini ha un piano gratuito ed è il punto di partenza consigliato; DeepSeek è economico; Claude e GPT-4o danno la qualità più alta.

Non vuoi scegliere?

Lascia fare all'Auto-Select

Il preset "Auto" sceglie da solo la catena di provider migliore per la lingua di destinazione e il genere del gioco, con fallback automatico se un provider fallisce. È la scelta giusta finché non hai preferenze.

Le chiavi API vengono salvate cifrate sul tuo disco e non passano da nessun server di GameStringer.

// 04 · La prima traduzione

Prova il flusso, prima di farlo davvero

Questo è esattamente quello che succede nell'app quando traduci un gioco. Avanza passo per passo (o premi Play): quando lo farai davvero, sarà déjà-vu.

La demo: il flusso in 15 secondi

Passa il mouse sulla scena per mettere in pausa
Mystery RPG こんにちは! スタート 設定 Ciao! Avvia Opzioni GameStringer 🎮 Mystery RPG RPG Maker MV · Steam 34 P.T. · /100 DRM ✕ · UTF-8 ✓ ⚡ String it! 📤 3/3 🤖 TranslateGemma · TM · 0–100 🛡 Backup ✓ → 🩹 100% こんにちは! 92 スタート 95 設定 98
1/7
0%

// 05 · Capire il P.T.

P.T.: l'analisi che ti evita brutte sorprese

Il Prediction Tool esamina il gioco prima di toccarlo e risponde alle domande giuste: quanto testo c'è, quanto ci vorrà, ci sono DRM o anti-cheat, quale modello AI conviene. Il risultato principale è un punteggio di difficoltà da 0 a 100.

0–30
Facile

Testo in file standard, poco volume, nessun DRM. Parti da qui per il tuo primo esperimento: risultato in minuti.

30–70
Impegnativo

Molte stringhe, encoding particolari o formati compressi. Fattibile, ma pianifica: il P.T. stima i tempi per 18 modelli AI.

70–100
Difficile

DRM pesante, anti-cheat o centinaia di migliaia di stringhe. Il P.T. ti avvisa prima che tu perda tempo: mettilo in fondo alla coda.

Dry Run

Scansiona tutta la libreria in una volta

Dalla Libreria, il Dry Run analizza in batch anche 800+ giochi senza modificare nulla, e classifica ognuno come Pronto, Con errori o Non supportato.

P.T.Rank

Ordina i giochi per difficoltà

Dopo qualche analisi, P.T.Rank mette in classifica i titoli analizzati: inizia dalle vittorie facili, lascia gli RPG da 800k stringhe per dopo.

Smart Gate

String it! è protetto

Se premi String it! senza un'analisi recente (24h), l'app ti propone di eseguire prima il P.T. — con la scelta esplicita di procedere comunque.

// 06 · Il tuo gioco

Che strada farà il tuo gioco?

GameStringer sceglie da solo tra tre strade tecniche. Non devi saperlo in anticipo — ma se sei curioso, rispondi a una domanda:

Che tipo di gioco vuoi tradurre?

🗂️ Strada 1 — Patch sui file

GameStringer estrae il testo dai file nativi (.locres, .pck, StringTable, BSA/BA2, CPK…), lo traduce e lo riscrive al loro posto, con backup automatico. Caso speciale: se un gioco Unity non ha file estraibili, l'app propone la Strada 2 con un clic (installa BepInEx + XUnity, avvia il gioco una volta, ri-scansiona).

🗂️ Strada 1 per MV/MZ e Ren'Py · 👁️ Strada 3 per i classici

Ren'Py e RPG Maker MV/MZ hanno pipeline dedicate su file (non invasiva per Ren'Py, con backup per MV/MZ). Per RPG Maker 2000/2003 il testo non è estraibile in modo affidabile: l'app te lo dice onestamente e ti propone l'overlay OCR che traduce a schermo mentre giochi.

👁️ Strada 3 — OCR a schermo

Nessun file viene toccato: GameStringer cattura lo schermo, legge il testo con l'OCR (con preset 8-bit, 16-bit e DOS) e mostra la traduzione in un overlay in tempo reale. Scorciatoia: Ctrl+Alt+O.

L'elenco completo dei 20+ engine supportati, con il livello di copertura di ciascuno, è nella sezione Engine della home.

// 07 · Patch Hub

Prima di tradurre, guarda se qualcuno l'ha già fatto

Le traduzioni della community diventano pacchetti .gspack pubblicati nel Patch Hub. Scaricare un pack pronto è sempre più veloce che tradurre da zero.

1 · Cerca

Sfoglia il Patch Hub

Dal Community Hub apri il Patch Hub e filtra per gioco, lingua, valutazione e completamento. Se il tuo gioco c'è già nella tua lingua, hai finito prima di iniziare.

2 · Applica

Scarica e applica

Il pack finisce nella tua libreria locale; da lì lo applichi al gioco con il patcher giusto — sempre con backup automatico prima di scrivere.

3 · Restituisci

Pubblica la tua

Quando una tua traduzione funziona, pubblicala dalla pagina Progetti con un passo solo. Il tuo nome resta sul pack: reputazione e badge da "verified translator".

Nel Community Hub trovi anche la chat in tempo reale, il forum e le notizie sulle traduzioni amatoriali.

// 08 · Sicurezza

Cosa protegge i tuoi giochi (e i tuoi account)

Sempre attivo

Backup prima di ogni patch

Prima di scrivere qualsiasi file, GameStringer salva una copia originale. Ripristinare = un clic. Il Dry Run e il P.T. non toccano proprio nulla.

Automatico

Update tracker

Se Steam aggiorna un gioco tradotto, l'app se ne accorge (via buildid), verifica l'integrità della patch e ti avvisa se va ri-applicata.

Regola d'oro

Gate anti-cheat

L'injection a runtime può far scattare EAC, BattlEye e simili. Un blocco rigido dentro l'app la impedisce sui giochi online: usa GameStringer solo su giochi single-player/offline. Il P.T. rileva DRM e anti-cheat in anticipo.

// 09 · Problemi?

Qualcosa è andato storto — quasi sempre si sistema così

Il mio gioco non compare in libreria

Controlla che lo store sia collegato nella pagina Stores, poi forza un aggiornamento della libreria. Se il gioco non viene da uno store (o resta invisibile), aggiungilo manualmente: Libreria → Aggiungi gioco → scegli la cartella dal disco.

La scansione non trova testo da tradurre

Se è un gioco Unity è normale: il testo è dentro gli asset compilati. L'app te lo dirà e proporrà di installare BepInEx + XUnity.AutoTranslator con un clic — poi avvia il gioco una volta, chiudilo e ri-scansiona. Per i giochi molto vecchi (RPG Maker 2000/2003, retro) la strada giusta è l'overlay OCR.

Il P.T. segnala DRM o anti-cheat

Fidati dell'avviso. Con anti-cheat attivo (EAC, BattlEye, Vanguard) l'injection è bloccata dal gate interno: non forzarla. Con DRM pesante (Denuvo) l'estrazione può essere impossibile: metti il gioco in fondo alla coda e scegli un titolo più semplice.

Ollama risulta "non installato" o offline

Apri Ollama / AI nella sidebar e usa il wizard di setup: verifica che il servizio sia in esecuzione e che almeno un modello sia scaricato. Il pannello mostra lo stato in tempo reale; da lì puoi anche riavviare il servizio.

Nel gioco vedo caratteri strani o quadratini

È un problema di font o di encoding, non di traduzione: il font originale non contiene i caratteri della tua lingua (tipico con cirillico, greco e CJK). Per i giochi Unity, XUnity può sostituire il font; per gli altri engine controlla le opzioni del patcher o segnala il titolo nelle Discussions.

Steam ha aggiornato il gioco e la traduzione è sparita

È il caso per cui esiste l'update tracker: ti avvisa quando una patch va ri-applicata. Apri il gioco in GameStringer e ri-applica la patch: la Translation Memory ricorda tutto, quindi non si ri-traduce nulla — si riscrive e basta.

La traduzione è brutta o incoerente

Tre leve, in ordine: 1) cambia provider o usa Multi-LLM Compare per confrontare i risultati riga per riga; 2) aggiungi i nomi propri al glossario così restano coerenti; 3) correggi le righe peggiori nell'Editor — le correzioni entrano nella Translation Memory e migliorano tutto il resto del progetto.

// 10 · Dizionario

Le parole che incontrerai nell'app

String it!

Il pulsante che fa tutto: scansiona, estrae, traduce e applica la patch in un flusso solo. Lo trovi nella pagina di ogni gioco.

P.T.

Prediction Tool: l'analisi preventiva del gioco. Difficoltà 0–100, DRM, encoding, tempi stimati e catena di modelli consigliata.

Dry Run

Scansione in batch dell'intera libreria senza modificare alcun file. Classifica i giochi come Pronto / Con errori / Non supportato.

Translation Memory (TM)

Il database locale che ricorda ogni frase tradotta e corretta: la stessa frase non si traduce mai due volte.

Glossario

L'elenco dei termini fissi (nomi di personaggi, luoghi, oggetti) che l'AI deve rispettare per mantenere la coerenza.

Punteggio qualità

Voto automatico 0–100 assegnato a ogni riga tradotta. La heatmap colora il progetto per farti vedere dove serve una revisione.

BepInEx + XUnity

La coppia di strumenti che GameStringer installa (con il tuo ok) nei giochi Unity senza file estraibili: intercettano il testo a runtime.

.gspack

Il formato dei pacchetti di traduzione condivisi nel Patch Hub: contiene le stringhe tradotte e i metadati per applicarle.

Backup

La copia dei file originali creata automaticamente prima di ogni patch. Ripristino con un clic.

Patch Hub

Il "workshop" della community: pubblichi le tue traduzioni come .gspack e scarichi quelle degli altri.

Overlay OCR

La finestra trasparente che legge lo schermo e mostra la traduzione in tempo reale, per i giochi il cui testo non è estraibile.

Profilo

Il tuo spazio personale nell'app: impostazioni, progetti, TM e chiavi API. Protetto da password + recovery key di 12 parole.

Scorciatoie da tastiera

OCR a schermoCtrl+Shift+T
Traduzione rapidaCtrl+Shift+Q
Overlay liveCtrl+Alt+O
XUnity on/off (in gioco)Alt+T
Command paletteCtrl+K