AI Collectibles

While Jacky runs in the background, he will occasionally spawn random collectible items on your screen. Click on one to add it to your permanent Collection — each item comes with unique AI-generated lore and rarity.

Collectible item floating on the desktop

How Collectibles Work

Spawning

Collectibles appear randomly based on two conditions:

• A spawn check runs approximately every 60 minutes.
• On each check, there is a 25% chance that an item spawns.

Sprites

There are 30+ different sprite types to discover, including:

...and many more surprises.

Each sprite has a unique icon and a localized display name. When a collectible spawns, it appears at a random position on your screen (at least 120px away from Jacky), bounces gently, and remains for up to 5 minutes before fading away.

Collecting an Item

When you click on a floating collectible:

1. Jacky enters a happy state and a thinking bubble appears.
2. Jacky sends the sprite name to the LLM to generate a unique card.
3. A Collectible Card dialog appears showing:

Rarity Levels

Collectibles come in five rarity tiers, each with a distinct color:

Rarity affects the card border color in both the collection dialog and the card popup.

Adding or Dismissing

On the card dialog, you have two choices:

• Add to Collection — saves the item permanently to your collection.
• Dismiss — discards the card. The item is lost forever.

Jacky will speak a line of dialogue in either case (e.g., "A new treasure for the collection!" or "Not this time...").

Collection Panel

Access your full collection from the context menu: right-click Jacky → Collection Panel.

The panel shows:

• Grid view of all collected items, sorted by rarity (legendary first).
• "NEW" badge on items collected within the last 24 hours.
• Rarity filter dropdown to show only items of a specific tier.
• Detail panel (right side) showing the full card when you click an item:
  • Large sprite preview (72px)
  • Name, stars, and rarity label
  • Full description / lore
  • Collection date
  • Delete button to remove the item from your collection

Collection Panel

Special Modes

Fallback System

If the LLM is unavailable or fails to generate a card, Jacky falls back to a pre-written catalog of humorous names and descriptions stored in fallbacks.json. These are localized to your language and drawn from a pool, so you'll still get a fun card even without an active LLM connection.

Evil Appearance Mode

When Jacky's appearance is set to Evil, all collectibles are forced to rarity 1 (Common). The card prompt is also tweaked with a darker, more mischievous tone.

Glitch Appearance Mode

When Jacky's appearance is set to Glitch, the collectible sprites display with a glitch distortion effect — scanline shifts, XOR block artifacts, and color offsets. The card prompt is adjusted to generate more chaotic, corrupted-sounding lore.

Persistence

All collected items are saved to collection.json in Jacky's user data directory. The file tracks:

• total_found — total number of items in your collection.
• collectibles — array of item objects, each containing:
  • id — unique hex identifier.
  • sprite — the sprite key (e.g., rubber_duck).
  • name — the LLM-generated name.
  • description — the LLM-generated lore.
  • rarity — integer 1–5.
  • obtained_at — UTC timestamp of collection.
  • times_seen — how many times this sprite type has been found.