godot-mechanic-secrets

Implements cheat codes, hidden interactions, and persistent meta-unlocks in Godot games.

Updated Aug 22, 2026
One-click install
npx skills add https://github.com/DecioLuvier/Shatterless --skill godot-mechanic-secrets-decioluvier
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: godot-mechanic-secrets
Source: https://github.com/DecioLuvier/Shatterless/tree/main/.claude/skills/godot/references/godot-mechanic-secrets
Command: npx skills add https://github.com/DecioLuvier/Shatterless --skill godot-mechanic-secrets-decioluvier

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Adding Easter eggs, cheat codes, and hidden content to a Godot game involves tricky problems: reliable input sequence detection, anti-brute-force protection, and meta-progress that survives save-slot deletion. This Skill provides proven GDScript patterns for each trigger type so secrets work correctly without frame-polling bugs or lost unlocks. ## Core Features & Use Cases - Trigger Decision Tree: Maps each secret type (Konami combos, spam thresholds, look-at detection, progress-% unlocks, random encounters) to a dedicated script such as secret_sequence_combo_matcher.gd or secret_visibility_detector.gd. - Meta Persistence: Saves gallery and achievement flags in user://secrets.cfg via secret_meta_persistence.gd so unlocks survive save-slot deletion. - Anti-Cheat & UX Rules: Lockout guards against macro brute-forcing, dot-product look-at detection instead of expensive raycasts, and glimmer/audio cues for discovery feedback. - Use Case: Add a Konami code that unlocks God Mode by attaching SecretSequenceComboMatcher to your GameManager, connecting combo_achieved, and persisting the flag with SecretMetaPersistence.unlock_secret. ## Quick Start Ask the AI to add a Konami-style cheat code to your Godot project using the secret sequence combo matcher with meta persistence.

Frequently Asked Questions about godot-mechanic-secrets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a Konami code cheat to my Godot game?▼

Attach SecretSequenceComboMatcher as a child of your GameManager or Player, define the button sequence in its sequences dictionary, and connect the combo_achieved signal. It uses a time-windowed event-based buffer rather than _process polling, so fast inputs are captured reliably.

How to detect if the player is looking at a hidden wall in Godot?▼

Use dot-product look-at detection via secret_visibility_detector.gd instead of physics raycasts. Comparing the camera forward vector against the direction to the target is far cheaper than per-frame raycasts when many hidden objects exist.

How do I keep secret unlocks after a player deletes their save file?▼

Store meta-progress in a dedicated user://secrets.cfg file using secret_meta_persistence.gd, separate from per-slot save data. Deleting a save slot then leaves gallery flags and achievement unlocks intact.

How do I prevent players from brute-forcing cheat codes with macros?▼

Use secret_lockout_cheat_guard.gd, which adds a lockout penalty after excessive failed attempts. Without it, a simple macro can brute-force a short button combo in seconds.

Can cheat unlocks be trusted in a Godot multiplayer game?▼

No, client-side cheat validation is unsafe in peer-to-peer games. If a secret grants stat boosts or items, peers must validate the unlock before applying combat or economy advantages, as covered by the godot-adapt-single-to-multiplayer skill.

Why should hidden walls not look identical to normal walls?▼

Completely invisible secrets feel like bugs rather than discoveries. Add a subtle glimmer effect or texture discrepancy using secret_vfx_discovery_glimmer.gd so observant players get a fair hint.