silphscope 1.3.6 → 1.4.0

package/ball-data/ballData.json

@@ -0,0 +1,38 @@
+{
+    "POKE": {
+        "index": 0
+    },
+    "GREAT": {
+        "index": 1
+    },
+    "SAFARI": {
+        "index": 2
+    },
+    "ULTRA": {
+        "index": 3
+    },
+    "MASTER": {
+        "index": 4
+    },
+    "NET": {
+        "index": 5
+    },
+    "DIVE": {
+        "index": 6
+    },
+    "NEST": {
+        "index": 7
+    },
+    "REPEAT": {
+        "index": 8
+    },
+    "TIMER": {
+        "index": 9
+    },
+    "LUXURY": {
+        "index": 10
+    },
+    "PREMIER": {
+        "index": 11
+    }
+}

package/main.js

@@ -5,5 +5,5 @@ import { extract } from "./src/graphics/extract.js"; // random message for a com
 
 export { renderMon, renderMonIcon, renderMonFoot, extract };
 
-import { renderAllMons, renderAllIcons, renderAllTrainers, renderAllMoves, renderAllGraphics } from "./src/graphics/graphics-extractor-main.js";
-export { renderAllMons, renderAllIcons, renderAllTrainers, renderAllMoves ,renderAllGraphics };
+import { renderAllMons, renderAllIcons, renderAllTrainers, renderAllMoves, renderAllBalls, renderAllGraphics } from "./src/graphics/graphics-extractor-main.js";
+export { renderAllMons, renderAllIcons, renderAllTrainers, renderAllMoves, renderAllBalls, renderAllGraphics };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "silphscope",
-  "version": "1.3.6",
+  "version": "1.4.0",
   "description": "A firered/leafgreen ROM asset extractor for use in web applications",
   "main": "main.js",
   "exports": {
@@ -22,7 +22,11 @@
     "!src/icon-data-parser.js",
     "!src/mon-data-parser.js",
     "!src/trainer-data-parser.js",
-    "!src/move-data-parser.js"
+    "!src/move-data-parser.js",
+    "!src/rom-map-parser.js",
+    "!rom-maps/",
+    "!graphics-maps/",
+    "ball-data/"
   ],
   "keywords": [],
   "author": "chickenPoo",

package/rom-configs/firered.js

@@ -21,5 +21,9 @@ export const firered = {
         itemIconTable: 0x3D4294, // newer update: (so turns out this old value was the pointer to the table lol however this new one is the actual table... for real this time!) rest of the old message: so this was very hard to find since it isn't labeled in the .map of ROMs... luckily Ghidra and the ROM decomps exist so that helped a ton... issue is I believe this contains both the palette and gfx in each listing (should probably double check pokefirered to confirm...) so it will be interesting to extract assets I suppose...
         moveAnimPicTable: 0x3ACC08,
         moveAnimPaletteTable: 0x3AD510,
+        ballParticlePicTable: 0x40BF48,
+        ballParticlePalTable: 0x40BFA8,
+        ballAnimPicTable: 0x26056C,
+        ballAnimPalTable: 0x2605CC, // any idea what I am doing next?
     } // if this works out... well hehe... :D
 }

package/src/graphics/balls/render-ball-particle.js

@@ -0,0 +1,59 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+import fs from "fs";
+import { PNG } from "pngjs";
+import { extract } from "../extract.js";
+import { render4bppImage } from "../render-4bpp-image.js";
+import { resolveBallParticlePic } from "./resolvers/ball-particle-resolver.js";
+import { resolveBallParticlePal } from "./resolvers/ball-particle-palette-resolver.js";
+
+const streamToBuffer = (stream) => new Promise((resolve, reject) => {
+    const chunks = [];
+    stream.on("data", chunk => chunks.push(chunk));
+    stream.on("end", () => resolve(Buffer.concat(chunks)));
+    stream.on("error", reject);
+})
+
+export async function renderBallParticle(ballName, balls, reader, rom, options = {}) {
+    const { outputDir = null } = options;
+    if (!rom || !(rom instanceof Uint8Array || Buffer.isBuffer(rom))) {
+        throw new TypeError("renderBallParticle(..., rom) requires a ROM Buffer/Uint8Array");
+    }
+
+    const ball = balls[ballName];
+    if (!ball) {
+        throw new Error(`Missing Ball: ${ballName}`);
+    }
+    const particlePic = resolveBallParticlePic(ball, reader, ballName);
+    const particlePal = resolveBallParticlePal(ball, reader, ballName);
+
+    if (!particlePic || !particlePal) {
+        throw new Error(`Missing assets for: ${ballName}`);
+    }
+
+    const particleImageData = extract(particlePic, rom);
+    const rawParticlePalData = extract(particlePal, rom);
+    const width = 8; // so actually the "particle image" is one image that just contains all of the particles used for the balls upon opening later on I will split the ones actually used by each ball so we aren't exporting a full redundant image :p
+    const height = 64;
+
+    const image = render4bppImage({
+        tileData: particleImageData.data,
+        paletteData: rawParticlePalData.data,
+        width,
+        height,
+    });
+
+    const png = new PNG({ width, height });
+    png.data = image;
+    const pngBuffer = streamToBuffer(png.pack());
+
+    if (outputDir) {
+        const dir = `${outputDir}/${ballName}`;
+        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+        const fileName = `${dir}/particle.png`;
+        fs.writeFileSync(fileName, pngBuffer);
+    }
+
+    return pngBuffer;
+}

package/src/graphics/balls/render-balls.js

@@ -0,0 +1,65 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+import fs from "fs";
+import { PNG } from "pngjs";
+import { extract } from "../extract.js";
+import { render4bppImage } from "../render-4bpp-image.js";
+import { resolveBallSpritePal } from "./resolvers/ball-sprite-palette-resolver.js";
+import { resolveBallSpritePic } from "./resolvers/ball-sprite-resolver.js";
+import { renderBallParticle } from "./render-ball-particle.js";
+
+const streamToBuffer = (stream) => new Promise((resolve, reject) => {
+    const chunks = [];
+    stream.on("data", chunk => chunks.push(chunk));
+    stream.on("end", () => resolve(Buffer.concat(chunks)));
+    stream.on("error", reject);
+})
+
+export async function renderBall(ballName, balls, reader, rom, options = {}) {
+    const {
+        outputDir = null,
+        ballParticles = false,
+    } = options;
+    if (!rom || !(rom instanceof Uint8Array || Buffer.isBuffer(rom))) {
+        throw new TypeError("renderBall(..., rom) requires a ROM Buffer/Uint8Array");
+    }
+
+    const ball = balls[ballName];
+    if (!ball) {
+        throw new Error(`Missing Ball: ${ballName}`);
+    }
+    if (ballParticles) {
+        renderBallParticle(ballName, balls, reader, rom, { outputDir });
+    }
+    const ballPal = resolveBallSpritePal(ball, reader, ballName);
+    const ballPic = resolveBallSpritePic(ball, reader, ballName);
+    if(!ballPal || !ballPic) {
+        throw new Error(`Missing assets for: ${ballName}`);
+    }
+
+    const ballImageData = extract(ballPic, rom);
+    const rawBallPalData = extract(ballPal, rom);
+    const width = 16;
+    const height = 48;
+
+    const image = render4bppImage({
+        tileData: ballImageData.data,
+        paletteData: rawBallPalData.data,
+        width,
+        height,
+    });
+
+    const png = new PNG({ width, height });
+    png.data = image;
+    const pngBuffer = streamToBuffer(png.pack());
+
+    if (outputDir) {
+        const dir = `${outputDir}/${ballName}`;
+        if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+        const fileName = `${dir}/ball.png`;
+        fs.writeFileSync(fileName, pngBuffer);
+    }
+
+    return pngBuffer;
+}

package/src/graphics/balls/resolvers/ball-particle-palette-resolver.js

@@ -0,0 +1,13 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+export function resolveBallParticlePal(ball, reader, ballName) {
+    const table = reader.getTable("ballParticlePalTable");
+    const entryOffset = table + ball.index * 8;
+    const ptr = reader.readPointer(entryOffset);
+    return {
+        name: `ball_${ballName}_particle_pal`,
+        offset: ptr,
+        size: 32,
+    }
+}

package/src/graphics/balls/resolvers/ball-particle-resolver.js

@@ -0,0 +1,12 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+export function resolveBallParticlePic(ball, reader, ballName) {
+    const table = reader.getTable("ballParticlePicTable");
+    const entryOffset = table + ball.index * 8;
+    const ptr = reader.readPointer(entryOffset);
+    return {
+        name: `ball_${ballName}_particle_pic`,
+        offset: ptr,
+    }
+}

package/src/graphics/balls/resolvers/ball-sprite-palette-resolver.js

@@ -0,0 +1,13 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+export function resolveBallSpritePal(ball, reader, ballName) {
+    const table = reader.getTable("ballAnimPalTable");
+    const entryOffset = table + ball.index * 8;
+    const ptr = reader.readPointer(entryOffset);
+    return {
+        name: `ball_${ballName}_pal`,
+        offset: ptr,
+        size: 32
+    }
+}

package/src/graphics/balls/resolvers/ball-sprite-resolver.js

@@ -0,0 +1,12 @@
+// Copyright (c) 2026 chickenPoo
+// Licensed under the MIT License. See LICENSE file in project root.
+
+export function resolveBallSpritePic(ball, reader, ballName) {
+    const table = reader.getTable("ballAnimPicTable");
+    const entryOffset = table + ball.index * 8;
+    const ptr = reader.readPointer(entryOffset);
+    return {
+        name: `ball_${ballName}_pic`,
+        offset: ptr, // I think this is lz77 compressed so it doesn't need a size value...
+    }
+}

package/src/graphics/graphics-extractor-main.js

@@ -10,6 +10,7 @@ import { renderTrainer } from "./trainers/render-trainers.js";
 import { RomReader } from "../rom-reader.js";
 import { getRomConfig } from "../get-rom-config.js";
 import { renderMove } from "./moves/render-moves.js";
+import { renderBall } from "./balls/render-balls.js";
 
 const currentDir = path.dirname(fileURLToPath(import.meta.url));
 
@@ -23,6 +24,7 @@ const icons = loadDefaultJson("../item-data/itemData.json");
 const trainers = loadDefaultJson("../trainer-data/trainerData.json");
 const trainersBack = loadDefaultJson("../trainer-data/trainerBackData.json");
 const moves = loadDefaultJson("../move-data/moveData.json");
+const balls = loadDefaultJson("../ball-data/ballData.json");
 
 export async function renderAllMons(rom, options = {}) {
     if (!rom || !(rom instanceof Uint8Array || Buffer.isBuffer(rom))) {
@@ -123,6 +125,24 @@ export async function renderAllMoves(rom, options = {}) {
     }
 }
 
+export async function renderAllBalls(rom, options= {}) {
+    const {
+        balls: providedBalls = balls,
+        outputDir = "./out",
+        ballParticles = true,
+    } = options;
+
+    fs.mkdirSync(outputDir, { recursive: true });
+
+    const config = getRomConfig(rom);
+    const reader = new RomReader(rom, config);
+
+    for (const ballName of Object.keys(providedBalls)) {
+        await renderBall(ballName, providedBalls, reader, rom, { outputDir });
+        console.log(`Done: ${ballName}`);
+    }
+}
+
 export async function renderAllGraphics(rom, options = {}) { // eventually I will speed this up instead of doing it sequentially :p but for now its fine I guess
     if (!rom || !(rom instanceof Uint8Array || Buffer.isBuffer(rom))) {
         throw new TypeError("renderAllGraphics(rom, options) requires rom Buffer/Uint8Array as first argument");
@@ -134,6 +154,7 @@ export async function renderAllGraphics(rom, options = {}) { // eventually I wil
         outputTrainerDir = "./out/trainers",
         outputMoveDir = "./out/moves",
         sortUnusedMoves = true,
+        outputBallDir = "./out/balls",
     } = options;
 
     await renderAllMons(rom, {
@@ -155,7 +176,12 @@ export async function renderAllGraphics(rom, options = {}) { // eventually I wil
         outputDir: outputMoveDir,
         renderMasterImage: true,
         sortUnused: sortUnusedMoves,
-    })
+    });
+
+    await renderAllBalls(rom, {
+        outputDir: outputBallDir,
+        ballParticles: true,
+    });
 }
 
 export function loadDefaultRom() {