User Manual

Lusus — the complete guide

Everything you need to install, customize and get the most out of Lusus: the fully customizable 3D arcade game that turns WordPress visitors into engaged leads. This manual covers every feature, setting and shortcode.

Version 2.0.9WordPress 5.8+PHP 7.4+License: GPL-2.0+128 settings

01 — Introduction

Lusus is a premium WordPress plugin that embeds a real 3D browser game — a WebGL arcade shooter built on Three.js — into any page or post with a single shortcode. But Lusus is more than a game: it’s an engagement and lead-generation engine. Players leave their name and email to save a score, climb a global leaderboard and can unlock discount coupons — turning idle visitors into contacts, returning players and buyers.

Who it’s for

Agencies — deliver a standout feature clients have never seen.
E-commerce — reward play with coupons and drive sales.
Education, events & portfolios — keep visitors on the page longer and make it memorable.

Key concepts

Shortcodes — three independent shortcodes place the game, the leaderboard and the news ticker anywhere.
Settings — 128 options control look, texts, audio, game rules and marketing features; a new install starts from the polished Base Style.
Style Presets — save a complete look and reuse it on other sites as a JSON file.
Leads — every saved score is a contact, stored with the date of consent, that you can export, receive by email or send to your automation tools.

02 — Requirements & Installation

Requirements

Requirement	Minimum
WordPress	5.8 or higher (tested up to 7.1)
PHP	7.4 or higher
Browser	Any modern browser with WebGL — desktop, tablet and phone. On the rare browsers without 3D graphics, the start screen explains what to do.

Installing the plugin

Go to Plugins → Add New → Upload Plugin and choose the Lusus ZIP file from your purchase (or upload the lusus folder to /wp-content/plugins/).
Activate Lusus in the Plugins menu.
Activate your license (Chapter 3).
Add [lusus] to any page or post to display the game.
Optional: add [lusus_leaderboard] for the public leaderboard and [lusus_ticker] for a standalone news ticker.

Out of the box

On a fresh install Lusus applies the Base Style preset — soundtrack, fonts, colors and logo already set — and switches on the global leaderboard. Updates never overwrite your customizations.

Removing Lusus

Deleting the plugin from the Plugins screen removes all its data: the leaderboard table, the settings and your saved presets (on multisite, on every site). Export the leaderboard to CSV first if you want to keep it.

03 — Activation & Licensing

Lusus is a premium plugin. Licensing, activation and automatic updates are handled by Freemius, the platform that also processes your purchase.

Activating your license

After you activate the plugin, Lusus shows the Freemius activation screen.
Enter the license key from your purchase confirmation email.
Done: updates now appear in your WordPress dashboard.

Plans

Annual — updates and support while the subscription is active. If it ends, the plugin keeps working; only new updates and support stop.
Lifetime — one payment, updates for as long as Lusus exists.

Every license unlocks 100% of the features and covers one site.

Updates

With an active license, new versions appear in Dashboard → Updates and install with one click, like any WordPress plugin. If you use a page cache, purge it after updating so visitors get the new game files.

04 — Quick Start

The fastest path to a working game:

Create or edit a page.
Insert the shortcode:

[lusus]

Publish and visit the page — the game is live.
Open Lusus → Game Settings to set your colors and logo (Branding and Colors), or pick a ready-made look in Style Presets.
Check Features: game rules, leaderboard, coupon, Game Over banner, email and webhook.

Tip

Want the leaderboard on a separate page, or a scrolling announcement bar? Use [lusus_leaderboard] and [lusus_ticker] — both work without the game (Chapter 7).

05 — How the Game Works

Lusus is an arcade shooter rendered in real time with Three.js/WebGL, up to 60 FPS and sharp on HiDPI screens. The ship flies down a neon track: the player steers, shoots and dodges.

Objective

Destroy asteroids, collect bonuses and survive as long as possible. The HUD shows the lives left; every hit costs one. The game gets faster as the score grows: SPEED 2 at 1,000 points and SPEED 3 at 2,500.

Points

What	How	Points
Asteroid	Shoot it — large ones break in two	`+10` × combo
Bonus cube	Shoot it	`+50`
Triple Laser cube	Shoot it: three lasers for 15 seconds	`+50`
Super Bonus (your image)	Fly into it — it also reloads the shots. Shooting it costs points	`+150` / `-50`
Close call	Fly very close to an obstacle without touching it	`+25` × combo
Power-up you don’t need	Shield already on, shots already full	`+50`

Power-ups

Glowing neon solids, collected by shooting them or flying into them:

Shield (tetrahedron) — absorbs the next hit; a shield icon lights up in the HUD.
Shots (bars) — reload part of the shots; the bigger the bar, the more shots.
Bomb (octahedron, about one a minute) — charges up in front of the ship with a big 3-2-1 countdown, then a shockwave runs down the track and destroys every asteroid and cube in flight, each worth its usual points. Barriers, the Super Bonus and the other power-ups are not affected.

Combo

Asteroids shot one after another build a chain that multiplies their points: ×2 from 5 in a row, ×3 from 12, ×4 from 25. The chain breaks after 3 seconds without destroying anything, or when the ship is hit. The counter and the multiplier appear under the score. Game speed follows the score without the multiplier, so combos never make the game harder.

Obstacles

Neon barriers — glowing girders that cannot be destroyed: fly through the gaps. Their shapes get more complex as the score grows.
Limited shots — 100 by default, with a counter in the HUD; “NO AMMO” means it’s time to find a reload.

Scenery & effects

Fifteen procedural wireframe themes — gates, ring tunnels, arches, cities, canyons and more — are combined at random, so the track never looks the same twice. Layered explosions with shockwaves, glowing lasers, floating score popups, camera shake and phone vibration make every hit felt. Motion effects respect the visitor’s “reduce motion” setting.

Start and Game Over screens

With Animated Screens on, the world keeps flowing slowly behind the start and Game Over windows, a few asteroids drift by, and the windows flip away in 3D on START and RESTART. At Game Over the player sees the final score, the summary (time, asteroids, accuracy, near misses, best combo), the personal ranking, the form to save the score and, if earned, the coupon.

Anti-cheat

Scores are checked by the server: values above the Maximum Score (default 1,000,000) are refused, saves are rate-limited, and a new score never changes a player’s public name before you approve it (Chapter 15).

06 — Controls, Pause & Full Screen

Device	Move	Fire
Keyboard	`WASD` or arrow keys	`Space` (hold for a burst)
Mouse (desktop)	The ship follows the pointer	Left button (hold for a burst)
Touch (phones, tablets)	Virtual joystick (bottom left)	Fire button (bottom right)

Pause

Press P or Esc, or the pause button in the HUD. The game also pauses by itself when the browser tab is hidden or the game is scrolled out of view, and resumes with a 3-2-1 countdown.

Full screen

The full-screen button (or F during a game) expands the game to the whole screen; switching in the middle of a game pauses it. On iPhone, where browsers have no full-screen mode, the game fills the browser window instead. You can hide the button in Layout & Effects → Display.

HUD

Score, lives, shots, power-ups, combo and the pause, full-screen and sound buttons sit in small glass windows at the top, in the style of the start and Game Over windows. The sound button mutes music and effects and remembers the choice.

Phones and tablets

The touch controls appear on every touch screen, held upright or sideways; sideways, the Game Over window switches to a compact two-column layout. With Adaptive Resolution on, slower devices lower the rendering resolution to stay smooth.

07 — Shortcodes Reference

Shortcode	What it shows	Independent?
`[lusus]`	The full 3D game, with the personal ranking, the form to save the score and the coupon at Game Over.	—
`[lusus_leaderboard]`	The public global leaderboard.	Yes — works on any page without the game.
`[lusus_ticker]`	A scrolling message bar.	Yes — shown even when the ticker checkbox is off.

Game height on desktop

To resize the game area on screens 769 px wide or more, add the desktop_height attribute; phones and tablets keep their own layout. Units: px, vh, vw, %, em, rem (a bare number means px).

[lusus desktop_height="800px"]

One game per page

The game adapts to every screen by itself, so separate desktop and mobile copies are not needed. If a page contains [lusus] twice — for example in two Elementor sections, one hidden on mobile and one on desktop — only the copy visible on screen starts and the others are removed.

Loaded only where needed

Scripts and styles load only on pages that contain a Lusus shortcode — in the content, in Elementor data, Theme Builder templates or popups. Inside the Elementor editor the game shows a lightweight placeholder.

08 — Admin Panel Overview

Everything lives under Lusus in the WordPress admin menu, in four tabs:

Tab	What’s inside
Game Settings	All 128 options, in five sub-tabs (below).
Leaderboard Moderation	Approve, reject or delete scores, one by one or in bulk; pages of 100 players and a Pending view; CSV export of all players or of the approved ones.
Analytics	Players and score trends (Chapter 20).
Style Presets	Built-in looks; save, load, export and import your own (Chapter 14).

Game Settings sub-tabs

Sub-tab	Sections
Branding	Game title and subtitle, fonts, logos, Super Bonus image.
Colors	Theme colors, window and button colors, game scene colors, leaderboard colors.
Layout & Effects	Borders and radii, neon glow, decorative asteroid, display (full screen, adaptive resolution, animated screens), audio.
Text & Labels	The 33 texts players see during the game.
Features	Gameplay rules, global leaderboard and privacy, news ticker, coupon reward, Game Over banner, email notification, webhook.

Every option is listed with its key and default value in Appendix A.

09 — Gameplay Settings

The rules of the game are in Features → Gameplay. Everything is on by default; switch off what you don’t want.

Setting	Default	What it does
Shots Available	`100`	Laser shots the player starts with. The Super Bonus and the shots power-up reload them. `0` = unlimited.
Asteroids Break Apart	On	Large asteroids split into two smaller pieces when shot.
Shield & Shots Power-ups	On	Glowing solids: the tetrahedron arms a shield, the bars reload shots.
Neon Barriers	On	Indestructible girders across the track, to fly through.
Combo & Close Calls	On	Score multiplier up to ×4 for asteroids shot in a row; 25 points for each near miss.
Bomb Power-up	On	A rare bomb with a 3-2-1 countdown and a shockwave that clears the track.
End-of-Game Summary	On	Time, asteroids, accuracy, near misses and best combo at Game Over.
Mouse Controls	On	On desktop the ship follows the pointer and the left button fires.

Coupon threshold

Combos and the bomb make scores grow faster. If you offer a coupon, play a few games and check that its Minimum Score is still a real challenge.

10 — Visual Customization

Lusus gives you a deep set of visual controls, so the game matches your brand instead of looking like a generic plugin. A color left empty follows the theme colors.

Theme colors

Setting	Default	Controls
Primary Color	`#5535FF`	Main neon hue: ship, grid, windows
Secondary Color	`#FF8C00`	Highlights, asteroids, combo, buttons
Background Color & Opacity	`#161616` / `100`	Game background (0–100% opacity)
Text & Laser Color	`#FFFFFF`	Interface text and lasers
Subtitle Color	`#aaaaaa`	Subtitle on the start screen

Windows, buttons & frame

The start, pause and Game Over windows and the HUD share one style: background color and opacity (default 45), frosted-glass blur (20 px), border color, radius (24) and width (2). Input fields, buttons and their hover states have their own colors and a button radius (12); the outer game frame has its own radius, width and color.

Game scene & leaderboard

Grid color, scenery (wireframe) color, ship shadow and Triple Laser cube color; final score, player names and record row colors; radius and border of the leaderboard boxes and rows.

Neon glow intensity

Neon Glow Intensity (0–200%, default 100) scales every glow and shadow — from subtle to full arcade neon.

Decorative asteroid

The large rotating asteroid behind the start screen follows the mouse with a magnetic effect. Switch it on or off and set its size (100–600 px, default 340) and position.

Display

Full Screen Button — shows the full-screen button in the HUD.
Adaptive Resolution — on devices that cannot keep the game smooth, the rendering resolution is lowered step by step; fast devices are not affected.
Animated Screens — the slowly flowing world, drifting asteroids and 3D window transitions on the start and Game Over screens.

All three are on by default.

11 — Typography & Fonts

Lusus has two font slots — primary (titles and interface; default Orbitron, weight 700) and secondary (text; default Rajdhani, weight 400) — each with three possible sources:

Source	How it works
Google Fonts	Pick a font from the list; the visitor’s browser loads it from Google.
Theme Font	Uses the fonts your theme already loads: Astra, GeneratePress, OceanWP, Kadence, Hello Elementor or the Elementor Kit.
Custom Upload	A WOFF or WOFF2 file from your Media Library; Lusus writes the `@font-face` for you. Only administrators can upload font files.

Per-slot fine-tuning

For each slot set the weight, letter spacing and text transform (for example UPPERCASE).

Privacy

With the Google Fonts source the visitor’s browser contacts Google’s servers, which receive the visitor’s IP address. In the EU, mention it in your privacy policy — or choose Theme Font or Custom Upload for both slots.

12 — Branding & Images

Title & subtitle

Game title (default LUSUS) and subtitle, shown on the start screen.

Logos

Start Screen Logo (PNG or GIF) — shown on the start screen.
Custom Logo — a small logo shown during play. Use a transparent PNG or SVG, about 50 px high.

Super Bonus image

The +150 Super Bonus can be your own image — your logo or product flying down the track. Animated GIFs are supported (decoded frame by frame). Recommended: square, up to 320×320 px, under about 50 KB, 8–20 frames.

White cube instead of your image?

A 3D texture needs permission to be used: take the image from this site’s Media Library. If your media are served by a CDN on another domain, the CDN must send the Access-Control-Allow-Origin header. The browser console shows a Lusus message with the address of the image.

13 — Texts & Audio

Texts

Every word the player sees is a setting in Text & Labels — 33 texts in all (full list in Appendix A). Some examples:

Text	Default
Start / Restart buttons	START GAME / RESTART GAME
Instructions title / text	FLIGHT CONTROLS / WASD, ARROWS or MOUSE to move – SPACE or CLICK for Laser – P to pause
Score label	POINTS:
Pause title / Resume button	PAUSED / RESUME
Combo label / Close call	COMBO / CLOSE CALL
Shield / Bomb	SHIELD ON / BOMB!
Shots reloaded / Out of shots	+{n} SHOTS / NO AMMO
Summary labels	TIME / ASTEROIDS / ACCURACY / NEAR MISSES / BEST COMBO
Empty personal ranking	NO SCORES YET

In +{n} SHOTS, {n} becomes the number of shots reloaded. The instructions text accepts basic HTML.

Music

Built-in soundtrack	Mood
Nebula Drifter 3.0	96 BPM — ambient, exploration
Hyperdrive Engage 3.0	138 BPM — fast, dogfight
Stardust Cruiser 3.0	115 BPM — dub techno, cruise

The soundtracks are composed live by the browser (Web Audio): no file to download. A Custom MP3 from your Media Library replaces them; Music Volume defaults to 50%.

Sound effects

Procedural effects with a touch of reverb and stereo positioning; the music muffles for a moment when the ship is hit. The sound button in the HUD mutes everything and remembers the choice. Browsers allow sound only after a click or tap, so it starts with START.

14 — Style Presets

Style presets are complete looks you can switch to instantly or reuse on other sites.

Built-in presets

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

Base Style is applied on a new install. Built-in presets change only the look — colors, fonts, images and music — and leave your texts, game rules, leaderboard, coupon, banner, email and webhook settings untouched. They cannot be overwritten and are refreshed when Lusus updates.

Your own presets

Configure the game the way you want.
In Style Presets, save the current configuration under a name.
Click the download icon next to a preset to export it as a JSON file.
Import the JSON on another site to reproduce the same look.

Safe by design

Loading or importing a preset can only change Lusus settings — never anything else on your site.

15 — Global Leaderboard

The persistent global leaderboard turns one-time visitors into regulars who come back to defend their rank.

Setup

Switch it on in Features → Global Leaderboard (already on in new installs).
Set its title (default GLOBAL RANKING) and Players Shown (default 10, range 5–100).
Show it anywhere with [lusus_leaderboard].

How players get in

At Game Over the player types a name (up to 8 characters) and an email address, ticks the consent box and saves. Each email is one player: a better score updates the same entry, and the number of games played is counted. The email is never shown in public. The personal ranking on the start and Game Over screens lives in the player’s browser.

Moderation

New players appear in public only after you approve them in Leaderboard Moderation: approve, reject or delete entries one by one or in bulk. The table shows 100 players per page and has a Pending view, so nothing waiting for approval gets lost. When an approved player saves a score under a different name, the leaderboard keeps the approved name until you approve the new one; Reject restores it.

Anti-spam

Scores above the Maximum Score (default 1,000,000) are refused.
Each network address can save up to 5 scores every 10 seconds; when it only has to wait, the game retries by itself.
Up to 30 new players per minute are accepted, so automated floods cannot fill the table or your inbox.
When a save is refused, the player sees why.

Events, offices, proxies

Behind a reverse proxy or CDN that hides visitors’ addresses, declare it with the lusus_trusted_proxies filter, otherwise every visitor shares one address. Developers can change the limits with lusus_ip_limit_max, lusus_ip_limit_window, lusus_new_entry_max and lusus_new_entry_window.

16 — Lead Generation

Every saved score comes with a name, an email address and the date and time of the player’s consent. Lusus gives you several ways to use them.

CSV export

In Leaderboard Moderation, download all players — or only the approved ones — as a CSV file (UTF-8, opens correctly in Excel) with the columns Email Address, First Name, Score, Status, Date, Consent Date, ready to import into Mailchimp, ActiveCampaign or Brevo. Values that could run as spreadsheet formulas are neutralized.

Email notification

In Features → Email Notification, receive an email whenever a player saves a new best score. Set the recipient (empty = the site admin email) and the subject, with the placeholders {name}, {email} and {score}:

Lusus: New score from {name}

The email contains the player’s name, email, score and time, with a link to the moderation tab.

Webhook

Send player data in real time to Zapier, Make, n8n or any endpoint. The request never slows the game down (non-blocking, 5-second timeout). JSON payload:

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

Signup form at Game Over

Show a newsletter form from Contact Form 7, WPForms, MC4WP or similar in the Game Over banner (Chapter 18).

Using the emails for marketing

The default consent text covers the leaderboard only, and the addresses are not verified. To send newsletters, change the consent text so that it asks for that purpose and confirm each address with the double opt-in of your email service — or collect newsletter signups with a dedicated form.

17 — Coupon Rewards

Reward players who reach a target score with a discount code at Game Over — gamified sales that send buyers straight to your shop.

Configuration

In Features → Coupon Reward:

Setting	Purpose	Default
Enable Coupon Reward	Turns the reward on	Off
Minimum Score to Unlock	Score needed to win the code	`0`
Coupon Code	The discount code shown	—
Reward Heading / Message	Title and instructions	You earned a reward! / Use this code at checkout
CTA Button Text / URL	Button to your shop	SHOP NOW / —
Expiry Info	Optional urgency line	—

Qualifying players see the code with a copy button and your CTA button. Remember to set both the code and the button URL: they are empty by default.

Protected code

The coupon code is not in the page source: the game asks the server for it only after the score qualifies, with a limit per network address. Nobody can read it without playing.

Check the threshold

Combos and the bomb make scores grow faster: test a few games and set a Minimum Score that is still a real challenge.

18 — Game Over Banner

Show your own block on the Game Over screen — the moment of peak attention. Perfect for a promotion, a link, an image or a newsletter signup.

In Features → Game Over Banner, tick Enable Banner.
Write your content in Banner HTML Content: text, links, images and shortcodes.

To show a signup form, paste the shortcode of your form plugin — Contact Form 7, WPForms, MC4WP and similar:

[contact-form-7 id="123"]

Use the shortcode

For security, forms, scripts and iframes pasted as raw HTML are removed. The form plugin’s shortcode works.

19 — News Ticker

A sleek scrolling message bar for announcements, rules or offers. Two messages: the first in the primary color, the second in the secondary color (by default they invite players to sign in and save their score).

Enable News Ticker in Features → News Ticker shows the bar above the game.
[lusus_ticker] shows it on any page, with or without the game, even when the checkbox is off.

20 — Analytics Dashboard

The Analytics tab gives you an at-a-glance view of engagement, with trends compared with the previous period:

Metric	Meaning
Total Players	All players in the leaderboard
New Today	Today compared with yesterday
This Week / This Month	Current period compared with the previous one
Average Score	Mean score across all players

21 — Privacy & GDPR

Lusus gives you the tools to collect contacts in line with the GDPR:

Consent checkbox with your own text (default “I consent to email processing for the leaderboard”) and a link to your privacy policy (Privacy Policy URL). The server checks it again: a save without consent is refused.
Consent date — the date and time of consent are stored with each score and included in the CSV export.
WordPress privacy tools — Tools → Export Personal Data and Erase Personal Data find a player’s leaderboard data by email address.
Policy text — a suggested section for your privacy policy in Settings → Privacy (policy guide).

What is stored

Only for players who save a score: name, email address, score, date of the save, date and time of consent and number of games played. The email is never shown in public. In the player’s browser, the game keeps the personal ranking, the player’s name and the sound choice; Lusus sets no tracking cookies.

Requests to other servers

Three.js and the game engine are bundled with the plugin. The only external request is to Google Fonts, when a font slot uses the Google Fonts source (the default): choose Theme Font or Custom Upload to avoid it (Chapter 11).

Your responsibility

Lusus provides the tools; your privacy policy, the consent text and how you use the data are up to you. For newsletters, see the note in Chapter 16.

22 — Multilingual Sites

Admin and built-in messages — English and Italian are included; translate into other languages with the standard WordPress .po/.mo files (Loco Translate, Poedit).
Game texts — everything players read is a setting (Text & Labels, title and subtitle, privacy text and link, news ticker, coupon, Game Over banner), so you can write it in any language.
Multilingual sites — with WPML (String Translation) or Polylang (Languages → Translations) the game texts can be translated for each language: Lusus ships a wpml-config.xml file that both plugins read.

23 — Performance & Compatibility

Loaded only where needed — scripts and styles load only on pages with a Lusus shortcode.
Lazy 3D engine — Three.js (bundled locally, no CDN) and the game engine download only when the game scrolls near the screen; a loading screen with a real progress bar covers the wait.
Small and fast — engine and stylesheet ship minified (the readable sources are used when SCRIPT_DEBUG is on); one WebGL context; rendering stops while the game is out of view.
Adaptive resolution — slower devices lower the rendering resolution to stay smooth.
Page builders — Elementor (with a lightweight placeholder in the editor), Divi, the block editor, Theme Builder templates and popups, and any properly coded theme.
Cache and optimization plugins — Lusus adds its own exclusions for WP Rocket, LiteSpeed Cache and Perfmatters (delayed JavaScript, unused CSS). On pages served from a cache it renews its security token by itself, so saves keep working.
Hosting — tested on LiteSpeed/Hostinger: HTTP/2 fix, reverse-proxy IP detection, anti-cache headers for its requests.

24 — Troubleshooting & FAQ

The game stays on “Loading…” or looks broken with an optimization plugin

Two optimizations can affect it: Delay JavaScript execution starts scripts only at the first mouse move or tap, and Remove unused CSS strips the styles of elements the game creates later. Lusus excludes itself automatically in WP Rocket, LiteSpeed Cache and Perfmatters. With other plugins, exclude lusus-loader and zacGameConfig from JavaScript delay, and the folder wp-content/plugins/lusus/css/ from unused CSS removal.

The game doesn’t appear

Check that the page was saved with the shortcode, then purge your cache. After changing settings or updating Lusus, purge the page cache too.

Players’ emails are not being saved

The global leaderboard must be on, and the player must enter a valid email (an invalid one makes the field shake) and tick the consent box. If the server refuses a save, the player sees why.

Several players on the same network get “please wait”

Each address can save 5 scores every 10 seconds, and the game retries by itself. Behind a proxy or CDN, declare it with lusus_trusted_proxies (Chapter 15).

The Super Bonus is a white cube

The image could not be used as a 3D texture — see the note in Chapter 12.

Scores are much higher than before

Combos (up to ×4) and the bomb, new in 2.0.9. Check your coupon’s Minimum Score, or switch them off in Features → Gameplay.

Can I put the game twice on the same page?

No: one [lusus] per page. It adapts to every screen by itself (Chapter 7).

25 — Changelog

Version	Highlights
2.0.9	Combo multiplier and close calls; bomb power-up; animated start and Game Over screens; new glass HUD; best combo in the summary. Consent checked by the server and stored with each score; WordPress privacy tools and policy text; shortcodes (signup forms) in the Game Over banner; WPML and Polylang; automatic exclusions for cache plugins. Security and reliability fixes.
2.0.8	Mouse controls; rewritten soundtracks; moderation with pages and a Pending view; saves that survive page caches; works with site storage blocked; phone layout fixes; complete Italian translation.
2.0.7	Pause and full screen; limited shots; shield and shots power-ups; neon barriers; procedural scenery; end-of-game summary; impact effects and new sounds; adaptive resolution; a much lighter, faster engine.
2.0.6	Touch and animated GIF fixes; font uploads for administrators only; lighter memory use; tested up to WordPress 7.1.
2.0.5	Clear errors when a score cannot be saved; keyboard fixes; rate-limited coupons; tap-to-retry if the engine fails to load.
2.0.4	3D engine loaded on demand; neon loading screen; placeholder in the Elementor editor; coupon served only to winners; anti-spam hardening; safer CSV export.
2.0.3	Smoother play under heavy action.
2.0.0 – 2.0.2	Freemius licensing and automatic updates; Base Style applied on new installs.

A — Complete Settings Reference

All 128 options with their default values, grouped as in Lusus → Game Settings. Option keys use the zac_ prefix. These are the plugin’s built-in defaults: a new install applies the Base Style preset on top (soundtrack, colors, fonts, logo) and switches on the global leaderboard.

Branding

Setting	Key	Default
Game Title	`zac_game_title`	`LUSUS`
Subtitle / Author	`zac_game_subtitle`	`Customizable 3D game widget`
Primary Font (UI, Titles)	`zac_font_primary`	`Orbitron`
Primary Font (UI, Titles) — source	`zac_font_primary_source`	`google`
Primary Font (UI, Titles) — uploaded file	`zac_font_primary_custom_url`	—
Primary Font (UI, Titles) — weight	`zac_font_primary_weight`	`700`
Primary Font (UI, Titles) — letter spacing	`zac_font_primary_letterspacing`	`0`
Primary Font (UI, Titles) — text transform	`zac_font_primary_transform`	—
Secondary Font (Text, Author)	`zac_font_secondary`	`Rajdhani`
Secondary Font (Text, Author) — source	`zac_font_secondary_source`	`google`
Secondary Font (Text, Author) — uploaded file	`zac_font_secondary_custom_url`	—
Secondary Font (Text, Author) — weight	`zac_font_secondary_weight`	`400`
Secondary Font (Text, Author) — letter spacing	`zac_font_secondary_letterspacing`	`0`
Secondary Font (Text, Author) — text transform	`zac_font_secondary_transform`	—
Custom Logo	`zac_custom_logo`	—
Start Screen Logo (PNG/GIF)	`zac_start_logo`	—
Super Bonus Image (+150)	`zac_super_bonus_image`	—

Colors → Theme Colors

Setting	Key	Default
Primary Color	`zac_primary_color`	`#5535FF`
Secondary Color	`zac_accent_color`	`#FF8C00`
Background Color & Opacity	`zac_bg_color`	`#161616`
Background Color & Opacity — opacity (%)	`zac_bg_opacity`	`100`
Text & Laser Color	`zac_ui_text_color`	`#FFFFFF`
Subtitle Color	`zac_subtitle_color`	`#aaaaaa`

Colors → UI Element Colors

Setting	Key	Default
Window Background & Opacity	`zac_overlay_bg_color`	`#161616`
Window Background & Opacity — opacity (%)	`zac_overlay_opacity`	`45`
Window Backdrop Blur (px)	`zac_overlay_blur`	`20`
Window Border Color	`zac_overlay_border_color`	—
Container Border Color	`zac_border_color`	—
Instruction Text Color	`zac_instruction_text_color`	`#CCCCCC`
Input Background Color	`zac_input_bg_color`	`#000000`
Input Text Color	`zac_input_text_color`	`#FFFFFF`
Button Background	`zac_btn_bg_color`	—
Button Hover Background	`zac_btn_bg_hover_color`	—
Button Text Color	`zac_btn_text_color`	`#FFFFFF`
Button Hover Text Color	`zac_btn_hover_text_color`	`#000000`
Privacy Text Color (GDPR)	`zac_privacy_color`	`#FFFFFF`

Colors → Game Scene Colors

Setting	Key	Default
Scrolling Grid Color	`zac_grid_color`	—
Wireframe Column Color	`zac_pillar_color`	—
Ship Shadow Color	`zac_shadow_color`	`#000000`
Triple Laser Cube Color	`zac_triple_laser_color`	`#FFFFFF`

Colors → Leaderboard Colors

Setting	Key	Default
Final Score Color	`zac_final_score_color`	—
Player Names Color	`zac_leader_name_color`	—
Record Row Background	`zac_record_bg_color`	`#000000`

Layout & Effects → Layout & Borders

Setting	Key	Default
Container Border Radius (px)	`zac_border_radius`	`0`
Container Border Width (px)	`zac_border_width`	`2`
Window Border Radius (px)	`zac_overlay_border_radius`	`24`
Window Border Width (px)	`zac_overlay_border_width`	`2`
Button Border Radius (px)	`zac_btn_border_radius`	`12`
Leaderboard Container Radius (px)	`zac_leader_box_radius`	`15`
Leaderboard Container Border (px)	`zac_leader_box_border`	`1`
Leaderboard Row Radius (px)	`zac_leader_item_radius`	`8`
Leaderboard Row Border (px)	`zac_leader_item_border`	`1`
Neon Glow Intensity (%)	`zac_neon_intensity`	`100`

Layout & Effects → Decorative Asteroid

Setting	Key	Default
Enable	`zac_enable_hero`	On
Size (px)	`zac_hero_size`	`340`
Horizontal Position	`zac_hero_right`	`50`
Vertical Position	`zac_hero_bottom`	`50`

Layout & Effects → Display

Setting	Key	Default
Full Screen Button	`zac_enable_fullscreen`	On
Adaptive Resolution	`zac_adaptive_quality`	On
Animated Screens	`zac_animated_screens`	On

Layout & Effects → Audio

Setting	Key	Default
Built-in Soundtrack	`zac_builtin_track`	`none`
Custom MP3 (override)	`zac_bg_music`	—
Music Volume (%)	`zac_bg_music_volume`	`50`

Text & Labels

Setting	Key	Default
Score Label	`zac_txt_score_label`	`POINTS:`
Start Button	`zac_txt_btn_start`	`START GAME`
Restart Button	`zac_txt_btn_restart`	`RESTART GAME`
Leaderboard Entry Message	`zac_txt_leader_entry_msg`	`You made it into the top pilots leaderboard`
Instructions Title	`zac_txt_instr_title`	`FLIGHT CONTROLS`
Instructions Text	`zac_txt_instr_body`	`WASD, ARROWS or MOUSE to move - SPACE or CLICK for Laser - P to pause`
Leaderboard Title (Start)	`zac_txt_leader_start`	`PERSONAL RANKING`
Leaderboard Title (End)	`zac_txt_leader_end`	`PERSONAL RANKING`
Empty Leaderboard Text	`zac_txt_leader_empty`	`NO SCORES YET`
Game Over Title	`zac_txt_game_over`	`GAME OVER`
Name Placeholder	`zac_txt_input_placeholder`	`Your Name`
Email Placeholder	`zac_txt_input_email_placeholder`	`Your Email`
New Record Text	`zac_txt_new_record`	`NEW RECORD`
Bonus Text (+50)	`zac_txt_bonus_flying`	`+50 BONUS`
Super Bonus Text (+150)	`zac_txt_super_bonus_flying`	`SUPER BONUS +150`
Penalty Text (-50)	`zac_txt_penalty_flying`	`PENALTY -50`
Triple Laser Text	`zac_txt_triple_laser_flying`	`TRIPLE LASER 15s!`
Speed Level 1 Text	`zac_txt_speed_1`	`SPEED 1`
Speed Level 2 Text	`zac_txt_speed_2`	`SPEED 2`
Speed Level 3 Text	`zac_txt_speed_3`	`SPEED 3`
Pause Title	`zac_txt_paused`	`PAUSED`
Resume Button	`zac_txt_btn_resume`	`RESUME`
Out of Shots Text	`zac_txt_no_ammo`	`NO AMMO`
Shield Text	`zac_txt_shield_flying`	`SHIELD ON`
Shots Reloaded Text	`zac_txt_ammo_flying`	`+{n} SHOTS`
Bomb Text	`zac_txt_bomb_flying`	`BOMB!`
Combo Label	`zac_txt_combo`	`COMBO`
Close Call Text	`zac_txt_close_call`	`CLOSE CALL`
Summary: Time Label	`zac_txt_sum_time`	`TIME`
Summary: Asteroids Label	`zac_txt_sum_destroyed`	`ASTEROIDS`
Summary: Accuracy Label	`zac_txt_sum_accuracy`	`ACCURACY`
Summary: Near Misses Label	`zac_txt_sum_grazes`	`NEAR MISSES`
Summary: Best Combo Label	`zac_txt_sum_combo`	`BEST COMBO`

Features → Gameplay

Setting	Key	Default
Shots Available	`zac_ammo_max`	`100`
Asteroids Break Apart	`zac_asteroid_split`	On
Shield & Shots Power-ups	`zac_powerups`	On
Neon Barriers	`zac_barriers`	On
Combo & Close Calls	`zac_combo`	On
Bomb Power-up	`zac_bomb`	On
End-of-Game Summary	`zac_enable_summary`	On
Mouse Controls	`zac_mouse_control`	On

Features → Global Leaderboard

Setting	Key	Default
Enable	`zac_enable_global_leaderboard`	Off
Leaderboard Title	`zac_global_lb_title`	`GLOBAL RANKING`
Players Shown	`zac_global_lb_limit`	`10`
Maximum Score (Anti-Cheat)	`zac_max_score_allowed`	`1000000`
Privacy Consent Text (GDPR)	`zac_privacy_text`	`I consent to email processing for the leaderboard`
Privacy Policy URL	`zac_privacy_url`	—

Features → News Ticker

Setting	Key	Default
Enable News Ticker	`zac_enable_news_ticker`	Off
Message 1 (primary color)	`zac_news_text_1`	`Sign in with your email to save your score and enter the World Rankings`
Message 2 (accent color)	`zac_news_text_2`	`You can change your name every time you set a new high score!`

Features → Coupon Reward

Setting	Key	Default
Enable Coupon Reward	`zac_enable_coupon`	Off
Minimum Score to Unlock	`zac_coupon_min_score`	`0`
Coupon Code	`zac_coupon_code`	—
Reward Heading	`zac_coupon_heading`	`You earned a reward!`
Reward Message	`zac_coupon_message`	`Use this code at checkout`
CTA Button Text	`zac_coupon_cta_text`	`SHOP NOW`
CTA Button URL	`zac_coupon_cta_url`	—
Expiry Info (optional)	`zac_coupon_expiry_text`	—

Features → Game Over Banner

Setting	Key	Default
Enable Banner	`zac_enable_gameover_banner`	Off
Banner HTML Content	`zac_gameover_banner_html`	—

Features → Email Notification

Setting	Key	Default
Enable Email Notification	`zac_enable_email_notify`	Off
Recipient Email	`zac_email_notify_to`	—
Email Subject	`zac_email_notify_subject`	`Lusus: New score from {name}`

Features → Webhook

Setting	Key	Default
Enable Webhook	`zac_enable_webhook`	Off
Webhook URL	`zac_webhook_url`	—