PHPackages                             carmelosantana/coqui-toolkit-doom-generator - 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. carmelosantana/coqui-toolkit-doom-generator

ActiveLibrary

carmelosantana/coqui-toolkit-doom-generator
===========================================

Doom mod generation toolkit for Coqui — WAD parsing, project scaffolding, DeuTex build orchestration, and source port launching

v0.1.0(1mo ago)00MITPHPPHP ^8.4CI passing

Since Apr 9Pushed 1mo agoCompare

[ Source](https://github.com/carmelosantana/coqui-doom-generator)[ Packagist](https://packagist.org/packages/carmelosantana/coqui-toolkit-doom-generator)[ RSS](/packages/carmelosantana-coqui-toolkit-doom-generator/feed)WikiDiscussions main Synced yesterday

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Coqui Doom Generator Toolkit
============================

[](#coqui-doom-generator-toolkit)

Doom mod generation toolkit for [Coqui](https://github.com/AgentCoqui/coqui). Provides native WAD file parsing, mod project scaffolding, DeuTex build orchestration, Freedoom IWAD management, and source port launching — all sandboxed to the workspace.

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

[](#requirements)

- PHP 8.4+
- [Coqui](https://github.com/AgentCoqui/coqui) (auto-discovered via Composer)

### Optional External Tools

[](#optional-external-tools)

- **DeuTex** — WAD compilation and asset injection (`apt install deutex` / `brew install deutex`)
- **GZDoom** or **Chocolate Doom** — source ports for launching and testing builds

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

[](#installation)

```
composer require coquibot/coqui-toolkit-doom-generator
```

When installed alongside Coqui, the toolkit is **auto-discovered** via Composer's `extra.php-agents.toolkits` — no manual registration needed.

Tools Provided
--------------

[](#tools-provided)

### `doom_wad_inspect`

[](#doom_wad_inspect)

Inspect any WAD file — parse headers, list lumps, search by name pattern, extract lump data.

ParameterTypeRequiredDescription`path`stringYesWAD file path relative to workspace`filter`stringNoGlob pattern to filter lump names (e.g. `MAP*`, `*SKY*`)`show_header`boolNoInclude header details in output (default: true)### `doom_project`

[](#doom_project)

Create and manage mod projects with standardized directory structure.

ParameterTypeRequiredDescription`action`enumYes`init`, `list`, `info``name`stringConditionalProject name (required for `init`, `info`)`iwad`stringNoTarget IWAD name (default: `freedoom2.wad`)`source_port`stringNoTarget source port (default: `gzdoom`)### `doom_asset`

[](#doom_asset)

Add, remove, list, or extract assets (graphics, sounds, sprites, flats) in a project.

ParameterTypeRequiredDescription`action`enumYes`add`, `remove`, `list`, `extract``project`stringYesProject name`lump_name`stringConditionalLump name for add/remove/extract`file_path`stringConditionalSource file path for add, output path for extract`category`enumNoAsset category: `graphic`, `sound`, `sprite`, `flat`, `music`, `patch`### `doom_build`

[](#doom_build)

Compile a project into a PWAD using DeuTex.

ParameterTypeRequiredDescription`project`stringYesProject name to build`output_name`stringNoCustom output WAD filename### `doom_run`

[](#doom_run)

Launch a build with a source port for testing.

ParameterTypeRequiredDescription`project`stringNoProject name (uses latest build)`wad_path`stringNoDirect path to a WAD file`source_port`enumNo`gzdoom`, `chocolate-doom`, `dsda-doom``iwad`stringNoOverride IWAD`extra_args`stringNoAdditional CLI arguments for the source port### `doom_toolchain`

[](#doom_toolchain)

Check system toolchain status and manage Freedoom IWADs.

ParameterTypeRequiredDescription`action`enumYes`status`, `install_freedoom`Architecture
------------

[](#architecture)

```
src/
├── DoomGeneratorToolkit.php      # ToolkitInterface entrypoint
├── Asset/
│   └── IwadManager.php           # Freedoom downloads + user IWAD management
├── Exception/
│   └── DoomGeneratorException.php
├── Project/
│   └── ProjectManager.php        # Mod project lifecycle
├── Runtime/
│   ├── DependencyChecker.php     # System tool detection
│   ├── DoomResult.php            # CLI result value object
│   └── DoomRunner.php            # Multi-binary CLI orchestrator
├── Tool/
│   ├── DoomAssetTool.php
│   ├── DoomBuildTool.php
│   ├── DoomProjectTool.php
│   ├── DoomRunTool.php
│   ├── DoomToolchainTool.php
│   └── DoomWadInspectTool.php
└── Wad/
    ├── WadHeader.php             # Header value object
    ├── WadLump.php               # Lump directory entry VO
    ├── WadReader.php             # Native PHP binary WAD parser
    ├── WadType.php               # IWAD/PWAD enum
    └── WadWriter.php             # PWAD binary writer

```

License
-------

[](#license)

MIT

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance93

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

34d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/597820?v=4)[Carmelo Santana](/maintainers/carmelosantana)[@carmelosantana](https://github.com/carmelosantana)

---

Top Contributors

[![carmelosantana](https://avatars.githubusercontent.com/u/597820?v=4)](https://github.com/carmelosantana "carmelosantana (1 commits)")

---

Tags

toolkitphp-agentscoquimoddingwaddoomgame-generationdeutex

###  Code Quality

TestsPest

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/carmelosantana-coqui-toolkit-doom-generator/health.svg)

```
[![Health](https://phpackages.com/badges/carmelosantana-coqui-toolkit-doom-generator/health.svg)](https://phpackages.com/packages/carmelosantana-coqui-toolkit-doom-generator)
```

PHPackages © 2026

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