A comprehensive integration guide for the Minijuegos.com LeChuck JS SDK to handle player authentication, achievements, and persistent game statistics.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install minijuegos-lechuck
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install minijuegos-lechuck using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Minijuegos LeChuck SDK Integration?
The Minijuegos LeChuck SDK Integration provides a standardized bridge between HTML5 games and the Minijuegos/Miniplay platform. This skill enables developers to implement secure player authentication via the platform's iframe architecture, ensuring that player progress, high scores, and achievements are correctly synchronized with the Minijuegos ecosystem.
By leveraging this integration, developers can overcome common pitfalls such as lost query parameters during server-side redirects and data loss during game-over events. It focuses on technical reliability, offering specific Nginx configurations and data-flushing strategies to ensure a robust connection between the game client and the Minijuegos backend, ultimately improving player retention through social features like leaderboards and achievements.
Minijuegos LeChuck SDK Integration Use Cases
- Authenticating players automatically when a game is loaded within a Minijuegos iframe.
- Synchronizing player statistics such as total kills, wins, or games played using the REPLACE type method.
- Unlocking platform-specific achievements to increase user engagement on the Miniplay portal.
- Preventing data loss on game-over screens by implementing critical request flushing techniques.
- Setting up a secure backend validation flow to register Minijuegos users in a custom database.
How Minijuegos LeChuck SDK Integration Works
- The game is loaded inside a Minijuegos iframe, passing user credentials via URL parameters.
- The Openclaw Skills logic initializes the LeChuck SDK and listens for the ready event to retrieve the user ID and token.
- The client sends these credentials to a custom backend for validation against the Minijuegos API using the secret API key.
- Upon successful validation, a session is established (typically via JWT) to allow secure score and stat reporting.
- During gameplay, the game calls SDK methods to track stats and unlock achievements.
- At the end of a session, the integration ensures all asynchronous HTTP requests are flushed before the game state resets.
Minijuegos LeChuck SDK Integration Setup
Client-Side Injection
Include the official SDK script in your HTML head:
<script src="https://ssl.minijuegosgratis.com/lechuck/js/latest.js"></script>
Environment Configuration
Set up your server-side environment variables:
export MINIPLAY_API_ID="your_numeric_id"
export MINIPLAY_API_KEY="your_secret_key"
export JWT_SECRET="your_secure_session_secret"
Nginx Configuration
Ensure query parameters are preserved during redirects:
location = / { return 301 /game/$is_args$args; }
Minijuegos LeChuck SDK Integration Data Schema & Taxonomy
The skill manages a specific set of metadata and database columns to ensure persistence across the Openclaw Skills ecosystem:
| Field | Type | Description |
|---|---|---|
| miniplay_id | VARCHAR(64) | Unique identifier for the Minijuegos user (Primary Key/Unique) |
| mp_api_user_token | String | Temporary token used for server-side authentication |
| stats.kills | Integer | Cumulative total of kills recorded |
| stats.plays | Integer | Cumulative total of game sessions |
| achievement_uid | String | Registered UID from the Minijuegos developer panel |
Minijuegos LeChuck SDK Integration Advanced Features
- Smart Portal Detection: Automatically identifies if the user is on the Spanish (Minijuegos) or International (Miniplay) version to adjust UI themes.
- Request Flushing Guard: Implements a 500ms safety window or sendBeacon fallback to prevent browser cancellation of stat updates.
- Synthetic Email Mapping: Automatically generates unique local emails for Minijuegos users to satisfy standard registration requirements.
- COEP Management: Provides specific Nginx headers to allow third-party SDK execution without triggering Cross-Origin isolation blocks.
SKILL.md
Loading
Related Openclaw Skills
Content Repurposer
The Content Repurposer transforms long-form articles, blogs, and transcripts into punchy, platform-optimized social media posts for LinkedIn, Twitter, and Instagram.
Techwrite: Deep Technical Writing Workflow
Techwrite is a professional-grade documentation engine that transforms complex technical concepts into actionable, high-precision prose for developers and stakeholders.
Serverless Deep Workflow
A comprehensive six-stage framework for designing, debugging, and scaling resilient serverless workloads across AWS Lambda, Azure Functions, and Google Cloud Functions.
Flight Itinerary OCR
A specialized OCR tool designed to extract structured passenger and flight data from airline transport electronic ticket itineraries.
Agent Browser
A high-performance headless browser CLI designed for AI agents using accessibility tree snapshots for deterministic element interaction.
Browser Automation
A comprehensive automation suite for programmatic web interaction, data extraction, and cross-browser testing.
Featured*
