Game Concept QR Critters

A mobile game where real-world QR codes become unique, collectible creatures.

1. Core Idea

Core Mechanic: Players scan any real-world QR code to generate a unique creature or item. The generation process is deterministic—the same QR code will always produce the same result.
Unique Scans: Each QR code can only be scanned once per player. The app stores a hash of the scanned code (locally or on a server) to prevent duplicates.
Game Objective: Collect creatures, build a team, and engage in PvP/PvE battles. The game encourages real-world exploration by having players hunt for new QR codes, without relying on geolocation.
Genre: A casual, offline-friendly mix of Pokémon GO (collecting), Tamagotchi (customization), and roguelite games (procedural generation).
The Hook: The motivation to explore the real world in search of new QR codes, providing a potentially infinite stream of unique content.

Creatures are procedurally generated based on a hash (e.g., SHA-256) of the scanned QR code. This hash acts as a seed for all randomized values.

Visual Traits:
- Color Palette: A creature's color scheme is generated from a segment of the hash (e.g., the first 6 characters become a hex code like #A1B2C3).
- Body Parts: A vast pool of predefined assets (ears, eyes, tails, teeth) is randomly selected. Examples include dragon ears, elven ears, cat-like ears; or vampire, shark, and rabbit teeth.
- Accessories: Items like hats, glasses, earrings, bowties, and clothing pieces (e.g., a samurai's armor, a cyberpunk jacket).
- Costumes: Rare, full-body outfits inspired by pop culture or mythology (e.g., a superhero suit, a Darth Vader costume, a Minotaur's armor), primarily available through special events.
Rarity Tiers: The creature's rarity (e.g., Common, Rare, Legendary) is determined by a mathematical operation on the hash (e.g., hash % 100). Rarer creatures have access to unique body parts and better base stats.
Combinations: Thanks to the modular design and a large asset library, the system can generate billions of visually unique creatures.

Base Stats: Every creature has a set of core stats (HP, Attack, Defense, Speed, Special) whose initial values are generated from the QR hash.
Trait-Based Modifiers: A creature's appearance directly influences its stats. For example, dragon ears might grant a +10% Attack bonus, while a pirate hat could add +5 Speed.
Elemental Types: Each creature is assigned an elemental type (e.g., Fire, Water, Nature), also derived from the hash. Types follow a rock-paper-scissors system of strengths and weaknesses (e.g., Fire deals 1.5x damage to Nature).
Progression:
- Leveling: Creatures gain EXP from battles, leveling up to increase their stats.
- Evolution: Upon reaching a certain level, a creature can evolve, changing its appearance and receiving a significant stat boost. The evolutionary form is also determined by the original hash.
- Breeding: Players can breed two creatures to create a new one. The offspring inherits traits and stats from its parents based on a combination of their hashes.
- Items: Scanning certain QR codes can yield consumable items that provide temporary buffs in battle.

Collection: All captured creatures are stored in a digital "Codex." Players are rewarded with achievements for completing collection milestones.
Trading: Players can trade creatures with each other either locally (via Bluetooth) or online.
Combat System:
- Style: Turn-based combat where turn order is determined by the Speed stat.
- Actions: Players choose from available actions: Physical Attack, Special (Elemental) Attack, Defend, or Use Item.
- Game Modes:
  - PvE: Battle against "wild" creatures generated from random QR codes or encounter them in story-driven quests.
  - Local PvP (BLE): To initiate a battle, one player generates a temporary QR code on their screen. The opponent scans it, which establishes a direct Bluetooth Low Energy (BLE) connection for the match.
  - Online PvP: Standard matchmaking for ranked or casual battles via a central server.

Generation Pipeline: QR Content -> SHA-256 Hash -> Seed for RNG -> Trait & Stat Selection.
Multiplayer Architecture:
- Offline (BLE): Utilizes Bluetooth Low Energy for local, internet-free interactions like battles and trades.
- Online: A server backend (e.g., Firebase or Photon) supports global trading, online matchmaking, and data synchronization.
Privacy & Security: The app only hashes the content of the QR code. It does not read, interpret, or store any personal data that might be embedded in it. User consent will be required for features like Bluetooth.