PHPackages                             craftquest/buggy - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Debugging &amp; Profiling](/categories/debugging)
4. /
5. craftquest/buggy

ActiveCraft-plugin[Debugging &amp; Profiling](/categories/debugging)

craftquest/buggy
================

Put bugs in your control panel and then learn how to use Xdebug via CraftQuest.

2.0.0(3y ago)11351[1 issues](https://github.com/CraftQuest/craft-buggy/issues)MITPHP

Since Jun 27Pushed 8mo agoCompare

[ Source](https://github.com/CraftQuest/craft-buggy)[ Packagist](https://packagist.org/packages/craftquest/buggy)[ RSS](/packages/craftquest-buggy/feed)WikiDiscussions develop Synced today

READMEChangelog (5)Dependencies (4)Versions (16)Used By (0)

Buggy plugin for Craft CMS 4.x
==============================

[](#buggy-plugin-for-craft-cms-4x)

Buggy lets you add a fun bug infestation to your Craft Control Panel.

[![Screenshot](resources/img/plugin-logo.png)](resources/img/plugin-logo.png)

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 4.0.0 or later.

Installation
------------

[](#installation)

To install the plugin, use the Craft Plugin Store or follow these instructions:

1. Open your terminal and go to your Craft project:

    ```
     cd /path/to/project

    ```
2. Then tell Composer to load the plugin:

    ```
     composer require craftquest/buggy

    ```
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for Buggy.

Buggy Overview
--------------

[](#buggy-overview)

Buggy has two modes:

1. Automatic Bug Spawning: Learn how to debug using Xdebug by solving bugs in the code. The number of bugs crawling on the screen is related to the number of bugs in the code.
2. Manual Bug Spawning: Generate and exterminate bugs using a simple interface. The bugs you generate will appear in the Control Panel.

Configuring Buggy
-----------------

[](#configuring-buggy)

By default Buggy is turned on to Automatic Bug Spawning. If you turn off Automatic Bug Spawnig and haven't created any bug swarms manually, then you can get rid of the bugs.

The Automatic Bug Spawning will only work if the small code bugs shipped with Buggy remain unfixed. Manual Bug Spawning requires you to create bug using the interface.

Automatic Bug Spawning
----------------------

[](#automatic-bug-spawning)

Automatic Bug Spawning exists as a learning tool for the Debugging with Xdebug course from [CraftQuest.io](https://craftquest.io).

The bugs are spawned based on the number of software bugs the system detects. As each bugs is fxied, the nunber of bugs spawned is reduced until there are no more bugs.

At that point, you can enable Manual Bug Spawning, so you don't miss your crawling friends!

Manual Bug Spawning
-------------------

[](#manual-bug-spawning)

To set up Manual Bug Spawning, copy the contents of example `index.twig` template in `vendor/craftquest/example-templates` to a template in your template directory.

Load that template in your web browser and you should see an interface for creating new bug swarms. Click the button "Create Swarm" and Buggy will automatically generate a new swarm of random size.

To get rid of the swarm, use the Spray Swarm button next to each swarm.

To get rid of the bugs on the screen you can just toggle off Manual Bug Spawning to remove the bugs completely.

Credits
-------

[](#credits)

- [Andrew Welch at NyStudio107](https://nystudio107.com) for ideas and help
- [AUZ Bug](https://github.com/Auz/Bug) - the library this plugin uses to get the bugs on your screen.

Brought to you by [Ryan Irelan](https://craftquest.io)

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance22

Infrequent updates — may be unmaintained

Popularity13

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity60

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~142 days

Recently: every ~296 days

Total

12

Last Release

266d ago

Major Versions

1.0.6 → 2.0.02022-07-14

v1.x-dev → 3.0.0-beta.12024-02-15

v2.x-dev → v4.x-dev2025-10-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/2708f0ff712285dea85d71758ed5eb0830298cec920bfc7fb49d089bc679de98?d=identicon)[mijingo](/maintainers/mijingo)

---

Top Contributors

[![ryanirelan](https://avatars.githubusercontent.com/u/2238?v=4)](https://github.com/ryanirelan "ryanirelan (3 commits)")

---

Tags

debuggingXdebugcmsCraftcraftcmscraft-plugincontrol panelbugsbuggy

###  Code Quality

TestsCodeception

### Embed Badge

![Health badge](/badges/craftquest-buggy/health.svg)

```
[![Health](https://phpackages.com/badges/craftquest-buggy/health.svg)](https://phpackages.com/packages/craftquest-buggy)
```

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

102393.6k68](/packages/verbb-formie)[verbb/comments

Add comments to your site.

13753.9k](/packages/verbb-comments)[verbb/vizy

A flexible visual editor field for Craft.

4250.4k](/packages/verbb-vizy)[verbb/hyper

A user-friendly links field for Craft.

24147.8k12](/packages/verbb-hyper)[studioespresso/craft-dumper

Bringing symfony/VarDumper to Craft CMS

20250.4k5](/packages/studioespresso-craft-dumper)[verbb/social-poster

Automatically post entries to social media.

918.5k](/packages/verbb-social-poster)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
