/*------------------------------
Copyright (c) 2025 PotatoDragon
Released under the MIT License.
https://opensource.org/license/mit
------------------------------*/

/*:
@target MZ
@url https://raw.githubusercontent.com/pota-gon/RPGMakerMZ/refs/heads/main/plugins/System/Ex/ExLevel.js
@plugindesc Lv Reference Control Character Ver1.0.1 (2025/7/22)
@author PotatoDragon
@license MIT License

@help
English Help Translator: munokura
This is an unofficial English translation of the plugin help,
created to support global RPG Maker users.
Feedback is welcome to improve translation quality
(see: https://github.com/munokura/PotatoDragon-MZ-plugins ).
Original plugin by PotatoDragon.
Please check the latest official version at:
https://github.com/pota-gon/RPGMakerMZ/wiki
-----

## Overview
Adds the control character \Lv to reference the level.

## Usage
By writing \Lv[Actor ID] OR \Lv[Actor Name],
you can reference the level of the corresponding actor.
*/

/*:ja
@plugindesc
Lv参照制御文字 Ver1.0.1(2025/7/22)

@url https://raw.githubusercontent.com/pota-gon/RPGMakerMZ/refs/heads/main/plugins/System/Ex/ExLevel.js
@target MZ
@author ポテトードラゴン

・アップデート情報
Ver1.0.1: アクター名を指定できる機能追加
Ver1.0.0: 公開

Copyright (c) 2025 ポテトードラゴン
Released under the MIT License.
https://opensource.org/license/mit

@help
## 概要
レベルを参照する制御文字 \Lv を追加します

## 使い方
\Lv[アクターID] OR \Lv[アクター名] のように記載すると  
該当するアクター のレベルを参照できるようになります
*/
(() => {
    'use strict';

    // ベースプラグインの処理
    function Potadra_search(data, id, column = "name", search_column = "id", val = "", initial = 1) {
        if (!id) return val;
        for (let i = initial; i < data.length; i++) {
            if (!data[i]) continue;
            if (search_column && data[i][search_column] == id) {
                val = column ? data[i][column] : data[i];
                break;
            } else if (i == id) {
                val = data[i];
                break;
            }
        }
        return val;
    }
    function Potadra_nameSearch(data, name, column = "id", search_column = "name", val = "", initial = 1) {
        return Potadra_search(data, name, column, search_column, val, initial);
    }
    function Potadra_checkName(data, name, val = false) {
        if (isNaN(name)) {
            return Potadra_nameSearch(data, name.trim(), "id", "name", val);
        }
        return Number(name || val);
    }

    /**
     * 制御文字の事前変換
     *    実際の描画を始める前に、原則として文字列に変わるものだけを置き換える。
     *    文字「\」はエスケープ文字（\e）に変換。
     *
     * @param {} text - 
     * @returns {} 
     */
    const _Window_Base_convertEscapeCharacters = Window_Base.prototype.convertEscapeCharacters;
    Window_Base.prototype.convertEscapeCharacters = function(text) {
        let tmp_text = _Window_Base_convertEscapeCharacters.apply(this, arguments);
        tmp_text = tmp_text.replace(/\x1bLv\[(.+?)\]/gi, (_, p1) =>
            this.potadraActorLevel(p1)
        );
        return tmp_text;
    };

    /**
     * アクター n 番のレベルを取得
     *
     * @param {} n - 
     * @returns {} 
     */
    Window_Base.prototype.potadraActorLevel = function(n) {
        const actor_id = Potadra_checkName($dataActors, n);
        if (!actor_id) return "";

        return $gameActors.actor(actor_id)._level;
    };
})();