Pubblicato · Kevin BK
Joi Database: che cos’è e cosa fa davvero l’editor
Perché il nome Joi Database trae in inganno
La grafia usata dal progetto è joi, non “Joy Database”. Compare nel repository, nei package Java, nei file di aiuto e nei nomi esportati. Una ricerca poco precisa incontra anche Joi, la libreria di validazione JavaScript, e molti prodotti non collegati chiamati Joy.
L’identità più affidabile viene dal repository di The joi Database Editor. La descrizione parla di un editor per creare “joi” per The joi Database; gli argomenti GitHub lo classificano come editor JavaFX e strumento di modifica per un gioco.
Queste prove non coincidono con pagine che presentano una piattaforma aziendale multimodello dotata di analisi in tempo reale, machine learning ed elaborazione di milioni di eventi. Nel codice non ci sono server di archiviazione, linguaggi di query, protocolli di rete o test ufficiali. Attribuire tali funzioni a questo editor sarebbe privo di base primaria.
Che cosa è confermato e che cosa no
| Aspetto | Confermato dal progetto | Non dimostrato |
|---|---|---|
| Scopo | Creare contenuti interattivi per un gioco specifico | Gestire dati aziendali come un DBMS |
| Applicazione | Editor visuale Java/JavaFX basato su nodi | Server SQL o servizio cloud gestito |
| Contenuto | Scene, dialoghi, immagini, tempo, scelte e metadati | Tabelle aziendali, grafi generici o serie temporali |
| Formato | JSON, immagini ed esportazione ZIP | Replica o transazioni distribuite |
| Prove | Codice, aiuto, release e issue | Audit di sicurezza o benchmark di scalabilità |
Salvare strutture in JSON non trasforma automaticamente un programma in un sistema di gestione di database. La guida sulla differenza tra database e directory separa motore di interrogazione, catalogo, struttura di file e interfaccia di modifica. Qui JSON descrive un contenuto che verrà interpretato dal gioco.
Come è organizzato un progetto
La guida introduttiva inclusa nel progetto definisce le scene come contenitori principali. Ogni scena appare come un nodo nell’area di lavoro. I collegamenti costruiscono un percorso lineare o ramificato.
Il modello ricorda un editor di narrativa interattiva, non una console di amministrazione. Aprendo una scena, l’autore aggiunge righe, un’immagine predefinita, operazioni e destinazioni possibili.
- Creare il progetto. Scegliere cartella di lavoro e lingua.
- Aggiungere le scene. Ognuna diventa un nodo visibile.
- Collegare il flusso. I collegamenti definiscono continuazioni e diramazioni.
- Modificare il contenuto. Inserire testo, immagini, timer, scelte e transizioni.
- Completare i metadati. Titolo, identificatore, versione del gioco, lingua e funzioni dichiarate permettono di riconoscere il pacchetto.
- Esportare e verificare. Generare file o ZIP e controllare il risultato nel gioco.
La verifica finale è essenziale. L’aiuto avverte che una scena può apparire diversamente nell’editor e nel gioco. Inoltre, una richiesta aperta propone un pulsante di anteprima: non si può dare per scontata una riproduzione completa già presente.
Testi, immagini e logica della scena
L’aiuto dell’editor di scene documenta operazione normale, timer, opzioni di dialogo e transizioni. Il codice aggiunge variabili, condizioni, calcoli e gruppi.
Testo e immagini
L’operazione normale contiene le righe e il loro stile. Una scena può avere un’immagine predefinita, mentre una singola riga può mostrarne temporaneamente un’altra. La documentazione consiglia immagini alte tra 900 e 1.080 pixel e cita una visualizzazione 1.920 × 1.080 nel gioco.
Timer e righe temporizzate
Un timer assegna una durata alla scena e associa testo o immagini a secondi specifici. Controlla la presentazione del racconto: non è uno scheduler di database e non esegue query periodiche.
Scelte, transizioni e condizioni
Le opzioni di dialogo creano pulsanti e nuovi punti di collegamento. Una transizione può inserire una breve riga tra due scene. Variabili e condizioni modificano il percorso in base allo stato; nodi aritmetici e gruppi ordinano flussi più complessi.
Le note di versione datano le funzioni: variabili e condizioni arrivano con la versione 9, nodi aritmetici e raggruppamento sono evidenziati nella 13, GIF e creatore di icone nella 14. Una richiesta in una issue non equivale a una funzione pubblicata.
File JSON e risorse del pacchetto
Per ogni lingua, il gestore cerca joi_text_<lingua>.json e info_<lingua>.json. Possono aggiungersi joi_icon.png e le immagini utilizzate nelle scene.
Il documento principale raccoglie i componenti in un array chiamato JOI. Comprende scene, modifiche a variabili, condizioni, operazioni aritmetiche, gruppi e ponti. L’esportazione mantiene i file separati o li riunisce in uno ZIP.
Il file informativo identifica il pacchetto e aiuta il gioco a filtrarlo. L’aiuto cita titolo, identificatore univoco, versione del gioco, lingua e caratteristiche dichiarate. La separazione tra contenuto e metadati spiega l’uso di più JSON.
La guida per leggere JSON senza programmare spiega oggetti, elenchi, chiavi e valori annidati. Serve per confrontare due esportazioni senza confondere struttura e contenuto.
Requisiti, versione disponibile e download
La configurazione Maven descrive un progetto Java destinato a Java 8. Usa JSON-java per JSON e include Scenic View come dipendenza di ispezione JavaFX. Il codice è distribuito con licenza MIT.
Nella pagina delle release, la versione 14 del 9 maggio 2021 è l’ultimo pacchetto binario visibile al controllo del 16 luglio 2026. La configurazione sorgente indica versione 15, ma questo non dimostra che sia stato pubblicato un binario 15.
- Scaricare dalla pagina delle release o da una fonte indicata dal manutentore.
- Conservare l’archivio originale e analizzarlo con gli strumenti di sicurezza locali.
- Verificare il runtime Java atteso dal pacchetto.
- Fare una copia di ogni progetto esistente prima di aprirlo con un’altra versione.
- Provare prima su una copia e confrontare JSON e immagini dopo l’esportazione.
- Leggere le issue aperte pertinenti al proprio flusso.
- Non scambiare licenza, stelle o download per un audit di sicurezza.
Questi controlli derivano dai file pubblici e dalla cronologia del progetto. Non rappresentano un’esperienza personale di installazione né garantiscono la compatibilità con ogni sistema moderno.
Stato del progetto e scelta pratica
Il repository è stato creato nel giugno 2019. I pacchetti pubblicati vanno dalla versione 6 del novembre 2019 alla 14 del maggio 2021. Esistono commit successivi, ma l’elenco pubblico non offre un pacchetto più recente.
Ciò non prova che l’editor sia inutilizzabile. Sistema operativo, Java e compatibilità con il gioco vanno però testati. Tra le richieste aperte compaiono più suggerimenti nell’interfaccia, casualità ponderata, spostamento di nodi tra gruppi e indicatore di avanzamento per operazioni lunghe.
L’editor è adatto a chi deve esaminare o produrre pacchetti per The joi Database e accetta uno strumento specialistico datato. Non serve a chi cerca SQL, accesso remoto, archiviazione distribuita, analisi aziendale o un database generalista.
Domande frequenti
Si scrive Joi Database o Joy Database?
Repository, codice e file usano “joi”. “Joy Database” porta a risultati diversi. Il nome più preciso è The joi Database Editor.
È un vero server di database?
No, secondo il progetto primario. È un editor desktop che crea pacchetti JSON per un gioco. SQL, processo server, replica e cloud non sono documentati.
Quali file crea?
Usa coppie come joi_text_it.json e info_it.json, immagini e un’icona opzionale. L’esportazione può racchiuderli in uno ZIP.
Supporta più lingue?
Sì. La configurazione elenca inglese, francese, russo, tedesco, ceco, spagnolo e italiano, con file di testo e metadati per ogni lingua.
Dove si scarica?
La pagina GitHub Releases permette di controllare data e note. L’ultimo binario elencato è la versione 14 del maggio 2021.