원클릭으로 Manus에서 모든 스킬 실행

smbw-build-deploy

스타0

포크1

업데이트2026년 6월 1일 02:39

Build, deploy, run, and smoke-test the SMBW Archipelago Switch subsdk and Kivy client. Use whenever you need to compile switch-mod (subsdk9), deploy it to Ryujinx, launch the SMBW Client, tail the in-game [smbwap] log, do the first-time /setup, or run the inbound/outbound end-to-end smoke tests. Covers Windows (PowerShell) and Linux. Triggers: "build the mod", "deploy to Ryujinx", "rebuild subsdk9", "run the client", "tail the log", "smoke test".

설치

Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.

Manus에서 실행

출처

mdietz94

mdietz94/smbw_ap

GitHub 저장소 열기 Creator 저장소 보기

다운로드

Manus에서 실행

SMBW build / deploy / run

The Switch side is a hakkun subsdk (LLVM 19 + LibHakkun) under switch-mod/. The PC side is a Kivy Archipelago client under apworld/smbw_archipelago/client/. Target: SMBW v1.0.0 (title ID 010015100b514000), dev on Ryujinx 1.3.3.

Paths below are repo-relative — run from the repo root. The Ryujinx deploy path is user-specific (%APPDATA% / ~/.config). cmake may not be on PATH; on this machine it's at C:\Program Files\CMake\bin\cmake.exe — use that full path if bare cmake fails.

Prereqs

LLVM 19.1.x (clang on PATH), CMake 3.16+, Ninja, Python 3.11+. On Windows a python3.exe shim must sit beside the interpreter (LibHakkun's toolchain.cmake shells out to bare python3). devkitPro is not used — hakkun hardcodes clang/clang++.

The easiest path is the /setup wizard inside SMBW Client (probe → install missing tools → junction → build → deploy). It auto-installs system tools on Windows (winget + pinned LLVM 19.1.7); on Linux it prints what's missing and leaves the package manager to you. See docs/first-time-setup.md for the user-facing first-run flow.

Build

# Windows — incremental build (after the one-time configure below)
& "C:\Program Files\CMake\bin\cmake.exe" --build "switch-mod\build"

# Linux
cmake --build "switch-mod/build"

First-time configure (only after a fresh clone or after deleting build/):

& "C:\Program Files\CMake\bin\cmake.exe" -S "switch-mod" -B "switch-mod\build" -G Ninja

cmake -S "switch-mod" -B "switch-mod/build" -G Ninja

⚠️ Do NOT pass -DCMAKE_TOOLCHAIN_FILE. switch-mod/CMakeLists.txt sets CMAKE_TOOLCHAIN_FILE to sys/cmake/toolchain.cmake before project(), which wins over (and conflicts with) a command-line -D.

Build artifacts land in switch-mod/build/: subsdk9 + subsdk9.npdm.

Deploy to Ryujinx

$dst = "$env:APPDATA\Ryujinx\mods\contents\010015100b514000\smbwap\exefs"
New-Item -ItemType Directory -Force $dst | Out-Null
Copy-Item "switch-mod\build\subsdk9"      -Destination $dst -Force
Copy-Item "switch-mod\build\subsdk9.npdm" -Destination "$dst\main.npdm" -Force   # NOTE: renamed to main.npdm

dst="${XDG_CONFIG_HOME:-$HOME/.config}/Ryujinx/mods/contents/010015100b514000/smbwap/exefs"
mkdir -p "$dst"
cp "switch-mod/build/subsdk9"      "$dst/"
cp "switch-mod/build/subsdk9.npdm" "$dst/main.npdm"

Run the SMBW Client

The client owns the LAN socket (:17777) and UDP discovery (:17776) — nothing else runs PC-side besides the AP server, this client, and Ryujinx.

# Via Archipelago Launcher (chrome + "SMBW Client" button)
python vendor/Archipelago/Launcher.py

# Or direct module invocation (skips Launcher; add --nogui for headless CI)
python -m apworld.smbw_archipelago.client.main --connect=localhost:38281 --name=Mario

Dev-mode autodiscovery needs a junction under vendor/Archipelago/custom_worlds/ (one-time): python scripts/install_smbw_apworld.py (or run /setup, which does this as one phase). scripts/launch_client.ps1 is an all-in-one install-deps → build → install-apworld → launch.

Tail the in-game log

Our lines are prefixed [smbwap inf] / [smbwap dbg]. Ryujinx writes svcOutputDebugString to its file log with embedded NUL bytes — strip them for offline parsing (tr -d '\0').

$latest = Get-ChildItem "C:\Users\maxwe\Desktop\Switch\ryujinx-1.3.3\Logs\Ryujinx_*.log" |
          Sort-Object LastWriteTime -Descending | Select-Object -First 1
Get-Content -Wait $latest.FullName | Select-String '\[smbwap'

ls -t "$HOME/.config/Ryujinx/Logs/Ryujinx_"*.log | head -1 |
    xargs -I{} tail -F {} | tr -d '\0' | grep '\[smbwap'

End-to-end smoke tests

After build + deploy, with the AP server + SMBW Client + Ryujinx all running (full runbook with the older python -m bridge invocation is in docs/m4-runbook.md — the client command is now python -m apworld.smbw_archipelago.client.main):

Test	Action	Expect in `[smbwap]` log / game
Inbound grant	AP `/send <Player> Spring Feet Badge`	badge appears live in the equip menu within ~2 s (container-C absolute overwrite tick)
Outbound check	enter W1-1, touch the flagpole	`COURSE_CLEARED` nerve fires → location check sent to AP
Wonder Seed	grab a Wonder Seed	`WONDER_SEED_AWARDED` nerve fires → location check
Reconnect	kill + restart the client, re-enter a course	Switch `HelloMsg` replays badges/seeds; grants survive

For grant internals (which primitive each item routes to, container layout, the hash-key table) see the smbw-save-data skill. For adding new hooks/checks, see smbw-reverse-engineering. To cut a release, see smbw-release.

Python tests

python -m pytest apworld/smbw_archipelago        # client + wire + decode suite

conftest.py puts vendor/Archipelago on sys.path.

이 저장소의 다른 Skills

같은 저장소

smbw-logic

mdietz94/smbw_ap

Edit and reason about the SMBW Archipelago apworld LOGIC — the item/location/ region data tables and access rules that AP fill uses to place items and prove a seed beatable. Use when changing a region gate or location `requires`, wiring badge/seed/power-up gating, adding a check, touching Rules.py / Regions.py / Options.py / DataValidation.py or data/{items,locations,regions,game}.json, reconciling against the community logic PDF, debugging a generation failure (FillError) or "why was item X placed so late / can I even reach it" softlock, or running the generation + beatability tests. Bundles the logic-reconciliation record and the progression-wall softlock rule. Triggers: "add a region gate", "edit the logic", "regions.json", "locations.json", "why placed in W6", "softlock", "FillError", "is this beatable", "badge gating", "logic PDF", "DataValidation", "Wonder Seed count gate".

2026-07-150

smbw-reverse-engineering

mdietz94/smbw_ap

Reverse-engineer Super Mario Bros. Wonder (v1.0.0 NSO) and add/maintain Switch subsdk hooks. Use when finding a new hook target in Ghidra, identifying a Nerve or game function, installing a hakkun trampoline (NSO-offset or SDK-symbol), reading the GameDataMgr/save accessors, or debugging a hook crash. Covers the two hook patterns, the Nerve system, NSO address-space layout, the critical crash gotchas, Ghidra setup + the script inventory, and bundles the full RE decompile journal. Triggers: "find a hook", "reverse engineer", "which Nerve", "Ghidra", "hook crashes the game", "NSO offset", "trampoline".

2026-07-140

smbw-romfs-datamining

mdietz94/smbw_ap

Resolve any named SMBW GameData flag to its hash + container category OFFLINE from the game's RomFS — no Ghidra, no runtime. Use when you need a flag's murmur3 hash, want to know whether a flag is Bool/Int/Enum/Struct (which picks the probe:: writer), are tracing a world-map obstacle/actor (cloud piranhas, castle fly-in, route gates) to the saved bool that gates it, parsing BYML/SARC RomFS data (GameDataList, WorldMapInfo, actor packs, AI graphs, gparam), or brute-recovering a name from a known hash. Bundles the GameDataList schema and the Bowser-approach worked example. Triggers: "resolve a flag hash", "what container category", "murmur3 a name", "GameDataList", "extract the romfs", "BYML", "SARC", "actor pack", "which world-map flag", "name this hash".

2026-06-100

smbw-save-data

mdietz94/smbw_ap

Grant items and read/write SMBW save data via the GameDataMgr (gmd::) runtime API. Use when wiring a new AP item to an in-game grant, picking which probe:: primitive an item needs (counter / bool / badge bitfield / per-course / wonder seed), working with hash keys, the container A/B/C/D layout, the save-file byte format, or the save-survival/replay strategy. Bundles the save-file format reference and the save-OUT-vs-live-state warning. Triggers: "grant an item", "GameDataMgr", "hash key", "container A/B/C", "badge bitfield", "royal seed", "wonder seed count", "save file offset", "why doesn't the grant survive reload".

2026-06-100

smbw-release

mdietz94/smbw_ap

Cut a release of the SMBW Archipelago apworld (maintainer-only). Use when tagging a new version, building/inspecting the bundled smbwonder.apworld, running the pre-push release-gate audit, dry-running the GitHub release workflow, recovering with a manual gh release, or deciding the semver bump. Triggers: "cut a release", "tag a version", "release audit", "build the apworld bundle", "publish to GitHub".

2026-06-010

name

smbw-build-deploy

description

SMBW build / deploy / run

Paths below are repo-relative — run from the repo root. The Ryujinx deploy path is user-specific (%APPDATA% / ~/.config). cmake may not be on PATH; on this machine it's at C:\Program Files\CMake\bin\cmake.exe — use that full path if bare cmake fails.

Prereqs

Build

# Windows — incremental build (after the one-time configure below)
& "C:\Program Files\CMake\bin\cmake.exe" --build "switch-mod\build"

# Linux
cmake --build "switch-mod/build"

First-time configure (only after a fresh clone or after deleting build/):

& "C:\Program Files\CMake\bin\cmake.exe" -S "switch-mod" -B "switch-mod\build" -G Ninja

cmake -S "switch-mod" -B "switch-mod/build" -G Ninja

Build artifacts land in switch-mod/build/: subsdk9 + subsdk9.npdm.

Deploy to Ryujinx

$dst = "$env:APPDATA\Ryujinx\mods\contents\010015100b514000\smbwap\exefs"
New-Item -ItemType Directory -Force $dst | Out-Null
Copy-Item "switch-mod\build\subsdk9"      -Destination $dst -Force
Copy-Item "switch-mod\build\subsdk9.npdm" -Destination "$dst\main.npdm" -Force   # NOTE: renamed to main.npdm

dst="${XDG_CONFIG_HOME:-$HOME/.config}/Ryujinx/mods/contents/010015100b514000/smbwap/exefs"
mkdir -p "$dst"
cp "switch-mod/build/subsdk9"      "$dst/"
cp "switch-mod/build/subsdk9.npdm" "$dst/main.npdm"

Run the SMBW Client

The client owns the LAN socket (:17777) and UDP discovery (:17776) — nothing else runs PC-side besides the AP server, this client, and Ryujinx.

# Via Archipelago Launcher (chrome + "SMBW Client" button)
python vendor/Archipelago/Launcher.py

# Or direct module invocation (skips Launcher; add --nogui for headless CI)
python -m apworld.smbw_archipelago.client.main --connect=localhost:38281 --name=Mario

Tail the in-game log

Our lines are prefixed [smbwap inf] / [smbwap dbg]. Ryujinx writes svcOutputDebugString to its file log with embedded NUL bytes — strip them for offline parsing (tr -d '\0').

$latest = Get-ChildItem "C:\Users\maxwe\Desktop\Switch\ryujinx-1.3.3\Logs\Ryujinx_*.log" |
          Sort-Object LastWriteTime -Descending | Select-Object -First 1
Get-Content -Wait $latest.FullName | Select-String '\[smbwap'

ls -t "$HOME/.config/Ryujinx/Logs/Ryujinx_"*.log | head -1 |
    xargs -I{} tail -F {} | tr -d '\0' | grep '\[smbwap'

End-to-end smoke tests

Test	Action	Expect in `[smbwap]` log / game
Inbound grant	AP `/send <Player> Spring Feet Badge`	badge appears live in the equip menu within ~2 s (container-C absolute overwrite tick)
Outbound check	enter W1-1, touch the flagpole	`COURSE_CLEARED` nerve fires → location check sent to AP
Wonder Seed	grab a Wonder Seed	`WONDER_SEED_AWARDED` nerve fires → location check
Reconnect	kill + restart the client, re-enter a course	Switch `HelloMsg` replays badges/seeds; grants survive

Python tests

python -m pytest apworld/smbw_archipelago        # client + wire + decode suite

conftest.py puts vendor/Archipelago on sys.path.