/*: * @target MZ MV * @plugindesc 日本語・URLエンコード・文字化け・機種依存文字(丸数字等)の素材読み込み失敗を自動修復・救済します。 * @author GameLauncher * * @help * 日本語ファイル名がURLエンコード(%E3%...)されたり、ファイル名と要求パスが * 一致せず「Loading Error Failed to load」で停止してしまう現象を自動的に修復・救済します。 * 丸数字(①②...)と通常数字(1, 2...)の表記揺れやNW.jsのファイルシステム探索に対応しています。 */ (() => { 'use strict'; const hasNode = typeof require === 'function' && typeof process === 'object'; const fs = hasNode ? require('fs') : null; const path = hasNode ? require('path') : null; // 1x1 透明 PNG (Data URL) - 万が一ファイルが見つからない場合のフォールバック用 const BLANK_PNG = 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mNkYAAAAAYAAjCB0C8AAAAASUVORK5CYII='; // 丸数字・ローマ数字・全角数字のマッピングテーブル const CIRCLE_NUMBERS = ['①', '②', '③', '④', '⑤', '⑥', '⑦', '⑧', '⑨', '⑩', '⑪', '⑫', '⑬', '⑭', '⑮', '⑯', '⑰', '⑱', '⑲', '⑳']; /** * 文字列内の丸数字や全角数字、波ダッシュ等を正規化して比較用キーを生成します。 * @param {string} str - 対象文字列 * @returns {string} 正規化文字列 */ function normalizeFuzzy(str) { if (!str) return ''; let res = str.normalize('NFC').toLowerCase(); // 丸数字 -> 通常数字 for (let i = 0; i < CIRCLE_NUMBERS.length; i++) { res = res.replaceAll(CIRCLE_NUMBERS[i], String(i + 1)); } // 全角数字 -> 半角数字 res = res.replace(/[0-9]/g, s => String.fromCharCode(s.charCodeAt(0) - 0xFEE0)); // 波ダッシュ・チルダ res = res.replaceAll('\u301C', '\uFF5E'); // 全角カッコ -> 半角カッコ res = res.replaceAll('(', '(').replaceAll(')', ')'); return res; } /** * URLからファイルシステム上の実ファイルを探索します。 * @param {string} url - 読み込み対象のURL/相対パス * @returns {string|null} 実ファイルの絶対パスまたは相対パス(見つからない場合はnull) */ function findActualFile(url) { if (!fs || !path || !url) return null; // クエリパラメータやハッシュを除去 const cleanUrl = url.split('?')[0].split('#')[0]; let decodedUrl = cleanUrl; try { decodedUrl = decodeURIComponent(cleanUrl); } catch (e) { } // 中途半端に % が残っている場合の再デコード if (decodedUrl.includes('%')) { try { decodedUrl = decodedUrl.replace(/(%[0-9A-Fa-f]{2})+/g, match => { try { return decodeURIComponent(match); } catch (e) { return match; } }); } catch (e) { } } let encodedUrl = cleanUrl; try { const parts = cleanUrl.split('/'); encodedUrl = parts.map(p => encodeURIComponent(decodeURIComponent(p))).join('/'); } catch (e) { } // 1. そのままのパスで存在するか if (fs.existsSync(cleanUrl)) return cleanUrl; // 2. URLデコードしたパスで存在するか if (fs.existsSync(decodedUrl)) return decodedUrl; // 3. URLエンコードしたパスで存在するか if (fs.existsSync(encodedUrl)) return encodedUrl; // 4. ディレクトリ内の実ファイルを走査して柔軟に検索(丸数字・表記揺れ対応) try { const dir = path.dirname(decodedUrl); const targetBase = path.basename(decodedUrl); const targetExt = path.extname(decodedUrl); const targetNameWithoutExt = path.basename(decodedUrl, targetExt); if (fs.existsSync(dir)) { const files = fs.readdirSync(dir); const fuzzyTarget = normalizeFuzzy(targetBase); const fuzzyTargetWithoutExt = normalizeFuzzy(targetNameWithoutExt); for (const file of files) { const fileExt = path.extname(file); const fileNameWithoutExt = path.basename(file, fileExt); // A. 通常比較 if (file.toLowerCase() === targetBase.toLowerCase()) { return path.join(dir, file); } // B. 表記揺れ(丸数字①⇔1、全角数字等)のファジーマッチ const fuzzyFile = normalizeFuzzy(file); const fuzzyFileWithoutExt = normalizeFuzzy(fileNameWithoutExt); if (fuzzyFile === fuzzyTarget) { return path.join(dir, file); } if (fuzzyFileWithoutExt === fuzzyTargetWithoutExt && fileExt.toLowerCase() === targetExt.toLowerCase()) { return path.join(dir, file); } // C. URLエンコード/デコードされたファイル名との比較 try { const decodedFile = decodeURIComponent(file); if (normalizeFuzzy(decodedFile) === fuzzyTarget) { return path.join(dir, file); } } catch (e) { } } } } catch (e) { } return null; } /** * 実ファイルをBase64 DataURLとして読み込みます。 * @param {string} filePath - 実ファイルのパス * @param {string} mimeType - MIMEタイプ * @returns {string|null} DataURL */ function readFileAsDataUrl(filePath, mimeType = 'image/png') { if (!fs || !filePath) return null; try { const buf = fs.readFileSync(filePath); return `data:${mimeType};base64,${buf.toString('base64')}`; } catch (e) { return null; } } // ========================================================================= // 1. Bitmap ロードの救済 (ツクールMV / MZ) // ========================================================================= if (typeof Bitmap !== 'undefined') { const _Bitmap_load = Bitmap.load; Bitmap.load = function(url) { if (fs && url) { const actual = findActualFile(url); if (actual && actual !== url) { try { const actualUrl = actual.replace(/\\/g, '/'); return _Bitmap_load.call(this, actualUrl); } catch (e) { } } } return _Bitmap_load.call(this, url); }; const _Bitmap_prototype_onError = Bitmap.prototype._onError; Bitmap.prototype._onError = function() { if (!this._recoveryAttempted && this._url) { this._recoveryAttempted = true; const actualFile = findActualFile(this._url); if (actualFile) { const dataUrl = readFileAsDataUrl(actualFile, 'image/png'); if (dataUrl && this._image) { console.log(`[GameLauncher] 画像の実ファイルを特定して自動救済: ${this._url} -> ${actualFile}`); this._isLoading = true; this._hasError = false; this._image.src = dataUrl; return; } } // URLデコード版を直接 image.src に設定してリトライ try { const decoded = decodeURIComponent(this._url); if (decoded !== this._url && this._image) { this._isLoading = true; this._hasError = false; this._url = decoded; this._image.src = decoded; return; } } catch (e) { } // 最終手段: ゲーム停止・クラッシュを回避するため透明PNGで代替 if (this._image) { console.warn(`[GameLauncher] 未存在画像の透過代替を適用(エラー停止回避): ${this._url}`); this._isLoading = false; this._hasError = false; this._image.src = BLANK_PNG; if (typeof this._onLoad === 'function') { try { this._onLoad(); } catch (e) { } } return; } } _Bitmap_prototype_onError.call(this); }; } // ========================================================================= // 2. WebAudio / AudioManager ロードの救済 (ツクールMV / MZ) // ========================================================================= if (typeof WebAudio !== 'undefined') { const _WebAudio_prototype_load = WebAudio.prototype._load; WebAudio.prototype._load = function(url) { let targetUrl = url; if (fs && url) { const actual = findActualFile(url); if (actual) { targetUrl = actual.replace(/\\/g, '/'); } } return _WebAudio_prototype_load.call(this, targetUrl); }; } // ========================================================================= // 3. Graphics.printLoadingError のエラー停止緩和 // ========================================================================= if (typeof Graphics !== 'undefined' && Graphics.printLoadingError) { const _Graphics_printLoadingError = Graphics.printLoadingError; Graphics.printLoadingError = function(url) { console.warn(`[GameLauncher] Loading Error が検出されました: ${url}`); _Graphics_printLoadingError.call(this, url); }; } // ========================================================================= // 4. PluginManager スクリプト読み込みの救済 // ========================================================================= if (typeof PluginManager !== 'undefined' && PluginManager.loadScript) { const _PluginManager_loadScript = PluginManager.loadScript; PluginManager.loadScript = function(name) { if (fs && name) { const target = 'js/plugins/' + name; const actual = findActualFile(target); if (actual) { const baseName = path.basename(actual); return _PluginManager_loadScript.call(this, baseName); } } return _PluginManager_loadScript.call(this, name); }; } console.log('[GameLauncher] ResourceLoaderFix プラグインが正常にロードされました。'); })();