AI Raiders

View saved version →

---
name: 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.
---

# AI Raiders

AI Raiders is a free original arcade game by Danny Griffin. Open it with
`play_raiders`. Its game surface belongs inside the conversation and can expand
inside ChatGPT. Do not direct the player to a website to play.

## Follow-up requests in ChatGPT

When this conversation has an AI Raiders card or app context, short requests
such as "make the aliens into cats" refer to that game. Use the connected
AI Raiders tools even if the user does not repeat the plugin name. If its
tools are not yet loaded, use the host's tool discovery for AI Raiders before
claiming they are unavailable. The registered tools are play_raiders,
customize_raiders and attach_raiders_images. Do not substitute a different
game, write a standalone game, or stop at describing settings.

For cats, read the current card config, call customize_raiders with that config
as base and changes.aliens set to [{kind: "emoji", value: "🐈"}], then pass the
returned complete config and current card bestScore to play_raiders. Preserve
every unrequested setting. If current card config is genuinely unavailable,
ask for that context rather than silently discarding an existing custom look.

## Play

Use the default config unless the player asks for changes. Pressing Play inside
the card begins the game and unlocks sound. Move the mouse left/right and click
or hold to fire. Arrow keys or A/D move, Space fires, and P pauses. On touch
screens drag and hold. Explain these briefly only when needed; the card already
shows instructions.

## Remix through conversation

Read the current config from the card's model context or its last tool result.
Pass it as `base` to `customize_raiders`, with only the requested `changes`.
Then pass the returned complete config to `play_raiders` to show the remix.
Carry `bestScore` from current card context as well when available.
Do not reset unrelated settings. Say that the remix is displayed only after
the rendering tool succeeds. Hosts may present a new card; do not promise that
every host updates an existing iframe or retains a run across separate cards.

Supported options:

- Themes: mint, violet, ice, sunset.
- Backgrounds: starfield, grid, plain, or a user-provided image.
- Difficulty: easy, normal, hard.
- Ship and 1–6 enemy designs: classic, a short emoji/symbol, or an authorised image.
- Title: up to 40 characters; sound: on/off.

For example, a rocket ship and cat aliens use `ship: {kind: "emoji", value: "🚀"}`
and `aliens: [{kind: "emoji", value: "🐈"}]`. For a full visual concept, translate
it into supported choices; explain anything that requires new capabilities.
Do not put JavaScript, CSS or HTML into the config. Simple vector path graphics are supported as described below.

## Pictures

Use `attach_raiders_images` for actual ChatGPT attachments. File objects must
contain the real `file_id` and `download_url` supplied by the host. The supported
top-level fields are `background_image`, `ship_image` and `alien_images` (up to
six). Never invent IDs, infer someone's identity, fetch an arbitrary URL, or
claim to generate, isolate or crop a face. Images are displayed as supplied.
If the host has not provided an authorised file object, ask for an image
attachment or suggest the upload buttons in the card. Call `play_raiders` with
the resulting config. The card resolves fresh file download URLs using the
ChatGPT file bridge. If an image cannot load, help the player upload it directly.

## Boundaries

No purchases, extra player accounts, multiplayer, leaderboards, automatic
account-wide save service, face recognition, or image-generation service exist.
Do not invent release approval, directory listing,
world-first status, or cross-client rendering evidence.

## Chat is the editor

When the

Preview of the first 4,000 characters. Read full instructions →