rl-item-mod 1.0.1 → 1.0.3

package/README.md

@@ -13,6 +13,16 @@ A powerful, user-friendly Node.js CLI tool for performing visual asset swaps in
 - **Automated Backups**: Automatically backs up original game assets before patching, with a one-click CLI restore feature.
 - **Item Database**: Uses a built-in `items.json` database for fuzzy-searching and mapping in-game item names directly to their underlying UPK files.
 
+## ⚠️ Warning - Some Swaps Will Crash the Game
+
+> **Swapping certain asset types is not yet fully supported and will cause Rocket League to crash on load.** This is a known limitation of the current version and is being worked on. Until a fix is released, avoid swapping the following:
+
+> Thumbnails in general cause a lot of crashes, as well as bodies and goal explosions.
+
+> If a swap you attempt causes a crash, you should validate game files, and when a crash occurs on an item use the **Restore backups** as shown in this screenshot
+
+<img width="571" height="298" alt="image" src="https://github.com/user-attachments/assets/e09d09eb-1e0e-499c-9ddd-74fea68163d0" />
+
 ## Installation
 
 ### Prerequisites

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';
@@ -83,9 +83,25 @@ async function runInteractiveWizard() {
             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(`\nExecuting Python offset-shifter...`);
-                execSync(cmd, { stdio: 'inherit' });
+                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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rl-item-mod",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "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",