L’emulatore Citron, uno dei progetti open-source più attivi nel campo dell’emulazione della console Nintendo Switch, prosegue la sua rapida evoluzione con il rilascio della versione 0.10.0.

Insieme a Eden e Ryubing, questo emulatore raccoglie l’eredità tecnica dei predecessori e prosegue lo sviluppo nel segno della collaborazione e della trasparenza tra team, valori ormai centrali nella scena emulativa.

Il nuovo aggiornamento di Citron introduce numerosi miglioramenti tecnici e funzionali, con un’attenzione particolare alle prestazioni su dispositivi mobili, alla stabilità di rete e alla compatibilità dei giochi e delle mod.

Tra le novità più importanti spiccano il supporto completo al servizio Account, le funzionalità LDN per il multiplayer locale, e il miglioramento della compatibilità con i firmware più recenti.

Le connessioni online risultano ora più stabili e affidabili, rendendo possibile un’esperienza di gioco più vicina a quella originale su console Switch.

Un’altra grande novità riguarda l’integrazione della celebre mod CTGP-DX di Mario Kart 8 Deluxe, ora perfettamente funzionante grazie al lavoro congiunto degli sviluppatori JPikachu e Maufeat del progetto Eden, e di TSRBerry proveniente dal team Ryujinx.

Questa collaborazione incarna lo spirito di condivisione che Citron promuove attivamente, valorizzando il contributo di tutti i developer coinvolti.

Sul fronte tecnico, Citron implementa un sistema di aggiornamento completamente rinnovato per Windows, con download sicuri tramite TLS, applicazione differita degli update e log avanzati per la diagnostica.

L’interfaccia grafica è stata anch’essa modernizzata con un nuovo sistema di temi, capace di adattarsi automaticamente alla modalità chiara o scura del sistema operativo. Gli utenti possono anche personalizzare l’aspetto dell’emulatore e godere di un’esperienza più coerente su tutte le piattaforme.

Sono stati inoltre risolti numerosi bug critici, tra cui crash legati alla gestione della memoria, problemi di salvataggio delle scorciatoie da tastiera e malfunzionamenti nella finestra delle proprietà.

Miglioramenti significativi sono arrivati anche per Android, dove ora lo storage funziona in modo stabile e compatibile con una gamma più ampia di GPU.

La struttura del codice è stata ottimizzata con una nuova architettura modulare, una gestione più efficiente dei binari esterni e un sistema di compilazione CMake aggiornato.

Implementazioni principali

• Revisione completa del pipeline di rendering Vulkan.
• Gestione avanzata delle tabelle ZBC con integrazione nella memoria GPU.
• Sistema migliorato di rilevamento e recupero crash del Nintendo SDK.
• Ottimizzazione delle prestazioni della coda di aggiornamento dei descrittori.
• Timeout adattivo e disattivazione automatica per la modalità turbo Vulkan.
• Implementazione delle funzioni e degli handle di evento kernel mancanti.
• Implementazione dell’istruzione ISBERD nel ricompilatore di shader.
• Servizio QueryPointerBufferSize con calcolo corretto del buffer IPC.
• Miglioramenti alla stabilità di rete per il multiplayer HDR.
• Correzioni di compilazione multipiattaforma (Linux/Android/Windows).
• Integrazione del sistema di autenticazione per il beta testing.

Note importanti

• STATO IMPLEMENTAZIONE FSR2: L’implementazione di FSR2 (FidelityFX Super Resolution 2) è attualmente SPERIMENTALE e incompleta. Gli utenti devono aspettarsi:
  • Artefatti visivi e glitch di rendering
  • Miglioramenti al frame rate incoerenti
  • Potenziali crash o instabilità
  • Problemi di gestione della memoria
  • Problemi di compatibilità con alcuni giochi

Questa funzione è fornita “così com’è” solo a scopo di test. Usatela a vostro rischio.

Bug attesi

Dato che si tratta di una riscrittura completa, gli utenti dovrebbero prevedere:

• Regressioni nella compatibilità dei giochi.
• Incoerenze nelle prestazioni.
• Problemi di interfaccia utente ed esperienza d’uso.
• Bug specifici per piattaforma.
• Perdite di memoria in determinati scenari.
• Problemi di sincronizzazione audio.

Raccomandazioni per i test

• Testare con una varietà di giochi appartenenti a generi diversi.
• Monitorare l’utilizzo della memoria durante le sessioni di gioco prolungate.
• Segnalare eventuali crash o problemi di prestazioni significativi.
• Disattivare FSR2 per un gameplay più stabile.

Changelog

Questa release si concentra su miglioramenti per dispositivi mobili, affinamenti degli input e correzioni critiche, estendendo compatibilità giochi e stabilità delle piattaforme.

Ringraziamenti & Crediti

Collaborazione cross-emulator:

• TSRBerry (sviluppatore Ryujinx): Implementazione iniziale per il supporto alle mod dipendenti da Skyline.
• JPikachu (sviluppatore Eden): Implementazione compatibilità CTGP-DX — supporto al mip level clamping.
• Maufeat (sviluppatore Eden): Supporto CTGP-DX.

Test & Quality Assurance:

• Community Discord di Citron: testing, feedback e supporto continui.
• Team di Citron e tutti i contributori.

Nota sull’attribuzione: continuiamo a impegnarci per sviluppo trasparente e attribuzione corretta; questa release include contributi adattati dal progetto Eden, debitamente accreditati.

Caratteristiche principali

Rete & Servizi Multiplayer

Funzionalità online potenziate (basate sulla documentazione ufficiale SwitchBrew):

• Implementazione completa del servizio Account — gestione corretta degli account utente.
• Servizi LDN (Local Network) — supporto multiplayer locale per giochi compatibili.
• Stub per firmware più recenti — maggiore compatibilità con giochi moderni.
• Stabilità di rete migliorata — connessioni online più affidabili.

Aggiornamento automatico Windows (Overhaul)

Sistema di aggiornamento completamente ridisegnato per Windows:

• Risolti problemi di file locking — gli aggiornamenti non falliscono più per file bloccati.
• Helper per aggiornamenti differiti — le patch vengono applicate dopo la chiusura di Citron.
• Supporto TLS — download aggiornamenti sicuri.
• Logging avanzato — diagnostica migliorata.
• Integrazione plugin Qt6 TLS — supporto HTTPS corretto.

Miglioramenti maggiori

Compatibilità giochi

Supporto CTGP-DX (grazie a JPikachu/Maufeat di Eden e TSRBerry di Ryujinx):

• La mod CTGP-DX ora funziona — aggiunto supporto al mip level clamping.
• Il popolare pacchetto di piste custom per Mario Kart 8 DX è pienamente giocabile.
• Gestione corretta delle texture per contenuti moddati.

Compatibilità Skyline:

• Supporto a offset di codice a 32-bit — abilita homebrew e mod compatibili con Skyline.
• Migliore integrazione con l’ecosistema homebrew della community.

Interfaccia utente

Rifacimento del sistema di temi:

• Integrazione tema di sistema — rispetto automatico modalità chiara/scura di Windows/Linux.
• Scelta tema in-app — possibilità di sovrascrivere il tema di sistema.
• Dialog di configurazione tematizzati — tutte le finestre si adattano al tema scelto.
• Correzioni della finestra Proprietà — problemi di visualizzazione risolti in tutte le modalità.

Input & Controlli

Migliorie al sistema di hotkey:

• Persistenza delle hotkey corretta — le configurazioni vengono salvate.
• Hotkey dedicata per attivare/disattivare l’overlay controller.
• Risolti memory leak che causavano crash legati alle hotkey.

Correzioni di bug

Fix critici

• Crash std::bad_alloc: Corretto l’errore di allocazione memoria che causava crash con l’overlay controller.
• File locking dell’updater Windows: Aggiornamenti non più fallibili per file bloccati.
• Bug salvataggio hotkey: Impostazioni persistenti tra le sessioni.
• Rendering finestra Proprietà: Corrette le anomalie di visualizzazione in vari temi.

Fix specifici per piattaforma

Windows:

• Locking updater completamente risolto.
• Plugin Qt6 TLS integrato correttamente per download sicuri.

Android:

• Configurazione e migrazione dello storage funzionanti.
• Migliore supporto per GPU diverse.

Fix della UI

• I dialog di configurazione rispettano tema di sistema e tema in-app.
• La finestra Proprietà ora mostra correttamente i contenuti in tutte le modalità.
• Maggiore coerenza dei dialog tra le piattaforme.

Fix del sistema di build

• Risolti problemi FFmpeg — compilazione corretta su tutte le piattaforme.
• Correzioni a title_ids.h — errori di compilazione risolti.
• Migliorie CMake — gestione esterni più robusta.
• DownloadExternals — selezione branch per ABI Android.

Dettagli tecnici

Modifiche architetturali

Organizzazione del codice:

• Classe utility TitleID — gestione dei title ID rifattorizzata.
• Refactor di main.cpp — migliore manutenibilità.
• Base di codice più pulita e separazione delle responsabilità.

Migliorie al sistema di build:

• Binari esterni come submodule — controllo versione migliorato (approccio testato e valutato).
• Copia del plugin Qt6 TLS aggiunta a CopyCitronQt6Deps.
• Download specifici per piattaforma — selezione binari in base ad ABI Android.
• Modernizzazione CMake.

Nuovi file aggiunti (esempi)

• src/citron/updater/
  • updater_service.cpp migliorato con aggiornamenti differiti.
  • Gestione errori e logging migliorati.
• Implementazione configurazione storage Android.
• File di sistema per l’overlay controller.
• Logica di adattamento temi.
• Fix per persistenza hotkey.

Problemi noti

• L’overlay controller è ottimizzato ma potrebbe necessitare ulteriori rifiniture per casi limite.
• Alcuni dispositivi Android con driver GPU molto vecchi potrebbero ancora avere problemi di compatibilità.
• L’auto-updater su Linux/macOS rimane basico (miglioramento significativo su Windows).

Compatibilità giochi – punti salienti

• Ora giocabile: CTGP-DX — il pacchetto di piste custom per Mario Kart 8 DX è pienamente funzionale.
• Compatibilità migliorata per homebrew compatibili con Skyline.
• Migliore supporto per giochi che richiedono servizi di rete/firmware più recenti.
• Supporto a titoli che usano offset di codice a 32-bit.

Note della community

• Questa release dimostra collaborazione cross-emulator; si riconosce apertamente il lavoro di JPikachu (Eden) che ha reso possibile CTGP-DX basandosi sul lavoro di TSRBerry (Ryujinx).
• Citron rimane impegnata in: Attribuzione corretta, collaborazione comunitaria, pratiche di sviluppo professionali, stabilità e accuratezza.

Statistiche

• Commit: 70+ dalla v0.9.0
• File modificati/aggiunti: 100+
• Bugfix: 20+ (critici e minori),
• Nuove feature utente: 4 principali,
• Supporto piattaforme: Desktop (Windows/Linux/macOS) e Android,
• Crediti cross-project: 1 (Eden – JPikachu),

Download: Citron v0.10.0 (Linux/Windows/Android)

Fonte: git.citron-emu.org