＄１：目的と目標と方針

牌譜(＝闘牌の進行を記録する方式)を標準化することによっていろんな素敵な環境が生まれるに違いない。
麻雀が大好きな人達が過去の対戦や遠隔地での対戦を手軽に追体験できたり、様々な大会での記録が利活用可能な形でデータベース化されたり、多くの出版物やゲームソフトなんかも出てくるかも知れない。 そして、競技技術が向上するだけでなく、『魅せる競技』『鑑賞する競技』としても麻雀がもっともっと広く認められるようになると素敵だ。
こんなことを考えて標準化案『ＭＪＲ』フォーマットを考えました。
取りあえずは、ネットによる対戦の成績や、採譜ソフトや、シミュレーションソフト等が対応してくれるととても嬉しい。
それと、批評やクイズ問題等で臨場感を高めることができたらイイと考えます。
『ＭＪＲ』フォーマットは、誰もがどのようにでも使えます。
ソフトウェアに組み込んだり、出版したり、他者に紹介することは全て自由です。
改変、定義機能の追加等も自由にできます。
『ＭＪＲ』フォーマットに対応したソフトウェアや出版物等が、独自の権利に基づいて価格を設定することそれ事体には何の制限もありません。その場合であっても、『ＭＪＲ』フォーマットの著作者はいかなる報酬も要求しないと同時に、何の保証もせず、また責任も負いません。
『ＭＪＲ』フォーマットは次に掲げるモノに採用されることを期待して定義されます。

• 採譜ソフトウェアのデータ格納形式、及び別機能のソフトウェアとの連係方式
• ネット対戦の戦況、闘牌の記録形式
• 全自動卓における半荘の記録形式
• 闘牌の再現機能を持つソフトウェアの参照方式
• 過去の名局、名勝負をデータベース化する際の記録方式

これ以外にも多くの用途があります。

＄２：ファイルの概略

ＭＪＲは基本的にはテキスト形式の可読なファイルです。
通信上、あるいはデータベース格納上、また隠蔽の目的の為に、テキストを圧縮／アーカイブ／エンコード／暗号化することは自由であり、その手法そのものは独自の形式としては定義しません。

ファイルは、牌譜を定義する行とコメント行とで構成されます。
定義行は必ず "$" で始まるタグが先頭にあり、その他の行はすべてコメント行で、ＭＪＲを解釈するアナライザはコメント行を無視します。

ＭＪＲは二つに大別され、一つは『半荘』等のゲームの一区切りの進行を記述するもので、もう一つは局の進行を記述するものです。
ゲームの区切りの進行を記述するＭＪＲを『荘ＭＪＲ』と呼び、局の進行を記述するＭＪＲを『局ＭＪＲ』と呼びます。

『荘ＭＪＲ』で記述される要素の代表的なものは、対戦が行われた時と場所や対戦者の名称や、各局での点数の授受等です。
『局ＭＪＲ』で記述される要素の代表的なものは、一局の中での各人の配牌や自摸牌、捨牌、リーチ等のアクションです。
『荘ＭＪＲ』で定義されるすべての情報は、『局ＭＪＲ』でも定義が可能です。 『局ＭＪＲ』でのみ実際の牌の去就を定義できますが、『荘ＭＪＲ』でのみ半荘全体の点数の動きなどを定義できます。

『荘ＭＪＲ』も『局ＭＪＲ』もそれぞれが独立したファイルで、単独でもデータとしては有効ですが、『荘ＭＪＲ』の一部には詳細な記述として『局ＭＪＲ』へのポインタを定義することができます。
一つの『荘ＭＪＲ』と、その中に定義される複数の『局ＭＪＲ』とで、半荘が完全に再現できます。

＄３：タグの基本

すべてのタグは、行の先頭で定義され、記号 "$" で始まります。
あるタグに対応するオペランドは、タグと同じ行にタグのすぐ後に定義されます。 一つのタグに対応するオペランドは、記号 "(" と ")" とで囲まれ、複数の要素を持つ場合には、記号 "/" で区切られます。
またタグの定義は基本的には一行内で完結しなければなりません（特別なタグの使用により複数行に定義することは可能。後述）。

一行に、複数のタグを定義することは可能です。

すべてのタグとオペランドの一部は、1バイト英文字と記号の列で表現され、大文字小文字の別を問いません。

『荘ＭＪＲ』で使用可能なタグのほとんどは『局ＭＪＲ』でも同様に使用できますが、同じ意味で使われた場合には『局ＭＪＲ』のタグが優先されます。 複数の『局ＭＪＲ』でも同じ意味で同一のタグが使用された場合には、後の『局ＭＪＲ』が有効です。

アナライザが理解できないタグがあっても、それを無視して問題なく動作します。 逆に、そのようにアナライザは作成されなければなりません。

＄４：タグの説明１−共通タグ

この章で述べられるタグは、『荘ＭＪＲ』でも『局ＭＪＲ』でも使用されます。

＄５：タグの説明２−『荘ＭＪＲ』でのみ使用可能なタグ

この章で述べられるタグは、『局ＭＪＲ』では使用できません。

＄６：タグの説明３−『局ＭＪＲ』でのみ使用可能な一般的なタグ

実際の闘牌を定義するのに十分な定義です。
この章で述べられるタグは、『荘ＭＪＲ』では使用できません。

＄７：タグの説明４−『局ＭＪＲ』でのみ使用可能な特殊なタグ

この章では、ある場面での闘牌を定義する方法を紹介します。
この章で述べられるタグは、『荘ＭＪＲ』では使用できません。

＄８：牌の表記

萬子：m1,m2,...m9
索子：s1,s2,...s9
筒子：p1,p2,...p9
東南西北／白發中：we,ws,ww,wn／dw,dg,dc
赤牌：p5r,m5r など
青牌：p5b,m5b など
白ポッチ：dwr

Ｑ：何故、こんなに複雑なのですか？

• 一目見て、とても複雑に見えます。
  もっと簡単にできるのではないかと思います。
  
• Ａ：それほど複雑ではありません。
  より多くのルールに対応したいという考えと、一つ一つの定義をなるべくシンプルにしたいとの考えから、このような形式になりました。
  異なったプラットフォームで性格が違ういくつものアナライザが動作する為には、定義のそれぞれが干渉し合わずにすむような設計が必要です。
  それにこのフォーマットを読むのは基本的には、ソフトウェアです。 そんなに複雑であるとは思えません。
  勿論、定義者の設計センスがこの程度のものに過ぎない、という指摘は当たっていますので、もっと素敵な形式を貴方が定義してください。
  

Ｑ：もっと読みやすい形にできませんか？

• ソフトが読むとは言っても、テキスト形式なわけですから、人の目にもある程度はもっと読みやすい方がいいのではないでしょうか。
  牌の表記についても、全然見慣れない形なので読みにくいです。
  
• Ａ：できます。置換タグの使用や定義の順番を工夫してください。
  置換タグ（「$$」タグ）を使ってください。
  次の定義を宣言することで、かなり一般的な形式にすることができます。
  　#----------------------- sample
  　$$(一=m1/ニ=m2/三=m3/四=m4/五=m5/六=m6/七=m7/八=m8/九=m9)
  　$$(１=s1/２=s2/３=s3/４=s4/５=s5/６=s6/７=s7/８=s8/９=s9)
  　$$(1}=p1/2}=p2/3}=p3/4}=p4/5}=p5/6}=p6/7}=p7/8}=p8/9}=p9)
  　$$(東=we/南=ws/西=ww/北=wn/白=dw/發=dg/中=dc)
  　#----------------------- sample
  筒子は通常ならば "1)" のようにすべきでしょうが、残念ながら、記号 ")" が、使用できないので、"}" で代用してみました。
  

Ｑ：小明槓の時はどのように記述するのですか？

• ポンした牌に、加槓する場合の表記はどのようにするのでしょうか。
  
• Ａ：次のようにします。
  付け牌は一旦、捨牌列に加え、他の三人へのアタリでなければ、三人のツモと捨牌を、スキップし（"//"）、自分の「$GET」で "K:"で、その牌を再記述します。
  このようにするのは、『搶槓』という役が存在するからです。
  

Ｑ：暗槓の表記はどうですか？

• はい、小明槓についてはよくわかりました。かなり論理的にすっきりしていますね。（←自分で言うか（笑））
  では、暗槓はどのように記述すればよいのでしょうか。
  
• Ａ：基本的には小明槓と同様です。
  暗槓の候補が一つしか存在しない場合には特別な記入は不要で、ツモ牌が "-" で嶺上牌を定義するだけです。
  これで、ほとんどの場合は事足りるとは思いますが、複数の暗槓候補がある場合には小明槓と同様の定義をします。
  

Ｑ：『チイ』の数字の意味は何ですか？

• 「$get」タグにおいて、『チイ』で取得した牌には "1:" のようにする、とありますが、あの数字（1,2,3）の意味は何ですか。
  また、どのように使い分けるのですか。
  
• Ａ：１２３は副露面子内での取得牌の位置を表しています。
  例えば、五萬を５６７で副露する時には "1:" と表記し、４５６で喰う時には "2:" とし、３４５ならば "3:" です。
  カンチャンをチイなら、常に "2:" です。
  

Ｑ：『荘ＭＪＲ』なんてあるのは何故ですか？

• 『局ＭＪＲ』だけでイイのではないですか。
  同じ内容なのに、ヘンな制限を設けて、二つものファイルを使いわけるメリットが思い浮かびません。
  
• Ａ：ＭＪＲ普及のための戦略です。
  確かに『局ＭＪＲ』だけで全ては定義可能です。
  しかし、このような標準案がどこにも存在しない現時点では、ある半荘すべての闘牌の記録を何やらワケワカメな怪しいフォーマットで表現してみようということは誰もしないでしょう。私もしたくありません。
  それなら、取り敢えずは、一局の定義だけでも完璧にできればマルでしょう。
  そして、それはルールの『６：タグの説明３』に掲げられた四種類のタグだけで済んでしまうのです。
  ですが、スグに局だけでなく、半荘全体の記録をしたいという要望はあるでしょう。 そうなった時に一本のファイルに何もかもを記述するのはハンドリングに難があると考えました。
  更には、牌譜とは別に、各競技者間の点数の動きだけでも定義したい状況があることに気付きました。 実際に雑誌の観戦記事では、キイ局以外は単に誰が誰からどのような役で和了ったかと点数の状況がしめされるだけです。
  このような要望に応えるためには、牌の動きとは異なるレベルの記述が必要なのは言うまでもなく、そこで『荘ＭＪＲ』の登場となりました。
  そして、これらのＭＪＲの違いの基本は、定義の方法にあるのではなく、あくまで、運用の方法にあることを付け加えておきます。
  

Ｑ：タグの種類が多すぎます。少なくなりませんか？

• これだけ多くのタグを記述するのも解釈するのも大変です。
  もっと少なくてもイイのではないですか
  
• Ａ：なりません。しかし、問題はありません。
  すべてのタグは、注意深く見ていただければわかるように、互いに干渉し合うことはそれほどは多くありません。
  この事実は、いくつかのタグはなくとも構わないことを意味しており、そしてそれを前提に設計しました。
  例えば、競技者の名前やルールのタグが記述されていなくとも闘牌の再現は可能ですし、シミュレーションでなら、他の対局者のツモ牌なんて見えなくても構わないのです。
  ＭＪＲに対応する各種のアナライザは、自らが必要な記述だけを抽出して動作すればイイのです。
  タグの種類は確かに多いかもしれませんが、これらの全てを鑑む必要性はありません。
  

Ｑ：「$RULE」タグの目的は何ですか？

• 「$RULE」タグには、ルールを簡潔に表現する、とありますが、これは何の目的であるのですか。
  ここに何か書かれていても、ただの文字列なので、これによって何かの動作が規定されることはないと思いますが。
  
• Ａ：ただのメモです。
  本来ならいくつかのルールを提示して、このルールならＡ／このルールならＢというような決めをしたかったのですが、それは現実には不可能です。
  どのようなフリー雀荘でも、各種競技団体でも、通信による対戦ゲームでも、麻雀のルールは千差万別なわけで、ある意味、それも麻雀の楽しみの一つだとも言えるわけです。
  だけど、ルールについて何の記載もできないのは、少し悲しいのでこのタグを作りました。
  

Ｑ：「$RONFIG」の引数が文字列なのは何故ですか？

• 和了りの役名が任意の文字列なのは何故でしょう。
  これだと正確な解析は不可能です。
  
• Ａ：これもメモという意味でしかありません。
  前の『ルール』と同様に、すべての役名を定義することは不可能だと考えました。
  ＭＪＲは、サンマやブーマンをはじめ、数多くのローカルルールに対応することが大きな目標ですので、役名（少なくとも四百種類あって、増え続けている）のすべてを列挙しても無意味なのです。
  現在中国で進められている麻将の統一ルールや、『ワレメでポン』の闘牌が記述できないようでは、ＭＪＲの価値は半減すると考えています。
  

Ｑ：「$POINTSTT」と「$POINTEND」は不要なのではないですか？

• 点数の記述としては「$POINT」タグがあるので、これら二つのタグは要らないのではないでしょうか。
  
• Ａ：必ずしも要るわけではありません。
  何度も言いますが、宣言されたタグのすべてが必要なわけではありません。
  この「$POINTSTT」と「$POINTEND」は、点数の集計に際しての利便をはかって作られたものです。
  例えば、複数の『局ＭＪＲ』から自動的に『荘ＭＪＲ』を生成したり、更には複数の『荘ＭＪＲ』から大会やリーグ戦全体の点数状況をデータベースに残す、等の場面で、効力を発揮するタグです。
  

Ｑ：ポンが入った場合の巡目はどのように決めるのですか？

• ポンやカンによってツモ番が飛んだ場合の巡目はどうなるのですか。
  
• Ａ：どのように決めても構いません。
  普通にしてください。

Ｑ：フェアリー麻雀にも対応していますか？

• 色んなルールにも対応しているということは、フェアリー麻雀の結果なども残せるのですか。
  
• Ａ：一部は記述可能ですが、対応しているとは言えません。
  フェアリー麻雀の中には、通常ではない牌を使用したり、山の牌があらかじめわかっていたり、ツモ順がバラバラなものがあったりと、一般的なルールとは懸け離れたものが数多くあるので、それらを完全な形で記述することは不可能です。
  ですが一部のフェアリー麻雀なら定義できるかもしれません。
  そんなことより、フェアリー麻雀の闘譜を記録して、何に使うのですか。 こっちが聞きたいです。（と、また自分に質問してる（笑））
  

Ｑ：『ツモ牌が不明』という例の意味は何ですか？

• 一体、何ですか。
  気になって夜も眠れません。
  
• Ａ：そのままの意味です。
  例えば、クイズ形式にＭＪＲを運用する場合には『不明』というのは有効な記述方法です。
  また、シミュレーションにおいても（実際のデータとしては記録されていても）観戦者に対しては『不明』とすることもできます。
  

Ｑ：サンプルファイルはありますか？

• 実際のサンプルファイルがないと、どうにもイメージが沸きません。
  あれば教えてください。
  
• Ａ：ありません。
  作り次第、アップします。