Përshkrim
Shortcode Arcade Crypto Idle Game is a fully-featured crypto-themed idle clicker game from ZillHa Games — and every single feature is 100% free. No upgrades, no Pro version, no paywalls. Everything that was previously locked behind a premium license is now included for everyone.
Players grow a virtual crypto mining operation by clicking to generate in-game currency, purchasing upgrades, and unlocking passive income systems. The game is designed for fair, long-term progression, using a carefully tuned Elo scaling curve combined with a prestige (“Hard Fork”) system to prevent runaway inflation and repetitive upgrade stacking.
This plugin is self-contained and runs entirely inside WordPress, making it ideal for gaming sites, crypto communities, membership sites, or any site looking to boost player engagement. Want to see it in action? Visit ZillHa.com for live examples and setup guides.
Core Features:
- Click-to-Mine Gameplay – Generate in-game currency through active clicking
- Elo-Balanced Progression – Upgrade costs scale dynamically using a rating system for fair long-term play
- Multiple Upgrade Paths – Unlock and stack 10 production upgrades with diminishing returns
- Prestige System (“Hard Fork”) – Reset progress for permanent +10% production bonuses per level
- Auto-Save – Progress saves automatically at regular intervals
- Offline Progress – Earn passive income while away, capped at 48 hours
- Miner Timeout System – Passive miners pause after 48 hours of inactivity to keep leaderboards fair
- Anti-Bot Protection – Multi-button system with decoy detection (1, 2, or 3 button modes)
- White-Label Branding – Customize game title, currency name, coin image, colors, and all 10 upgrade names
- AI Storyline Popups – AI-generated narrative messages on upgrade unlocks and prestige events (optional, requires API key)
- Custom Theming – Full color scheme control via admin branding settings, applied live to the game
- Modern UI – Clean neon cyberpunk interface with Orbitron font
- Mobile Responsive – Fully playable on desktop, tablet, and mobile with touch support
Optional Advanced Features:
- Cloud Saves – Store player progress in the WordPress database (login required)
- Leaderboards – Rank players using prestige-weighted Elo scores
- Per-Difficulty Leaderboards – Separate Easy, Medium, and Hard rankings with tabbed display
- Custom Login Portal – Branded login, registration, and password reset pages via shortcodes
- Ad Integration – Optional ad placement via shortcode attribute or admin Ad Space
- REST API – Public endpoints for leaderboard and game data
- WordPress 7.0 AI Client – Optionally use the native WP 7.0 AI provider system instead of a direct API key
Gameplay Settings:
- Difficulty Level – Easy (0.6x) / Medium (0.8x) / Hard (1.0x) intensity
- Allow Player Difficulty – Let players choose difficulty (creates per-difficulty leaderboards)
- Button Mode – 1 (standard), 2 (1 real + 1 decoy), 3 (1 real + 2 decoys) anti-bot protection
- Movement Trigger – None / Click / Timer / Both (button position swapping)
- Enable Self-Reset – Let players start a new run keeping prestige and best score
- Ad Space – Optional ad HTML placement within the game
Timed Contests (Coming in v2.1):
- Create Contests – Set up timed competitions with custom names, start/end dates, and contest types (weekly, monthly, custom)
- Prize Management – Define 1st, 2nd, and 3rd place prizes for each contest
- Live Contest Leaderboards – Players compete in real time during active contests
- Automatic Winner Selection – System selects and records winners when a contest ends
- Achievement Tracking – Contest winners earn achievements stored in your database
- AI Storyline Integration – AI narrative popups automatically suppressed during active contests for fair play
Shortcodes:
Display the game:
[sacig_crypto_idle_game]
Display the game with custom ad code:
[sacig_crypto_idle_game ad_code=””]
Display the leaderboard (requires cloud saves):
[sacig_crypto_idle_leaderboard]
Display a branded login form:
[sacig_crypto_idle_login]
Display a branded registration form:
[sacig_crypto_idle_register]
Cloud Saves & Leaderboards:
When enabled in Settings Crypto Idle Game, cloud saves allow you to:
- Store player progress in your WordPress database
- Require user login for saving/loading games
- Enable competitive leaderboards
- Keep all player data on your own server
External Services
This plugin uses the following external services:
Google Fonts CDN
- Service: Google Fonts API
- Purpose: Loads custom fonts (Orbitron, Rajdhani) for game UI styling
- Endpoint: https://fonts.googleapis.com/
- Privacy Policy: https://policies.google.com/privacy
- Data Shared: Your IP address and browser information when loading fonts
- When Used: Only on pages where the game shortcode is displayed
- User Choice: No opt-out available (required for proper game display)
All font requests are made directly from the user’s browser to Google’s servers. No personal data is collected or stored by this plugin.
AI Storyline (Optional)
The AI Storyline feature is optional and disabled by default. When enabled:
- Service: Anthropic Claude Haiku 4.5, OpenAI GPT-4o Mini / GPT-5 Mini, or xAI Grok 4.1
- Purpose: Generates short narrative popup messages when players hit upgrade milestones
- Data Shared: Only the event type and upgrade name are sent (no user data, no personal information)
- When Used: Only when a player triggers an upgrade or prestige event and AI Storyline is enabled
- API Keys: Stored in WordPress options, never exposed to the frontend
- Caching: Responses cached for 24 hours — minimal API calls
- Fallback: If the API call fails, the popup is silently skipped — no errors shown to players
Credits
Developed by: ZillHa Games
Website: https://zillha.com
Privacy Policy
Shortcode Arcade Crypto Idle Game respects user privacy:
- Local saves are stored in browser localStorage
- Cloud saves (optional) are stored in WordPress custom tables
- No external analytics, tracking, or telemetry
- Site administrators retain full control over all stored data
Site owners are responsible for updating their privacy policy if cloud saves are enabled.
Instalim
Automatic Installation
- Log in to your WordPress admin panel
- Go to Plugins Add New
- Search for “Shortcode Arcade Crypto Idle Game”
- Click “Install Now” and then “Activate”
Manual Installation
- Download the plugin ZIP file
- Upload the
shortcodearcade-crypto-idle-gamefolder to/wp-content/plugins/ - Activate the plugin through the Plugins menu
After Installation
- Add
[sacig_crypto_idle_game]to any page or post - (Optional) Enable cloud saves and leaderboards in plugin settings
- (Optional) Add ad code using the shortcode attribute
PBR
-
Does the game save progress?
-
Yes. Progress is saved locally in the browser at regular intervals. Optional cloud saves can be enabled by the site administrator.
-
What’s the difference between local saves and cloud saves?
-
Local Saves: Stored in the browser. No login required.
Cloud Saves: Stored in the WordPress database. Login required. Enables leaderboards. -
How do I enable the leaderboard?
-
- Go to Settings Crypto Idle Game
- Enable Cloud Saves
- Enable Leaderboards
- Add
[sacig_crypto_idle_leaderboard]to a page
-
Is the game mobile-friendly?
-
Yes. The interface is fully responsive and touch-friendly.
-
Where is player data stored?
-
Local saves are stored in browser localStorage. Cloud saves are stored in WordPress custom database tables when enabled.
-
Is it compatible with WordPress 7.0?
-
Yes. Version 2.0.0 is fully tested and compatible with WordPress 7.0, with all code updated to align with modern WordPress standards and best practices.
-
Does the plugin send data to external servers?
-
Only if the optional AI Storyline feature is enabled. When enabled, the upgrade event type
and upgrade name are sent to your configured AI provider (Anthropic, OpenAI, or xAI).
No user data or personal information is transmitted. The feature is disabled by default. -
Which AI providers are supported?
-
Claude Haiku 4.5 (Anthropic), GPT-4o Mini and GPT-5 Mini (OpenAI), and Grok 4.1 Fast (xAI).
You must supply your own API key in Settings AI Storyline. -
When will Timed Contests be available?
-
The full Contest system — including timed competitions, prize management, live leaderboards,
and automatic winner selection — is planned for version 2.1. Follow
ZillHa.com for release announcements.
Shqyrtime
Për këtë shtojcë s’ka shqyrtime.
Kontribues & Zhvillues
“Shortcode Arcade Crypto Idle Game” është software me burim të hapur. Në këtë shtojcë kanë dhënë ndihmesë personat vijues.
KontribuesPërkthejeni “Shortcode Arcade Crypto Idle Game” në gjuhën tuaj.
Ju intereson zhvillimi?
Shfletoni kodin, shkarkoni depon SVN, ose pajtohuni përmes RSS-je te regjistri i zhvillimeve.
Regjistër ndryshimesh
2.1.0
- NEW: Per-upgrade AI media — set a video or image URL per upgrade tier that plays before the AI narrative popup
- NEW: Phased AI popup — media plays first with a Skip button, then transitions to the AI text message
- NEW: Per-upgrade AI media URL fields in the AI Storyline admin settings
- NEW: Styled difficulty change confirmation modal replaces native browser dialog
- NEW: Styled self-reset (New Run) confirmation modal replaces native browser dialog
- NEW: UI label override system — all in-game text strings customizable via Branding settings
- NEW: Real button glow animation and decoy dim effect in multi-button anti-bot mode
- NEW: “Find the brighter coin!” click hint shown on first load in multi-button mode
- NEW: Decoy click shows animated ✗ indicator instead of text flash
- NEW: Absolute-position button movement with chaos jitter (triangle pattern in 3-button mode)
- NEW: Mobile double-tap zoom prevention on game container
- NEW: Footer {year} and {title} token substitution now works as advertised in Branding settings
- NEW: Currency symbol option wired to frontend game display
- NEW: Gold Bitcoin coin icon in WordPress admin sidebar menu
- FIXED: Miner status bar was completely unstyled — now shows active/stopped states with animations
- FIXED: Leaderboard difficulty tabs rendered but had no CSS styling — now fully styled
- FIXED: Login, registration, and forgot-password forms rendered completely unstyled
- FIXED: Offline earnings were incorrectly capped at 24 hours — corrected to 48 hours matching miner timeout
- FIXED: phpcs ignore comments lost during refactor — restored on all confirmed false positives
- UPDATED: Plugin rebranded to ZillHa Games — visit ZillHa.com for live examples and setup guides
- UPDATED: readme.txt description updated to reflect all features are 100% free
2.0.2
- NEW: Custom upgrade names via Branding settings (all 10 tiers)
- NEW: UI label system — game strings now localizable via PHP
- NEW: Leaderboard difficulty tabs when player difficulty is enabled
- NEW: Miner timeout — passive miners pause after 48 hours of inactivity, with an in-game Restart control
- FIXED: Branding upgrade names were hardcoded; now read from admin settings
- FIXED: Leaderboard showed flat list even when per-difficulty data existed
2.0.1
- NEW: Difficulty system (Easy/Medium/Hard) with per-difficulty leaderboards
- NEW: Player-selectable difficulty with separate competitive rankings
- NEW: Anti-bot button mode (1/2/3 buttons with decoys)
- NEW: Movement trigger system for button position swapping
- NEW: Self-reset feature preserving prestige and best scores
- NEW: Ad Space integration with sanitized HTML support
- NEW: AI Storyline wired to game frontend — popups now fire for players
- FIXED: DB schema updated with difficulty and per-difficulty best score columns
- FIXED: Cloud save now stores and returns player difficulty
- FIXED: Leaderboard supports per-difficulty filtering
2.0.0
- NEW: All features now free — no Pro version required
- NEW: Top-level admin menu with Arcade-themed UI
- NEW: Branding settings (game title, currency name, coin image, colors, footer) now apply to the live game
- NEW: Login and registration shortcodes — [sacig_crypto_idle_login] and [sacig_crypto_idle_register] — with configurable titles and redirects
- NEW: Leaderboard display settings (title, avatars, highlight color) now apply on the frontend
- NEW: Purple neon arcade admin design
- NEW: About page with shortcode reference and plugin info
- UPDATED: WordPress 7.0 compatibility confirmed
- FIXED: GitHub Actions deploy workflow env var correction
1.0.0
- Stable release
- Full WordPress 7.0 compatibility and compliance
- Code optimizations and quality improvements
- Tested and verified across all core gameplay and admin features
- Production-ready for wide distribution
0.4.6 – 2026-01-15
- Critical reviewer-risk cleanup and schema unification
- Fixed JS header and version metadata (0.4.0 0.4.6)
- Unified database schema column naming (total_currency total_satoshis)
- Updated all file headers to match exact plugin branding
- Removed legacy package references and outdated comments
- Added documentation for frontend globals and localStorage usage
- No gameplay changes or data migrations required
0.4.5 – 2026-01-15
- Completed full namespace and prefixing audit for WordPress.org compliance
- Updated all shortcodes to use sacig_ prefix for clear attribution
- Standardized all CSS classes, IDs, and JavaScript functions with sacig prefix
- Renamed asset files to match plugin namespace
- Removed legacy shortcode aliases per review guidelines
- No gameplay or data changes
0.4.4 – 2026-01-14
- Completed full namespace and prefix refactor using a unique
SACIGprefix - Renamed internal class files to match new naming conventions
- Updated root plugin loader to reflect new structure
- Verified compliance with WordPress.org Plugin Review requirements
- No gameplay changes
- No data migrations
0.4.3 – 2026-01-14
- Refactored plugin-specific functions, classes, constants, and options to use a uniform prefix
- Resolved naming collisions identified during manual review
- Corrected plugin ZIP filename to meet WordPress.org requirements
- No gameplay changes
0.4.2 – 2026-01-13
- Renamed plugin to Shortcode Arcade Crypto Idle Game
- Updated admin and frontend UI labels
- Updated readme, plugin headers, and branding
- No gameplay changes
0.4.0 – 2025-01-06
- Stable release
- Improved progression balancing
- Added prestige scaling refinements
- Improved admin UI clarity
- No breaking changes
0.3.4 – 2025-01-06
- Gameplay balance refinements
0.3.3 – 2025-01-04
- Fixed Plugin Checker and PHPCS warnings
- Improved database handling



