Manuale utente

Lusus — la guida completa

Tutto ciò che ti serve per installare, personalizzare e sfruttare al meglio Lusus: il gioco arcade 3D completamente personalizzabile che trasforma i visitatori di WordPress in lead coinvolti. Questo manuale copre ogni funzione, impostazione e shortcode.

Versione 2.0.9WordPress 5.8+PHP 7.4+Licenza: GPL-2.0+128 impostazioni

01 — Introduzione

Lusus è un plugin WordPress premium che inserisce un vero gioco 3D nel browser — uno sparatutto arcade in WebGL basato su Three.js — in qualsiasi pagina o articolo con un solo shortcode. Ma Lusus è più di un gioco: è un motore di engagement e lead generation. I giocatori lasciano nome ed email per salvare un punteggio, scalano una classifica globale e possono sbloccare coupon sconto — trasformando i visitatori passivi in contatti, giocatori abituali e clienti.

Per chi è

  • Agenzie — offri una funzione straordinaria che i clienti non hanno mai visto.
  • E-commerce — premia chi gioca con i coupon e stimola le vendite.
  • Formazione, eventi & portfolio — tieni i visitatori più a lungo sulla pagina e rendila memorabile.

Concetti chiave

  • Shortcode — tre shortcode indipendenti posizionano il gioco, la classifica e il ticker di notizie ovunque.
  • Impostazioni — 128 opzioni controllano aspetto, testi, audio, regole di gioco e funzioni di marketing; una nuova installazione parte dal rifinito Base Style.
  • Style Preset — salva uno stile completo e riusalo su altri siti come file JSON.
  • Lead — ogni punteggio salvato è un contatto, registrato con la data del consenso, che puoi esportare, ricevere via email o inviare ai tuoi strumenti di automazione.

02 — Requisiti & installazione

Requisiti

RequisitoMinimo
WordPress5.8 o superiore (testato fino alla 7.1)
PHP7.4 o superiore
BrowserQualsiasi browser moderno con WebGL — computer, tablet e telefono. Sui rari browser senza grafica 3D, la schermata iniziale spiega cosa fare.

Installare il plugin

  1. Vai in Plugin → Aggiungi nuovo → Carica plugin e scegli il file ZIP di Lusus ricevuto con l’acquisto (oppure carica la cartella lusus in /wp-content/plugins/).
  2. Attiva Lusus dal menu Plugin .
  3. Attiva la licenza (capitolo 3).
  4. Aggiungi [​lusus] a qualsiasi pagina o articolo per mostrare il gioco.
  5. Facoltativo: aggiungi [​lusus_leaderboard] per la classifica pubblica e [​lusus_ticker] per un ticker di notizie autonomo.
Pronto all'uso

In una nuova installazione Lusus applica il preset Base Style — colonna sonora, font, colori e logo già impostati — e attiva la classifica globale. Gli aggiornamenti non sovrascrivono mai le tue personalizzazioni.

Rimuovere Lusus

Eliminando il plugin dalla schermata Plugin si cancellano tutti i suoi dati: la tabella della classifica, le impostazioni e i preset salvati (in un multisito, su ogni sito). Se vuoi conservare la classifica, esportala prima in CSV.

03 — Attivazione & licenza

Lusus è un plugin premium. Licenze, attivazione e aggiornamenti automatici sono gestiti da Freemius, la piattaforma che gestisce anche il tuo acquisto.

Attivare la licenza

  1. Dopo aver attivato il plugin, Lusus mostra la schermata di attivazione di Freemius.
  2. Inserisci la chiave di licenza ricevuta nell'email di conferma d'acquisto.
  3. Fatto: gli aggiornamenti ora compaiono nella bacheca di WordPress.

Piani

  • Annuale — aggiornamenti e supporto finché l’abbonamento è attivo. Se scade, il plugin continua a funzionare; si fermano solo i nuovi aggiornamenti e il supporto.
  • A vita — un solo pagamento, aggiornamenti finché esiste Lusus.

Ogni licenza sblocca il 100% delle funzioni e vale per un sito.

Aggiornamenti

Con una licenza attiva, le nuove versioni compaiono in Bacheca → Aggiornamenti e si installano con un clic, come qualsiasi plugin WordPress. Se usi una cache delle pagine, svuotala dopo l’aggiornamento, così i visitatori ricevono i nuovi file del gioco.

04 — Avvio rapido

Il percorso più veloce per avere un gioco funzionante:

  1. Crea o modifica una pagina.
  2. Inserisci lo shortcode:
[​lusus]
  1. Pubblica e visita la pagina — il gioco è attivo.
  2. Apri Lusus → Impostazioni Gioco per impostare colori e logo (Branding e Colori), oppure scegli uno stile pronto in Style Preset.
  3. Controlla Funzionalità: regole del gioco, classifica, coupon, banner di Game Over, email e webhook.
Suggerimento

Vuoi la classifica su una pagina a parte, o una barra di annunci scorrevole? Usa [​lusus_leaderboard] e [​lusus_ticker] — funzionano entrambi anche senza il gioco (capitolo 7).

05 — Come funziona il gioco

Lusus è uno sparatutto arcade disegnato in tempo reale con Three.js/WebGL, fino a 60 FPS e nitido sugli schermi HiDPI. L’astronave vola lungo una pista al neon: il giocatore la pilota, spara e schiva.

Obiettivo

Distruggi gli asteroidi, raccogli i bonus e resisti il più a lungo possibile. L’HUD mostra le vite rimaste; ogni urto ne costa una. Il gioco accelera man mano che il punteggio cresce: SPEED 2 a 1.000 punti e SPEED 3 a 2.500.

Punti

CosaComePunti
AsteroideSparagli — i grandi si spezzano in due+10 × combo
Cubo bonusSparagli+50
Cubo Triplo LaserSparagli: tre laser per 15 secondi+50
Super Bonus (la tua immagine)Prendilo con l’astronave — ricarica anche i colpi. Se gli spari perdi punti+150 / -50
SfiorataPassa vicinissimo a un ostacolo senza toccarlo+25 × combo
Power-up che non ti serveScudo già attivo, colpi già al massimo+50

Power-up

Solidi al neon luminosi, da raccogliere sparandogli o volandoci contro:

  • Scudo (tetraedro) — assorbe il prossimo urto; nell’HUD si accende l’icona dello scudo.
  • Colpi (barre) — ricaricano una parte dei colpi; più grande è la barra, più colpi.
  • Bomba (ottaedro, circa uno al minuto) — si carica davanti all’astronave con un grande conto alla rovescia 3-2-1, poi un’onda d’urto percorre la pista e distrugge ogni asteroide e cubo in volo, ognuno col suo punteggio normale. Barriere, Super Bonus e gli altri power-up non vengono toccati.

Combo

Gli asteroidi abbattuti uno dopo l’altro formano una catena che ne moltiplica i punti: ×2 da 5 di fila, ×3 da 12, ×4 da 25. La catena si rompe dopo 3 secondi senza distruggere nulla, o quando l’astronave viene colpita. Il contatore e il moltiplicatore compaiono sotto il punteggio. La velocità del gioco segue il punteggio senza il moltiplicatore, così le combo non rendono mai il gioco più difficile.

Ostacoli

  • Barriere al neon — travi luminose indistruttibili: passa nei varchi. Le loro forme diventano più complesse man mano che il punteggio cresce.
  • Colpi limitati — 100 di default, con un contatore nell’HUD; “NO AMMO” vuol dire che è ora di trovare una ricarica.

Scenario ed effetti

Quindici temi wireframe procedurali — portali, tunnel ad anelli, archi, città, canyon e altro — si combinano a caso, così la pista non è mai uguale. Esplosioni a strati con onde d’urto, laser luminosi, punteggi fluttuanti, scossa della camera e vibrazione del telefono fanno sentire ogni colpo. Gli effetti di movimento rispettano l’impostazione “riduci movimento” del visitatore.

Schermate di inizio e di Game Over

Con le Schermate animate attive, il mondo continua a scorrere lento dietro le finestre di inizio e di Game Over, qualche asteroide passa, e le finestre ruotano via in 3D su START e RESTART. A Game Over il giocatore vede il punteggio finale, il riepilogo (tempo, asteroidi, precisione, sfiorate, miglior combo), la classifica personale, il modulo per salvare il punteggio e, se lo ha vinto, il coupon.

Anti-cheat

I punteggi sono controllati dal server: i valori oltre il Punteggio Massimo (predefinito 1.000.000) vengono rifiutati, i salvataggi hanno un limite di frequenza e un nuovo punteggio non cambia mai il nome pubblico di un giocatore prima che tu lo approvi (capitolo 15).

06 — Comandi, pausa e schermo intero

DispositivoMovimentoFuoco
TastieraWASD o le frecce direzionaliSpazio (tieni premuto per la raffica)
Mouse (computer)L’astronave segue il puntatoreTasto sinistro (tieni premuto per la raffica)
Touch (telefoni, tablet)Joystick virtuale (in basso a sinistra)Pulsante di fuoco (in basso a destra)

Pausa

Premi P o Esc, oppure il pulsante di pausa nell’HUD. Il gioco va in pausa da solo anche quando la scheda del browser è nascosta o il gioco esce dallo schermo, e riprende con un conto alla rovescia 3-2-1.

Schermo intero

Il pulsante schermo intero (o F durante una partita) allarga il gioco a tutto lo schermo; cambiare a metà partita la mette in pausa. Su iPhone, dove i browser non hanno la modalità a schermo intero, il gioco riempie invece la finestra del browser. Puoi nascondere il pulsante in Layout ed Effetti → Schermo.

HUD

Punteggio, vite, colpi, power-up, combo e i pulsanti di pausa, schermo intero e audio stanno in piccole finestre di vetro in alto, nello stile delle finestre di inizio e di Game Over. Il pulsante audio spegne musica ed effetti e ricorda la scelta.

Telefoni e tablet

I comandi touch compaiono su ogni schermo touch, in verticale o in orizzontale; in orizzontale la finestra di Game Over passa a un layout compatto su due colonne. Con la Risoluzione Adattiva attiva, i dispositivi più lenti abbassano la risoluzione per restare fluidi.

07 — Guida agli shortcode

ShortcodeCosa mostraIndipendente?
[​lusus]Il gioco 3D completo, con la classifica personale, il modulo per salvare il punteggio e il coupon a Game Over.—
[​lusus_leaderboard]La classifica globale pubblica.Sì — funziona su qualsiasi pagina senza il gioco.
[​lusus_ticker]Una barra di messaggi scorrevole.Sì — visibile anche con la casella del ticker spenta.

Altezza del gioco su desktop

Per ridimensionare l’area di gioco sugli schermi larghi almeno 769 px, aggiungi l’attributo desktop_height ; telefoni e tablet mantengono il loro layout. Unità: px, vh, vw, %, em, rem (un numero senza unità vale px).

[​lusus desktop_height="800px"]
Un gioco per pagina

Il gioco si adatta da solo a ogni schermo, quindi non servono copie separate per desktop e mobile. Se una pagina contiene [​lusus] due volte — per esempio in due sezioni Elementor, una nascosta su mobile e una su desktop — parte solo la copia visibile sullo schermo e le altre vengono rimosse.

Caricato solo dove serve

Script e stili si caricano solo sulle pagine che contengono uno shortcode di Lusus — nel contenuto, nei dati di Elementor, nei template del Theme Builder o nei popup. Nell’editor di Elementor il gioco mostra un segnaposto leggero.

08 — Il pannello di amministrazione

Tutto si trova sotto Lusus nel menu di amministrazione di WordPress, in quattro schede:

SchedaCosa contiene
Impostazioni di giocoTutte le 128 opzioni, in cinque sottoschede (sotto).
Moderazione ClassificaApprova, rifiuta o elimina i punteggi, uno alla volta o in blocco; pagine da 100 giocatori e una vista In attesa ; esportazione CSV di tutti i giocatori o solo di quelli approvati.
AnalyticsAndamento di giocatori e punteggi (capitolo 20).
Style PresetStili integrati; salva, carica, esporta e importa i tuoi (capitolo 14).

Sottoschede di Impostazioni Gioco

SottoschedaSezioni
BrandingTitolo e sottotitolo del gioco, font, loghi, immagine del Super Bonus.
ColoriColori del tema, delle finestre e dei pulsanti, della scena di gioco, della classifica.
Layout ed EffettiBordi e raggi, bagliore neon, asteroide decorativo, schermo (schermo intero, risoluzione adattiva, schermate animate), audio.
Testi ed EtichetteI 33 testi che i giocatori vedono durante la partita.
FunzionalitàRegole del gioco, classifica globale e privacy, news ticker, premio coupon, banner di Game Over, notifica email, webhook.

Ogni opzione è elencata con la sua chiave e il valore predefinito nell’ Appendice A.

09 — Regole di gioco

Le regole del gioco sono in Funzionalità → Gameplay. Tutto è attivo di default; spegni quello che non vuoi.

ImpostazionePredefinitoCosa fa
Colpi a disposizione100Colpi laser con cui il giocatore parte. Il Super Bonus e il power-up colpi li ricaricano. 0 = illimitati.
Asteroidi che si spezzanoAttivoGli asteroidi grandi si spezzano in due pezzi più piccoli quando vengono colpiti.
Power-up Scudo e ColpiAttivoSolidi luminosi: il tetraedro arma uno scudo, le barre ricaricano i colpi.
Barriere al NeonAttivoTravi indistruttibili attraverso la pista, da superare passando nei varchi.
Combo e SfiorateAttivoMoltiplicatore fino a ×4 per gli asteroidi abbattuti di fila; 25 punti per ogni sfiorata.
Power-up BombaAttivoUna bomba rara con conto alla rovescia 3-2-1 e un’onda d’urto che ripulisce la pista.
Riepilogo di Fine PartitaAttivoTempo, asteroidi, precisione, sfiorate e miglior combo a Game Over.
Comandi col MouseAttivoAl computer l’astronave segue il puntatore e il tasto sinistro spara.
Soglia del coupon

Combo e bomba fanno crescere i punteggi più in fretta. Se offri un coupon, gioca qualche partita e controlla che il suo Punteggio Minimo sia ancora una vera sfida.

10 — Personalizzazione grafica

Lusus ti dà un ampio set di controlli grafici, così il gioco si adatta al tuo brand invece di sembrare un plugin generico. Un colore lasciato vuoto segue i colori del tema.

Colori del tema

ImpostazionePredefinitoComandi
Colore Primario#5535FFTonalità neon principale: astronave, griglia, finestre
Colore Secondario#FF8C00Evidenziazioni, asteroidi, combo, pulsanti
Colore di Sfondo e Opacità#161616 / 100Sfondo del gioco (opacità 0–100%)
Colore Testi e Laser#FFFFFFTesti dell’interfaccia e laser
Colore Sottotitolo#aaaaaaSottotitolo nella schermata iniziale

Finestre, pulsanti e cornice

Le finestre di inizio, pausa e Game Over e l’HUD condividono uno stile: colore di sfondo e opacità (predefinita 45), sfocatura effetto vetro (20 px), colore del bordo, raggio (24) e spessore (2). Campi di testo, pulsanti e i loro stati hover hanno colori propri e un raggio dei pulsanti (12); la cornice esterna del gioco ha raggio, spessore e colore propri.

Scena di gioco e classifica

Colore della griglia, dello scenario (wireframe), dell’ombra dell’astronave e del cubo Triplo Laser; colori del punteggio finale, dei nomi e della riga record; raggio e bordo dei riquadri e delle righe della classifica.

Intensità del bagliore neon

Intensità Neon Glow (0–200%, predefinita 100) regola ogni bagliore e ombra — da discreto a neon arcade pieno.

Asteroide decorativo

Il grande asteroide che ruota dietro la schermata iniziale segue il mouse con un effetto magnetico. Puoi attivarlo o spegnerlo e regolarne dimensione (100–600 px, predefinita 340) e posizione.

Schermo

  • Pulsante Schermo Intero — mostra il pulsante schermo intero nell’HUD.
  • Risoluzione Adattiva — sui dispositivi che non riescono a mantenere fluido il gioco, la risoluzione scende un passo alla volta; i dispositivi veloci non ne risentono.
  • Schermate animate — il mondo che scorre lento, gli asteroidi di passaggio e le transizioni 3D delle finestre di inizio e di Game Over.

Tutte e tre sono attive di default.

11 — Tipografia e font

Lusus ha due slot per i font — primario (titoli e interfaccia; predefinito Orbitron, peso 700) e secondario (testi; predefinito Rajdhani, peso 400) — ognuno con tre possibili sorgenti:

SorgenteCome funziona
Google FontsScegli un font dall’elenco; il browser del visitatore lo carica da Google.
Font del TemaUsa i font che il tuo tema carica già: Astra, GeneratePress, OceanWP, Kadence, Hello Elementor o il Kit di Elementor.
Caricamento PersonalizzatoUn file WOFF o WOFF2 dalla Libreria media; Lusus scrive per te il @font-face . Solo gli amministratori possono caricare file di font.

Regolazione fine per slot

Per ogni slot imposta il peso, la spaziatura tra le lettere e la trasformazione del testo (per esempio MAIUSCOLO).

Privacy

Con la sorgente Google Fonts il browser del visitatore contatta i server di Google, che ricevono il suo indirizzo IP. Nell’UE va indicato nella privacy policy — oppure scegli Font del Tema o Caricamento Personalizzato per entrambi gli slot.

12 — Branding e immagini

Titolo & sottotitolo

Titolo del gioco (predefinito LUSUS) e sottotitolo, mostrati nella schermata iniziale.

Loghi

  • Logo Schermata Iniziale (PNG o GIF) — mostrato nella schermata iniziale.
  • Logo Personalizzato — un piccolo logo mostrato durante la partita. Usa un PNG o SVG trasparente, alto circa 50 px.

Immagine del Super Bonus

Il Super Bonus da +150 può essere una tua immagine — il tuo logo o un prodotto che vola lungo la pista. Le GIF animate sono supportate (decodificate fotogramma per fotogramma). Consigliato: quadrata, fino a 320×320 px, meno di circa 50 KB, 8–20 fotogrammi.

Cubo bianco invece della tua immagine?

Una texture 3D ha bisogno del permesso per essere usata: prendi l’immagine dalla Libreria media di questo sito. Se i tuoi media sono serviti da una CDN su un altro dominio, la CDN deve inviare l’header Access-Control-Allow-Origin . La console del browser mostra un messaggio di Lusus con l’indirizzo dell’immagine.

13 — Testi e audio

Testi

Ogni parola che il giocatore vede è un’impostazione in Testi ed Etichette — 33 testi in tutto (elenco completo nell’ Appendice A). Alcuni esempi:

TestoPredefinito
Pulsanti Avvia / RiavviaSTART GAME / RESTART GAME
Titolo / testo delle istruzioniFLIGHT CONTROLS / WASD, ARROWS or MOUSE to move – SPACE or CLICK for Laser – P to pause
Etichetta del punteggioPOINTS:
Titolo pausa / pulsante RiprendiPAUSED / RESUME
Etichetta combo / sfiorataCOMBO / CLOSE CALL
Scudo / bombaSHIELD ON / BOMB!
Colpi ricaricati / colpi esauriti+{n} SHOTS / NO AMMO
Etichette del riepilogoTIME / ASTEROIDS / ACCURACY / NEAR MISSES / BEST COMBO
Classifica personale vuotaNO SCORES YET

In +{n} SHOTS, {n} diventa il numero di colpi ricaricati. Il testo delle istruzioni accetta HTML di base.

Musica

Colonna sonora integrataAtmosfera
Nebula Drifter 3.096 BPM — ambient, esplorazione
Hyperdrive Engage 3.0138 BPM — veloce, combattimento
Stardust Cruiser 3.0115 BPM — dub techno, crociera

Le colonne sonore sono composte dal vivo dal browser (Web Audio): nessun file da scaricare. Un MP3 personalizzato dalla Libreria media le sostituisce; il Volume Musica è al 50% di default.

Effetti sonori

Effetti procedurali con un tocco di riverbero e posizione stereo; la musica si attutisce per un attimo quando l’astronave viene colpita. Il pulsante audio nell’HUD spegne tutto e ricorda la scelta. I browser permettono l’audio solo dopo un clic o un tocco, quindi parte con START.

14 — Preset di stile

I preset di stile sono stili completi da attivare all’istante o riusare su altri siti.

Preset integrati

Base Style Flight Style B&W Style Matrix Style Mapping Style Love Style

Il Base Style viene applicato in una nuova installazione. I preset integrati cambiano solo l’aspetto — colori, font, immagini e musica — e lasciano invariati testi, regole di gioco, classifica, coupon, banner, email e webhook. Non si possono sovrascrivere e si rinnovano quando si aggiorna Lusus.

I tuoi preset

  1. Configura il gioco come preferisci.
  2. In Style Preset, salva la configurazione attuale con un nome.
  3. Clicca l’icona di download accanto a un preset per esportarlo come file JSON.
  4. Importa il JSON su un altro sito per riprodurre lo stesso stile.
Sicuro per costruzione

Caricare o importare un preset può cambiare solo le impostazioni di Lusus — mai altro sul tuo sito.

15 — Classifica globale

La classifica globale persistente trasforma i visitatori occasionali in habitué che tornano a difendere la loro posizione.

Configurazione

  • Attivala in Funzionalità → Classifica Globale (già attiva nelle nuove installazioni).
  • Imposta il suo titolo (predefinito GLOBAL RANKING) e Giocatori Mostrati (predefinito 10, da 5 a 100).
  • Mostrala ovunque con [​lusus_leaderboard].

Come si entra in classifica

A Game Over il giocatore scrive un nome (fino a 8 caratteri) e un indirizzo email, spunta la casella del consenso e salva. Ogni email è un giocatore: un punteggio migliore aggiorna la stessa riga e viene contato il numero di partite giocate. L’email non è mai mostrata in pubblico. La classifica personale delle schermate di inizio e di Game Over resta nel browser del giocatore.

Moderazione

I nuovi giocatori compaiono in pubblico solo dopo che li approvi in Moderazione Classifica: approva, rifiuta o elimina le righe una alla volta o in blocco. La tabella mostra 100 giocatori per pagina e ha una vista In attesa , così niente in attesa di approvazione va perso. Quando un giocatore approvato salva un punteggio con un nome diverso, la classifica mantiene il nome approvato finché non approvi quello nuovo; Rifiuta lo ripristina.

Anti-spam

  • I punteggi oltre il Punteggio Massimo (predefinito 1.000.000) vengono rifiutati.
  • Ogni indirizzo di rete può salvare fino a 5 punteggi ogni 10 secondi; quando deve solo aspettare, il gioco riprova da solo.
  • Si accettano fino a 30 nuovi giocatori al minuto, così gli invii automatici in massa non possono riempire la tabella né la tua casella email.
  • Quando un salvataggio viene rifiutato, il giocatore vede il perché.
Eventi, uffici, proxy

Dietro un reverse proxy o una CDN che nasconde gli indirizzi dei visitatori, dichiaralo con il filtro lusus_trusted_proxies , altrimenti tutti i visitatori condividono un solo indirizzo. Gli sviluppatori possono cambiare i limiti con lusus_ip_limit_max, lusus_ip_limit_window, lusus_new_entry_max e lusus_new_entry_window.

16 — Lead generation

Ogni punteggio salvato porta con sé un nome, un indirizzo email e la data e l’ora del consenso del giocatore. Lusus ti dà diversi modi per usarli.

Esportazione CSV

In Moderazione Classifica, scarica tutti i giocatori — o solo quelli approvati — come file CSV (UTF-8, si apre correttamente in Excel) con le colonne Email Address, First Name, Score, Status, Date, Consent Date, pronto da importare in Mailchimp, ActiveCampaign o Brevo. I valori che potrebbero essere eseguiti come formule nel foglio di calcolo vengono neutralizzati.

Notifica email

In Funzionalità → Notifica Email, ricevi un’email ogni volta che un giocatore salva un nuovo record personale. Imposta il destinatario (vuoto = l’email dell’amministratore del sito) e l’oggetto, con i segnaposto {name}, {email} e {score}:

Lusus: New score from {name}

L’email contiene nome, email, punteggio e ora del giocatore, con un link alla scheda di moderazione.

Webhook

Invia i dati dei giocatori in tempo reale a Zapier, Make, n8n o a qualsiasi endpoint. La richiesta non rallenta mai il gioco (non bloccante, timeout di 5 secondi). Payload JSON:

{
  "event": "new_score",
  "name": "MARCO",
  "email": "marco@example.com",
  "score": 1250,
  "timestamp": "2026-10-19T12:30:00+02:00",
  "site_url": "https://example.com"
}

Modulo di iscrizione a Game Over

Mostra un modulo newsletter di Contact Form 7, WPForms, MC4WP o simili nel banner di Game Over (capitolo 18).

Usare le email per il marketing

Il testo di consenso predefinito copre solo la classifica, e gli indirizzi non sono verificati. Per inviare newsletter, cambia il testo del consenso perché chieda quello scopo e conferma ogni indirizzo con il doppio opt-in del tuo servizio email — oppure raccogli le iscrizioni con un modulo dedicato.

17 — Coupon premio

Premia chi raggiunge un punteggio obiettivo con un codice sconto a Game Over — vendite gamificate che portano chi compra dritto al tuo shop.

Configurazione

In Funzionalità → Premio Coupon:

ImpostazioneScopoPredefinito
Attiva Premio CouponAttiva il premioDisattivato
Punteggio Minimo per SbloccarePunteggio necessario per vincere il codice0
Codice CouponIl codice sconto mostrato—
Titolo / messaggio del premioTitolo e istruzioniYou earned a reward! / Use this code at checkout
Testo / URL del pulsante CTAPulsante verso il tuo shopSHOP NOW / —
Info ScadenzaRiga di urgenza facoltativa—

I giocatori che si qualificano vedono il codice con un pulsante per copiarlo e il tuo pulsante CTA. Ricorda di impostare sia il codice sia l’URL del pulsante: sono vuoti di default.

Codice protetto

Il codice coupon non è nel sorgente della pagina: il gioco lo chiede al server solo dopo che il punteggio è sufficiente, con un limite per indirizzo di rete. Nessuno può leggerlo senza giocare.

Controlla la soglia

Combo e bomba fanno crescere i punteggi più in fretta: prova qualche partita e imposta un Punteggio Minimo che sia ancora una vera sfida.

18 — Banner di Game Over

Mostra un tuo blocco nella schermata di Game Over — il momento di massima attenzione. Perfetto per una promozione, un link, un’immagine o l’iscrizione alla newsletter.

  1. In Funzionalità → Banner Game Over, spunta Attiva Banner.
  2. Scrivi il contenuto in Contenuto HTML Banner: testo, link, immagini e shortcode.

Per mostrare un modulo di iscrizione, incolla lo shortcode del tuo plugin di moduli — Contact Form 7, WPForms, MC4WP e simili:

[​contact-form-7 id="123"]
Usa lo shortcode

Per sicurezza, moduli, script e iframe incollati come HTML vengono rimossi. Lo shortcode del plugin di moduli invece funziona.

19 — News ticker

Un’elegante barra di messaggi scorrevole per annunci, regole od offerte. Due messaggi: il primo nel colore primario, il secondo nel colore secondario (di default invitano i giocatori ad accedere e salvare il punteggio).

  • Attiva News Ticker in Funzionalità → News Ticker : se spuntata, mostra la barra sopra il gioco.
  • [​lusus_ticker] la mostra su qualsiasi pagina, con o senza il gioco, anche quando la casella è spenta.

20 — Statistiche

La scheda Statistiche ti dà a colpo d’occhio l’andamento del coinvolgimento, con le tendenze confrontate col periodo precedente:

MetricaSignificato
Giocatori totaliTutti i giocatori in classifica
Nuovi oggiOggi rispetto a ieri
Questa settimana / Questo mesePeriodo attuale rispetto al precedente
Punteggio medioPunteggio medio di tutti i giocatori

21 — Privacy e GDPR

Lusus ti dà gli strumenti per raccogliere contatti in linea con il GDPR:

  • Casella di consenso con il tuo testo (predefinito “I consent to email processing for the leaderboard”) e un link alla tua privacy policy (URL Privacy Policy). Il server la controlla di nuovo: un salvataggio senza consenso viene rifiutato.
  • Data del consenso — data e ora del consenso vengono salvate con ogni punteggio e incluse nell’esportazione CSV.
  • Strumenti privacy di WordPress — Strumenti → Esporta dati personali e Cancella dati personali trovano i dati di classifica di un giocatore dal suo indirizzo email.
  • Testo per la policy — una sezione suggerita per la tua privacy policy in Impostazioni → Privacy (guida alla policy).

Cosa viene salvato

Solo per i giocatori che salvano un punteggio: nome, indirizzo email, punteggio, data del salvataggio, data e ora del consenso e numero di partite giocate. L’email non è mai mostrata in pubblico. Nel browser del giocatore il gioco conserva la classifica personale, il nome e la scelta dell’audio; Lusus non usa cookie di tracciamento.

Richieste ad altri server

Three.js e il motore del gioco sono inclusi nel plugin. L’unica richiesta esterna è a Google Fonts, quando uno slot di font usa la sorgente Google Fonts (quella predefinita): scegli Font del Tema o Caricamento Personalizzato per evitarla (capitolo 11).

La tua responsabilità

Lusus fornisce gli strumenti; la privacy policy, il testo del consenso e l’uso dei dati spettano a te. Per le newsletter, vedi la nota del capitolo 16.

22 — Siti multilingua

  • Pannello e messaggi integrati — inglese e italiano sono inclusi; per altre lingue si traducono con i normali file WordPress .po/.mo (Loco Translate, Poedit).
  • Testi del gioco — tutto ciò che i giocatori leggono è un’impostazione (Testi ed Etichette, titolo e sottotitolo, testo e link della privacy, news ticker, coupon, banner di Game Over), quindi puoi scriverlo in qualsiasi lingua.
  • Siti multilingua — con WPML (String Translation) o Polylang (Lingue → Traduzioni) i testi del gioco si possono tradurre per ogni lingua: Lusus include un file wpml-config.xml che entrambi i plugin leggono.

23 — Prestazioni e compatibilità

  • Caricato solo dove serve — script e stili si caricano solo sulle pagine con uno shortcode di Lusus.
  • Motore 3D su richiesta — Three.js (incluso nel plugin, nessuna CDN) e il motore del gioco si scaricano solo quando il gioco si avvicina allo schermo; una schermata di caricamento con una vera barra di avanzamento copre l’attesa.
  • Leggero e veloce — motore e foglio di stile sono minificati (i sorgenti leggibili si usano quando SCRIPT_DEBUG è attivo); un solo contesto WebGL; il disegno si ferma quando il gioco è fuori dallo schermo.
  • Risoluzione adattiva — i dispositivi più lenti abbassano la risoluzione per restare fluidi.
  • Page builder — Elementor (con un segnaposto leggero nell’editor), Divi, l’editor a blocchi, i template del Theme Builder e i popup, e qualsiasi tema scritto bene.
  • Plugin di cache e ottimizzazione — Lusus aggiunge da solo le sue esclusioni per WP Rocket, LiteSpeed Cache e Perfmatters (JavaScript ritardato, CSS inutilizzato). Sulle pagine servite dalla cache rinnova da solo il token di sicurezza, così i salvataggi continuano a funzionare.
  • Hosting — provato su LiteSpeed/Hostinger: correzione HTTP/2, rilevamento dell’IP dietro reverse proxy, header anti-cache per le sue richieste.

24 — Risoluzione problemi e FAQ

Il gioco resta su “Loading…” o si vede male con un plugin di ottimizzazione

Due ottimizzazioni possono interferire: Delay JavaScript execution avvia gli script solo al primo movimento del mouse o tocco, e Remove unused CSS toglie gli stili degli elementi che il gioco crea dopo. Lusus si esclude da solo in WP Rocket, LiteSpeed Cache e Perfmatters. Con altri plugin, escludi lusus-loader e zacGameConfig dal ritardo del JavaScript, e la cartella wp-content/plugins/lusus/css/ dalla rimozione del CSS inutilizzato.

Il gioco non compare

Controlla che la pagina sia stata salvata con lo shortcode, poi svuota la cache. Dopo aver cambiato le impostazioni o aggiornato Lusus, svuota anche la cache delle pagine.

Le email dei giocatori non vengono salvate

La classifica globale deve essere attiva, e il giocatore deve inserire un’email valida (se non lo è, il campo trema) e spuntare la casella del consenso. Se il server rifiuta un salvataggio, il giocatore vede il perché.

Più giocatori sulla stessa rete ricevono “attendi”

Ogni indirizzo può salvare 5 punteggi ogni 10 secondi, e il gioco riprova da solo. Dietro un proxy o una CDN, dichiaralo con lusus_trusted_proxies (capitolo 15).

Il Super Bonus è un cubo bianco

L’immagine non si può usare come texture 3D — vedi la nota del capitolo 12.

I punteggi sono molto più alti di prima

Merito delle combo (fino a ×4) e della bomba, novità della 2.0.9. Controlla il Punteggio Minimodel tuo coupon, oppure spegnile in Funzionalità → Gameplay.

Posso mettere il gioco due volte nella stessa pagina?

No: uno [​lusus] per pagina. Si adatta da solo a ogni schermo (capitolo 7).

25 — Changelog

VersioneNovità principali
2.0.9Moltiplicatore combo e sfiorate; power-up bomba; schermate di inizio e Game Over animate; nuovo HUD di vetro; miglior combo nel riepilogo. Consenso verificato dal server e salvato con ogni punteggio; strumenti privacy di WordPress e testo per la policy; shortcode (moduli di iscrizione) nel banner di Game Over; WPML e Polylang; esclusioni automatiche per i plugin di cache. Correzioni di sicurezza e affidabilità.
2.0.8Comandi col mouse; colonne sonore riscritte; moderazione a pagine con vista In attesa; salvataggi che resistono alle cache delle pagine; funziona anche con la memoria del sito bloccata; correzioni del layout sui telefoni; traduzione italiana completa.
2.0.7Pausa e schermo intero; colpi limitati; power-up scudo e colpi; barriere al neon; scenario procedurale; riepilogo di fine partita; effetti d’impatto e nuovi suoni; risoluzione adattiva; un motore molto più leggero e veloce.
2.0.6Correzioni per touch e GIF animate; caricamento dei font solo per gli amministratori; meno memoria; testato fino a WordPress 7.1.
2.0.5Errori chiari quando un punteggio non si salva; correzioni della tastiera; coupon con limite di richieste; tocca per riprovare se il motore non si carica.
2.0.4Motore 3D caricato su richiesta; schermata di caricamento al neon; segnaposto nell’editor di Elementor; coupon consegnato solo a chi vince; protezione anti-spam rafforzata; esportazione CSV più sicura.
2.0.3Gioco più fluido nell’azione intensa.
2.0.0 – 2.0.2Licenze Freemius e aggiornamenti automatici; Base Style applicato nelle nuove installazioni.

A — Complete Settings Reference

Tutte le 128 opzioni con i valori predefiniti, raggruppate come in Lusus → Impostazioni Gioco. Le chiavi delle opzioni usano il prefisso zac_ . Questi sono i valori predefiniti del plugin: una nuova installazione applica sopra il preset Base Style (colonna sonora, colori, font, logo) e attiva la classifica globale.

Branding

ImpostazioneKeyPredefinito
Titolo del Giocozac_game_titleLUSUS
Sottotitolo / Autorezac_game_subtitleCustomizable 3D game widget
Font Principale (UI, Titoli)zac_font_primaryOrbitron
Font Principale (UI, Titoli) — sorgentezac_font_primary_sourcegoogle
Font Principale (UI, Titoli) — file caricatozac_font_primary_custom_url—
Font Principale (UI, Titoli) — pesozac_font_primary_weight700
Font Principale (UI, Titoli) — spaziatura letterezac_font_primary_letterspacing0
Font Principale (UI, Titoli) — trasformazione testozac_font_primary_transform—
Font Secondario (Testi, Autore)zac_font_secondaryRajdhani
Font Secondario (Testi, Autore) — sorgentezac_font_secondary_sourcegoogle
Font Secondario (Testi, Autore) — file caricatozac_font_secondary_custom_url—
Font Secondario (Testi, Autore) — pesozac_font_secondary_weight400
Font Secondario (Testi, Autore) — spaziatura letterezac_font_secondary_letterspacing0
Font Secondario (Testi, Autore) — trasformazione testozac_font_secondary_transform—
Logo Personalizzatozac_custom_logo—
Logo Schermata Iniziale (PNG/GIF)zac_start_logo—
Immagine Super Bonus (+150)zac_super_bonus_image—

Colori → Colori Tema

ImpostazioneKeyPredefinito
Colore Primariozac_primary_color#5535FF
Colore Secondariozac_accent_color#FF8C00
Colore di Sfondo e Opacitàzac_bg_color#161616
Colore di Sfondo e Opacità — opacità (%)zac_bg_opacity100
Colore Testi e Laserzac_ui_text_color#FFFFFF
Colore Sottotitolozac_subtitle_color#aaaaaa

Colori → Colori Elementi UI

ImpostazioneKeyPredefinito
Sfondo Finestre e Opacitàzac_overlay_bg_color#161616
Sfondo Finestre e Opacità — opacità (%)zac_overlay_opacity45
Effetto Blur Sfondo Finestre (px)zac_overlay_blur20
Colore Bordi Finestrezac_overlay_border_color—
Colore Bordi Contenitorizac_border_color—
Colore Testi Istruzionizac_instruction_text_color#CCCCCC
Colore Sfondo Inputzac_input_bg_color#000000
Colore Testo Inputzac_input_text_color#FFFFFF
Sfondo Pulsantizac_btn_bg_color—
Sfondo Pulsanti Hoverzac_btn_bg_hover_color—
Colore Testo Pulsantizac_btn_text_color#FFFFFF
Colore Testo Hover Pulsantizac_btn_hover_text_color#000000
Colore Testo Privacy (GDPR)zac_privacy_color#FFFFFF

Colori → Colori Scena di Gioco

ImpostazioneKeyPredefinito
Colore Griglia di Scorrimentozac_grid_color—
Colore Colonne Wireframezac_pillar_color—
Colore Ombra Astronavezac_shadow_color#000000
Colore Cubo Triplo Laserzac_triple_laser_color#FFFFFF

Colori → Colori Classifica

ImpostazioneKeyPredefinito
Colore Punteggio Finalezac_final_score_color—
Colore Nomi Giocatorezac_leader_name_color—
Sfondo Riga Recordzac_record_bg_color#000000

Layout ed Effetti → Layout e Bordi

ImpostazioneKeyPredefinito
Raggio Bordi Contenitori (px)zac_border_radius0
Spessore Bordi Contenitori (px)zac_border_width2
Raggio Bordi Finestre (px)zac_overlay_border_radius24
Spessore Bordi Finestre (px)zac_overlay_border_width2
Raggio Bordi Pulsanti (px)zac_btn_border_radius12
Raggio Contenitore Classifica (px)zac_leader_box_radius15
Bordo Contenitore Classifica (px)zac_leader_box_border1
Raggio Righe Classifica (px)zac_leader_item_radius8
Bordo Righe Classifica (px)zac_leader_item_border1
Intensità Neon Glow (%)zac_neon_intensity100

Layout ed Effetti → Asteroide Decorativo

ImpostazioneKeyPredefinito
Attivazac_enable_heroAttivo
Dimensione (px)zac_hero_size340
Posizione Orizzontalezac_hero_right50
Posizione Verticalezac_hero_bottom50

Layout ed Effetti → Schermo

ImpostazioneKeyPredefinito
Pulsante Schermo Interozac_enable_fullscreenAttivo
Risoluzione Adattivazac_adaptive_qualityAttivo
Schermate animatezac_animated_screensAttivo

Layout ed Effetti → Audio

ImpostazioneKeyPredefinito
Colonna sonora integratazac_builtin_trackNessuno
MP3 personalizzato (sostituisce)zac_bg_music—
Volume Musica (%)zac_bg_music_volume50

Testi ed Etichette

ImpostazioneKeyPredefinito
Etichetta Punteggiozac_txt_score_labelPOINTS:
Pulsante Iniziozac_txt_btn_startSTART GAME
Pulsante Riavviozac_txt_btn_restartRESTART GAME
Messaggio Ingresso Classificazac_txt_leader_entry_msgYou made it into the top pilots leaderboard
Titolo Istruzionizac_txt_instr_titleFLIGHT CONTROLS
Testo Istruzionizac_txt_instr_bodyWASD, ARROWS or MOUSE to move - SPACE or CLICK for Laser - P to pause
Titolo Classifica (Inizio)zac_txt_leader_startPERSONAL RANKING
Titolo Classifica (Fine)zac_txt_leader_endPERSONAL RANKING
Testo Classifica Vuotazac_txt_leader_emptyNO SCORES YET
Titolo Game Overzac_txt_game_overGAME OVER
Placeholder Nomezac_txt_input_placeholderYour Name
Placeholder Emailzac_txt_input_email_placeholderYour Email
Testo "Nuovo Record"zac_txt_new_recordNEW RECORD
Testo Bonus (+50)zac_txt_bonus_flying+50 BONUS
Testo Super Bonus (+150)zac_txt_super_bonus_flyingSUPER BONUS +150
Testo Penalità (-50)zac_txt_penalty_flyingPENALTY -50
Testo Triplo Laserzac_txt_triple_laser_flyingTRIPLE LASER 15s!
Testo Speed Livello 1zac_txt_speed_1SPEED 1
Testo Speed Livello 2zac_txt_speed_2SPEED 2
Testo Speed Livello 3zac_txt_speed_3SPEED 3
Titolo Pausazac_txt_pausedPAUSED
Pulsante Riprendizac_txt_btn_resumeRESUME
Testo Colpi Esauritizac_txt_no_ammoNO AMMO
Testo Scudozac_txt_shield_flyingSHIELD ON
Testo Colpi Ricaricatizac_txt_ammo_flying+{n} SHOTS
Testo Bombazac_txt_bomb_flyingBOMB!
Etichetta Combozac_txt_comboCOMBO
Testo Sfioratazac_txt_close_callCLOSE CALL
Riepilogo: Etichetta Tempozac_txt_sum_timeTIME
Riepilogo: Etichetta Asteroidizac_txt_sum_destroyedASTEROIDS
Riepilogo: Etichetta Precisionezac_txt_sum_accuracyACCURACY
Riepilogo: Etichetta Sfioratezac_txt_sum_grazesNEAR MISSES
Riepilogo: Etichetta Miglior Combozac_txt_sum_comboBEST COMBO

Funzionalità → Gameplay

ImpostazioneKeyPredefinito
Colpi a disposizionezac_ammo_max100
Asteroidi che si spezzanozac_asteroid_splitAttivo
Power-up Scudo e Colpizac_powerupsAttivo
Barriere al Neonzac_barriersAttivo
Combo e Sfioratezac_comboAttivo
Power-up Bombazac_bombAttivo
Riepilogo di Fine Partitazac_enable_summaryAttivo
Comandi col Mousezac_mouse_controlAttivo

Funzionalità → Classifica Globale

ImpostazioneKeyPredefinito
Attivazac_enable_global_leaderboardDisattivato
Titolo Classificazac_global_lb_titleGLOBAL RANKING
Giocatori Mostratizac_global_lb_limit10
Punteggio Massimo (Anti-Cheat)zac_max_score_allowed1000000
Testo Consenso Privacy (GDPR)zac_privacy_textI consent to email processing for the leaderboard
URL Privacy Policyzac_privacy_url—

Funzionalità → News Ticker

ImpostazioneKeyPredefinito
Attiva News Tickerzac_enable_news_tickerDisattivato
Messaggio 1 (colore primario)zac_news_text_1Sign in with your email to save your score and enter the World Rankings
Messaggio 2 (colore secondario)zac_news_text_2You can change your name every time you set a new high score!

Funzionalità → Premio Coupon

ImpostazioneKeyPredefinito
Attiva Premio Couponzac_enable_couponDisattivato
Punteggio Minimo per Sbloccarezac_coupon_min_score0
Codice Couponzac_coupon_code—
Titolo Premiozac_coupon_headingYou earned a reward!
Messaggio Premiozac_coupon_messageUse this code at checkout
Testo Pulsante CTAzac_coupon_cta_textSHOP NOW
URL Pulsante CTAzac_coupon_cta_url—
Info Scadenza (opzionale)zac_coupon_expiry_text—

Funzionalità → Banner Game Over

ImpostazioneKeyPredefinito
Attiva Bannerzac_enable_gameover_bannerDisattivato
Contenuto HTML Bannerzac_gameover_banner_html—

Funzionalità → Notifica Email

ImpostazioneKeyPredefinito
Attiva Notifica Emailzac_enable_email_notifyDisattivato
Email Destinatariozac_email_notify_to—
Oggetto Emailzac_email_notify_subjectLusus: New score from {name}

Funzionalità → Webhook

ImpostazioneKeyPredefinito
Attiva Webhookzac_enable_webhookDisattivato
URL Webhookzac_webhook_url—