Skip to content

v1.0.0

Choose a tag to compare

@ijocn0930-lang ijocn0930-lang released this 16 Nov 13:33
· 3 commits to master since this release

BVEマップエディターがリリース!

BVEマップエディターをリリースしました。構文エラーチェックにより分かりやすく!

BVE Trainsim 5 / 6 のマップ(BveTs Map 2.02)を書くための専用テキストエディタです。書いている間に構文をチェックし、間違っている所に波線を引き、直し方の候補まで出します。

主な機能

リアルタイムの構文チェック

  • 入力に合わせて裏で構文をチェックします(エディタは固まりません)。保存したとき・ほかのソフトから戻ったときもチェックし直します。
  • エラーは赤、警告はオレンジの波線で、間違っている部分(キー・ファイル名・コマンド名など)だけに引きます。
  • 画面下の「構文エラー一覧」をダブルクリックすると、その行・列へ移動します(include 先のエラーはそのファイルを開きます)。
  • 次のような間違いを見つけます。
    • ; 抜け・; の連続、() [] の抜けや閉じ忘れ、' の閉じ忘れ、全角の英数字・記号・スペース
    • 知らないコマンド、引数の数の間違い、文字列の引数の ' ' 忘れ
    • リストファイル(ストラクチャー・サウンド・ステーションなど)にないキー、必須の Load がない、Load の順番
    • include 先のファイルの中身(ファイルがない・循環 include も)
    • 変数($名前)の使い方: その行より前で値を入れていない変数、$ の後ろに名前がない、値と値の間に演算子がない($a $a; など)、同じ変数のもう一度の宣言(警告)
    • 距離程の式の間違い(distance +;、マイナスの距離程など。変数を使った距離程も同じようにチェック)
  • リストファイル(CSV)は UTF-8 / Shift-JIS のどちらでも読めます(日本語のキーにも対応)。

修正の候補(ワンクリックで直す)

  • エラー一覧の行、またはエディタのエラーのある行を右クリックすると、「修正の候補」が出ます。
    • ; を足す、全角を半角に、() や . を足す、' を閉じる、キーを ' ' で囲む など
    • つづりの近いコマンド名・キーを最大3つ候補に出します(例: Structre → Structure)
    • 引数の数が合う兄弟のコマンド(Put ↔ Put0)に変える、足りない引数を足す・多い引数を消す
    • 必須の Load の行、Cant.SetGauge の行、BeginTransition の行(距離程をダイアログで選ぶ)を足す
  • 同じファイルの同じ種類のエラーは「まとめて直す」で一度に直せます。どれも Ctrl+Z で元に戻せます。
  • エラー一覧の「このエラーについて検索・ヘルプを表示」で、エラーの種類ごとの解説ページ(原因・直し方・例)を開けます。

自動補完

  • コマンドの入力補完に加えて、Structure[' などと打つと、読み込んだリストファイルのキーを候補に出します。
  • キーを選ぶと '] が自動で入り、続けて .Put(); などの関数を候補に出します。
  • 「設定」メニューで、自動補完・キーの自動補完をそれぞれオン・オフできます。
  • $変数 にマウスを乗せると、宣言(どのファイルの何行目で、何を入れたか)を吹き出しで表示します(「設定」でオン・オフ)。

便利な機能

  • 終了時にタブごとのカーソルの位置を記録し、次に開いたときにその位置に戻します(「設定」でオン・オフ)。
  • エラー一覧の右クリックメニューの「すべてコピー」で、エラーを全部 Excel やメモ帳に貼れる形でコピーできます。

編集・ファイル

  • 大きなマップファイルでも軽く動きます(AvalonEdit)。BVE のマップ用の色分け表示つき。
  • 複数のタブで編集できます。タブの × ボタン・マウスの真ん中ボタン・右クリックメニュー(ほかのタブをすべて閉じる・パスをコピー・ファイルの場所を開く)で閉じられます。未保存なら保存するか聞きます。
  • 検索と置換(Ctrl+F)、Ctrl+マウスホイールで拡大・縮小(マウスの下の文字を中心に)。
  • 文字コードは開くときに自動で判定し、保存時に UTF-8(BOMなし/BOM付き)・Shift-JIS を選べます。ファイルごとに「次回から確認しない」も選べます。Shift-JIS で保存できない文字があれば保存前に知らせます。
  • 保存したことは、ステータスバーに「保存しました: ファイル名(時刻)」と出ます。

エクスプローラーペイン・プロジェクト

  • フォルダをツリーで表示し、ダブルクリックで開けます。リストファイル(CSV)なども確認なしで開けます。画像・音・3D モデルなどは Windows で関連付けられたソフトで開きます。
  • 新規テキストファイル・名前の変更・コピー・貼り付けができます。フォルダの中が変わっても、開いていたフォルダはそのままです。
  • 名前の変更で使えない文字や Windows の予約名(CON など)は止めます。exe・dll・sys・bat などのシステムにかかわるファイルは、名前の変更・貼り付け・名前を付けて保存で作ることができません(ATS プラグインの dll が入った車両フォルダも貼り付けできません)。こうしたファイルは、中身が文字でもエディタで開きません。
  • Windows・Program Files・ProgramData などのシステムのフォルダは開けず、中のファイルも開けません(エクスプローラーペインにも表示しません)。
  • 「プログラムから開く」やエディタへのドラッグで渡したファイルも開けます。
  • タブとエクスプローラーペインの状態を、プロジェクト(.bveproj)として保存・復元できます。

BVE との連携

  • エディタのメニューから BVE 5 / 6 本体や QuickMapViewer を起動できます(試すシナリオ・マップは起動したソフトで選びます。先にエディタで保存してください)。

安全のための対策

  • 構文チェックの別プロセスとの通信は、自分が起動したプロセス・同じユーザーとだけ行います。
  • 細工されたマップや巨大なファイル(20MB を超える include 先・リストファイル)で、メモリを使い切ったり固まったりしないようにしています。
  • 構文チェックが 60 秒以内に終わらないときは、自動で起動し直します。
  • エディタが強制終了やクラッシュで終わっても、構文チェックの別プロセスが残らないようにしています。
  • 括弧がとても深い計算式(64 段を超えるもの)は計算せずエラーにして、構文チェックの別プロセスが落ちないようにしています。

動作環境

  • Windows 10 / 11(64bit)
  • .NET 10.0(.NET 8.0 以降)

分かっている問題

  • まれに、ファイルを開いたときにそのタブに切り替わらないことがあります(調査中)。
  • まれに、構文チェックの別プロセスが止まることがあります(調査中。自動で起動し直します)。
  • include 先のファイルだけを開いてチェックすると、親のマップに書いた Load が分からないため「まだロードされていない」と出ることがあります。親のマップを一度チェックすると、正しくチェックされます。