RPGツクールMZ用データベース整頓ツール

2026/09/19

 RPGツクールMZ用のデータベース整頓ツールです。
 Claude Codeで作成しました。

 通常、ツクール上でデータを入れ替えた場合、他のDBやマップイベントからの参照には反映されません。そちらを入れ替えたい場合は手作業で一つずつ変更していく必要があります。しかしながら、ツクール上の操作だけでは各データがどこで使用されているかを知るのも困難です。

 このツールはそういったデータベースの整頓作業を自動化します。データを入れ替えた場合は、他のDBやマップイベント側の変更も自動的に実行できます。


主な機能

  • DB項目の並び替え
  • 使用箇所の検索
  • 不要コマンドの一括削除
  • 素材ファイル名の置換
  • 日本語/英語対応

 プラグインパラメータも検索&置換の対象となります。
 ただし、対象となるのはアノテーション(例:@type actor)が設定されており、紐づくDBが明確な場合だけです。特殊な実装をしているプラグインや設定のないプラグインだと検索できないことがあります。

検索できないもの

  • メモ欄のタグ(<ActorID:5>のような記述)。
  • 文章中の名前、変数参照(例:\n[1], \v[1])。
    ※文字列として検索&置換すること自体は可能です。
  • スクリプト。
  • アノテーション(例:@type actor)指定のないプラグインパラメータ。

 なお、スクリプトでも$gameSwitches.value(), $gameSwitches.setValue(), $gameVariables.value(), $gameVariables.setValue()については例外的に対象としています。

 入念なテストをしたわけでもない非公式の怪しい代物なので、開発中のプロジェクトに対する使用は要注意です。上述の通り置換できないデータもあるので、長期間開発した大きなプロジェクトほど問題が起きやすいです。

 このツールで何らかの問題が起こっても一切の保証はできません。必ず事前にプロジェクトのバックアップを取ってください。

 検索機能については、比較的安全に使用できると思います。


目次


導入方法(Install)

更新履歴(History)

保存とバックアップについて

データベース(アクター〜変数)

プラグインパラメータ

イベントコマンド

文章の表示

詳細検索&置換

本文から名前に変換

素材


導入方法(Install)


 以下のファイルをダウンロードして解凍してください。
 exeファイルをクリックすると起動します。

 NRP_DatabaseOrganizerMZ.zip ver1.03(2026/09/19)

更新履歴(History)


2026/09/19(ver1.03)

  • 素材タブにて、対応できていない素材種別が多数あったので修正した。

2026/08/18(ver1.02)

  • スキルの検索対象にイベントコマンドの『戦闘行動の強制』が含まれていない不具合修正。
  • @type skill[]など配列型のアノテーションを参照できていなかった不具合を修正。

2026/07/12(ver1.01)

  • タイプにも対応した。
  • 素材のファイル名変更機能を追加した。
  • プラグインパラメータタブにプラグイン名での検索を追加した。
  • 素材の「ファイルを置換」時にプラグインパラメータに登録されているファイル名を置換できていない不具合修正。
  • マウスドラッグで項目を入れ替える場合、一番下への入れ替えができない不具合修正。
  • 別プロジェクトを読み込んだ時にプラグインパラメータタブなどが前のままになっている不具合修正。

2026/07/05(ver1.00)

  • 公開!

保存とバックアップについて


 当ツールにおいて実際にファイルが更新されるのは保存ボタン(Ctrl+S)を押したタイミングになります。それまではメモリ上を書き換えているだけなので、ファイルには反映されません。

 保存時に変更を実行したファイルのバックアップを取る仕様です。初期設定では、当ツールの直下に作成されます。
 もし、何らかの問題が起きた場合は復旧にご利用ください。

 なお、あまり何度も大きな変更と保存を繰り返すと、バックアップのファイルサイズもどんどん膨れ上がっていきます。ご注意ください。

 当ツールはツクールMZを起動したまま併用することも可能です。ツクールMZはファイルの更新を常に検知しているらしく、保存時にはリロードを促すメッセージが表示されます。

データベース(アクター〜変数)


 データベース項目の検索や並び替えが可能です。
 上下矢印のボタンやマウスドラッグで入れ替えができます。Ctrl+カーソルキー上下でも入れ替えができます。


 削除/挿入も可能です。
 削除については、Shiftキーを押しながらの複数削除にも対応しています。
 ただし、削除や挿入はわりと影響が大きい処理です。対象項目より下の全項目のIDがズレるため、さらにその全てを参照しているマップデータに対して更新がかかります。

 各項目をダブルクリックすると、使用箇所を検索表示できるので参考にしてください。入替を実行した場合は、ここに表示されている全てのファイル(+入替先の使用箇所)が更新対象となります。

 DBに存在しないIDへの参照が存在する場合は、赤い警告マークが表示されます。(上の画像だとコモンイベント)
 詳細は右上の「情報欄を表示」ボタンから確認できます。

プラグインパラメータ


 プラグインパラメータの検索ができます。
 今のところ検索しかできません。


 ちなみにプラグインコマンドの使用場所を調べたい場合は、以下のイベントコマンドで可能です。プラグインコマンドを選択し、プラグイン名などで検索をかけてください。

イベントコマンド


 イベントコマンドの検索や削除ができます。
 例えば、不要になったコモンイベントなどを一括で削除できます。


 ただし、以下のイベントコマンドや「全て」については削除の対象外です。これらは入れ子構造を持ち、削除の影響が大きいためです。
 「選択肢の表示」「条件分岐」「ループ」「スキップ」「戦闘の処理」

 検索結果に対してダブルクリックすると、そのパラメータを検索欄にセットして再検索することもできます。

 イベントコマンドは件数が非常に多いので、このタブのみ表示件数の制限(1000件ずつ)をかけています。検索条件なども組み合わせてご活用ください。

文章の表示


 文章の表示コマンドの検索&置換を行います。
 文章の表示はイベントコマンドでも検索できますが、より詳細な操作が可能です。(削除はイベントコマンド専用の機能です。)
 ※現状は文章の表示だけが対象です。「選択肢の表示」や「文章のスクロール表示」は対象外となっております。


 検索の選択はマップ単位です。「子マップも対象」のチェックを入れた状態で親マップを選択すると、まとめて検索できます。特に一番上のプロジェクトルートを選択すると、プロジェクト全体を検索することも可能です。
 当画面では、名前と本文を区別して検索できます。

詳細検索&置換

 正規表現(参考)によって詳細な検索を行います。さらに検索結果に対して、一括置換を行うことも可能です。
 ※正規表現では\や[]はエスケープする必要があります。
  (例:『\n[1]』→『\\n\[1\]』)
 ※行の削除や追加には対応していません。削除時は空行になります。
 ※置換後の文字列は正規表現ではなく通常入力してください。



 サンプルとして『本文が4行の文章』『本文一行が20字以上』『本文行頭の「を一括削除』『名前\n[1]を\n[2]に一括置換』といったものがあります。
 「現状は4行まで文章を書いていたが、3行以下に統一したい」とか「一行が長すぎる文章は修正したい」とかそういった用途を想定しています。

本文から名前に変換

 ツクール2000やMVなど旧ツクールから作品データを移行した際に、本文内に名前が含まれたままになっていることがあります。
 そういった場合、名前が格納されているルール(正規表現)を指定することで、本文内の名前を一括で名前欄に移行できます。


 正規表現に関してはサンプルを参考にしてください。
 例えば、『【】で囲まれている部分』『2行目が「で始まっている文章の一行目』などがサンプルにあります。

 あまりないと思いますが、名前と本文に何の区切りもない場合は移行が難しいです。(名前と本文に区切りがなく、一行目から本文が始まるケースがあるなど。)

素材


 作中で参照されている素材を検索表示します。
 DBやイベントコマンド、プラグインパラメータから参照されているファイルが対象です。ファイルが存在しない場合は赤色で表示されます。


 各ファイル毎に置換やファイル名の変更が可能です。
 ファイルを差し替えたい場合や、ファイル名を変更したい場合に有効です。

 >RPGツクールMZ&MV目次に戻る
posted by 砂川赳 at 14:15 | RPGツクールMZ&MV | このブログの読者になる | 更新情報をチェックする