GitHub 저장소 · 작성자 MadAppGang

claudoom

Name: claudoom
Author: MadAppGang

함수 훅, doom-cli, 비공개 tmux 서버로 Claude Code 패널에서 Doom 엔진 WAD를 실행하고 프레임을 캡처해 터미널 Raster로 다시 그리는 Claude Code 플러그인입니다.

MadAppGang@MadAppGang

MadAppGang/magus-alpha/tree/main/plugins/claudoom

번역 완료

이 mod 소개

claudoom은 함수 훅 모듈(hooks/register.tsx)에 동작이 들어 있는 Claude Code 플러그인입니다. 비공개 tmux 서버에서 doom-cli를 실행하고 tmux capture-pane으로 각 프레임을 읽어 패널에 맞는 터미널 Raster로 다시 그립니다. 함수 훅은 얼리 액세스이며 기본값으로 꺼져 있습니다. CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir plugins/claudoom으로 시작합니다. 명령은 /claudoom install(doom-cli를 빌드하고 Freedoom 다운로드), /claudoom install shareware(셰어웨어 약관 표시, accept를 추가하면 다운로드), /claudoom(설치되어 있으면 셰어웨어 에피소드, 아니면 Freedoom 재생), /claudoom freedoom2, /claudoom <file.wad>, /claudoom stop, /claudoom uninstall입니다. 키는 WASD 또는 화살표로 이동, F로 발사, E로 사용, Enter 또는 R로 선택, Q로 메뉴, 1-7로 무기 선택입니다. Esc는 키를 프롬프트로 돌려주고 ctrl+x tab은 다시 가져옵니다. tmux, make, curl, tar, unzip, shasum이 필요합니다. 다운로드는 HTTPS만 사용해 ~/.claude/claudoom으로 들어가며 고정된 다이제스트로 검증됩니다. doom-cli(GPLv2, 고정된 업스트림 커밋에서 빌드), Freedoom 0.13.0(3조항 BSD), 선택 가능한 DOOM1.WAD 셰어웨어(id Software 셰어웨어 라이선스, 옵트인)가 대상입니다. DOOM은 ZeniMax의 상표이며 id Software, ZeniMax, Anthropic과 제휴하지 않습니다.

설치

먼저 작성자의 README에서 marketplace와 플러그인 이름을 확인하세요. 저장소 구조에 따라 명령어가 달라질 수 있습니다.

claude plugin marketplace add MadAppGang/magus-alpha
claude plugin install claudoom

원문 / README

claudoom

Plays Doom-engine WADs in a Claude Code pane. It is a Claude Code mod: a plugin whose behaviour lives in a function-hooks module (hooks/register.tsx). It runs doom-cli in a private tmux server, reads each frame with tmux capture-pane, and repaints it into a terminal Raster, scaled to fit the pane.

Function hooks are early access and off by default. Start Claude Code with the flag and the plugin folder:

CLAUDE_CODE_ENABLE_FUNCTION_HOOKS=1 claude --plugin-dir plugins/claudoom

Commands

| Command | Does | |---|---| | /claudoom install | Builds doom-cli and downloads Freedoom | | /claudoom install shareware | Shows the shareware licence terms; add accept to download | | /claudoom | Plays the shareware episode if installed, else Freedoom; again closes it | | /claudoom freedoom2 | Plays Freedoom Phase 2 | | /claudoom <file.wad> | Plays a WAD you own | | /claudoom stop | Stops the game | | /claudoom uninstall | Stops the game and removes what the install wrote; files you added yourself stay |

While the pane holds the keys: WASD or ↑↓ move, F fire, E use, Enter or R select, Q menu, 1–7 weapons. Esc hands the keys back to the prompt; ctrl+x tab takes them again. It needs tmux, make, curl, tar, unzip and shasum. It never runs git, so a git config that rewrites GitHub URLs to SSH cannot break the install.

What is downloaded, and under which licence

Nothing below ships with this plugin. /claudoom install fetches it onto your machine, into ~/.claude/claudoom, over HTTPS only (a redirect to plain http is refused), and verifies each download against a pinned digest before anything is built, kept or run.

The engine's digest covers the extracted source tree, not the tarball, so a forge re-compressing the same commit does not break the install while a changed file still does. The command that recomputes it is in hooks/doom.ts, beside the digest.

| Component | Licence | Source | |---|---|---| | doom-cli, a doomgeneric port | GPLv2 | fetched from upstream at a pinned commit, verified against a pinned source-tree digest, then built locally; the mod talks to it only through tmux | | Freedoom 0.13.0 | 3-clause BSD, notice kept as freedoom-COPYING.txt | the official GitHub release, checked against its signed SHA-256 | | DOOM1.WAD, the shareware episode (opt-in) | id Software's shareware licence: not free software, no commercial use | id's own doom19s.zip from /idgames, archive and WAD both checked |

The shareware licence (LICENSE.DOC, shipped with id's v1.8 shareware) allows electronic distribution royalty free and "only in compressed format", and forbids modifying the WAD (§1), commercial use (§2) and charging anyone for it without id's prior written consent (§4). That is why the shareware download is opt-in, shows those terms first, and fetches id's compressed archive rather than a bare WAD.

DOOM is a trademark of the ZeniMax group of companies. Claude is a trademark of Anthropic. This plugin is not affiliated with or endorsed by id Software, ZeniMax or Anthropic. This is not legal advice.