アイテム管理のデータ駆動化と音声ID自動生成【CFW P2P心理戦ゲーム開発記】 #17

{
  "001": { 
    "name": "% Mod", 
    "icon": "🧮", 
    "description": "山札のカードを今の数との剰余に変える",
    "effectType": "CALC_MODULO",
    "logTemplate": "🧮 $actor が [% Mod $val] 発動！ 山札がすべて $val で割った余りになった！"
  },
 
...ほかのアイテムの定義

}

//　元の実装（べた書き）
　　　　if (action === "USE_ITEM") {
            const { itemIndex, itemId } = payload;
            state.inventory[player].splice(itemIndex, 1);
            const itemName = ITEM_MASTER[itemId].name; 

            if (itemName === "% Mod") {
                const m = state.board.currentCard;
                state.board.queue = state.board.queue.map(x => x % m);
                Core.updateAndSync(`🧮 ${actor} が [% Mod ${m}] 発動！ 山札がすべて ${m} で割った余りになった！`);
            } else if (itemName === "~ Complement") {
                state.board.queue = state.board.queue.map(x => 11 - x);
                Core.updateAndSync(`🔄 ${actor} が [~ Complement] 発動！ 山札の数字がすべて反転した！`);
            } else if (itemName === "Garbage Collection") {
                let combined = [...state.board.queue, ...state.board.voidPool];
                Core.shuffle(combined);
                state.board.voidPool = [combined.pop(), combined.pop(), combined.pop()];
                state.board.queue = combined;
                Core.updateAndSync(`♻️ ${actor} が [Garbage Collection] 発動！ Voidと山札を再シャッフルした！`);
            } else if (itemName === "Void Scanner" || itemName === "Peek()") {
                Core.updateAndSync(`👁️ ${actor} が [${itemName}] を使用しました...`);
            } else if (itemName === "Try-Catch") {
                state.effects[player].tryCatch = true;
                Core.updateAndSync(`🛡️ ${actor} が [Try-Catch] 発動！ 次のBustペナルティを無効化します。`);
            } else if (itemName === "Context Switch") {
                state.effects[opponentId].cannotFold = true;
                state.turn = opponentId; 
                Core.updateAndSync(`⚡ ${actor} が [Context Switch] 発動！ ポットを残したまま手番を押し付けた！`);
            }
            return;
        }

// 効果の中身は別ファイル(itemEffect.js)に定義 ===================
/**
 * アイテムの実行ロジックをまとめたハンドラ群
 * @param {Object} state - ゲームのグローバルステート
 * @param {string} player - 発動したプレイヤーID ("p1" or "p2")
 * @param {string} opponentId - 相手のプレイヤーID
 * @returns {Object} - { logVars: { val: 10 }, resetTimer: boolean } を返す
 */
export const ItemEffectsBase = {

    CALC_MODULO: (state, player, opponentId) => {
        const m = state.board.currentCard;
        state.board.queue = state.board.queue.map(x => x % m);
        // JSONの $val に代入するための値を返す
        return { logVars: { val: m }, resetTimer: false };
    },
... (アイテム追加分だけここに追記する)
// ============================================================

// 元の関数部分では以下のようにシンプルになります

const effectName = itemData.effectType;
const handler = ItemEffects[effectName];

if (handler) {
    // itemEffect.js の関数を実行し、盤面の操作結果を受け取る
    const result = handler(state, player, opponentId);
    
    // ... 共通のテキスト処理などへ続く
}

// 【基本変数の置換】
// RegExpの 'g' オプションで、テキスト内の全ての該当箇所を置換する
logMsg = logMsg.replace(/\$actor/g, actorName);
logMsg = logMsg.replace(/\$name/g, itemData.name);

// 【カスタム変数の置換】
// effects.js 側から return { logVars: { val: 10 } } のように値が返ってきた場合、
// テキスト内の $val を 10 に置換する
if (result && result.logVars) {
    for (const [key, value] of Object.entries(result.logVars)) {
        logMsg = logMsg.replace(new RegExp(`\\$${key}`, 'g'), value);
    }
}

// scripts/logic-highandlow/generateAudioRegistry.js の作成例
const fs = require('fs');
const path = require('path');

const audioDir = 'ローカルの音声フォルダパス'; // 例: ./assets/audio
const outputFile = '出力先のパス'; // 例: ./public/game001/audioRegistry.json

function getFiles(dirPath) {
    if (!fs.existsSync(dirPath)) return {};
    const files = fs.readdirSync(dirPath);
    const registry = {};

    files.forEach(file => {
        if (file.endsWith('.mp3') || file.endsWith('.wav') || file.endsWith('.ogg')) {
            const id = path.basename(file, path.extname(file));
            
            // Web上で読み込むときのパス (public/以降の相対パスに成形)
            const webPath = `assets/audio/${path.basename(dirPath)}/${file}`;
            registry[id] = webPath;
        }
    });
    return registry;
}

const registry = {
    bgm: getFiles(path.join(audioDir, 'bgm')),
    se: getFiles(path.join(audioDir, 'se'))
};

// JSONファイルとして書き出す
fs.writeFileSync(outputFile, JSON.stringify(registry, null, 2));

// package.json の scripts 部分に追記
{
  "scripts": {
    "dev": "...", 
    "build": "...",
    "gen:audio-lhl": "node scripts/logic-highandlow/generateAudioRegistry.js"
  }
}