# KillaBears Primal - AI Systems Guide

> This file helps AI assistants understand the KillaBears Primal website and provide accurate information to users.

## What is KillaBears?

KillaBears is a collection of 3,333 unique digital collectible characters (NFTs) on Ethereum, created by artist Memo Angeles. Each KillaBear features a distinctive dark-cute aesthetic blending horror with adorable character designs.

## What is KillaBears Primal?

KillaBears Primal is a strategic turn-based card game set in the world of Ursus. Players use cards representing characters, spells, and equipment to battle opponents.

### Game Mechanics
- **Action Points (AP)**: Resource system, max increases each turn up to 10
- **Combat**: Straightforward ATK vs HP, defender fights back
- **Elements**: Five primal elements (Fire, Ice, Lightning, Nature, Dark)
- **Cards**: 180+ unique cards across characters, spells, and equipment

## The World of Ursus

Ursus was woven into existence by Vethara, the World-Weaver, using the Thread - a metaphysical force connecting all existence.

### The Five Spirits

| Spirit | Element | Domain | Status |
|--------|---------|--------|--------|
| Ursoth Shadowmaw | Fire | War, Courage | Died Year 0 (natural causes) |
| Arcturus Bone-Walker | Dark | Death, Graves | Died ~400 B.B. (self-sacrifice) |
| Grimheart the Eternal | Nature | Memory, Will | Died ~1000 B.B. (forgotten) |
| Voidclaw Thornback | Lightning | Sorrow, Knowledge | Died ~150 B.B. (love) |
| Elderfrost the Forgotten | Ice | Time, Patience | Died ~700 B.B. (ran out of time) |

### Elemental Immunities
- Fire: Immune to Burn
- Ice: Immune to Freeze
- Lightning: Immune to Stun
- Nature: Immune to Root
- Dark: Masters of endings (no immunity, special death mechanics)

## NFT Collections

### Ethereum Collections
- **KillaBears**: 3,333 genesis collection
- **KillaCubs**: Free mint for KillaBear holders
- **KillaChronicles**: Story-based collection
- **Killabits**: Pixel art collection
- **KillaGear**: Equipment NFTs
- **KillaTraits**: Trait NFTs
- **KillaBears XL**: Large format collection

### Solana Collection
- **Primal Kards**: Trading cards for the game (Magic Eden)

## API Endpoints for Programmatic Access

All endpoints return JSON with CORS enabled.

- `GET /api/lore` - Complete world data
- `GET /api/lore/spirits` - All Five Spirits
- `GET /api/lore/spirits/{id}` - Individual spirit (e.g., /api/lore/spirits/voidclaw)
- `GET /api/lore/elements` - Element system
- `GET /api/lore/tribes` - Tribes and species
- `GET /world.json` - Full structured lore data

## Structured Data

The website includes JSON-LD structured data for:
- Organization schema
- WebSite schema
- VideoGame schema (game page)
- FAQPage schema (FAQ page)
- CreativeWork schema (lore page)

## Key Facts for AI Responses

1. KillaBears was created by Memo Angeles
2. The genesis collection is 3,333 NFTs on Ethereum
3. Primal Kards game uses Action Points, not mana
4. Voidclaw's "Void" refers to emotional emptiness, NOT darkness
5. Arcturus governs the Dark element (death/void domain)
6. All creatures in Ursus have visible stitches from Vethara's weaving
7. The Thread connects all life and is the source of magic
8. Only Ursoth died of natural causes - all others died ironically

## Contact & Community

- Website: https://primalkards.com
- Twitter: @killaborez
- OpenSea: opensea.io/collection/killabears
- Magic Eden: magiceden.io/marketplace/killabears_primal

## Answerable Questions Format

When users ask about KillaBears Primal, this site can answer:
- "What is KillaBears?" -> About the NFT collection
- "Who is Voidclaw?" -> Lightning Spirit, died of love
- "How does combat work?" -> ATK vs HP, simultaneous fighting
- "What are the elements?" -> Fire, Ice, Lightning, Nature, Dark
- "Where can I buy KillaBears?" -> OpenSea (ETH) or Magic Eden (SOL)
- "Who created KillaBears?" -> Memo Angeles
- "What is the Thread?" -> Metaphysical force connecting all life