From aa4b9f524b75a008b577e3241cbd9f19db1d464c Mon Sep 17 00:00:00 2001 From: DefenderOfHyrule <11156197+DefenderOfHyrule@users.noreply.github.com> Date: Mon, 30 Mar 2026 11:00:53 +0200 Subject: [PATCH] make autoRCM boot0/boot1 warning less passive aggressive, 'improve' serial number checker and move modchip guide to getting started page as opposed to on the modchip introduction page. --- docs/_internal/serialNumberChecker.html | 24 +-------- docs/extras/autorcm.md | 2 +- docs/public/scripts/ssnc.js | 66 ++++++++++++++++++++----- docs/user_guide/getting_started.md | 8 +++ docs/user_guide/modchip/index.md | 14 +----- 5 files changed, 66 insertions(+), 48 deletions(-) diff --git a/docs/_internal/serialNumberChecker.html b/docs/_internal/serialNumberChecker.html index f08c5e5..d9578b0 100644 --- a/docs/_internal/serialNumberChecker.html +++ b/docs/_internal/serialNumberChecker.html @@ -19,29 +19,7 @@ - - - - - - - - - - - - - - - - - - - - - - - + diff --git a/docs/extras/autorcm.md b/docs/extras/autorcm.md index 2fe504e..984b2cd 100644 --- a/docs/extras/autorcm.md +++ b/docs/extras/autorcm.md @@ -8,7 +8,7 @@ AutoRCM causes the console to believe it is bricked, and will automatically laun **If you don't have a BOOT0/1 backup yet...** -You really want to kill your console, huh? If you haven't made a BOOT0/1 backup yet, it is recommended to make one **right now**. +If you haven't made a BOOT0/1 backup yet, it is recommended to make one **right now**. Please follow the steps below to do so: 1. Boot into hekate. 1. Go to `Tools`, and select `Backup eMMC`. diff --git a/docs/public/scripts/ssnc.js b/docs/public/scripts/ssnc.js index cab91bc..17d3649 100644 --- a/docs/public/scripts/ssnc.js +++ b/docs/public/scripts/ssnc.js @@ -1,3 +1,27 @@ +const MARIKO_FAMILIES = [ + { base: 'XKW', type: 'range', from: 0, to: 9 }, + { base: 'XKJ', type: 'range', from: 0, to: 9 }, + { base: 'XKE', type: 'range', from: 0, to: 9 }, + { base: 'XTW', type: 'range', from: 0, to: 9 }, + { base: 'XTJ', type: 'range', from: 0, to: 9 }, + { base: 'XTE', type: 'range', from: 0, to: 9 }, + { base: 'XJW', type: 'range', from: 0, to: 9 }, + { base: 'XJJ', type: 'range', from: 0, to: 9 }, + { base: 'XJE', type: 'range', from: 0, to: 9 }, + { base: 'XWW', type: 'range', from: 0, to: 9 }, + { base: 'XWJ', type: 'range', from: 0, to: 9 }, + { base: 'XWE', type: 'range', from: 0, to: 9 }, +]; + +function buildMarikoOptions(group) { + for (const family of MARIKO_FAMILIES) { + const opt = document.createElement('option'); + opt.value = family.base; + opt.textContent = `${family.base} (${family.from}–${family.to})`; + group.appendChild(opt); + } +} + function initSerialChecker() { const prefix = document.getElementById("serial-prefix"); const digits = document.getElementById("serial-digits"); @@ -7,7 +31,14 @@ function initSerialChecker() { if (!prefix || !digits) return; + const marikoGroup = document.getElementById("mariko-prefixes"); + if (marikoGroup) buildMarikoOptions(marikoGroup); + function checkSerial(s) { + if (s.length >= 3) { + const isMarikoFamily = MARIKO_FAMILIES.some(f => s.startsWith(f.base)); + if (isMarikoFamily) return 'mariko'; + } if (s.match(/^X[KJWT][JWCE]/)) return 'mariko'; if (s.match(/^XA[JW][9]/)) return 'refurb'; if (s.match(/^XAK[1479]/)) return 'krmaybe'; @@ -62,14 +93,14 @@ function initSerialChecker() { } const messages = { - mariko: { type: 'danger', text: 'This appears to be a Mariko (V2) Switch or Switch Lite. These are patched and not hackable via software, only via hardware modchip. Find trusted hardware modders here.' }, - switch2: { type: 'danger', text: 'This appears to be a Switch 2. These are currently not hackable.' }, - refurb: { type: 'warning', text: 'This prefix belongs to officially refurbished Switch consoles, it might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, - krmaybe: { type: 'warning', text: 'This serial might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, - maybe: { type: 'warning', text: 'This serial might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, - patched: { type: 'danger', text: 'This serial is patched. It is not hackable via software. Find trusted hardware modders here.' }, - unpatched: { type: 'tip', text: 'This serial is not patched! Click the following link to continue with the RCM path of the guide.' }, - invalid: { type: 'danger', text: 'This serial is invalid. Double-check you typed it correctly. At minimum, provide 6 digits after the prefix.' }, + mariko: { type: 'danger', text: 'This appears to be a Mariko (V2) Switch or Switch Lite. These are patched and not hackable via software, only via hardware modchip. Find trusted hardware modders here.' }, + switch2: { type: 'danger', text: 'This appears to be a Switch 2. These are currently not hackable.' }, + refurb: { type: 'warning', text: 'This prefix belongs to officially refurbished Switch consoles, it might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, + krmaybe: { type: 'warning', text: 'This serial might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, + maybe: { type: 'warning', text: 'This serial might be patched. The only way to know for sure is to manually push a payload. Continue to this page.' }, + patched: { type: 'danger', text: 'This serial is patched. It is not hackable via software. Find trusted hardware modders here.' }, + unpatched: { type: 'tip', text: 'This serial is not patched! Click the following link to continue with the RCM path of the guide.' }, + invalid: { type: 'danger', text: 'This serial is invalid. Double-check you typed it correctly. At minimum, provide 6 digits after the prefix.' }, } function redact(s) { @@ -110,8 +141,21 @@ function initSerialChecker() { digits.addEventListener("input", serialChangeEvent); } -if (document.readyState === "loading") { - document.addEventListener("DOMContentLoaded", initSerialChecker); -} else { +// make sure this component loads properly upon refreshing page/random navigation :P + +function tryInit() { + const prefix = document.getElementById("serial-prefix"); + if (!prefix) return; + if (prefix.dataset.initialized) return; + prefix.dataset.initialized = "1"; initSerialChecker(); } + +if (document.readyState === "loading") { + document.addEventListener("DOMContentLoaded", tryInit); +} else { + tryInit(); +} + +const observer = new MutationObserver(tryInit); +observer.observe(document.body, { childList: true, subtree: true }); \ No newline at end of file diff --git a/docs/user_guide/getting_started.md b/docs/user_guide/getting_started.md index 4ad8880..ec1aec9 100644 --- a/docs/user_guide/getting_started.md +++ b/docs/user_guide/getting_started.md @@ -14,6 +14,14 @@ head: [ If you already know you have a modchipped Switch console, you can skip ahead to the [Modchip Introduction](../user_guide/modchip/index) page. +A modchip is a physical modification to the motherboard of your Switch. It cannot be installed without decent microsoldering experience. You can outsource this work to people who are willing to do the job for you, or you can also view the following guide if you are willing- and able to install one yourself. + +::: tip + +Modchip Installation guide → + +**Note:** The above guide is not hosted or supported by NH Server; we cannot provide support for reviving consoles ruined by inexperience. + ::: ## Finding your serial number diff --git a/docs/user_guide/modchip/index.md b/docs/user_guide/modchip/index.md index 5255250..cc4dc0e 100644 --- a/docs/user_guide/modchip/index.md +++ b/docs/user_guide/modchip/index.md @@ -1,17 +1,5 @@ # Introduction to Modchips -## Prerequisites - -A modchip is a physical modification to the motherboard of your Switch. It cannot be installed without decent microsoldering experience. You can outsource this work to people who are willing to do the job for you, or you can also view the following guide if you are willing to install one yourself. - -::: tip - -Modchip Installation guide → - -**Note:** The above guide is not hosted or supported by NH Server; we cannot provide support for reviving consoles ruined by inexperience. - -::: - ## Information Unlike "unpatched" consoles, modchips enable CFW via CPU voltage glitching, which bypass bootROM firmware verifications. It allows a ``payload.bin`` file to be launched in place of BOOT0, loaded via a modchip firmware module named `sdloader`. This is much different from RCM and its exploit, [fusee-gelee](https://github.com/Qyriad/fusee-launcher/blob/master/report/fusee_gelee.md), which "unpatched" consoles use. @@ -19,7 +7,7 @@ Modchips allow any console, including all patched consoles, to run CFW! ## General knowledge -Patched Switch consoles (consoles produced after mid-2018) are immune to the fusee-gelee exploit in RCM. Attempting to inject a payload on a Patched console will be unsuccessful. +Patched Switch consoles (consoles produced after mid-2018) are immune to the fusee-gelee exploit in RCM. Attempting to inject a payload via RCM on a Patched console will be unsuccessful. Depending on your modchip's firmware, you may not be able to boot the console without a microSD card inserted. This means without a microSD inserted at all times, your Switch becomes *unusable*. The likelihood of the Switch becoming *unusable* is small, but still possible. To know if your modchip and its firmware support the bypassing of the firmware module `sdloader`, consult the "**About modchips and their firmware versions**" section below.