Un'applicazione web completa, leggera e self-hosted per gestire la tua collezione di carte di Yu-Gi-Oh!, costruire mazzi competitivi e testare le tue strategie.
Sviluppata per funzionare 24/7 su pc o server locali (come Raspberry Pi) tramite Docker, l'app offre un ambiente completamente autonomo con dati sempre aggiornati grazie all'integrazione con l'API ufficiale di YGOPRODeck.
- 📸 Anteprima dell'Applicazione
- ✨ Caratteristiche Principali
- 🚀 Come Installare e Avviare l'App
- 📂 Come usare le Banlist Personalizzate (.conf)
- 📡 Dati e Riconoscimenti
- 📦 Gestione Collezione e Wishlist: Tieni traccia delle carte che possiedi fisicamente e di quelle che stai cercando. Nel Deck Builder, le carte che hai inserito ma che ti mancano fisicamente verranno mostrate "ingrigite", permettendoti di capire a colpo d'occhio cosa ti manca per completare il mazzo.
- 🔄 Sincronizzazione in Tempo Reale: Scarica l'intero database mondiale delle carte (con nomi, effetti, attributi e immagini) con un solo click. Include il supporto per le carte in lingua italiana (se disponibili) e usa l'inglese come ripiego automatico per le ultimissime uscite.
- 🛠️ Deck Builder Avanzato: Costruisci i tuoi mazzi rispettando le regole ufficiali (limiti di 60 carte per il Main Deck, 15 per Extra e Side). Supporta il Drag & Drop e l'ordinamento automatico intelligente per tipologia di carta.
- 📜 Formati e Banlist Storiche (Dynamic Engine):
- Supporto nativo per i formati TCG Avanzato e OCG.
- Motore storico integrato per Goat Format (2005) ed Edison Format (2010): l'app calcola automaticamente la data di uscita originale della carta, bloccando in automatico le meccaniche o le carte uscite nel "futuro" senza bisogno di liste pre-compilate.
- ⚙️ Banlist Personalizzate (File .conf): Carica file
.lflist.conf(gli stessi usati da simulatori come EDOPro o Dueling Nexus) direttamente nell'app o spostandoli nella cartella del server. L'app li riconoscerà automaticamente per applicare tornei con regole custom! - 📤 Import/Export YDK: Compatibilità totale con i simulatori online. Esporta i tuoi mazzi in formato
.ydkper giocarli su EDOPro/YGO Omega, o importa file YDK per analizzarli all'interno dell'app. - 🃏 Test della Mano Iniziale (Test Draw): Simula pescate iniziali di 5 carte e testa la consistenza del mazzo in tempo reale, senza bisogno di tavoli fisici o simulatori esterni.
Puoi far girare l'applicazione in tre modi diversi, a seconda delle tue esigenze. Ricorda appena avvii l'applicazione di andare nella sezione Cerca Nuove Carte e clicca su Sincronizza DB, altrimenti le carte non saranno cercabili !!!
Se non vuoi installare né Python né Docker, puoi usare i file eseguibili precompilati, perfetti per l'uso personale su PC.
- Scarica il file eseguibile per il tuo sistema operativo QUI (es. il file
.exeper Windows o il file binario PE per Linux). - Mettilo in una cartella apposita cosi quando verrà avviato si genereranno i file per il database e la cartella delle banlist.
- Fai doppio clic sul file per avviarlo.
- Il browser predefinito si aprirà automaticamente sull'applicazione!
- 🛑 Come spegnerlo: Quando hai finito di usare l'app, ti basterà chiudere la finestra del browser e questo spegnerà in modo sicuro e definitivo il processo in background sul tuo computer.
Ideale per chi vuole testare l'app al volo sul proprio computer.
- Assicurati di avere Python 3 installato sul tuo sistema.
- Clona o scarica questa repository sul tuo computer.
- Apri il terminale nella cartella del progetto e installa i requisiti:
pip install -r requirements.txt
- Avvia l'applicazione:
che avvierà in automatico il browser all'indirizzo:
python3 app.py
http://localhost:5000 - 🛑 Come spegnerlo: Torna nella finestra del terminale in cui l'applicazione sta girando e premi la combinazione di tasti CTRL+C sulla tastiera per arrestare il server.
Se vuoi installare l'app su un Raspberry Pi, un server Linux o un NAS per renderla disponibile sulla tua rete Wi-Fi di casa ininterrottamente, usa Docker Compose. Il file docker-compose.yml è già configurato per salvare permanentemente i tuoi progressi.
-
Assicurati di avere Docker e Docker Compose installati.
-
Apri il terminale nella cartella del progetto ed esegui:
docker compose up -d --build
-
Finito! L'app è ora in esecuzione in background. Puoi chiudere il terminale.
-
Per accedere, apri il browser e digita l'indirizzo IP del tuo server (es.
http://192.168.1.xxx:5000) oppure direttamente sul tuo pc (http://127.0.0.1:5000) -
🛑 Come spegnerlo: Se per qualsiasi motivo desideri spegnere il server e fermare l'applicazione, apri il terminale nella cartella del progetto ed esegui il comando:
docker compose down
Oppure da qualsiasi cartella
docker compose down yugioh-personalcollection
(Nota: Grazie al Docker Compose, se il server si riavvia per un calo di corrente, l'app si riaccenderà da sola automaticamente. I tuoi mazzi e le tue carte sono al sicuro nel file database generato in automatico e montato come volume).
Vuoi giocare un formato specifico con i tuoi amici o creare una tua banlist personale? Nessun problema:
- Crea o scarica un file banlist standard (es.
BanlistTorneo.conf) da un qualsiasi sito (es. YGOProg Banlist Builder). - Puoi inserirlo nella tua app in due modi:
- Dall'interfaccia: Nel Deck Builder, apri la tendina delle Banlist e clicca su "➕ Carica nuovo .conf...".
- Direttamente dal server: Trascina il file all'interno della cartella
banlist/del progetto. L'applicazione lo rileverà istantaneamente.
- L'app bloccherà o limiterà le carte esattamente come indicato nel tuo file, in modo da poter creare i deck con le tue carte direttamente con quella banlist! Puoi eliminare le banlist personalizzate non più necessarie cliccando sull'icona del cestino 🗑️ a fianco del menu.
L'applicazione non contiene carte pre-caricate per mantenere il software leggerissimo. Al primo avvio, ti basterà recarti nella sezione "Cerca Nuove Carte" e cliccare su "Sincronizza DB" per scaricare i dati più recenti in tempo reale e poter cercare le carte molto piu velocemente.
I dati delle carte, le immagini e le legalità dei tornei ufficiali sono forniti generosamente dalle API pubbliche di YGOPRODeck.