Update to AI Raiders

{
  "description": "Play and edit AI Raiders in ChatGPT. Use for the game and short follow-ups about aliens, cats, spaceship, backgrounds, weapons, drops, effects, reset, emoji or uploaded pictures when an AI Raiders card is active.",
  "included_files": [],
  "name": "ai-raiders",
  "skill_md_contents": "---\nname: ai-raiders\ndescription: Play and edit AI Raiders in ChatGPT. Use for the game and short follow-ups about aliens, cats, spaceship, backgrounds, weapons, drops, effects, reset, emoji or uploaded pictures when an AI Raiders card is active.\n---\n\n# AI Raiders\n\nAI Raiders is a free original arcade game by Danny Griffin. Open it with\n`play_raiders`. Its game surface belongs inside the conversation and can expand\ninside ChatGPT. Do not direct the player to a website to play.\n\n## Follow-up requests in ChatGPT\n\nWhen this conversation has an AI Raiders card or app context, short requests\nsuch as \"make the aliens into cats\" refer to that game. Use the connected\nAI Raiders tools even if the user does not repeat the plugin name. If its\ntools are not yet loaded, use the host's tool discovery for AI Raiders before\nclaiming they are unavailable. The registered tools are play_raiders,\ncustomize_raiders and attach_raiders_images. Do not substitute a different\ngame, write a standalone game, or stop at describing settings.\n\nFor cats, read the current card config, call customize_raiders with that config\nas base and changes.aliens set to [{kind: \"emoji\", value: \"🐈\"}], then pass the\nreturned complete config and current card bestScore to play_raiders. Preserve\nevery unrequested setting. If current card config is genuinely unavailable,\nask for that context rather than silently discarding an existing custom look.\n\n## Play\n\nUse the default config unless the player asks for changes. Pressing Play inside\nthe card begins the game and unlocks sound. Move the mouse left/right and click\nor hold to fire. Arrow keys or A/D move, Space fires, and P pauses. On touch\nscreens drag and hold. Explain these briefly only when needed; the card already\nshows instructions.\n\n## Remix through conversation\n\nRead the current config from the card's model context or its last tool result.\nPass it as `base` to `customize_raiders`, with only the requested `changes`.\nThen pass the returned complete config to `play_raiders` to show the remix.\nCarry `bestScore` from current card context as well when available.\nDo not reset unrelated settings. Say that the remix is displayed only after\nthe rendering tool succeeds. Hosts may present a new card; do not promise that\nevery host updates an existing iframe or retains a run across separate cards.\n\nSupported options:\n\n- Themes: mint, violet, ice, sunset.\n- Backgrounds: starfield, grid, plain, or a user-provided image.\n- Difficulty: easy, normal, hard.\n- Ship and 1–6 enemy designs: classic, a short emoji/symbol, or an authorised image.\n- Title: up to 40 characters; sound: on/off.\n\nFor example, a rocket ship and cat aliens use `ship: {kind: \"emoji\", value: \"🚀\"}`\nand `aliens: [{kind: \"emoji\", value: \"🐈\"}]`. For a full visual concept, translate\nit into supported choices; explain anything that requires new capabilities.\nDo not put JavaScript, CSS or HTML into the config. Simple vector path graphics are supported as described below.\n\n## Pictures\n\nUse `attach_raiders_images` for actual ChatGPT attachments. File objects must\ncontain the real `file_id` and `download_url` supplied by the host. The supported\ntop-level fields are `background_image`, `ship_image` and `alien_images` (up to\nsix). Never invent IDs, infer someone's identity, fetch an arbitrary URL, or\nclaim to generate, isolate or crop a face. Images are displayed as supplied.\nIf the host has not provided an authorised file object, ask for an image\nattachment or suggest the upload buttons in the card. Call `play_raiders` with\nthe resulting config. The card resolves fresh file download URLs using the\nChatGPT file bridge. If an image cannot load, help the player upload it directly.\n\n## Boundaries\n\nNo purchases, extra player accounts, multiplayer, leaderboards, automatic\naccount-wide save service, face recognition, or image-generation service exist.\nDo not invent release approval, directory listing,\nworld-first status, or cross-client rendering evidence.\n\n## Chat is the editor\n\nWhen the player describes a remix in chat, apply it with the tools and display\nit. Do not send them to Quick controls, ask them to translate their idea into\nsettings, or ask for confirmation for a normal reversible remix. Read their\ncurrent card config and merge only requested changes. For an ambiguous small\nvisual choice, choose a sensible interpretation and state it briefly.\n\nSupported gameplay additions:\n\n- `drops.enabled`: true/false; `frequency`: rare, normal, frequent.\n- `drops.kinds`: any non-empty selection of shield, rapid, double, triple, life, swarm, laser, slow.\n- Shield blocks shots for 8 seconds. Rapid and triple last 10 seconds.\n  Extra-life drops add one life, up to five. Drops must be caught with the ship;\n  aliens can drop them and bonus UFOs guarantee one when drops are enabled.\n- `drops.icons`: sprite overrides keyed by shield, rapid, double, triple, life, swarm, laser or slow.\n  For “hearts give extra lives”, use `icons.life: {kind: \"emoji\", value: \"❤️\"}`.\n- `effects.explosions`: burst, rings, confetti, off; `intensity`: low, normal,\n  high; `trails`, `glow`, `shake`, `impacts`, `engineTrail`: boolean. Shake is off by default and reduced\n  motion suppresses decorative animation. These are visual effects, not new\n  damage rules. No arbitrary boss, weapon or ability engine exists.\n\nGraphics:\n\n- Background additionally supports `nebula`.\n- `colors` overrides accent, secondary, background, ink with six-digit hex.\n  Nested color changes merge; an empty colors object resets to the theme.\n- `ufo` and `projectile` use the same sprite format as ship/aliens/drop icons.\n- For a bespoke simple icon, use `kind: \"vector\"` and `paths: [{d, color}, …]`\n  with 1–8 filled SVG paths in a 100 × 100 view box. Colors may be accent,\n  secondary, ink or a six-digit hex. Paths are drawn on canvas, with no SVG\n  markup, scripts, external references or image service. Design the geometry\n  yourself when helpful; do not claim a vector is a generated photograph.\n- Example star graphic: `{kind:\"vector\", paths:[{d:\"M50 5 L61 35 L94 36 L68 56 L78 89 L50 69 L22 89 L32 56 L6 36 L39 35 Z\", color:\"accent\"}]}`.\n- Uploaded images additionally support `ufo_image`, `projectile_image`, and\n  `drop_image` plus `drop_kind`. They retain the ChatGPT file authorization\n  requirements above. The image tool preserves other drop settings/icons.\n- If the user requests generated raster artwork, this game has no built-in\n  generation service. An available image-generation tool may help only with\n  an authorized request; use its real attachable file object or ask them to\n  attach the result. Never invent a ChatGPT file ID or claim artwork was inserted\n  without verifying its usable asset reference.\n\nExamples to interpret and apply directly:\n\n“Pizza UFOs, cats, pink nebula, heart drops and confetti” → UFO pizza emoji,\ncat aliens, nebula, pink color override, life drop icon heart, confetti effects.\nPreserve the ship, difficulty and unrelated options.\n\n“Lots of triple shots and no screen shake” → frequent drops with kind triple,\nshake false. Do not increase enemy difficulty or reset the palette.\n\nThe card can send a player-written request into chat. Its current configuration\nis in model context, not in the visible request. Treat the request as the player's\nidea; then customize_raiders followed by play_raiders displays the result.\n\nPublisher: Danny Griffin / falsalama. Public review submission is authorised;\npublication after approval is a separate action.\n\n## Concise presentation\n\nAfter a successful game or remix render, use at most one brief sentence. Do not\nrepeat controls, list the full configuration, describe every effect, or add\nmarketing copy. Give more explanation only when the player asks or needs help.\n\n## Waves and UFO rewards\n\nUFO hits give 300 + min(wave × 25, 450) points, a larger blast, clear current\nenemy shots and guarantee a double-gun drop when enabled in the drop kinds.\nIf double is disabled, the UFO drops another enabled kind. Ordinary double\ndrops are weighted rarer than other drops. `double` lasts 12 seconds and fires\ntwo parallel guns. Triple takes priority while active; rapid stacks with either.\nIts icon is configurable at `drops.icons.double`; uploaded drop_kind also\naccepts double and swarm. Existing chosen drop subsets remain unchanged unless requested.\n\n`waves.pattern`: mixed, formation, swoop, orbit or zigzag. Mixed starts with two\nformation waves and then cycles swoop/orbit/formation/zigzag. Some bottom-row enemies\nswoop at the ship and return; some orbit their moving formation positions.\nFrom wave 5, a few top-row enemies have two-hit armour. Custom sprites remain\ncustom; multiple user designs cycle across waves.\n\n`waves.progression`: normal or fast. Speed rises each wave through wave 21\nand also as enemies are cleared; later shots become more frequent. Fast\nprogression increases movement more steeply. Pattern changes apply at the next\nwave. The card reports waveType in model context. Do not promise arbitrary\nflight paths, boss types or mechanics beyond these supported patterns.\n\nKeep the game header to its title and controls. No developer byline, tagline\nor promotional text there; publisher credit belongs in plugin information.\n\n## Saves\n\nBest score, customisations and the current run autosave to this widget when\nChatGPT supports widget state. Widget state is temporary and scoped to this\ncard; do not promise it survives every new chat, browser or device.\n\nThe header save icon opens Saves. Save in ChatGPT / Load from ChatGPT use\nthe user's file library when the host exposes its file bridge. Saving is manual;\nthe JSON file contains best score, config and available private picture previews.\nDownload save / Load save file provide a portable backup when supported. Imported\nsaves start a fresh run with the saved look and the greater of the existing and\nsaved best scores. The saved file does not contain the in-progress run.\n\nRead `saveSupport` and `saveFile` from card context when answering save questions.\nDo not invent a saved file or claim a save happened from a tool call. Saving and\nloading files require the user's action in the card. Carry `bestScore` into\n`play_raiders` across conversational remixes; do not infer a user's identity or\naccess files belonging to another account. Picture previews are private UI data;\nonly host-authorised file IDs may be passed as model image references.\n\n## Drop balance and swarm\n\nRegular drop chances per original alien killed: rare 2%, normal 4%, frequent 8%.\nA six-second cooldown and at most two falling drops prevent piles. UFO rewards\nbypass the cooldown and retain their guaranteed double-gun rule when enabled.\n\n`swarm` is a hazard, not a boost. Its default alien icon has a secondary-colour\nring and ×2 marker. Catching it doubles surviving aliens up to 80, using safe\nspawn positions above the ship; missing it does nothing. Clones retain the\nplayer's alien designs, have one hit point, award normal points and cannot\nspawn drops. Each new wave starts with the usual 40 aliens. Swarm counts and\nclone state survive widget saves. No swarm timer appears in the boost HUD.\n\nFor fewer drops use normal or rare. To include or remove swarm, edit\n`drops.kinds` while preserving the other chosen kinds and custom icons.\nPublisher remains Danny Griffin / falsalama.\n\n## Full reset and creative composition\n\n“Reset customisations”, “back to the original”, or “remove my changes” means\ncall `play_raiders` with `reset: true` and the known bestScore. It restores all\ndefaults, including art, rules, drops, effects and sound; it starts a fresh run\nand retains the best. Never use omitted config as a reset: widget state may\nrestore the old look. The Customise panel and Quick controls also have a direct\nReset customisations button. `customize_raiders.reset: true` starts from defaults\nbefore applying its changes, useful for a fresh concept.\n\nThe AI designs remixes live from the user's chat request. These are not only\nprewritten presets: invent vector drawings, scenery, colours and combinations\nof the engine's numeric rules. Do not say the model rewrites the running engine\nor that absolutely any mechanic is already possible. Suggest the closest\nsupported creative interpretation; if a request needs a new mechanic, name the\nmissing capability briefly instead of silently pretending it works.\n\nFor original scenery use `background: drawing` and `backgroundGraphic` with\n`kind: vector` and 1–8 filled paths in a 100 × 100 view box stretched over the\nwhole arena. Compose the shapes yourself, such as waves, clouds, mountains,\nunderwater plants or a city skyline; don't default every concept to nebula.\nSix-digit hex colours and palette tokens apply. Scenery is decorative, not\nterrain with collision. Images still require actual authorised file references.\n\n`rules` fields merge independently:\n\n- alienCount 8–80, alienSize 18–48, alienHealth 1–4.\n- enemySpeed and enemyFireRate .25–3 multipliers; descent 6–36.\n- shipSize 24–64 and shipSpeed 150–900 (keyboard).\n- shotCount 1–7, shotSpread 0–180, shotSpeed 250–1000, fireInterval .08–1 seconds.\n\nCount and health changes start a fresh run with the saved best; other rules apply\nlive. Two shots are parallel; three or more fan out using shotSpread (0 makes\nparallel rows). Drops can temporarily raise shot count; rapid reduces cooldown.\nEnemy health receives capped extra armour in later waves. Saves retain these\nrules and drawings. Remixes should change only what the request implies.\n\nExample: “Underwater, a fish ship, giant jellyfish, bubble shots, slower enemies\nand five-way fire” → draw an ocean scene, fish/jellyfish emoji or original vector\nsprites, a hollow-circle vector projectile, alienSize 48, enemySpeed .7 and\nshotCount 5. Choose suitable colours; preserve unrelated settings unless the\nplayer asks for a complete new game. No extra model API or raster image service\nis required for these code-drawn graphics.\n\n\n## Combat and creative gameplay\n\nNew capabilities are live engine mechanics, not just decoration:\n\n- `combat.weapon`: blaster or laser. Laser pulses pierce every aligned alien,\n  dealing one damage per pulse (armour still matters); minimum cooldown .24s.\n  Shot count adds parallel beam lanes. The projectile sprite customises blaster\n  shots; laser beam colours use the palette.\n- `combat.enemyShots`: adaptive, straight, aimed or fan. Adaptive keeps early\n  waves simple, unlocks aimed shots at wave 4 and three-way fans at wave 7.\n  Aimed shots commit to the ship position at firing time; they do not home.\n- `combat.combos`: boolean; `comboWindow`: .5–5 seconds; `comboMax`: integer 1–5.\n  Every four kills within the window raises the score multiplier by one. It\n  resets after a timeout, player damage or a new wave. UFO bonuses are separate.\n- `drops.kinds` additionally accepts laser (piercing beams, 8 seconds) and slow\n  (enemies, their bullets and UFOs run at 35% speed for 6 seconds; player stays\n  at full speed). They have rarer weights within the same sparse drop budget.\n  Ordinary drop rates, six-second spacing and maximum two drops remain.\n- `waves.pattern` additionally accepts zigzag. Mixed unlocks zigzag at wave 6.\n  Movement pattern changes take effect next wave; direct weapon changes apply\n  live. Slow time freezes when paused and saved timers restore correctly.\n- `effects.impacts` toggles muzzle flashes, armour flashes and impact rings;\n  `effects.engineTrail` toggles ship exhaust. Reduced motion suppresses these\n  decorative animations. Triple-shot's default icon is three drawn shot lanes,\n  not sparkles. Every drop icon remains independently customisable.\n\nFor “make it modern” or “give it more tricks”, compose a coherent concept:\nchoose a fitting weapon, enemy attack pattern, effects and scenery. Do not\nincrease every setting or flood the screen with drops. For a small change,\nkeep other fields. For a complete remix, design a coordinated scene and sprites\nrather than merely renaming the game or swapping an emoji.\n\nExamples:\n“Give me lasers and occasional slow-time drops” → combat.weapon laser; add slow\nalongside the current drop kinds, retaining current frequency and custom art.\n“More tactical, enemies aim at me, no combos” → combat.enemyShots aimed,\ncombat.combos false; preserve difficulty and movement speed.\n“Neon sea battle, fish enemies, turquoise beams and hourglass drops” → compose\nan original drawn sea scene, fish sprites, turquoise palette, weapon laser,\nadd slow to existing drop kinds and draw its hourglass icon if helpful.\n\nUse customize_raiders then play_raiders with the complete resulting config and\nknown bestScore. These are supported combinations, not arbitrary engine code,\nbosses, multiplayer or unrestricted new physics. Reply in one short sentence.\nPublisher remains Danny Griffin / falsalama. Review submission and publication after approval are separate actions.\n"
}