MZ用プラグイン

MPP 文章の表示拡張 - MPP_MessageEX.js

シェア用テキスト:
▼MPP 文章の表示拡張(木星ペンギン様作) - MPP_MessageEX.js
https://plugin-mz.fungamemake.com/archives/2393
文章表示の機能を拡張したり表示の演出を追加します。

ふりがな:ぶんしょうのひょうじかくちょう

機能概要: 文章表示の機能を拡張したり表示の演出を追加します。

利用規約(ライセンス): MITライセンス

作者:木星ペンギン

作者サイト:https://woodpenguin.web.fc2.com/MV_Plugin/

解説ページ:https://woodpenguin.web.fc2.com/MV_Plugin/Pseudo3DBattl…

ファイル名:MPP_MessageEX.js

プラグインのヘルプ:

/*:ja
 * @target MV MZ
 * @plugindesc 文章表示の機能を拡張したり表示の演出を追加します。
 * @author 木星ペンギン
 * @url 
 *
 * @help [version 4.0.0]
 * このプラグインはRPGツクールMVおよびMZ用です。
 * 
 * ▼ [文章の表示]の制御文字
 *   SP[n]        # 文章の表示速度(秒間描写文字数n / 0:瞬間表示)
 *   AT[n]        # アニメーションタイプをn番に変更(※1)
 *   SET[n]       # 設定した文字列に変換(※2)
 *   CO[S]        # 文字列Sを1文字として表示
 *   RB[S,R]      # 文字列SにルビRを付けて表示(※3)
 *   MX[n]        # 次に表示する文字のX座標をnピクセルずらす
 *   MY[n]        # 次に表示する文字のY座標をnピクセルずらす
 *   PX[n]        # 次に表示する文字のX座標をnに変更
 *   PY[n]        # 次に表示する文字のY座標をnに変更
 *   SW[n]        # スイッチn番をONにする
 *   SN[n]        # スキルID n 番の名前に置き換える
 *   SIN[n]       # スキルID n 番のアイコンと名前に置き換える
 *   IN[n]        # アイテムID n 番の名前に置き換える
 *   IIN[n]       # アイテムID n 番のアイコンと名前に置き換える
 *   WN[n]        # 武器ID n 番の名前に置き換える
 *   WIN[n]       # 武器ID n 番のアイコンと名前に置き換える
 *   AN[n]        # 防具ID n 番の名前に置き換える
 *   AIN[n]       # 防具ID n 番のアイコンと名前に置き換える
 *   WE           # イベントの演出が終了するまでウェイト(※4)
 *   C[r,g,b]     # 文字色をRGBで指定
 *   FS[n]        # 文字サイズをnに変更 / デフォルト値:MV=28,MZ=26
 *   OP[n]        # 文字の不透明度(0~255) / デフォルト値:255
 *   OC[n]        # 文字の縁の色をn番に変更 / 0:デフォルト(黒)
 *   OC[r,g,b]    # 文字の縁の色をRGBで指定
 *   OC[r,g,b,a]  # 文字の縁の色をRGBAで指定(※5)
 *   OW[n]        # 文字の縁の太さを変更 / デフォルト値:4
 *   RC[n]        # ルビの色をn番に変更 / 0:デフォルト
 *   RC[r,g,b]    # ルビの色をRGBで指定
 *   RC[r,g,b,a]  # ルビの色をRGBAで指定(※5)
 *   DF           # 文章表示の設定をデフォルト値に戻す(※6)
 *   SV           # 現在の文章表示の設定を記憶(※6)
 *   LD           # SVで記憶した設定の呼び出し(※6)
 *
 *  - 以下は文章内に含まれていた場合に適用
 *   A            # 決定キーやシフトキーによるスキップの禁止
 *   ES           # イベントの演出のスキップを一時的に有効にする(※7)
 *  
 *  - すべての制御文字は大文字小文字どちらでも可能
 * 
 * ▼ 制御文字詳細
 *  ※1: AT[n] (アニメーションタイプをn番に変更)
 *   - アニメーションタイプのデフォルトは以下のようになります。
 *       0: デフォルト
 *       1: 文字が右にスライドしながら浮かび上がる
 *       2: 文字が横に広がりながら表示される
 *       3: 文字が拡大しながら表示される
 *       4: 文字を左側から表示する(表示速度6推奨)
 *  
 *  ※2: SET[n] (設定した文字列に変換)
 *   - プラグインパラメータ[Text Set]で指定した文字列に変換します。
 *   - 制御文字も設定可能です。
 *  
 *  ※3: RB[S,R] (文字列SにルビRを付けて表示)
 *   - ルビを振った文字列は一文字ずつではなくまとめて表示されます。
 * 
 *  ※4: WE (演出が終了するまでウェイト)
 *   - プラグインパラメータ[Wait Effects]で設定したイベントの演出が終了するまで
 *     ウェイトを行います。
 *   - 文章のスキップを行ってもウェイトがかかります。
 * 
 *  ※5: OC[r,g,b,a] (文字の縁の色をRGBAで指定)
 *   - アルファ値(a)は0.0~1.0で指定してください。
 * 
 *  ※6: DF, SV, LD (文章表示の設定を初期化/保存/呼び出し)
 *   - プラグインパラメータ[Text Informations]で対象となる情報を指定してください。
 * 
 *  ※7: ES (イベントの演出のスキップを一時的に有効にする)
 *   - 詳細はプラグインコマンドの SetEffectSkip を参照。
 * 
 * ▼ プラグインコマンド詳細
 *  - MVでは数値を入力する項目で v[N] と記述することで変数N番を参照します。
 *  - MZでは数値を入力する項目で、テキストを選択して v[N] と記述することで
 *    変数N番を参照します。
 *    
 *  〇 MV / MZ
 *  
 *  〇 SetMesRow row  / メッセージ行数設定
 *       row : メッセージウィンドウの行数
 *   - メッセージウィンドウの表示行数をn行に変更します。
 *    
 *  〇 SetMesFadeOut type  / メッセージフェードアウト
 *       type : フェードアウトのタイプ
 *   - フェードアウトのタイプを変更します。
 *   - 指定するタイプは以下の通りです。
 *       0: デフォルト
 *       1: 徐々に消える
 *       2: 上にスクロール
 * 
 *  〇 SetEffectSkip bool  / 演出スキップ
 *       bool : trueで有効, falseで無効
 *   - 文章のスキップを行った際、演出のスキップをするかどうかを変更できます。
 *   - 初期設定は無効です。
 *   - スキップする演出はプラグインパラメータ[Skip Effects]にて設定できます。
 *   - 制御文字 ES は一時的なものですが、こちらはコマンド実行後、常に適用されます。
 * 
 * ================================
 * Mail : wood_penguin@yahoo.co.jp (@は半角)
 * Blog : http://woodpenguin.blog.fc2.com/
 * License : MIT license
 * 
 * @command messageRow
 * @text メッセージ行数設定
 * @desc 
 *
 * @arg row
 * @desc 
 * @type number
 * @min 1
 * @default 4
 * 
 * 
 * @command messageFadeOut
 * @text メッセージフェードアウト
 * @desc 
 *
 * @arg type
 * @desc 
 * @type number
 * @max 2
 * @default 0
 * 
 * 
 * @command effectSkip
 * @text 演出スキップ
 * @desc 
 *
 * @arg boolean
 * @desc 
 * @type boolean
 * @default true
 * 
 * 
 * @param -----Basic
 * 
 * @param Text Set
 * @text 文字列セット
 * @desc SETにて呼び出す文字列のセットの配列
 * (上から SET[1],SET[2]... となります)
 * @type string[]
 * @default []
 * @parent -----Basic
 *
 * @param Text Informations
 * @text 保存するテキスト情報
 * @desc DF,SV,LDを実行した際に操作する情報
 * @type struct<Informations>
 * @default {”Text Speed”:”true”,”Anime Type”:”true”,”Text Color”:”true”,”Text Size”:”true”,”Text Opacity”:”true”,”Outline Color”:”true”,”Outline Width”:”true”,”Ruby Color”:”true”}
 * @parent -----Basic
 *
 * @param Wait Effects
 * @text 終了待ちする演出
 * @desc WE実行時に終了待ちをする演出
 * @type struct<WaitEffects>
 * @default {”Scroll Map”:”true”,”Set Movement Route”:”true”,”Show Animation”:”true”,”Show Balloon Icon”:”true”,”Move Picture”:”true”,”Tint Picture”:”true”,”Tint Screen”:”true”,”Flash Screen”:”true”,”Shake Screen”:”false”,”Set Weather Effect”:”false”,”Fadeout BGM”:”false”,”Fadeout BGS”:”false”,”Play ME”:”false”}
 * @parent -----Basic
 *
 * @param Skip Effects
 * @text スキップする演出
 * @desc 文章のスキップをした際、同時にスキップを行う演出
 * @type struct<SkipEffects>
 * @default {”Scroll Map”:”true”,”Set Movement Route”:”true”,”Move Picture”:”true”,”Tint Picture”:”true”,”Tint Screen”:”false”,”Flash Screen”:”false”,”Shake Screen”:”false”,”Set Weather Effect”:”false”}
 * @parent -----Basic
 *
 * @param Skip Effects Timing
 * @text 演出スキップのタイミング
 * @desc 
 * @type select
 * @option スキップ時
 * @value skip
 * @option 文章の表示終了時
 * @value end of text
 * @default skip
 * @parent Skip Effects
 *
 * @param Ruby Oy
 * @text ルビY軸補正値
 * @desc 
 * @type number
 * @min -9999
 * @default 0
 * @parent -----Basic
 * 
 * @param Always Leave Ruby Height
 * @text 常にルビの高さを空ける
 * @desc 
 * @type boolean
 * @default false
 * @parent -----Basic
 *
 * @param -----Default
 * 
 * @param Default Anime Type
 * @text アニメーションタイプ
 * @desc 
 * @type number
 * @default 1
 * @parent -----Default
 *
 * @param Default Message Row
 * @text メッセージ行数
 * @desc [メッセージウィンドウの表示行数]のデフォルト値
 * @type number
 * @min 1
 * @default 4
 * @parent -----Default
 *
 * @param Default FadeOut Type
 * @text フェードアウトタイプ
 * @desc 
 * @type select
 * @option 0:なし(瞬時に消える)
 * @value 0
 * @option 1:徐々に消える
 * @value 1
 * @option 2:上にスクロール
 * @value 2
 * @default 0
 * @parent -----Default
 *
 * @param Default FadeOut Speed
 * @text フェードアウト速度
 * @desc 
 * @type number
 * @default 5
 * @parent -----Default
 *
 * @param Default Text Speed
 * @text 文章の表示速度
 * @desc 
 * @type number
 * @default 60
 * @parent -----Default
 *
 * @param Default Ruby Color
 * @text ルビの色
 * @desc 
 * @default 255,255,255
 * @parent -----Default
 *
 * @param Default Ruby Size
 * @text ルビの文字サイズ
 * @desc 
 * @type number
 * @default 14
 * @parent -----Default
 *
 * @param Default Ruby Outline
 * @text ルビの縁の太さ
 * @desc 
 * @type number
 * @default 2
 * @parent -----Default
 *
 */

スポンサードリンク

スポンサードリンク

-MZ用プラグイン

Copyright© #ツクプラMZ , 2026 All Rights Reserved.