Skip to content
SpookyJumpyBeansPublic

About

Chrome/Edge extension for Krillion's Puffer Party: reads the category and suggests three obscure answers, skipping any already played this game. Bring your own OpenAI key or answer banks.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

21 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Krillify: deep cuts, quick picks. A glowing pufferfish in a pixel-art ocean.

Version 1.6.1 Works on Chrome and Edge Manifest V3 MIT license

Krillify

Krillify is an unofficial Chrome/Edge companion for Krillion's Puffer Party. It reads the category on the page and brings answer suggestions into the game, so you can stay focused on your turn.

Click a suggestion to fill the answer box, then submit it yourself. Krillify tracks your submitted answers for the current game and makes them available again in the next one.

v1.6.1 turns suggestions on at install and opens Settings with a short welcome, so new users can play straight away.

v1.6.0 prepares the Chrome Web Store release: verified answers now rank above every unverified guess, the shared bank covers 301 prompts, and the extension has its own icon.

v1.5.0 grounds the AI in game results: for each prompt it sees the answers the game accepted (with their tiers) and rejected, and is asked for real, standard names at that level of detail, facts it is sure of, and less common choices only within that list.

v1.4.0 learns from rejected answers: an answer the game says isn't on its list is never suggested again for that prompt, in later games or through the shared bank. Each accepted or rejected answer is now matched to its category exactly, and with the game feed connected your own submissions count only once the game accepts or rejects them.

v1.3.0 shipped a shared answer bank to every install, ranks answers by the rarity tiers seen in real games, and picks at random from the rarest few so players sharing the bank don't all give the same answers. The bank keeps three answers on screen and refills only the slot you used.

v1.2.0 added structured game-state detection with a DOM fallback, historical accepted-answer tracking, five original starter banks, and one bounded retry for a fast server failure. Rarity and acceptance remain estimates; this release has not been benchmarked against other extensions in live matches.

What it does

Feature Behavior
Automatic prompt detection Reads game snapshots/patches; falls back to the visible category
Three suggestions Shows three unused answers picked at random from the six rarest, rarest first
Click to fill Inserts an answer into the game box; you still press Enter
Game-scoped memory Excludes submitted answers and known aliases during the current game
Opponent tracking Reads accepted game events and bubbles, removes used suggestions, and fills the gaps
Local cache Keeps answer lists across games and browser restarts
Shared bank Prompts in extension/banks.json work for everyone, no key needed
Verified rarity Answers other players get accepted are saved with their tier and ranked by it
Starter banks Five exact prompts work without a key; acceptance unverified
Answer bank imports Supports your own JSON lists without an API key
On-page panel Drag it, minimize it, or pick the prompt manually

Install

No build step, package install, or server is needed.

  1. Download this repository using Code → Download ZIP, then extract it. You can also clone it:

    git clone https://github.com/SpookyJumpyBeans/krillify.git
  2. Open chrome://extensions in Chrome or edge://extensions in Edge.

  3. Enable Developer mode and click Load unpacked.

  4. Select the extension folder inside this repository. That is the folder containing manifest.json.

  5. Open Krillify from the browser's Extensions menu.

  6. Add your OpenAI API key, enable recommendations, and save. The default model is gpt-4.1-mini; your account must have access to the configured model.

  7. Refresh Krillion and enter a Puffer Party room.

The source is free. AI requests use your own API account and may incur charges. There are no shared keys or credits bundled in the extension. Without a key, prompts in the shared bank, five starter prompts, and your imported banks work locally. Starter prompts: "Name an insect", "Name an egg dish", "Name a country in East Africa", "Name something that uses steam", and "Name a building material". These original lists contain 57 candidates, ordered by estimated obscurity; they are not verified against the game's answer database.

During a game

  • Click an answer to fill the input. Filling or viewing a suggestion does not mark it used.
  • Submit in the game. With the game feed connected, an answer counts as used once the game accepts it or rejects it. The game ignores Enter when it isn't your turn, so those presses don't count. Without the feed, Krillify falls back to counting every Enter in the answer box, accepted or not.
  • Next 3 temporarily skips the current suggestions and offers another batch. It does not permanently exclude answers you only viewed.
  • New game, fresh used list. The helper uses the server game identity when available, with lobby, countdown, game-over and category-counter transitions as a fallback. Ordinary category changes keep the same game's list.
  • Refreshes in the same tab retain the game identity. Tabs observing the same server game share its used list; the DOM fallback uses a per-tab identity.
  • Pick prompt lets you click the category text if automatic detection misses it.

Opponents' accepted answers are tracked automatically. Krillify reads accepted answers from game snapshots/patches and watches accepted-answer bubbles, adds them to the same game-scoped exclusion list, removes only the matching visible suggestions (including known aliases), and fills each freed slot so three answers stay on screen. It also checks answers that arrive while a suggestion request is running. Typing previews, rejected guesses and chat do not count as opponent answers.

Structured tracking can recover earlier accepted answers included in the server event history when you join. If structured tracking is unavailable, tracking covers accepted bubbles rendered while the helper runs. A server history that has already been truncated cannot be recovered. Known aliases are matched; unknown alternate names can still slip through.

The shared bank

extension/banks.json ships with the extension, so every install can answer the prompts in it without an API key. It uses the same format as an imported bank, with an optional tier on each answer.

Verified answers. Every accepted answer in the game feed is saved with the rarity tier the game gave it (krillion, deepcut, rare, schooler, plankton, and so on). The feed marks each category change, so each answer is matched to its exact category. Answers from a category that ended before you joined are skipped, because their text was never on screen. Saved tiers rank your suggestions straight away: verified rare answers move to the top, verified common ones to the bottom, and unverified answers keep their order.

Rejected answers. When the game rejects an answer as not on its list ("no echo"), Krillify marks it miss for that prompt and never suggests it again, and the AI is told to avoid it too. Answers rejected only because someone already said them are just skipped for that game. A rejection only applies to an answer already in your cache or the bank, so other players' typos never become entries, and a later acceptance always overrides it. Matching ignores case, spaces, punctuation and accents, but not typos. Krillion often accepts a short form of a longer answer and reports that, so two answers also match when one equals the first whole words of the other: "Hiball" clears a "Hiball Energy" card, and the two are never offered together. "Cat" matches "Cat shark" but never "Catfish".

Other names. Krillion can accept an answer under a completely different name ("Korean steamed eggs" for "Gyeran-jjim"). The game broadcasts each player's typing preview, so Krillify can tell which accepted answers are yours. When your accepted answer arrives under another name, the card you submitted is cleared too, and if it was a suggestion the game's name is saved as its alias, so the bank learns the two are the same answer. Tiers and verified names always come from what the game reports, never from what you typed. Answers you type yourself are cleared but never saved as aliases, so typos stay out of the bank.

Random picks. Suggestions are drawn at random from the six rarest unused answers rather than always the top three, so players sharing the bank spread across more answers.

Maintainer mode is for whoever runs the repository. In Settings, turn on Commit bank updates after each game and give it the repository, a branch (default bank-updates), and a fine-grained token limited to that one repository with only Contents: read and write. Chrome asks for access to api.github.com at that point; other users never grant it. When a game ends, Krillify merges your new AI answers and verified answers into banks.json on that branch and commits it, creating the branch from the default branch if needed. It commits only when something changed, at most once a minute, and Sync now runs it on demand. Merge the branch into the default branch to ship the bank to users.

Bring your own answers

In Settings, choose a JSON file under Instant answer banks. Map prompt text to lists ordered from most obscure to less obscure:

{
  "Name an egg dish": [
    {
      "answer": "Oeufs en meurette",
      "aliases": ["Eggs in meurette"],
      "note": "Poached eggs in a Burgundian red wine sauce"
    },
    "Chawanmushi",
    "Gyeran-jjim"
  ]
}

These are format examples, not verified entries from Krillion's accepted-answer database. Prompt matching ignores case and punctuation. Imports merge into the local cache without clearing used answers.

Speed and limits

The page checks for a prompt every 200 ms. Cached answers avoid the API round trip. A new or exhausted prompt asks the model for up to 18 candidates, then keeps the extras for later choices. The cache holds up to 300 prompts, with up to 60 candidates each.

Cold prompts can take several seconds. The API request has a 14-second deadline and extension messaging an 18-second deadline for suggestions. Requests for superseded prompts are cancelled; cancellation does not guarantee that an already-processed request is unbilled. A partial cached batch appears immediately, and any empty slot is topped up in the background while the shown answers stay put.

Fast HTTP 5xx failures get one retry after 750 ms, within the messaging deadline. Billing, authentication, rate limits and slow timeouts are not retried automatically. If recommendations stall, try Retry, reload the extension, and refresh the game. See troubleshooting.

Privacy

The API key, cache, verified answers, and used-answer records stay in this browser profile's extension storage. They are not synced. The key is not encrypted locally, but storage access is restricted to extension pages and the background worker.

OpenAI requests contain the category, excluded/cached answer names, and your API authentication. They do not include room chat, player identities, cookies, or room credentials. Requests set store: false. No analytics or developer-operated backend is included.

A read-only page-world adapter observes Puffer Party WebSocket/SSE messages locally and forwards only game identity, phase, category, and accepted answer names/tiers to the overlay. It does not send game actions. It never forwards chat, player identities, cookies or room credentials to the worker or API.

Maintainer mode sends only banks.json (prompts, answers, aliases, notes and tiers) to GitHub, using your token. It never includes player names, chat, room codes or keys.

The extension runs on krillion.io and www.krillion.io; its declared remote API host is api.openai.com, and api.github.com is an optional permission requested only for maintainer mode. Read the manifest and implementation write-up for details.

Inside the repository

extension/      Load this folder into Chrome or Edge
assets/         Original README banner
docs/           Design write-up, troubleshooting, and artwork notes

The extension is plain JavaScript, HTML, and CSS using Manifest V3. There are no runtime package dependencies. To check JavaScript syntax with Node.js installed:

node --check extension/background.js
node --check extension/content.js
node --check extension/game-events.js
node --check extension/core.js
node --check extension/bank.js
node --check extension/options.js
node tests/game-events.cjs
node tests/matching.cjs
node tests/worker-v120.cjs
node tests/worker-refill.cjs
node tests/worker-bank.cjs
node tests/worker-prompt.cjs
node tests/worker-install.cjs

Comparing models

tools/model-eval.mjs measures answer-generating models against the game's own results in a bank file: for each prompt with enough results, half are shown to the model as examples and half are held back to grade its answers (known accept, known reject, or unknown). Keys come from OPENAI_API_KEY and ANTHROPIC_API_KEY in your shell, never from the extension.

cd tools && npm install
node model-eval.mjs ../extension/banks.json          # dry run: prompts, calls, estimated cost
node model-eval.mjs ../extension/banks.json --run    # calls the APIs

Chrome Web Store build

node tools/build-store.mjs writes dist/krillify-<version>-store.zip and an unpacked copy in dist/store/. The store build uses the listing name and leaves out the GitHub permission, so maintainer mode isn't available there. python tools/store-art/capture.py renders the store screenshots and promo tile into dist/store-art/, and python tools/make-icons.py makes the icons from the banner's pufferfish. Listing text, permission justifications and privacy answers are in docs/STORE.md; the privacy policy is docs/PRIVACY.md.

Contributing

Useful contributions include verified answer banks, prompt-detection examples, and reproducible bug reports. Include your browser version, extension version, prompt text, and exact error message. Keep API keys and private room details out of reports.

The settings page bundles the VT323 font, © The VT323 Project Authors, under the SIL Open Font License 1.1 (extension/fonts/OFL.txt).

Krillify is an independent project, not affiliated with or endorsed by Krillion. The banner is original AI-generated artwork, not an official game asset. Code is available under the MIT license.

About

Chrome/Edge extension for Krillion's Puffer Party: reads the category and suggests three obscure answers, skipping any already played this game. Bring your own OpenAI key or answer banks.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages