Skip to content
k4nagatsuki edited this page Mar 1, 2015 · 201 revisions

CardWirthPy Reboot


お知らせ

お知らせを飛ばす(次の項目までジャンプ)

2015年3月1日

CardWirthPy 0.12.2をリリースしました(ダウンロード)。

このバージョンの開発にあたって、開発者の皆様方、提案や問題の報告をしてくださった方々に多大な協力をいただきました。この場を借りてお礼申し上げます。ありがとうございました!



これは何?

これはCardWirthPy Developer's Siteで開発中だったCardWirthPyのフォークです(フォークについての説明)。本家側の更新停止が続いているため、Rebootと称して独自に開発を継続しています。

原開発者の方に連絡を取ったところ、恐らく本家側の更新は今後も無いという事なので、事実上開発を引き継いだ形になっています。

開発に参加したりさらに引き継いだりしてくれる方を募集中です。

takuto_cwさんのよくまとまった紹介記事もご覧ください。

開発に興味のある方は開発者向け情報をご覧ください。


最新リリース版のダウンロード

バージョン 0.12.2 RC3 から 0.12.2 への更新内容

追加

  • 称号判定分岐でCardWirthPyのバージョンを判別できるようにした。詳細はReadMe.txtの「CardWirthPyでプレイ中か判定するイベントを作る方法について」の項をご覧ください。

変更

  • CardWirth 1.30以前はJPY1のレタッチ内容によってセルとして配置した時に指定したマスク設定が無効にされてしまう場合があるが、1.50では無効にならないため、互換モードで対応。
  • 最大使用回数0のリサイクルカードは無限使用可能とならないようにした。
  • 沈黙・魔法無効化・能力修正・ペナルティ等の条件を含めたカードの自動選択可否条件をCardWirthに合わせた。
  • 召喚獣が所属対象の魔法無効化状態の影響を受けないようにした。
  • 召喚獣の取得方法・リサイクル・使用回数の条件を含めた召喚獣取得処理をCardWirthに合わせた。
  • CardWirth 1.50では同行キャストに対象消去の効果が無いため、それに合わせた。
  • CardWirthに合わせてカード効果の並び順が対象の自動選択に影響するようにした。
  • エネミーカードのフラグをオフにした場合の選択メンバ関係の挙動をCardWirthに合わせた。
  • クーポン選択分岐やカード所持分岐で対象がいなかった場合の挙動をCardWirthに合わせた。
  • テキストセルで指定されたサイズによるフォント選択の判断をCardWirthに合わせた(現状Windows環境のみ)。
  • 不正なチャンクを持つPNGイメージの読込時の警告ダイアログの表示を抑制。

修正

  • 荷物袋やカード置場の整列条件を「価格」にしていると、再度ダイアログを開いた時に「しない」が選択されている。
  • 描画倍率が1倍の時、メニューカードの情報ダイアログを開いてから画面サイズを変更し、再度情報ダイアログを開くと、変更前のサイズでカードが描画される。
  • 宿帳の絞込検索によって該当者が一人もいない時に追加・情報ボタンが押せてしまい、エラーになる。
  • コンボボックスやパネル見出しのフォントによってはシナリオ選択ダイアログの右側に描画されない領域が発生する。
  • カードイベントで行動不能になった時は手札使用ダイアログを再オープンするべきではない。
  • 手札選択ダイアログで不可能な行動を選択した時、ダイアログを開く設定にしているとブザーが鳴らない。
  • 荷物袋やカード置場のカード選択ダイアログを一旦閉じて再度開いた時、どのページを開いていても左側のページ欄の値が1となっている。
  • 環境によって圧縮されたシナリオの展開後にエラーが出る事がある。
  • 魔法的物理属性が魔法無効化状態の影響を受ける。
  • 敵がいない時に戦闘参加者が行動の自動選択を行わない。
  • フィールド全体で対象を選択した時、選択中のメンバが優先選択される。
  • 大きなサイズのメニューカードのイメージ位置がおかしい。
  • カード画像のないメンバが先頭にいるパーティを冒険の再開ダイアログで表示しようとするとエラー。
  • システムイベント用のメニューカードを同時に何度も押すと押した回数だけシステムイベントが発生する。
  • シナリオ開始直後にデバッガのボタンの有効・無効がイベント中であるかのように切り替わることがある。
  • 多岐分岐で後続ツリーに分岐条件の重複がある時、キャッシュされた多岐分岐の結果がキャッシュ不使用時と異なった結果になる場合がある。
  • F9でシナリオを脱出した時、最後に鳴らされたシナリオ内のMP3効果音ファイルが解放されない。

最新のテスト版やスキンのダウンロードとそのChangeLog


CardWirthからの移行方法

冒険者の宿の変換が必要です。起動してから「スタート」カードを選ぶと宿の選択ダイアログが出ますが、そこで「変換」ボタンを押してCardWirthのYadoフォルダ内にある冒険者の宿のフォルダを選択するか、宿のフォルダをダイアログにドラッグ&ドロップしてください。宿は自動的に変換され、CardWirthPyで使用できる状態になります。

また、Scenarioフォルダ内にはショートカットを置く事ができるので、まずはCardWirthのScenarioフォルダへのショートカットを作るといいでしょう。

バリアントからの移行方法

バリアントのエンジンの実行ファイル(例えばModernWirth.exe)をCardWirthPyのウィンドウにドロップすると、そのバリアントのデータからスキンを自動生成するダイアログが出ます。

そのまま「決定」ボタンを押せば、必要なデータが自動的に抽出され、そのバリアントをそのまま移植したスキンが生成されます。スキンは右下の歯車ボタンで開く設定ダイアログから切り替える事ができます。

スキンの生成と同時にそのバリアントのシナリオのフォルダへのショートカットがCardWirthPyのScenarioフォルダに自動的に生成されますが、宿のデータは変換されません。必要な宿を個別に変換してください。


CardWirth 1.30以前のシナリオとの互換動作について

適宜シナリオの対応エンジンの情報を与えることで、CardWirthPyに過去のCardWirthエンジン相当の動作を行わせる事ができます。

例えば、CardWirth 1.20から1.28への移行の時、メニューカードの位置がプレイヤーカードの上に表示されていたのに、1.28ではその位置関係が逆になり、1.20環境で作られた一部シナリオのメニューカードがプレイヤーカードの背後に隠れて見えなくなるといった事が起きました。CardWirthPyは、普段は1.28エンジンのようにプレイヤーカードを上に描画しますが、「このシナリオのこのエリアは1.20のようにメニューカードを上に表示するべき」であると判断すると、自動的にそのような描画に切り替えます。これを互換モードと呼びます。

互換モードに切り替える判断材料には次のようなものがあります。

互換性データベース

いくつかのシナリオについては、エンジン本体に同梱された互換性データベースによって、自動的に互換モードに切り替わります。

全てのシナリオの互換性を調査する事は容易ではないため、互換性データベースに入っているシナリオのリストは不完全です。CardWirthエンジンのバージョンアップで動かなくなったシナリオ等について、皆様からの情報提供をお待ちしております。

そういったシナリオを見つけたら、Issueを作成してお知らせください。タイトルは【互換性DB】から始め、説明には該当するシナリオの情報(シナリオ名やどこで手に入るか等)を書き、Kindはenhancementを選択するとよいでしょう。出来る限り速やかに対応させていただきます。

mode.ini

互換性データベースには情報が無いが、とりあえずすぐに互換モードで動かしたいシナリオ等が存在する場合、シナリオのフォルダにmode.iniというファイルを追加する事で、CardWirthPyに互換モードで動くよう指示を出す事ができます。

mode.iniはテキストファイルで、内容は次の2行です。

[Compatibility]
engine=1.20

ここで、2行目がengine=1.20となっているとCardWirth 1.20相当の互換モードで動きます。1.28相当のモードにしたい場合は、これをengine=1.28にしてください。

互換モードの詳しい内容

現在の互換モードがどの程度まで過去のエンジン相当の挙動をするかについての詳細はIssue #17で見る事ができます。


問題を見つけたら

現在のCardWirthPyが抱える課題はIssue(課題)の一覧で参照する事ができます。

バグや仕様の不備等の問題を見つけたら、新たにIssueを作成してお知らせください。皆様のご協力をお待ちしております。

Issue(課題)の書き方

  1. 課題のタイトルと説明を書いてください。発生した問題の内容や、どのように操作すれば問題が発生するかを具体的に詳しく書いていただければ調査が簡単になります。使っているOSのバージョンなど、バグに関係のありそうな情報があるとなおよいでしょう。
  2. Kindの欄は、その課題がバグであればbugを、要望であればproposalを選択してください。
  3. Prioerityは課題の重要度です。blocker-critical-major-……の順に重要度が下がっていきます。直さないとデータが消えてしまったりするような重大なバグの場合はcriticalに、メッセージのほんの些細な誤りなどの小さな問題はminorに……などと使い分けるといいでしょう。とはいえ、通常はmajorで問題ありません。

なお、Bitbucketのユーザアカウントを持っていなくてもIssueを作成する事はできますが、その後コメントする事はアカウント無しにはできないようです。修正の通知の後でなお問題が残っていたりした場合、遠慮無く次のIssueを作ってください。

その他、連絡や要望などに使っていただいても構いません。

Issueの新規作成をしたくない場合は

汎用の報告・連絡用Issueがあるのでここに返信する形で書き込んでください。ただしBitbucketのユーザアカウントが必要です。


テスト版のバージョン

最新リリースと同等か、それよりも新しいバージョンがDownloadsにあります。これらはテスト版としてソースコードに更新があるたびにビルドされているバージョンです。

以下のファイルをダウンロードし、出てきたフォルダを統合する事で遊べるようになります。

  • cardwirthpy_[日付].zip
  • skin_classic_[日付].zip
  • font_[日付].zip

CardWirthPyの目標

ここに書いてあるのは個人的に決めた事なので、他の開発者の意向で変更されるかもしれません。

フリー・オープンソースの維持

フリー・オープンソースを維持します。大方針と反しない限りにおいて、協力をできるだけ受け入れます(もちろん大方針に反するforkも可能です)。

事故や開発者側の都合によって永遠に開発が打ち切られるというリスクをこれによって軽減します。

CardWirth(~1.50)との99%の互換性を目指す

本質的な部分で何も変わらない事を目指す事を意味します。具体的には以下の目標を掲げます。

従来のCardWirthとほぼ変わりないプレイ環境を提供する

できるだけフォントを合わせるなどして違和感をなくし、シナリオの変換などしなくてもそのまま再生できるようにします。

さらなる互換性の強化

シナリオ側に簡単なiniファイルを追加する等の方法で、1.20以前のシナリオも問題なくプレイできるようにしたいと考えています。

また、CardWirthから自動的にスキンを生成する機能により、バリアントシナリオもプレイできるようにします。

追加・拡張機能は将来的な互換性を考えて慎重に実装する

例えば追加のイベントコンテントなどは、将来のCardWirth側の拡張と衝突する可能性があるため、特に注意しなくてはなりません。

しかし、例えばシナリオを一覧表示するような、純粋なインタフェースの改良などは問題ない場合が多いでしょう。

いずれにせよ、単体のソフトウェアではなくプラットフォームである以上、意思決定は軽々しくするべきではないと考えます。

互換性を考えない残り1%

  • *.wsnとしてまとめたシナリオの再生。
  • より強力なデバッグ機能。
  • 背景切替方式。
  • 音声再生方式。
  • 長いカード名に対応。
  • スキン方式によるバリアントの吸収。
  • 宿データの互換性。CardWirthの宿データを直接使用するように作った場合、パフォーマンス上の制約が大きくなり(例えば大きな宿の読込に数秒かかったりします)、拡張性も不足します。そのため、より効率的なフォーマットを採用した上で、相互に変換できるようにします。
  • CABアーカイブだけでなくZIPアーカイブにも対応。
  • 将来的に問題ないと思われるレベルのインタフェースの改良。

現在の状況

CardWirthPyとしての未完成部分

概ね完成したと考えています。残る課題についてはIssueをご覧ください。

Reboot側での追加要素

  • 変換無しでシナリオを読み込めるようにする。
  • Scenarioフォルダ内のショートカット対応。
  • スキンのパラメータによりメッセージのフォントをCardWirthに合わせる。
  • 従来のCardWirthからのスキン自動生成。
  • スキンを拡張し、バリアントで変化しているような箇所はすべてスキンで吸収できるように。
  • CAB対応。
  • ZIP対応。
  • シナリオや宿読込の高速化。
  • 宿データの逆変換。
  • CardWirth 1.29~1.50相当の機能の追加。
  • インタフェースの若干の変更(貼紙のツリー表示や宿帳の一覧表示など)。これについては随時継続。

Clone this wiki locally