---
title: "sparkmine"
url: "https://claudemods.dev/zh-cn/builds/sparkmine-702d28"
source: "https://github.com/tozmoz/sparkmine"
source_type: "github"
repo: "https://github.com/tozmoz/sparkmine"
author: "tozmoz"
author_handle: "tozmoz"
stars: 0
category: "游戏与娱乐"
categories: ["games"]
tags: ["clicker-game", "hooks", "idle-game", "pixel-art", "plugin", "statusline"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add tozmoz/sparkmine\nclaude plugin install sparkmine@sparkmine"
added: "2026-10-11T12:55:56.841Z"
updated: "2026-10-11T09:49:23Z"
locale: "zh-cn"
content_locale: "zh-cn"
---

# sparkmine

一个为 Claude Code 设计的像素艺术挖矿放置点击游戏，运行在提示符上方的区域，通过工具调用和 Claude 的工作赚取火花，包含商店、升级、矿脉、深度层和成就。

## Description

Sparkmine 是一个 Claude Code 模组，在你的提示符上方的区域玩放置挖矿点击游戏。Claude 每次工具调用都会挖掘火花 ✻，按下 Mine 会挖更多；Claude 自己的工作也有回报（通过测试、提交、长时间回合）。在商店中花费火花购买生产者和升级，捕捉金矿脉获得奖励，下降深度层获取 perks，从 500 米深处开始新矿井获得古老石头。它附带 33 个成就、可选声音，以及命令如 /mine、/mine share、/mine sound、/mine stop、/mine compact、/mine hide 和 /mine reset。所有会话共享一个存档。它不使用令牌，不进行网络请求或命令，并保留一个小型本地存档。

## Install

```
claude plugin marketplace add tozmoz/sparkmine
claude plugin install sparkmine@sparkmine
```

## Original README

# Sparkmine: Idle Clicker Game for Claude Code

A game you play while Claude works, built as a
[Claude Code mod](https://code.claude.com/docs/en/plugins/mods/overview).
Claude works. You click.

Plays in the Code tab of the **Claude Desktop app** and in Claude Code in the
terminal.

![The band above the prompt: a pixel miner digs while Claude works](docs/band.png)

While Claude works, a pixel miner digs in the band above your prompt. Every
tool call Claude makes mines sparks ✻, and each press of **Mine** mines more.
Claude's own work pays too: a test run that passes, a commit, a long turn.
Spend it all in the shop on a crew that keeps digging, and on upgrades.

<img src="docs/shop.png" alt="The shop in the Claude Desktop app: upgrades and a new shaft" width="420">

## Install

Needs Claude Code v2.1.293 or later. In a terminal, run:

```bash
claude plugin marketplace add tozmoz/sparkmine
claude plugin install sparkmine@sparkmine --scope user
```

The user scope puts it in every session, including the Code tab of the Claude
Desktop app. New sessions load it; in open ones, run `/reload-plugins`. Inside Claude Code, `/plugin install sparkmine --marketplace
tozmoz/sparkmine` does the same.

To update later:

```bash
claude plugin marketplace update sparkmine
claude plugin update sparkmine@sparkmine
```

Or let updates arrive on their own: in Claude Code in a terminal, run
`/plugin`, open the Marketplaces tab, select sparkmine and choose **Enable
auto-update**.

## Play

- Press **Mine** while Claude works. Clicks count only then. In the
  terminal, give the band the keyboard (click it, or press ctrl+x then Tab)
  and press `m`: every press counts, while quick clicks on one spot count as
  one.
- Open the shop with **Shop** or `/mine`. Producers mine every second Claude
  works; upgrades make clicks, tool calls, Claude's work and the crew
  stronger. The shop's stats show where your sparks came from.
- **Claude's work pays**, once a turn each: tests that pass, a bug squashed
  (tests that failed, then pass), a build that passes, a clean lint, a commit,
  a pull request opened or merged, and a turn longer than five minutes. Every
  third good turn in a row pays a streak.
- **Veins:** now and then a gold vein shows beside the Shop sign for twenty
  seconds. Catch it for two minutes of income, or a ×5 frenzy for thirty.
- **Depth:** the mine goes a hundred metres deeper with every tenfold of
  sparks, through layer after layer. Each layer you reach adds its perk for
  the rest of the run.

  ![The layers down to the core, where each starts and what it adds](docs/layers.png)

- **New shaft:** from 500 m down, open a new shaft in the shop to start over
  for ◈ ancient stones. They add to everything for good, each a little less
  than the one before: 10 stones add 50%, 100 add 251%. A deeper run pays more
  of them.
- **Achievements:** 33 badges for records such as your first vein, 100
  commits, a ten-turn streak or reaching the magma, and nine secrets. Each
  adds 2% to everything, and they stay through new shafts.
- **Sounds:** a few rare moments chime softly, such as a vein caught.
  `/mine sound` turns them off.

All your sessions share one save, so they mine into the same mine. The crew's
idle pace is paid once, however many sessions are open.

| Command | What it does |
| :- | :- |
| `/mine` | Opens the shop |
| `/mine share` | Puts a card of your mine in the conversation to paste anywhere (in the terminal, on the clipboard too) |
| `/mine sound` | Turns the sounds off in every session, and on again |
| `/mine stop`, `/mine start` | Stops the game in every session, and starts it again |
| `/mine compact` | Keeps the band to one line, even while Claude works |
| `/mine hide`, `/mine show` | Hides the band in this session, and brings it back |
| `/mine reset` | Deletes your save, after asking |

To remove it, disable or uninstall it from `/plugin`. Your save stays until
you reset it.

## What it touches

- It **DOES NOT** use tokens: it never calls a model and adds nothing to your
  prompts.
- It **DOES NOT** make network requests or run commands. Nothing leaves your
  machine. Its few sounds play through the system's own player (`afplay` on
  macOS).
- It **DOES NOT** keep or send your prompts or Claude's answers: it reads them
  on your machine only to notice a few words.
- It counts tool calls, turns and permission prompts, and reads whether a
  test run passed or a commit landed, but changes none of them.
- It keeps one small save on your machine.

## Known limits

- In the terminal, quick clicks on one spot count as one. Press `m` instead.
- A mod cannot see a permission dialog, so the band keeps going while one is
  open. It rests only while Claude asks you a question or waits on a plan.
- Each machine keeps its own save.

## License

MIT