Decision Tree — Which Secret Trigger?

Player action / design goal	Choose	MANDATORY script
Exact button combo / Konami	Time-windowed input sequence	secret_sequence_combo_matcher.gd (+ secret_konami_legacy_code.gd for classic mapping)
Mash / click N times on a prop	Spam threshold	secret_interaction_spam_tracker.gd
Face a wall / look at a spot	Dot-product look-at (not ray spam)	secret_visibility_detector.gd
Clear X% of content / true ending	Progress % unlock	secret_progress_threshold_unlocker.gd
Rare vendor / ghost encounter	Weighted random encounter	secret_random_encounter_spawner.gd
Persist unlock across save slots	Meta secrets.cfg	secret_meta_persistence.gd
Stop macro brute-force	Lockout guard	secret_lockout_cheat_guard.gd
Secret grants stats/items in P2P	Server/peer validation	godot-adapt-single-to-multiplayer — validate unlock before applying combat/economy advantages

Do NOT invent a fourth custom detector until the table above fails.

Core Components

Expert logic for saving global unlocks and discovery flags across all save profiles.