Repository navigation
BVEマップエディターがアップデート!
BVEマップエディターをアップデートしました。構文エラーチェックにより分かりやすく!
BVE Trainsim 5 / 6 のマップ(BveTs Map 2.02)を書くための専用テキストエディタです。書いている間に構文をチェックし、間違っている所に波線を引き、直し方の候補まで出します。
主な機能
リアルタイムの構文チェック
- 入力に合わせて裏で構文をチェックします(エディタは固まりません)。保存したとき・ほかのソフトから戻ったときもチェックし直します。
- エラーは赤、警告はオレンジの波線で、間違っている部分(キー・ファイル名・コマンド名など)だけに引きます。
- 画面下の「構文エラー一覧」をダブルクリックすると、その行・列へ移動します(include 先のエラーはそのファイルを開きます)。長いメッセージやファイル名は、マウスを乗せると全文を吹き出しで表示します。
- 次のような間違いを見つけます。
;抜け・;の連続、()[]の抜けや閉じ忘れ、'の閉じ忘れ、全角の英数字・記号(全角スペースは BVE5・BVE6 でエラーにならないため出しません)- 知らないコマンド、引数の数の間違い、文字列の引数の
' '忘れ - リストファイル(ストラクチャー・サウンド・ステーションなど)にないキー、必須の Load がない、Load の順番
- include 先のファイルの中身(ファイルがない・循環 include も)
- 変数(
$名前)の使い方: その行より前で値を入れていない変数、$の後ろに名前がない、値と値の間に演算子がない($a $a;など) - 距離程の式の間違い(
distance +;、マイナスの距離程など。変数を使った距離程も同じようにチェック) - カーブ・勾配・カントの
BeginTransition→Begin/Endの順番(BVE と同じく、距離程の順に並べてから調べます。include 先ごとに路線の始めから書いたマップでも正しく調べます) - BveEx(拡張構文):
BveEx.MapPlugin.Loadに書いたプラグインの一覧(xml)の書き方と、そこに書いたプラグイン(dll)があるかを調べます。BveEx を使っていることの「注意」は、最初の 1 か所だけに出します。BveEx が入っているパソコンでは出しません(プラグインごとのコマンドの中身は調べません)
- リストファイル(CSV)は UTF-8 / Shift-JIS のどちらでも読めます(日本語のキーにも対応)。
修正の候補(ワンクリックで直す)
- エラー一覧の行、またはエディタのエラーのある行を右クリックすると、「修正の候補」が出ます。
;を足す、全角を半角に、()や.を足す、'を閉じる、キーを' 'で囲む など- つづりの近いコマンド名・キーを最大3つ候補に出します(例:
Structre→Structure) - 引数の数が合う兄弟のコマンド(
Put↔Put0)に変える、足りない引数を足す・多い引数を消す - 必須の Load の行、
Cant.SetGaugeの行、BeginTransitionの行(距離程をダイアログで選ぶ)を足す
- 同じファイルの同じ種類のエラーは「まとめて直す」で一度に直せます。どれも Ctrl+Z で元に戻せます。
- エラー一覧の「このエラーについて検索・ヘルプを表示」で、エラーの種類ごとの解説ページ(原因・直し方・例)を開けます。
自動補完
- コマンドの入力補完に加えて、
Structure['などと打つと、読み込んだリストファイルのキーを候補に出します。 - キーを選ぶと
']が自動で入り、続けて.Put();などの関数を候補に出します。 - 「設定」メニューで、自動補完・キーの自動補完をそれぞれオン・オフできます。
$変数にマウスを乗せると、その場所で使われる宣言(どのファイルの何行目で、何を入れたか)を吹き出しで表示します。同じ変数を何回か宣言していても、その場所より前でいちばん近い宣言を出します(「設定」でオン・オフ)。
便利な機能
- 終了時にタブごとのカーソルの位置を記録し、次に開いたときにその位置に戻します(「設定」でオン・オフ)。
- エラー一覧の右クリックメニューの「すべてコピー」で、エラーを全部 Excel やメモ帳に貼れる形でコピーできます。
- BVE ではエラーにならない一部の警告(
Background.Change('')の空のキー、;の連続)は、エラー一覧の右クリックの「この種類を表示しない」で隠せます。「設定」➔「表示しない警告」で元に戻せます。 - CSV(リストファイル)を開くと、列の始まりがそろって表示されます。ファイルの中身は変わりません(「設定」でオン・オフ)。
- リストファイルは専用の色分けで表示されます(キー・ファイルのパス・時刻や数字・コメントを色で区別)。
- マップを右クリックして「ストラクチャーを追加…」を選ぶと、キーと .x ファイルを入れるだけでストラクチャーリストに 1 行足せます(リストのタブで確かめてから保存します)。「サウンドを追加…」「サウンド3Dを追加…」で、.wav のファイルも同じように足せます。「駅を追加…」では、駅名や到着・発車時刻などを入れてステーションリストに駅を足せます(細かい値は、リストの最後の駅の値が初めに入ります)。「キーがリストファイルに存在しません」のエラーでは、修正の候補からそのキーをリストに足すダイアログを開けます。
- Load や include に書いたファイルがないときは、修正の候補の「○○を作る…」で、リストの見出しだけのファイル(include は空のファイル)を作れます(マップのフォルダの中だけ。すでにあるファイルは上書きしません)。
- 日本語入力がオンのとき、変換キーでカーソルの周りの文字(選んでいれば選んだ文字)を変換し直せます(再変換)。Ctrl+Z 1 回で変換前に戻せます。
編集・ファイル
- 大きなマップファイルでも軽く動きます(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)として保存・復元できます。
アップデートの確認
- 「ヘルプ」➔「アップデートを確認…」で、GitHub に新しいバージョンがあるかを確かめられます。新しいバージョンがあれば、ダウンロードのページを開くか尋ねます(自動でダウンロードはしません)。
BVE との連携
- エディタのメニューから BVE 5 / 6 本体や QuickMapViewer を起動できます(試すシナリオ・マップは起動したソフトで選びます。先にエディタで保存してください)。
安全のための対策
- 構文チェックの別プロセスとの通信は、自分が起動したプロセス・同じユーザーとだけ行います。
- 細工されたマップや巨大なファイル(20MB を超える include 先・リストファイル)で、メモリを使い切ったり固まったりしないようにしています。
- 構文チェックが 60 秒以内に終わらないときは、自動で起動し直します。
- エディタが強制終了やクラッシュで終わっても、構文チェックの別プロセスが残らないようにしています。
- 括弧がとても深い計算式(64 段を超えるもの)は計算せずエラーにして、構文チェックの別プロセスが落ちないようにしています。
インストール
BveMapEditor-(バージョン)-setup.exeを開くとインストールできます。管理者の権限は要りません(自分のユーザーのフォルダに入ります)。- スタートメニューに「BVE Map Editor」ができます。デスクトップのショートカットと
.bveepの関連付けは、インストールの画面で選べます。 - アンインストールは Windows の「アプリと機能」からできます。最後に、設定などを消すか残すかを選べます。
- 開いたときに「Windows によって PC が保護されました」と出たら、「詳細情報」➔「実行」で進めてください。
動作環境
- Windows 10 / 11(64bit)
- .NET 10.0(.NET 8.0 以降)
分かっている問題
- まれに、ファイルを開いたときにそのタブに切り替わらないことがあります(調査中)。
- まれに、構文チェックの別プロセスが止まることがあります(調査中。自動で起動し直します)。
- include 先のファイルだけを開いてチェックすると、親のマップに書いた Load が分からないため「まだロードされていない」と出ることがあります。親のマップを一度チェックすると、正しくチェックされます。
#BveEx
BveExをサポートします。自動補完はまだ動きません。