CivSwitch README

README проекта с github.com/Gezine/CivSwitch. Одним файлом markdown: README.md.

CivSwitch

XSS toolchain for the Switch 1 edition of Civilization 7.
Only the 1.0.0 version of the game in physical cartridge is supported.

Every switch 1/2 firmware 20.x.x and up to current version (23.0.1) should work.

Tested at Switch 1 fw 22.5.0, Switch 2 fw 20.4.0 and 23.0.1

Two components:

Layout

core.js at the root is the shared payload both components build from, and send_js.py at the root sends any payload to a running loader.

Workflow

Video Tutorial from switch2hacks reddit

  1. Build + flash the loader UF2 (see PicoSwitch/README.md).

    On the Switch, go to "System" menu and change system language to English(US).
    Go to "Controllers & Accessories" menu and change USB Keyboard to English(US).

    These are required to type "English" letters (code) using USB keyboard.
    (Higher fw might not need to change system language as they support typing english without language change)

    NOTE for JP-only Switch2 :

    1. If you have another Switch, you can connect the two consoles via local wireless multiplayer and plug the Pico on the other device, allowing it to send the payload over the network.
    2. Use jis builds of pico uf2 firmware and enable english input at on screen keyboard settings.

    Connect to Internet using 90DNS to block Nintendo servers. (WARNING : YOU MUST READ 90DNS INSTRUCTION CAREFULLY, IF NOT GAME WILL BE LOCKED)

    Then launch game and navigate main menu -> MULTIPLAYER -> WIRELESS -> CREATE GAME -> HOST LOBBY -> CHAT then plug the Pico in (in docked mode, focus the chat box first to receive Pico input).

    The Pico types the chat XSS (~87 lines, ~20 min); the Remote JS Loader comes up on the console (TCP :9026) for that session.

  2. Install the persistent boot trigger from the PC: python installer-creator/install.py <console-ip> — uploads the save template, splices the compressed payload into it on-console, wipes save:/saves/Single/, and writes the trigger.

  3. From then on, every boot: main menu -> Load Game -> the payload runs from savedata (and if the payload is the loader, :9026 is up at boot — and survives console sleep/wake).

  4. You can revert system language after installer finished.

Sending payloads (send_js.py)

python send_js.py <console-ip> [port] file.js

Sends a JS file as-is to the Remote JS Loader (default port 9026), then prints the log output the console streams back (read until close or timeout).

Build (Pico firmware)

On Ubuntu 24.04:

sudo apt install -y git build-essential cmake ninja-build gcc-arm-none-eabi libnewlib-arm-none-eabi libstdc++-arm-none-eabi-newlib python3 nodejs npm
git clone --branch 2.3.1 --depth 1 --recurse-submodules --shallow-submodules https://github.com/raspberrypi/pico-sdk.git ~/pico-sdk
export PICO_SDK_PATH=$HOME/pico-sdk
cd PicoSwitch
npm install                    # terser for compress.js
./build_all.sh                 # payload + all four variants: pico1/pico2 x us/jis

Credits

CivSwitch (Gezine/CivSwitch)

Ищем в базе…

Что это такое?CivSwitch — набор инструментов для эксплойтов, который даёт выполнение кода в пользовательском пространстве на Nintendo Switch. Для этого используется XSS-уязвимость в чате физической версии Civilization 7 на картридже. С её помощью можно запускать на консоли произвольные JavaScript-пейлоады.
Это только программа или нужно ещё железо?Состоит из двух частей. PicoSwitch — прошивка для Raspberry Pi Pico (RP2040/RP2350), которая работает как макрос USB-клавиатуры и вводит пейлоад эксплойта в игровой чат. installer-creator — инструмент на Python, который записывает в сохранение постоянный триггер загрузки, поэтому эксплойт сохраняется и после перезагрузок.
Как на самом деле запустить эксплойт?Прошейте загрузчик на Pico. Установите системный язык Switch и раскладку USB-клавиатуры English(US), подключитесь через 90DNS. Затем в Civ7 создайте беспроводное многопользовательское лобби в роли хоста, откройте его чат и подключите Pico, чтобы он ввёл пейлоад в чат. После этого запустите с ПК python installer-creator/install.py, чтобы эксплойт сохранялся при загрузке.
Что нужно помимо самой игры?Физический картридж Civilization 7 с игрой версии 1.0.0, Raspberry Pi Pico с прошивкой PicoSwitch, ПК с Python для sendjs.py и install.py, а также Ubuntu 24.04, если нужно собрать прошивку самостоятельно.
Работает ли это на любом Switch или любой версии Civ7?Поддерживается только версия Civ7 1.0.0 на физическом картридже. Должно работать и на прошивках Switch 1 и Switch 2 от 20.x.x до актуальной 23.0.1, но протестировано лишь на нескольких конкретных сборках. Ввод пейлоада в чат занимает примерно 15 минут за каждый сеанс.
Что происходит после завершения установщика?install.py загружает шаблон сохранения и вшивает в него на консоли сжатый пейлоад. Затем он удаляет save:/saves/Single/ и записывает триггер загрузки. Поэтому при загрузке этого сохранения при любом последующем включении пейлоад запускается снова. Если это загрузчик, TCP-сервер :9026 возвращается автоматически и даже переживает переход консоли в спящий режим и выход из него.
Что делает sendjs.py?Отправляет любой файл с JavaScript-пейлоадом как есть уже запущенному Remote JS Loader по TCP на порт 9026 и выводит в ответ потоковый журнал консоли.
Зачем менять системный язык и блокировать серверы Nintendo?HID-макрос USB настроен на правильный ввод с раскладкой English(US). А 90DNS блокирует серверы Nintendo, чтобы консоль не могла передавать на них данные и получать обновления, пока настраивается эксплойт.
Откуда взялся код эксплойта?JS-ядро эксплойта основано на inject.js из проекта Netflix-N-Hack и его форка от ufm42. Прошивка PicoSwitch основана на Pico-Switch-Controller от Element2424.
Автор
Gezine
Размер
1 MB
Звёзды
755
Возраст
17 д
Коммиты · 90 дней