Installing this mod correctly is essential. A misplaced .jar file will simply not load. Follow this guide precisely.
| Problem | Likely Solution | |--------|----------------| | Mod doesn’t appear in mod list | Make sure you’re running the Forge profile, not Vanilla. | | Crashes on launch | Check that the mod is for 1.8.9 – rename can be misleading. Remove conflicting mods. | | No effect in game | Check your keybinding; also some servers block high CPS or require a reach/AC patch. | | Server kicks you for “Flying” or “Invalid packets” | CPS too high or mod poorly coded. Lower CPS and add randomisation. | | Mod works in singleplayer but not multiplayer | The server’s anti‑cheat (Watchdog, AAC, Grim) is rejecting the click pattern. | File name- Butterfly-Click-Mod-Forge-1.8.9.jar
mods folder doesn’t exist, create it.Vanilla Minecraft (unmodded) has a built-in "click throttle." If the game detects that you are clicking over a certain threshold (usually 7-10 CPS), it begins ignoring input to prevent macros. This is a nightmare for butterfly clickers who naturally achieve 15-25 CPS. Installing this mod correctly is essential
Here is how the mod solves this:
| Aspect | Detail |
|--------|--------|
| CPS limit | Many servers detect >15–20 CPS as autoclicker. Keep ≤14 CPS to be safer. |
| Alternation pattern | Good mods vary the interval (e.g., 40ms, 55ms, 38ms) to avoid perfect periodicity. |
| Packet injection | Works by sending LeftClickPacket or using Robot class + Forge’s ClientTickEvent. |
| Compatibility | Only for Forge 1.8.9 – does not work with Fabric, OptiFine alone, or newer MC versions. | If the mods folder doesn’t exist, create it
Note: If a mods folder does not exist, create one manually (case sensitive).
Take your Butterfly-Click-Mod-Forge-1.8.9.jar file and drag and drop it directly into the mods folder.
Do not unzip the file. The .jar extension is the mod itself.