К основному содержанию
скилл CX Codex

console-controller — скилл для Claude Code: настройка геймпада

Скилл console-controller для Claude Code подключает геймпады, клавиатуру и touch-управление к PS2Recomp. Меняет раскладку, стики и ввод для двух игроков.

MIT ★ 449 обновлён 2026-10-22

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill
Открыть на GitHub

Что делает console-controller

Скилл console-controller создаёт console/ps2_pad.cpp из карты управления в console/controls.json. Он превращает ввод, который видит raylib, в отчёт DualShock 2 для PS2Recomp: доступны пресеты PlayStation, Xbox, Switch и keyboard, переопределение кнопок, мёртвая зона, инверсия Y, обмен стиками, порог аналоговых триггеров, второй игрок и touch-зоны Android.

Команды init, check, gen, install и restore готовят карту, проверяют конфликты, генерируют файл и устанавливают его в названный checkout PS2Recomp. Перед заменой исходный ps2_pad.cpp сохраняется в console/backups. Режим --replay добавляет запись и воспроизведение ввода для тестовых сценариев. Rumble не подключён, чувствительность кнопок давления передаётся как нажатие или отпускание, а touch-зоны Android не рисуют экранный overlay.

Какие задачи решает

  • подключить DualSense, Xbox или Switch Pro к игре
  • переназначить кнопки через console/controls.json
  • исправить инверсию камеры и обмен стиков
  • добавить клавиатурное или Android touch-управление
  • повторить ввод в сценарном тесте

Примеры запросов агенту

  • Настрой раскладку Xbox в console/controls.json и установи её в checkout PS2Recomp.
  • Исправь перепутанные кнопки Switch Pro и проверь карту командой padmap.py check.
  • Сгенерируй файл с записью ввода для теста меню командой padmap.py gen --replay.

Как установить console-controller

1Через маркетплейс плагинов

/plugin marketplace add Jakeschincariol/console-skill
/plugin install console-skill@console-skill

Команда ставит плагин console-skill целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Jakeschincariol/console-skill --skill console-controller -a claude-code

3Вручную: положить файлы

~/.claude/skills/console-controller/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/console-controller/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о console-controller

Как установить console-controller в Claude Code?

В Claude Code выполни /plugin marketplace add Jakeschincariol/console-skill и затем /plugin install console-skill@console-skill.

Что делает console-controller?

Скилл читает карту из console/controls.json и генерирует замену ps2xRuntime/src/lib/ps2_pad.cpp. Она переводит ввод геймпада, клавиатуры или touch-зон в отчёт DualShock 2 для PS2Recomp.

Что нужно для работы console-controller?

Нужны Python 3, checkout PS2Recomp и контроллер, который видит raylib. Для сборки используется cmake --build <build dir>, а Android touch-зоны работают без экранного overlay.

Исходный текст

SKILL.md · MIT
---
name: console-controller
description: >-
  Controller Mapper. Hooks the game up to any controller: DualSense, Xbox, Switch Pro, keyboard or
  touch, remapped how you like. Reads a mapping in console/controls.json (a layout preset plus
  per-button overrides, radial deadzone, invert Y, stick swap, analog trigger threshold, keyboard
  keys, two players, Android touch zones) and writes console/ps2_pad.cpp, a drop-in replacement for
  PS2Recomp's ps2xRuntime/src/lib/ps2_pad.cpp with the same class, signature and DualShock 2 report.
  Optional input replay and recording for scripted test runs. Backs up the stock file before
  installing and only touches the PS2Recomp checkout you name. Use when the user says "my controller
  doesn't work", "remap the buttons", "use my Xbox pad", "Switch Pro buttons are swapped", "invert
  the camera", "keyboard controls", "two players", "touch controls on Android", or when
  /console-tester needs scripted input.
argument-hint: "init|check|gen|install|restore|presets|table [flags]"
---

# console-controller

The recompiled game asks the runtime for the pad state many times a second through
`PSPadBackend::readState(int port, int slot, uint8_t *data, size_t size)` in
`ps2xRuntime/src/lib/ps2_pad.cpp`. The stock file maps raylib's gamepad 0 and a fixed keyboard
layout onto the 32-byte DualShock 2 report. This skill replaces that one file with a generated one
built from your `console/controls.json`, so any controller raylib can see becomes a DualShock 2,
mapped your way. Nothing else in the runtime changes, so the rebuild is incremental.

Honest limits: rumble is not wired in the runtime, pressure-sensitive buttons are reported as fully
pressed or not pressed, and touch zones on Android are invisible (the runtime draws no overlay).

`${CLAUDE_SKILL_DIR}` below is this skill's folder (where this SKILL.md lives).

```bash
python3 "${CLAUDE_SKILL_DIR}/padmap.py" init --layout xbox          # writes console/controls.json
python3 "${CLAUDE_SKILL_DIR}/padmap.py" check                       # every DS2 button bound, no clashes
python3 "${CLAUDE_SKILL_DIR}/padmap.py" gen --replay                # writes console/ps2_pad.cpp
python3 "${CLAUDE_SKILL_DIR}/padmap.py" install --repo ~/PS2Recomp  # backs up, then copies it in
python3 "${CLAUDE_SKILL_DIR}/padmap.py" restore --repo ~/PS2Recomp  # puts the stock file back
python3 "${CLAUDE_SKILL_DIR}/padmap.py" presets switch-labels       # playstation xbox switch switch-labels keyboard
python3 "${CLAUDE_SKILL_DIR}/padmap.py" table                       # the DS2 bit table
python3 "${CLAUDE_SKILL_DIR}/padmap.py" check --script console/inputs/menu.txt   # validate a replay script
```

Flags: `--config FILE` (default `console/controls.json`; the preset alone is used if it is missing),
`--layout NAME`, `--out FILE` (`-` for stdout), `--json`, `--strict` (warnings fail `check`),
`--backups DIR` (default `console/backups`). Exit codes: 0 ok, 1 `check` found a problem, 2 bad input.

## What it reads and writes

| file | what |
| --- | --- |
| `console/controls.json` | your mapping: `layout` + overrides. Full format: [reference/controls-json.md](reference/controls-json.md) |
| `console/ps2_pad.cpp` | the generated drop-in pad file (from `gen`) |
| `<PS2Recomp>/ps2xRuntime/src/lib/ps2_pad.cpp` | replaced by `install`, only when you pass `--repo` |
| `console/backups/ps2_pad.cpp.orig` | the stock file, saved once and never overwritten; later installs also keep a timestamped copy |
| `templates/menu-walk.txt` | an example input replay script to copy and edit |

## The DualShock 2 report the file fills

`data[0] = 0x01`, `data[1] = 0x73` (analog), buttons ACTIVE-LOW in `data[2]` (low byte) and
`data[3]` (high byte), so `0xFFFF` means nothing pressed. Sticks: `data[4]` RX, `data[5]` RY,
`data[6]` LX, `data[7]` LY, `0x80` centre, `0x00` full left or up. Bits: SELECT 0x0001, L3 0x0002,
R3 0x0004, START 0x0008, UP 0x0010, RIGHT 0x0020, DOWN 0x0040, LEFT 0x0080, L2 0x0100, R2 0x0200,
L1 0x0400, R1 0x0800, TRIANGLE 0x1000, CIRCLE 0x2000, CROSS 0x4000, SQUARE 0x8000.
`Kernel/Stubs/Pad.cpp` copies bytes 2 to 7 into the game's pad buffer, sets the mode byte itself
(digital 0x41 until the game switches the pad to analog) and fills the pressure bytes as 0xFF or 0.

## Method

1. **Find out what they play with.** Controller model, how it connects (USB or Bluetooth), which
   OS, one or two players, and whether they want keyboard or touch. If a button already lands in
   the wrong place, ask which physical button they pressed and what the game did.
2. **Start from a preset.** `init --layout playstation|xbox|switch|switch-labels|keyboard`.
   raylib reports pads by POSITION: the bottom face button is Cross on every pad (Xbox A, Nintendo
   B). `switch-labels` matches Nintendo's printed letters instead (A, on the right, is Cross).
   Details and why some Switch Pro setups arrive already swapped: [reference/controllers.md](reference/controllers.md).
3. **Apply the user's changes** in `controls.json`: `buttons` overrides, `keyboard` keys,
   `deadzone` (radial, default 0.15), `invert_y` (`true` means the right stick, the camera in most
   games), `stick_swap`, `trigger_threshold` (reads L2/R2 from the analog trigger axes), `players: 2`
   (port 2 gets the second pad), `touch` zones for Android. Keep it a mapping, never game code.
4. **Check.** `padmap.py check`. Fix every ERROR. Read the warnings out: Escape quits the game
   (raylib's default exit key; the runtime never changes it) and F1 opens the debug panel on
   desktop builds with the debug UI.
5. **Generate.** `padmap.py gen` (add `--replay` when /console-tester will drive scripted runs).
6. **Install.** `padmap.py install --repo <their PS2Recomp checkout>` backs the stock file up to
   `console/backups/ps2_pad.cpp.orig` and copies the new one in. Then the normal incremental build
   (`cmake --build <build dir>`, the same command recorded in `console/STATE.md`). One `.cpp`
   changes and no header does, so it is quick. Never clean the build for this.
7. **Test with the controller in hand.** Run the port, press every button once in a menu that
   reacts to all of them (or a game's controller test screen). If one is wrong, change
   `controls.json`, `gen`, `install`, rebuild. Log the result in `console/STATE.md`.
8. **Scripted input for tests** (with `--replay`): set `PS2X_INPUT_RECORD=console/inputs/run1.txt`,
   play the bit you want to repeat, quit; that file replays with `PS2X_INPUT_SCRIPT` (which
   `/console-tester`'s `run.py --input` sets for you). The format is in
   [reference/controls-json.md](reference/controls-json.md). Frame numbers count the game's reads of
   pad port 0, so a script stays in step with the game, not with the wall clock.

## Rumble, pressure, analog, touch

| feature | status in this PS2Recomp checkout |
| --- | --- |
| Rumble | not wired: `scePadSetActDirect` and `scePadSetActAlign` in `Kernel/Stubs/Pad.cpp` return 1 and do nothing (`scePadInfoAct` reports two motors). Adding it is runtime C++ work for /console-backend, not a mapping |
| Pressure-sensitive buttons | digital: when a game turns pressure mode on, `Pad.cpp` reports 0xFF for a pressed button and 0 otherwise |
| Analog mode | the game switches it (`scePadSetMainMode`); sticks are always sent and the game ignores them in digital mode |
| Touch (Android) | `ps2_android_runtime.cpp` is only a TODO for an on-screen overlay, so the stock port has no touch controls. `touch` zones work as invisible areas; a Bluetooth controller is the better answer |
| Two players | the stock file feeds the same pad to both ports; the generated one gives port 2 its own pad with `players: 2`, or a released pad otherwise |

## Guard rails

- **Bring your own game.** Only games you own, dumped from your own disc. Never download ISOs, ELFs
  or BIOS files, never help find them. PS2Recomp needs no BIOS.
- **Nothing from the game gets published.** The disc, ELF, IRX modules, assets and the recompiled
  `runner/*.cpp` stay on your machine. A `controls.json`, a generated `ps2_pad.cpp` and replay
  scripts you wrote are yours to share.
- **Not affiliated with Sony.** PlayStation and DualShock are trademarks of Sony Interactive
  Entertainment. DualSense, Xbox and Nintendo Switch belong to their owners.
- **Back up, then replace one file.** `install` refuses a source it did not generate, never
  overwrites the `.orig` backup, and touches only the checkout you name. Never edit headers
  (`ps2_pad.h` included: a header change rebuilds every generated file) and never clean the build.

## Hands off to

- `/console-tester` to run the port with a replay script (`run.py boot --input ...`).
- `/console-anywhere` to build for the device the controller is for (Steam Deck, Android, Vita).
- `/console-backend` if the game needs rumble or a pad call the runtime does not implement yet.

© Jake Schincariol · MIT · Jakeschincariol/console-skill

Похожие скиллы

Каталог скиллов SKILL.md →
recovery-controller-setup aws Скилл recovery-controller-setup настраивает AWS Application Recovery Controller: routing controls с safety rules для failover между регионами и zonal shift для восстановления после сбоя зоны доступности. CX Codex +1 4 700установок unit-test-controller-layer giuseppe-trisciuoglio Скилл unit-test-controller-layer для Claude Code генерирует модульные тесты REST-контроллеров Spring с MockMvc и Mockito. Проверяет HTTP-статусы, валидацию и JsonPath без запуска полного контекста. CX Codex +1 4 000установок omada-controller jakeasmith Скилл omada-controller для Claude Code, Codex, Cursor, Copilot и других агентов, который подключается к TP-Link Omada SDN Controller через Open API. CX Codex +1 880установок opencode-controller sundial-org Скилл opencode-controller для управления Opencode через слэш-команды. Выбирает модель ИИ, переключает агентов между планированием и разработкой, управляет сессиями проекта. CX Codex +1 167установок glab-runner-controller vince-winkintel Скилл glab-runner-controller для Claude Code управляет контроллерами GitLab Runner и их токенами. Срабатывает на запросы о создании контроллера, его областях действия или токенах. CX Codex +1 113установок git-context-controller davila7 Скилл git-context-controller организует память ассистента в виде версионируемой файловой структуры .GCC/. Он сохраняет контрольные точки проекта, ведёт ветки для экспериментов и восстанавливает контекст между сессиями. CX Codex +1 82установок

Из того же набора12

Весь набор →
console-physics Скилл console-physics для Claude Code ищет физические константы в ELF игры и печатает патчи для PCSX2 и PS2Recomp. Запускается для скорости, гравитации, прыжка, сцепления и FPS. CX Codex +1 ★ 449звёзд репо console-levels Скилл console-levels для Claude Code находит на извлечённом диске PS2 архивы уровней, распаковывает их в отдельные файлы и собирает обратно после правок. Запускается на просьбу «распакуй этот архив». CX Codex +1 ★ 449звёзд репо console-anywhere Скилл console-anywhere для Claude Code готовит сборку PS2Recomp для выбранного устройства и собирает папку для игрока. Запускается по просьбе собрать порт для Steam Deck, Android, Mac или другого поддерживаемого устройства. CX Codex +1 ★ 449звёзд репо console-sound Скилл console-sound для Claude Code извлекает аудиодорожки из файлов PS2 и добавляет в них собственные записи. Он работает с форматами VAG и SPU2 ADPCM, преобразуя их в WAV для редактирования. CX Codex +1 ★ 449звёзд репо console-tester Скилл console-tester для Claude Code автоматизирует плейтестинг портов PS2. Запускает ELF через ps2EntryRunner, отслеживает сбои, разбирает логи по адресам и сравнивает дампы с PCSX2. CX Codex +1 ★ 449звёзд репо console-backend Скилл console-backend для Claude Code разбирает логи PS2Recomp и ранжирует проблемы backend. Он подключается после остановки игры или команды про syscall, IOP и stub. CX Codex +1 ★ 449звёзд репо console-mod Скилл console-mod для Claude Code переносит читы и патчи PCSX2 в порты PS2Recomp. Запускается по запросу добавить чит, портировать .pnach или изменить механику игры. CX Codex +1 ★ 449звёзд репо console-graphics Скилл console-graphics для Claude Code выгружает и пересобирает PS2-текстуры, а также ищет патчи широкого экрана. Запускается по запросам о 16:9 и проблемах рендера. CX Codex +1 ★ 449звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой