rl-item-mod 1.0.0 → 1.0.2

package/dist/index.js

@@ -2,7 +2,7 @@
 import { Command } from 'commander';
 import * as fs from 'fs';
 import * as path from 'path';
-import { execSync } from 'child_process';
+import { spawnSync } from 'child_process';
 import inquirer from 'inquirer';
 import { UPKFile } from './upk.js';
 import { resolvePackagePath, searchAssets } from './assets.js';
@@ -24,7 +24,7 @@ async function runInteractiveWizard() {
     while (active) {
         console.clear();
         console.log('Welcome to RLItemMod, What would you like to do?');
-        console.log('-----------------------------------------------------');
+        console.log('-------------------------------------------------');
         const { action } = await inquirer.prompt([{
                 type: 'rawlist',
                 name: 'action',
@@ -49,7 +49,7 @@ async function runInteractiveWizard() {
                     default: global.COOKED_DIR || DEFAULT_COOKED_DIR
                 }]);
             global.COOKED_DIR = newDir;
-            console.log(` Game directory updated to: ${newDir}`);
+            console.log(`Game directory updated to: ${newDir}`);
             await inquirer.prompt([{ type: 'input', name: 'pause', message: 'Press Enter to continue...' }]);
             continue;
         }
@@ -78,18 +78,34 @@ async function runInteractiveWizard() {
                 await inquirer.prompt([{ type: 'input', name: 'pause', message: 'Press Enter to continue...' }]);
                 continue;
             }
-            console.log(`\n Swapping ${target.item.name} for ${source.item.name}...`);
+            console.log(`\nSwapping ${target.item.name} for ${source.item.name}...`);
             const targetUpk = new UPKFile(target.path);
             try {
                 const pythonScriptPath = path.resolve(__dirname, '../python/rl_asset_swapper.py');
                 backupFile(target.path);
-                const cmd = `python "${pythonScriptPath}" --no-gui --target "${target.item.name}" --donor "${source.item.name}" --no-preserve-header-offsets --overwrite --donor-dir "${cookedDir}" --output-dir "${cookedDir}"`;
-                console.log(`\n Executing advanced Python offset-shifter...`);
-                execSync(cmd, { stdio: 'inherit' });
-                console.log(' SUCCESS: Visual Swap complete! please restart your game and view your new item!');
+                console.log(`\nExecuting Python offset-shifter...`);
+                const result = spawnSync('python', [
+                    pythonScriptPath,
+                    '--no-gui',
+                    '--target', target.item.name,
+                    '--donor', source.item.name,
+                    '--no-preserve-header-offsets',
+                    '--overwrite',
+                    '--donor-dir', cookedDir,
+                    '--output-dir', cookedDir
+                ], { stdio: ['inherit', 'inherit', 'pipe'], encoding: 'utf8' });
+                if (result.stderr && result.stderr.trim()) {
+                    console.error('\n--- Python Error Output ---');
+                    console.error(result.stderr.trim());
+                    console.error('---------------------------');
+                }
+                if (result.status !== 0) {
+                    throw new Error(`Python script exited with code ${result.status}`);
+                }
+                console.log('SUCCESS: Visual Swap complete! Restart your game to see your new item.');
             }
             catch (e) {
-                console.error(` Failed: ${e.message}`);
+                console.error(`Failed: ${e.message}`);
             }
             await inquirer.prompt([{ type: 'input', name: 'pause', message: 'Press Enter to continue...' }]);
             continue;
@@ -101,22 +117,22 @@ async function runInteractiveWizard() {
                 const files = fs.readdirSync(cookedDir);
                 const backups = files.filter(f => f.endsWith('.bak'));
                 if (backups.length === 0) {
-                    console.log(' No backups found.');
+                    console.log('No backups found.');
                 }
                 else {
                     for (const bak of backups) {
                         const original = bak.replace('.bak', '');
                         const bakPath = path.join(cookedDir, bak);
                         const originalPath = path.join(cookedDir, original);
-                        console.log(` Restoring ${original}...`);
+                        console.log(`Restoring ${original}...`);
                         fs.copyFileSync(bakPath, originalPath);
                         fs.unlinkSync(bakPath);
                     }
-                    console.log(' SUCCESS: All backups restored!');
+                    console.log('SUCCESS: All backups restored.');
                 }
             }
             catch (e) {
-                console.error(` Failed: ${e.message}`);
+                console.error(`Failed: ${e.message}`);
             }
             await inquirer.prompt([{ type: 'input', name: 'pause', message: 'Press Enter to continue...' }]);
             continue;
@@ -134,7 +150,7 @@ async function promptForItemAndUPK(message, cookedDir) {
         }]);
     const matches = searchAssets(searchTerm);
     if (matches.length === 0) {
-        console.error(` No items found matching "${searchTerm}".`);
+        console.error(`No items found matching "${searchTerm}".`);
         return null;
     }
     const { selectedItem } = await inquirer.prompt([{
@@ -149,14 +165,14 @@ async function promptForItemAndUPK(message, cookedDir) {
     const owned = selectedItem.productId.toString();
     const result = await resolvePackagePath(owned, cookedDir);
     if (!result) {
-        console.error(` Could not resolve "${owned}".`);
+        console.error(`Could not resolve "${owned}".`);
         return null;
     }
     let finalUpkPath = '';
     if ('candidates' in result) {
         let currentCandidates = result.candidates;
         while (currentCandidates.length > 20) {
-            console.log(` Found ${currentCandidates.length} potential matches.`);
+            console.log(`Found ${currentCandidates.length} potential matches.`);
             const { refine } = await inquirer.prompt([{
                     type: 'input',
                     name: 'refine',
@@ -183,27 +199,27 @@ async function promptForItemAndUPK(message, cookedDir) {
 }
 async function executePatch(upkPath, data, exportIndex) {
     try {
-        console.log(` Patching ${upkPath}...`);
+        console.log(`Patching ${upkPath}...`);
         backupFile(upkPath);
         const upk = new UPKFile(upkPath);
         upk.readSummary();
         upk.readExportMap();
         if (exportIndex === -1) {
             exportIndex = upk.exports.reduce((maxIdx, curr, idx, arr) => curr.serialSize > arr[maxIdx].serialSize ? idx : maxIdx, 0);
-            console.log(` Auto-selected Export[${exportIndex}] (Size: ${upk.exports[exportIndex].serialSize} bytes)`);
+            console.log(`Auto-selected Export[${exportIndex}] (Size: ${upk.exports[exportIndex].serialSize} bytes)`);
         }
         const newHex = (typeof data === 'string') ? fs.readFileSync(data) : data;
         upk.patchExport(exportIndex, newHex);
-        console.log(' SUCCESS: Patch complete!');
+        console.log('SUCCESS: Patch complete.');
     }
     catch (error) {
-        console.error(' CRITICAL FAILURE:', error.message);
+        console.error('CRITICAL FAILURE:', error.message);
     }
 }
 function backupFile(filePath) {
     const backupPath = `${filePath}.bak`;
     if (!fs.existsSync(backupPath)) {
-        console.log(` Creating backup: ${path.basename(backupPath)}`);
+        console.log(`Creating backup: ${path.basename(backupPath)}`);
         fs.copyFileSync(filePath, backupPath);
     }
 }
@@ -234,7 +250,7 @@ program
     let upkPath = options.upk;
     let cookedDir = options.dir;
     if (!fs.existsSync(cookedDir)) {
-        console.error(` Error: CookedPCConsole directory not found at: ${cookedDir}`);
+        console.error(`Error: CookedPCConsole directory not found at: ${cookedDir}`);
         console.log('Use --dir <path> to specify the correct game directory.');
         return;
     }
@@ -244,14 +260,14 @@ program
             upkPath = res.path;
     }
     if (!upkPath) {
-        console.error(` Error: Could not resolve item "${options.owned}" in ${cookedDir}.`);
+        console.error(`Error: Could not resolve item "${options.owned}" in ${cookedDir}.`);
         return;
     }
     await executePatch(upkPath, options.target, options.export ? parseInt(options.export) : -1);
 });
 // Handle Ctrl+C gracefully
 process.on('SIGINT', () => {
-    console.log('\n Exiting RLItemMod. See you next time!');
+    console.log('\nExiting RLItemMod.');
     process.exit(0);
 });
 async function runSafeWizard() {
@@ -260,10 +276,10 @@ async function runSafeWizard() {
     }
     catch (e) {
         if (e.name === 'ExitPromptError') {
-            console.log('\n Goodbye!');
+            console.log('\nGoodbye!');
         }
         else {
-            console.error('\n An unexpected error occurred:', e.message);
+            console.error('\nAn unexpected error occurred:', e.message);
         }
         process.exit(0);
     }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "rl-item-mod",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "description": "A comprehensive CLI tool for safely applying visual asset swaps to Rocket League UPK files with full encryption and binary offset handling.",
   "main": "dist/index.js",
   "bin": {
-    "rl-item-mod": "./dist/index.js"
+    "rl-item-mod": "dist/index.js"
   },
   "files": [
     "dist",
@@ -13,7 +13,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "start": "ts-node index.ts",
+    "start": "ts-node src/index.ts",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "keywords": [

package/dist/scratch/ts_debug_exports.js

@@ -1,33 +0,0 @@
-import { UPKFile } from '../dist/upk.js';
-const upk = new UPKFile('E:\\games\\rocketleague\\TAGame\\CookedPCConsole\\explosion_badaboom_SF.upk');
-try {
-    upk.readSummary();
-    const r = upk.dataBuffer ? new (require('../dist/upk.js').BinaryReader)(upk.dataBuffer) : null;
-    if (r) {
-        r.pos = upk.summary.exportOffset;
-        for (let i = 0; i < upk.summary.exportCount; i++) {
-            const classIndex = r.readI32();
-            const superIndex = r.readI32();
-            const outerIndex = r.readI32();
-            const objectNameIndex = r.readI32();
-            const objectNameNumber = r.readI32();
-            const archetypeIndex = r.readI32();
-            const objectFlags = r.readU64();
-            const serialSize = r.readI32();
-            const serialOffset = r.readI32();
-            const exportFlags = r.readI32();
-            const netObjCount = r.readI32();
-            console.log(`Export ${i}: NetObjCount = ${netObjCount}, pos before skip: ${r.pos}`);
-            if (netObjCount < 0 || netObjCount > 1000) {
-                console.log(`Abnormal netObjCount: ${netObjCount} at export ${i}`);
-                break;
-            }
-            r.skip(netObjCount * 4);
-            r.skip(16); // PackageGuid
-            r.readI32(); // PackageFlags
-        }
-    }
-}
-catch (e) {
-    console.error(e);
-}

package/dist/swapper.js

@@ -1,81 +0,0 @@
-/**
- * Implements the "Fixed Rename" logic from RLUPKTools.
- * This renames a name table entry IN-PLACE by padding with nulls.
- * This ensures the header size and all subsequent offsets remain identical.
- */
-export class UPKSwapper {
-    upk;
-    constructor(upk) {
-        this.upk = upk;
-    }
-    /**
-     * Renames an existing name entry to a new name.
-     * The new name must be shorter than or equal to the original name's space.
-     */
-    fixedRename(oldName, newName) {
-        if (!this.upk.summary || !this.upk.getData())
-            return false;
-        const data = this.upk.getData();
-        const nameOffset = this.upk.summary.nameOffset;
-        let pos = nameOffset;
-        for (let i = 0; i < this.upk.summary.nameCount; i++) {
-            const entryStart = pos;
-            const length = data.readInt32LE(pos);
-            pos += 4;
-            let currentName;
-            let totalBytes;
-            if (length > 0) {
-                // ANSI
-                currentName = data.toString('utf8', pos, pos + length - 1);
-                totalBytes = length;
-                pos += length;
-            }
-            else if (length < 0) {
-                // UTF-16
-                const absLen = Math.abs(length) * 2;
-                currentName = data.toString('utf16le', pos, pos + absLen - 2);
-                totalBytes = absLen;
-                pos += absLen;
-            }
-            else {
-                pos += 8; // Skip flags
-                continue;
-            }
-            // Skip ObjectFlags (8 bytes)
-            pos += 8;
-            if (currentName === oldName) {
-                console.log(` Found name entry "${oldName}" at index ${i}. Renaming to "${newName}"...`);
-                // Prepare the new string
-                const newBuf = Buffer.alloc(totalBytes, 0);
-                if (length > 0) {
-                    newBuf.write(newName, 'utf8');
-                }
-                else {
-                    newBuf.write(newName, 'utf16le');
-                }
-                // Write it back
-                newBuf.copy(data, entryStart + 4);
-                return true;
-            }
-        }
-        return false;
-    }
-    /**
-     * Swaps all references of donorName to targetName in the package.
-     * This is useful for "tricking" the engine into loading one asset instead of another.
-     */
-    swapAssetReferences(targetAssetName, donorAssetName) {
-        console.log(` Swapping references: ${targetAssetName} <-> ${donorAssetName}`);
-        // We actually want to rename the TARGET name to something else,
-        // and the DONOR name (which we might have imported) to the TARGET name.
-        // But for a simple swap where we just patch the file, we can just rename 
-        // the internal package name.
-        const success = this.fixedRename(targetAssetName, donorAssetName);
-        if (success) {
-            console.log(` Successfully swapped ${targetAssetName} for ${donorAssetName} references.`);
-        }
-        else {
-            console.warn(` Failed to find name entry for ${targetAssetName}.`);
-        }
-    }
-}