1.Getting Started

※このページは、公式フォーラムのModule System Documentationについて和訳したものです。

1.はじめに

1.1 Module System とは?


 Mount&Blade Module SystemとはMount&Bladeに新たな要素を追加するためのPython スクリプトのセットです。
これは、実際に公式バージョンを開発するのに用いられているシステムです。
このModule Systemを使用することで、新しい兵種、登場人物、クエスト、ダイアログ等・・・を追加したり、
既に存在しているコンテンツを編集することができます

 ここで、Mount&Blade本体はPythonを用いたり、Module System python script を直接読み込んではいないことを
注釈しておきます。python scriptはMount&Bladeが読み込むテキストファイルの生成を行います。

 Mount&BladeはMount&Blade\Modulesフォルダ以下にあるテキストファイルからそのコンテンツを読み込んでいます。
従って、(理論的には)全ての修正をこれらのテキストファイルを編集することで行うことが出来ます。
(実際、Mod開発者の内のいくらかは、これらのファイルの使用法を調べ、驚くべきMod開発を彼ら自身の手で行いました。)
しかしながら、これらのテキストファイルは可読性が低く、実用的であるとは言えません。

 現在、新しいModを作るにあたり2つの選択肢があります。一つは、このドキュメントで記述する公式のModule Systemを用いること、
もう一つが、Effidian氏の非公式エディタを用いることです。Effidian氏のエディタはGUI(グラフィカル ユーザー インターフェース)を備えており、公式Module Systemよりも扱いやすくなっています。それ故、M&Bのmod開発法を学びたい新規ユーザにとって
大変素晴らしいツールであると言えるでしょう。

1.2 Module Systemを用いるにあたって必要なもの


 Python scriptを含むModule Systemで開発を行うにあたり、あなたのシステムにPythonをインストールする必要があります。
Pythonは以下のダウンロードページで落とすことが出来ます。必要なのは最新のウィンドウズ用インストーラのみです。
http://www.python.org/download/

インストールが完了したら、環境変数パスにPythonを追加してください。重要ですので、この作業は正確に行ってください。

 Windows 9x系のシステムでは、autoexec.batファイルを編集することでpythonフォルダを環境変数パスに追加できます。
例として、PythonがC:\Python24にインストールされている場合、以下の一文を追加してください

 set PATH=C:\Python24;%PATH%

 もし貴方がWindowsXPシステムを用いている場合、少し方法が異なります。マイコンピュータを右クリックし、
プロパティを選択、詳細設定タブをクリックし、環境変数ボタンを押してPythonパスを加えてください。(例";C:\Python24"を追加)

1.3 Module Systemを入手する

Module Systemの最新バージョンは公式サイトの次のページでダウンロードできます。

 www.taleworlds.com/mb_module_system.html

Module Systemのzipファイルをダウンロードし、解凍を行ってください。
("D:"以下に解凍したと仮定すると、全てのファは"D:\ModuleSystem\"以下に展開されます。もちろん、どこに解凍してもかまいません)

1.4 Module System File

 では、Module Systemファイルを見てみましょう。展開されたPythonファイル(拡張子.py)をみてみると、、
次の4種類のファイルがあることが分かります。ファイル名が、

1.header_
2.process_
3.ID_
4.module_

で始まるものです。最初の2種類のファイルはmodule systemを実行するのに必要なファイルです。
これらのファイルは変更すべきではありません。3番目の種類のファイル(ID_)は、moduleをビルドする時に
生成される一時的なファイルです。消去したければ、消すこともできますし、module systemは再びそれを生成します。
最後の種類(module_)が、実際にコンテンツデータを含んでいるファイルです。これが変更してもよいファイルです。

1.5 新しいModuleを作る

 先に進む前に、まず新しいmodule用のフォルダを作りましょう。そのためには、Mount&Blade以下のModulesフォルダに
移動してください。(デフォルトでは"c:/Program Files/Mount&Blade/Modules"となっています。)
Modulesフォルダ以下にはNativeという名前のフォルダがあるはずです。これは、言ってみれば公式moduleです。
あなたのオリジナルmoduleを作るには、Modules以下にに新しいフォルダを作ってください。次にNative内のファイルを新しく作った
フォルダにコピーしてください。このフォルダはあなた自身のものですから、好きな名前を付けることができます。
簡単化の為に、そのフォルダはMyNewModuleと名づけられたと仮定します。

 ここまでの準備が上手く出来たかは、Mount&Bladeを起動することで確認できます。
Mount&Bladeの起動ウィンドウ内にコンボボックスがあるはずです。これであなたのプレーしたい
moduleを選択できます。では、MyNewModuleを選択してNew Gameを開始してみてください。
MyNewModuleの中身はNativeフォルダ内をコピーした訳ですから、開始されるゲームもNativeと同様のものとなります。

 次に、Module SystemがMyNewModuleフォルダをターゲットとして用いるようにしましょう。
その為には、module_info.pyファイルを編集するために開きます。(ファイルを右クリックして"IDLEで編集"を選択します。
またはノートパッドやあなたの好むテキストエディタで開いてください)そして、export_dirの示す部分を新規moduleフォルダへのパスに変更します。
例えば、新規moduleフォルダが"c:/Program Files/Mount&Blade/Modules/MyNewModule"に存在するなら、次のように変更します。

export_dir = "C:/Program Files/Mount&Blade/Modules/MyNewModule/"

これでmodule systemを利用する準備は整いました。これを確かめるために、MyNewModuleフォルダ内のconversation.txtファイルを
消去してください。次にModuleSystemのbuild_module.batファイルをダブルクリックしてください。
コマンドプロンプトが起動して次のように出力されるはずです。


D:\ModuleSystem>python process_strings.py
Exporting strings...

(略)

D:\ModuleSystem>python process_dialogs.py
exporting triggers...
exporting dialogs...

D:\ModuleSystem>pause
Press any key to continue . . .


MyNewModuleフォルダを調べてみて下さい。正常に動作していれば新しいconversations.txtファイルが生成されているはずです。

もしエラーが生じた場合、このチュートリアルを手順通りに正しく行ったかどうか、確認してみて下さい。
見直してみても駄目なら、フォーラムの検索機能を使ってみて下さい。(既に同じような問題に遭遇した人が、解決法を投稿している可能性があります)

正常に動作したなら、おめでとうございます!M&B module systemを使ってmod開発を行う準備は全て終了しました。では、Part2へ移りましょう。