{"id":44567537,"url":"https://github.com/insektaure/pkteraraid","last_synced_at":"2026-04-24T13:00:57.133Z","repository":{"id":338331356,"uuid":"1157500489","full_name":"Insektaure/pkTeraRaid","owner":"Insektaure","description":"Nintendo Switch homebrew to view Pokemon Sword / Shield (+DLCs) Raid Dens, Scarlet / Violet (+ DLCs) Tera Raids with information. Read from Save / Live with interactive maps locations \u0026 coordinates.","archived":false,"fork":false,"pushed_at":"2026-04-23T21:39:16.000Z","size":7059,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-23T23:29:33.667Z","etag":null,"topics":["homebrew","nintendo","pokemon","scarlet","shield","switch","sword","violet"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Insektaure.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-13T22:23:17.000Z","updated_at":"2026-03-22T11:04:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/Insektaure/pkTeraRaid","commit_stats":null,"previous_names":["insektaure/pkteraraid"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/Insektaure/pkTeraRaid","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insektaure%2FpkTeraRaid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insektaure%2FpkTeraRaid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insektaure%2FpkTeraRaid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insektaure%2FpkTeraRaid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Insektaure","download_url":"https://codeload.github.com/Insektaure/pkTeraRaid/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Insektaure%2FpkTeraRaid/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32224413,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-24T10:26:35.452Z","status":"ssl_error","status_checked_at":"2026-04-24T10:25:27.643Z","response_time":64,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["homebrew","nintendo","pokemon","scarlet","shield","switch","sword","violet"],"created_at":"2026-02-14T01:25:21.516Z","updated_at":"2026-04-24T13:00:57.125Z","avatar_url":"https://github.com/Insektaure.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pkTeraRaid - Map Viewer\n\nA Nintendo Switch homebrew application for viewing raid details in Pokemon Scarlet \u0026 Violet and Sword \u0026 Shield.\\\nAlso includes a spawner viewer for Pokemon Legends: Arceus.\n\n## Features\n\n### Pokemon Scarlet \u0026 Violet — Tera Raids\n\n- **Dual mode support**\n  - **Save file mode** (Title Override): Reads raid data from the game's save file. Supports profile selection.\n  - **Live mode** (Applet / HBMenu overlay): Reads raid data directly from the running game's memory. Auto-detects Scarlet or Violet.\n- **Interactive map view** with raid locations for all three regions:\n  - Paldea\n  - Kitakami (The Teal Mask DLC)\n  - Blueberry Academy (The Indigo Disk DLC)\n- **Detailed raid information** including:\n  - Species with sprite preview\n  - Star rating (1-6 stars, including 6-star black raids)\n  - Tera type (with color-coded display)\n  - IVs (color-coded: gold for 31, red for 0), Nature, Ability\n  - Moves\n  - Shiny status\n  - Gender\n  - PID and EC\n  - **Reward preview** — calculated item drops from the raid seed, split by Host / Joiner / Everyone. Rare drops (Herba Mystica, Ability Patch, Ability Capsule, Bottle Cap, Gold Bottle Cap) are highlighted in gold\n- **Raid list** with scrollable list panel alongside the map, showing shiny count per region\n- **Raid filters** — composable filters to quickly find interesting raids:\n  - **X button**: Cycle preset filter (All → 5+ Stars → 6 Stars → Rare Rewards)\n  - **Y button**: Toggle shiny-only filter\n  - Filters combine freely (e.g., Shiny + Rare Rewards) and active filters are highlighted in the header\n- **Profile selector** with support for multiple Switch user profiles\n- **Game selector** for switching between Sword, Shield, Scarlet, and Violet save data\n\n### Pokemon Sword \u0026 Shield — Den Crawler\n\n- **Dual mode support**\n  - **Save file mode** (Title Override): Reads den data from the game's save file. Supports profile selection.\n  - **Live mode** (Applet / HBMenu overlay): Reads den data directly from the running game's memory. Auto-detects Sword or Shield.\n- **Interactive map view** with den locations across all three areas:\n  - Wild Area\n  - Isle of Armor\n  - Crown Tundra\n- **Den information** including:\n  - Species with sprite preview\n  - Star rating (1-5 stars)\n  - Level (derived from star rating)\n  - Pokemon types (with color-coded display)\n  - Beam type (Normal / Rare / Event)\n  - Flawless IVs\n  - IVs (color-coded: gold for 31, red for 0)\n  - Shiny prediction (up to 10,000 advances) with skip count in detail view\n  - Location name\n  - Full 64-bit seed\n- **Active/All dens toggle** — press X to switch between showing only active dens or all dens (including inactive ones) with their predicted encounters and shiny info\n- **Den list** with scrollable list panel alongside the map\n- **Profile selector** with support for multiple Switch user profiles\n- **Game selector** for switching between Sword, Shield, Scarlet, and Violet save data\n\n### Pokemon Legends: Arceus — Spawner Viewer\n\n- **Live mode only** (Applet). No save-file mode - PLA generates encounters from live spawner seeds.\n- **Region tabs** (L/R) for all 5 Hisui regions: Obsidian Fieldlands, Crimson Mirelands, Cobalt Coastlands, Coronet Highlands, Alabaster Icelands\n- **Interactive map view** with marker dots projected from world coordinates; selected spawner highlighted\n- **Spawner scan** across all groups in the map, showing for each:\n  - Predicted species (+ alpha marker `α`) resolved from per-spawner slot tables\n  - Active/inactive state (active = currently spawning in the world)\n  - Generator seed + derived group seed\n  - First fixed-spawn preview: EC, PID, nature, IVs (color-coded 31/0)\n  - Shiny prediction: \"Current\" if the first spawn is shiny, otherwise \"Shiny in N\" up to 5000 advances - using the per-group guaranteed-IV count from the marker database\n- **Mass outbreak badge**: detected group ID + spawn count overlaid on the map\n- **Filter**: Y toggles shiny-only\n\n## Compatibility\n\n- Scarlet / Violet version **3.0.1 / 4.0.0 only** !\n- Sword / Shield version **1.3.2 only** !\n- Legends: Arceus version **1.1.0 / 1.1.1 only !**\n\n## Requirements\n\n- Nintendo Switch with [Atmosphere](https://github.com/Atmosphere-NX/Atmosphere) custom firmware\n- Pokemon Scarlet, Violet, Sword, Shield, or Legends: Arceus (physical or digital)\n- **Save file mode**: Launch via title override (hold R while launching a game)\n- **Live mode**: Launch from HBMenu overlay (album applet) while the game is running\n\n## Controls\n\n| Button | Action |\n|--------|--------|\n| D-Pad / Left Stick | Navigate |\n| A | Select / View details |\n| X | Cycle filter preset (SV) / Toggle active/all dens (SwSh) |\n| Y | Toggle shiny filter (SV) / Toggle shiny-only (PLA) |\n| B | Back / Close details |\n| L / R | Switch map tab |\n| ZL / ZR | Scroll list 10 at a time |\n| - | About |\n| + | Quit |\n\n## Ultrahand overlay (Legends Arceus quick-glance)\n\n`overlay/` builds a companion `.ovl` that runs under [Ultrahand](https://github.com/ppkantorski/Ultrahand-Overlay) (libultrahand). It reads Legends Arceus spawner state from memory and shows a compact summary (current shinies + \"shiny in N\" within 100 advances) per Hisui region. Use it as a triage screen from within the game — pick a region from the menu for detail, then launch the main pkTeraRaid app when you want the map + full spawner info.\n\n### Overlay build\n\n1. Pull in the libultrahand submodule (skip if you've already run it):\n   ```bash\n   git submodule update --init --recursive\n   ```\n2. Build from the repo root:\n   ```bash\n   export DEVKITPRO=/opt/devkitpro\n   make -C overlay\n   ```\n3. Output is `overlay/pkTeraRaid.ovl`.\n\nPortlibs required in addition to the main app's SDL stack: `curl`, `zlib`, `minizip`, `mbedtls`. Install with:\n```bash\nsudo dkp-pacman -S switch-curl switch-zlib switch-libminizip switch-mbedtls\n```\n\n### Overlay install\n\nCopy `overlay/pkTeraRaid.ovl` to `/switch/.overlays/pkTeraRaid.ovl` on your SD card. Ultrahand picks it up automatically; summon Ultrahand (default: `L + ZL + Dpad-Down` or your configured combo) while PLA is running.\n\n**Overlay navigation:** menu-based. The root shows the 5 Hisui regions with a per-region shiny count summary; select one with `A` to open its detail view (current shinies + spawners within 100 advances). In the detail view, `X` teleports the player to the currently-highlighted spawner (raw marker coords). `B` returns to the region list. `Y` rescans memory on either screen.\n\n## Building\n\n### Prerequisites\n\n- [devkitPro](https://devkitpro.org/wiki/Getting_Started) with libnx\n- Switch portlibs: `SDL2`, `SDL2_ttf`, `SDL2_image`, `freetype`, `harfbuzz`, `libpng`, `libjpeg`, `libwebp`\n\nInstall portlibs:\n```bash\nsudo dkp-pacman -S switch-sdl2 switch-sdl2_ttf switch-sdl2_image switch-freetype switch-harfbuzz\n```\n\n### Build\n\n```bash\nexport DEVKITPRO=/opt/devkitpro\nmake all\n```\n\nThis produces `pkTeraRaid.nro`.\n\n### Clean\n\n```bash\nmake clean\n```\n\n## Installation\n\n1. Copy `pkTeraRaid.nro` to `/switch/pkTeraRaid/` on your SD card.\n2. Launch from HBMenu:\n   - **Save file mode**: Hold R while launching any game to open HBMenu via title override, then select pkTeraRaid.\n   - **Live mode**: With Pokemon SV running, open the album to access HBMenu overlay, then select pkTeraRaid.\n\n## Screenshots\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"screenshots/001.jpg\"\u003e\n  \u003cimg src=\"screenshots/002.jpg\"\u003e\n  \u003cimg src=\"screenshots/003.jpg\"\u003e\n  \u003cimg src=\"screenshots/004.jpg\"\u003e\n  \u003cimg src=\"screenshots/005.jpg\"\u003e\n  \u003cimg src=\"screenshots/006.jpg\"\u003e\n  \u003cimg src=\"screenshots/007.jpg\"\u003e\n  \u003cimg src=\"screenshots/008.jpg\"\u003e\n\u003c/div\u003e  \n\n## Credits\n\n- [PKHeX](https://github.com/kwsch/PKHeX) by kwsch - Save file structure and Pokemon data\n- [Tera-Finder](https://github.com/Manu098vm/Tera-Finder) by Manu098vm - Raid encounter logic and data resources\n- [RaidCrawler](https://github.com/LegoFigure11/RaidCrawler) by LegoFigure11 - Map coordinate formulas and reward table data\n- [CaptureSight](https://github.com/zaksabeast/CaptureSight) by zaksabeast - SwSh den data structures and encounter tables\n- [PKHeX Raid Plugin](https://github.com/architPokemon/PKHeX_Raid_Plugin) - SwSh den map coordinates and location data\n- [PLA-Live-Map](https://github.com/Lincoln-LM/PLA-Live-Map) by Lincoln-LM - PLA pointer chains and spawner RNG logic\n- [JKSV](https://github.com/J-D-K/JKSV) by J-D-K - Save data access approach\n- [Atmosphere](https://github.com/Atmosphere-NX/Atmosphere) - dmntcht for live memory reading\n\n## License\n\nThis project is for personal/educational use. It relies on several open-source projects, each with their own licenses. Please refer to the individual projects linked above for their respective license terms.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsektaure%2Fpkteraraid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finsektaure%2Fpkteraraid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finsektaure%2Fpkteraraid/lists"}