PuppyClicker

PuppyClicker for Minecraft

Connect Minecraft to your PuppyClicker account.
Send a self-click from a configurable keybind, craft clicker items for accepted
friends, or opt into carefully rate-limited actions for advancements and
damage.

Features

• Press P by default to send a self-click.
• Configure and validate a masked PuppyClicker API key in-game.
• Craft multiple Puppy Clickers and bind each stack to a different accepted friend.
• Right-click a bound clicker to send its friend a click; sneak-right-click to rebind it.
• Optionally send a self-click after earning a visible advancement.
• Optionally send a self-targeted OSC shock after taking damage.
• Configure a 15–300 second damage-action cooldown; the default is 30 seconds.
• Receive clear hotbar feedback for success, Do Not Disturb suppression, credentials, rate limits, HTTP failures, and network failures.

Automated actions are off by default and each category must be enabled
separately. Damage actions target only the authenticated player’s own
PuppyClicker devices. The mod does not contact OpenShock directly and does not
choose device intensity or duration.

Supported versions

Choose the JAR whose filename contains both your loader and exact Minecraft
version.

| Minecraft | NeoForge | Forge | Fabric |
| — | — | — | — |
| 1.18.2 | — | Yes | Yes |
| 1.19.2 | — | Yes | Yes |
| 1.20.1 | — | Yes | Yes |
| 1.21.1 | Yes | Yes | Yes |
| 1.21.11 | Yes | Yes | Yes |
| 26.1.2 | Yes | Yes | Yes |

The 1.18.2 and 1.19.2 Forge builds are intended for the generation of popular
older packs that includes ATM7, ATM8, FTB StoneBlock 3, and FTB One. Fabric
installations also require Fabric API.

The JARs are deliberately loader- and version-specific because Minecraft and
the three loaders use incompatible binary APIs and startup metadata. The
shared PuppyClicker core is already included in every JAR; there is no separate
library mod to install.

Installation and use

1. Install the matching JAR on both the Minecraft client and server.
2. On NeoForge or Forge, open Mods → PuppyClicker for Minecraft → Config. On Fabric, press O; the binding can be changed under Controls.
3. Enter the personal PuppyClicker API key and choose Validate & Save.
4. Press P for a self-click, or enable either automation category from Automated Actions….
5. Craft a clicker from a stone button, iron nugget, and redstone in any arrangement.

| Clicker interaction | Result |
| — | — |
| Right-click an unbound clicker | Open the accepted-friend picker |
| Right-click a bound clicker | Send a click to its selected friend |
| Sneak-right-click a bound clicker | Choose a different friend |

Privacy and safety

The mod connects only to puppyclicker-api.boundfire.com. The API key remains
on the client and is never sent to the Minecraft server, stored in an item, or
intentionally logged. The local client config is plain text, so never share or
upload puppyclicker-client.toml or puppyclicker-client.json.

Advancement automation uses PuppyClicker’s self-click endpoint. Damage
automation sends only type: osc to PuppyClicker’s self-action endpoint—no
friend identifier, message, or integration override. PuppyClicker, Do Not
Disturb, and the player’s device configuration remain responsible for delivery
and physical safety limits.

Help and links

• Setup help and issue forms
• Full documentation and source
• Release history
• PuppyClicker
• Author — Éimí Mhic an Ridire

Source code and documentation are available under the MIT License. PuppyClicker
branding and artwork have separate terms described in the repository’s asset
notices.