Installazione

Questa pagina descrive la versione in sviluppo: una parte non è ancora nella v1.3.0. Questa pagina nella v1.3.0 · Cosa arriva

Come installare, aggiornare e rimuovere PlayGuard, e cosa scrive sulla scheda SD. Una volta installato: Per iniziare.

Dove trovarlo

A scelta:

• Homebrew App Store / App Store di sphaira (stesso catalogo) — Cerca PlayGuard e installalo. Le nuove versioni vengono riprese automaticamente, dopo una verifica: spesso qualche giorno dopo GitHub. PlayGuard sa di essere stato installato da lì e consiglia di aggiornarlo tramite lo store.
• Manualmente — Scarica playguard.zip dall'ultima versione ed estrailo nella radice della scheda SD. L'app finisce in sd:/switch/playguard/, i suoi file in sd:/config/playguard/.
• sphaira › GitHub — Lo zip della versione contiene già la voce (/config/sphaira/github/playguard.json): dopo una prima installazione, aggiorna da GitHub in sphaira.

Il sysmodule di ripristino facoltativo si installa da PlayGuard (Console › Moduli facoltativi, o Sicurezza › Bloccato?), o a mano dal suo download (playguard-rescue.zip): estrai anche lui nella radice della scheda SD, poi riavvia la console. Finisce in atmosphere/contents/4200000000505247/ e agisce solo quando un file RESCUE glielo chiede — vedi Console bloccata?.

Poi apri PlayGuard sopra un gioco, con l'utente di un genitore (perché).

Aggiornare

• In PlayGuard: Preferenze › Aggiorna con sceglie come — in PlayGuard stesso (scarica la versione, la verifica, si sostituisce e si riavvia), sphaira, l'Homebrew App Store o manualmente. Con Cerca aggiornamenti ogni giorno attivo, PlayGuard si apre sulla nuova versione quando ce n'è una.
• Il sysmodule di ripristino segue la versione di PlayGuard: dopo ogni aggiornamento, estrai di nuovo il playguard-rescue.zip di quella versione (oppure Aggiorna sulla voce Il sysmodule di ripristino non è aggiornato della campanella, o in Console › Moduli facoltativi), poi riavvia la console.
• L'agente del collegamento remoto, se è installato: all'avvio successivo ne viene proposto l'aggiornamento quando PlayGuard ne contiene uno più recente (Home Assistant, in inglese).
• Impostazioni, cronologia, profili e backup restano: sono in sd:/config/playguard/, non accanto all'app.

Rimuoverlo

Elimina sd:/switch/playguard/ (l'app) e, per rimuovere anche i suoi file, sd:/config/playguard/; con i sysmodule facoltativi, anche sd:/atmosphere/contents/4200000000505247/ (ripristino) e sd:/atmosphere/contents/4200000000504741/ (l'agente), oppure rimuovili prima in Console › Moduli facoltativi. I limiti, il PIN e le limitazioni sono quelli della console: restano sulla console. Per rimuovere anche loro, usa prima Sicurezza › Elimina il filtro famiglia.

File sulla scheda SD

Tutti in sd:/config/playguard/ (l'app stessa resta in sd:/switch/playguard/: rimuoverla o reinstallarla li conserva). Le versioni che li tenevano accanto all'app li hanno spostati lì al primo avvio.

• config.json — Preferenze (lingua, tema, server NTP, Proteggi PlayGuard con il PIN…); ogni chiave in config.md (in inglese). Se non si può leggere, viene conservato come config.json.bad (il precedente come .bad.1) e le impostazioni ripartono dai valori predefiniti; PlayGuard lo segnala una volta all'avvio
• profiles/ — I profili di limiti del tempo di gioco salvati
• exports/ — Le esportazioni dell'attività
• nand/<system>/ — Ciò che appartiene a un sistema, ognuno con il proprio filtro famiglia: sysmmc/ per il sysMMC, emummc/ per l'emuMMC. Dentro: history.json la cronologia delle modifiche (le 500 più recenti, comprese quelle rifiutate dalla console; se non si può leggere, viene conservata come history.json.bad, la precedente come .bad.1, invece di essere sovrascritta, e PlayGuard lo segnala una volta); state.json ciò che Blocca tutti i giochi, il tempo extra, un nuovo blocco in sospeso e la scelta del firmware devono ricordare (config.md, in inglese); forwarders.json i forwarder creati da PlayGuard; watch.json ciò che PlayGuard ha visto per ultimo della console, per segnalare cosa è cambiato fuori da lui (config.md, in inglese; eliminarlo non fa danni); backups/ i backup delle impostazioni (mai il PIN); cache/ l'ultima attività di gioco letta (tutti gli utenti, e ogni utente consultato), mostrata subito all'avvio successivo mentre il registro viene riletto. I file di una versione precedente a queste cartelle vanno al primo sistema su cui PlayGuard si avvia
• cache/ — Le icone dei giochi (icons/, 16 MB al massimo, svuotata quando cambia la lingua della console), comuni a tutti i sistemi, per non rileggere nome e icona di ogni gioco a ogni avvio; le note di rilascio di Atmosphère, hekate, sys-patch e del firmware (sys_notes.json, per Console) e quelle di PlayGuard (per Informazioni); in modalità sviluppatore, l'elenco di Installa un'altra build (dev_builds.json)
• github_token — L'accesso a GitHub di Invia un rapporto… e, in modalità sviluppatore, di Installa un'altra build; eliminato uscendo dall'account (Informazioni › Aiuto e diagnostica › Account GitHub, mostrato una volta effettuato l'accesso)
• gate.nro, gate-<hash>.nro, gate_*.txt — Il cancello dei forwarder protetti (Console › Forwarder): il suo programma, i suoi orari liberi, gli orari in cui non si apre mai e la pausa dopo i rifiuti, i suoi tentativi finché PlayGuard non li legge, e quanto dura la sua schermata di apertura (gate_wait.txt, letto a ogni avvio)
• previous_build.json, boot_check.json — Dopo l'installazione di una build al posto di quella attuale: il nome della build sostituita (conservata accanto al .nro come playguard.nro.previous), e il controllo dell'avvio successivo (eliminato appena compare la sua prima schermata)
• rescue_report.txt — Lasciato dal sysmodule di ripristino dopo il suo intervento, finché PlayGuard non lo mostra all'avvio (se non si può leggere viene rimosso, e PlayGuard lo segnala)
• rescue_nonce — Una sfida casuale a cui il sysmodule di ripristino risponde nel suo rapporto, perché PlayGuard distingua un rapporto scritto da lui da uno scritto a mano (sysmodule/rescue/README.md, in inglese); uno nuovo a ogni avvio
• sync.conf — Solo una volta configurato l'Accesso remoto: le impostazioni del collegamento, password del broker compresa (mai in un rapporto né in un invio)
• sync/ — Solo con l'Accesso remoto: i profili salvati, per l'agente facoltativo (profiles.txt); ciò che legge e scrive per un sistema è nel nand/<system>/sync/ di quel sistema (registrazioni, nomi dei giochi, ciò che ha cambiato, i suoi eventi). Un sysMMC e un emuMMC condividono sync.conf ma sono due dispositivi in Home Assistant
• logs/ — reports/ i rapporti di diagnostica salvati (mai il PIN né il numero di serie); crashes/ un file per crash (ciò che ha fermato PlayGuard); uploads/ un collegamento Internet (.url) per ogni rapporto inviato online; play_timer/ i file del tempo di gioco degli strumenti per sviluppatori. Quanti rapporti, file di crash e link vengono conservati: Informazioni › Aiuto e diagnostica (per numero, età o dimensione; il più recente resta sempre)

Maggiori dettagli in packaging/README.md (in inglese).

Vedi su GitHub