WWA Wing: 簡易マニュアル

WWA Wing( WWA In the Next Generation )は、WWAのJavaScript実装です。 煩わしい警告は出ず、スマートフォンでも動作します。

サーバにアップロードするファイルについて

下記の通りです。(下記のフォルダ構成は、通常配布版のzipファイルを解凍したものです)

  +--+ mapdata
      +--+ audio (フォルダ) - フォルダごとアップロードすることを強くおすすめします。
      |  |
      |  +-- 1...69.mp3 - 効果音です。1.mp3と3.mp3はシステムで使用するので必ずアップロードしてください。
      |  +-- 70...98.mp3 - BGMです。アップロードは任意です。
      |
      +-- wwa.js - wwa本体です。本家のWWA.classに相当します。名前はHTML中のscript要素で変更できます。
      +-- wwaload.js - wwa.jsから起動するマップデータのローダです。名前は「起動するには」で紹介する「data-wwa-loader」属性で変更できます。
      +-- wwa.css - WWAの見栄えを調整するCSSファイルです。アップロードしないと見栄えがかなり大変なことになります。名前はHTML中のlink要素で変更できます。
      +-- wwa_classic.css - wwa.cssのメッセージウィンドウを、WWA原作(Java版)風味に近づけたものです。こちらを指定する場合にはwwa.cssは不要です。
      +-- style.css - ページのWWAの部分以外の見栄えを調整するCSSファイルです。自由に編集してみてください。
      +-- cover.gif - タイトル画像です。
      +-- ***.dat - WWAのマップデータファイルです。
      +-- ***.html - WWAを配置するWebページです。「wwa-wrappeer」のIDを持つdiv要素の中にWWAが立ち上がります。
      +-- ***.gif - WWAのマップで使う画像です。

起動するには

<div id="wwa-wrapper" class="wwa-size-box"
  data-wwa-mapdata="caves01.dat"
  data-wwa-loader="wwaload.js"
  data-wwa-urlgate-enable="true">
  data-wwa-title-img="cover.gif">
</div>
の、data-wwa-mapdata 属性に起動したいマップデータの名前を記入します。上の例では、caves01.datです。

ローカルでテストしたい場合は、同梱の「wwa-server.exe」をご利用ください。http://localhost:3000/に続けて同じディレクトリのHTMLファイルをURLに指定するとテストプレイできます。

例: http://localhost:3000/wwamap.html

htmlファイルを直接クリックしても動きません!!

起動オプション属性一覧

太字・斜体の項目は必須項目です。必須項目はすべて指定しないと起動しません!!

data-wwa-mapdata属性
起動したいマップデータのファイル名を記述します。(例:wwamap.dat
data-wwa-loader属性
ローダのファイル名を記述します。通常、wwaload.jsから変更する必要はありません。
data-wwa-urlgate-enable属性
通常はtrueを指定してください。falseを指定するとURLゲートが無効になります。
data-wwa-title-img属性
起動時に表示されるタイトル画像を指定できます(形式: GIF, JPEG, PNGのいずれか, サイズ:横560ピクセル*縦440ピクセル。ただし下の16ピクセル分はステータスバーに隠されます。 )。 指定しなかった場合は本家を再現した白のローディング画面が使われます。
data-wwa-audio-dir属性
効果音ファイルが入っているフォルダを指定できます。指定しなかった場合は./audio/になります。
data-wwa-classic-mode-enable属性
trueを指定すると、本家と類似した挙動で動作します(詳細は後述)。 指定しなかった場合はfalseになります。
data-wwa-item-effect-enable属性
falseを指定すると、アイテム取得時のエフェクトが無効になります。(マクロ文 $effitem=0を最初に実行することと等価) 指定しなかった場合はtrueになります。
data-wwa-use-go-to-wwa属性
trueを指定すると、現在戦闘予測ボタン「Battle Report」が WWA公式サイトへの移動ボタン「GoTo WWA」(v3.1系以下やJava版WWAでのボタン)でに変更できます。 指定しなかった場合はfalseになります。

注意

HTMLファイル, CSSファイルの文字コードはUTF-8(BOMなし)としてください。

下記の機能は本家とは異なる挙動をすることがあります。

  • 物体ジャンプゲートから物体ジャンプゲートにジャンプしたときのパーツメッセージ表示優先順位
  • ランダム選択パーツ
  • マクロが実行されるタイミング

下記はdata-wwa-classic-mode-enablefalseした場合に、異なる挙動をします。

  • メッセージ表示中の物体パーツのアニメーション

WWA作成ツールは作者NAO氏の許可を得て再配布しております。

wwa.jsを更新したにも関わらず、古いバージョンの挙動をする場合には、wwa.jsの名前をバージョンごとに変更し、script要素で読み込むwwa.jsのファイル名を変更すると解決できるかもしれません、 将来的には、ブラウザにWWA Wingのエンジン本体をキャッシュさせない機構も検討したいと考えています。

更新情報

v3.2.10からv3.2.11への変更点

  • $colorマクロで背景色が変わらない問題を修正

v3.2.1からv3.2.10への変更点

  • $imgframeでアイテムボックスの背景を変更した後、アイテムを取得すると背景が一瞬デフォルトになる問題を修正
  • その他、WWAとしての挙動を伴わない変更(CSS開発のscssへの移行, リリースフローの見直し, マニュアル訂正など)

v3.2.0からv3.2.1への変更点

  • Firefox68以降、HTMLファイルをローカルで直接開いての起動ができなくなったことに伴う対応

v3.1.9からv3.2.0への変更点

本バージョンより、多くの環境で60FPSで動作すると思われます。60FPSの場合、ゲームの進行速度や歩行アニメーションの速度がこれまでの約1.2倍になるので注意してください。

WWA Phoenixのサポートは、v3.1.xをもって廃止されました。本バージョン以降、WWA Phoenixの提供はありませんのでご了承願います。

  • iOS, Androidなどのスマートフォン系OSでも音が鳴るように変更 (利用できる場合は音源再生にWebAudioを使用するように)
  • 音声ファイルが存在しない場合もゲームが開始するように変更(不足がある場合、開発者ツールを開くことで不足しているサウンド番号を調べることができます)
  • AudioJSの設置が不要に
  • ゲームパッドに対応(各種ゲーム機のコントローラをUSBやBluetoothでPCに接続すると使えることがあります)
  • 描画の高速化
  • スマートフォン向けにYes/Noボタンの拡大
  • $partsマクロの高速化
  • Go To WWAボタンを先頭予測が可能な「Battle Report」ボタンに変更 (data-wwa-use-go-to-wwa属性をtrueに設定することでGo To WWAに戻せます)
  • 50FPSからrequestAnimationFrameによるフレーム呼び出しに変更。
  • 待ち時間の処理をフレーム単位の指定に変更
  • FirefoxによるローカルでのHTMLオープン時に警告(alert)ダイアログが出ないように変更
  • サポートブラウザを明記
  • その他、開発上複雑になったコードの整理を実施。

v3.1.8からv3.1.9への変更点

  • WWA Wingの作成ツールをv3.1.7以前のものに変更(エンジンファイルの変更はありません)

v3.1.7からv3.1.8への変更点

  • $effectマクロの最初の数字が0のとき(エフェクト終了)にフリーズする可能性がある不具合を修正
  • WWA Wingの新しい作成ツールを同梱

v3.1.6からv3.1.7への変更点

  • Java版WWAに実装されていた$effitemマクロを復活
  • メッセージがマクロのみのスコア表示パーツでメッセージが消えない問題を修正
  • メッセージの先頭にある空白文字(半角スペースなど)が表示されない問題を修正
  • クラシックモードかつタイトル画像が指定されている場合のプログレスバースタイル表示スタイルを修正

W3.15dβ2からv3.1.6への変更点

  • 新しいビルド方式に移行
  • $mapマクロがモンスターとスコア表示で相対座標に指定できない不具合を修正
  • WWA Debuggerを廃止し、新しい開発用サーバへ移行
  • 効果音読み込みなしでパスワードセーブした後、効果音読み込みありで起動した場合にBGMが復元されない不具合を修正
  • 戦闘予測表示中にパーツのイベントが実行される不具合を修正
  • BGM 71.mp3の音源が途中で途切れないように修正
  • HTMLファイルの改行コードを統一, メモ帳で開いても改行が出るようにした

W3.15cからW3.15dβ2への変更点

  • β版とは異なる内容でW3.15cがリリースされたため、変更差分を取り込む。リリース予定のバージョンをW3.15dに変更(W3.15dβ2)
  • WWA PhoenixのWelcome To表示がクラシックになっていない問題を修正(W3.15cβ2)
  • wwa_classic.cssを追加 (W3.15cβ1)
  • マップデータバージョンが3.0以下の場合 (作成ツールが3.02c以下で作成した場合)、追尾/逃げる属性の挙動を当時のWWAに合わせる (W3.15cβ1)
  • 一部のシステムメッセージを本家準拠に変更(W3.15cβ1)
  • Classic Modeを実装(W3.15cβ1)
  • カバー画像未指定時に本家同様のWelcome To WWA! を表示するように変更(W3.15cβ1)
  • 攻撃力をマクロ$statusで変更した時にステータス欄に反映されない不具合を修正(W3.15c+)

W3.15bからW3.15cへの変更点

  • 動作属性が空白の場合に物体が静止するように対応(W3.15c)
  • マップデータ最下端にいるモンスターの戦闘結果予測ができない不具合を修正(W3.15b+++)
  • WWA PhoenixのHTTPS対応(W3.15b++)
  • ライセンスファイルの著作権表記微修正(W3.15b+)
  • WWA V2.9でのマップデータ読み込み開始位置の修正(W3.15b+)

W3.15aからW3.15bへの変更点

  • マップデータバージョン2への対応(W3.15b)
  • マップデータバージョンをバージョン情報各所に併記(W3.15b)

W3.15からW3.15aへの変更点

  • $face マクロが正常に動作しない不具合を修正
  • (開発者向け) TypeScript 1.8 に対応

W3.14bからW3.15への変更点

  • 配布zipファイルの文字コードをCP932からUTF-8に変更。配布物にマルチバイト文字のファイル名が入らないように変更。(W3.15)
  • GitHubでの配布物自動生成を開始。(W3.15)
  • ステータス変化アイテム取得時、生命力以外の値が負になる場合のキーボードおよびマウス入力の挙動を修正。(W3.15)
  • 特定の条件を満たすときに画像ファイル名のロードに失敗する問題を修正。(W3.14b+)

W3.14aからW3.14bへの変更点

  • ランダム選択パーツが勝手に動き出す問題を修正。
  • ランダム選択パーツが置換される範囲を修正。
  • リスタート時にランダム選択が置換されない問題を修正。

W3.14からW3.14aへの変更点

  • メッセージ表示中にスペースキーを押すとスクロールされる問題を修正。(W3.14a)
  • オーディオ関連ディレクトリの配置変更を配置変更可能に(W3.14a)
  • WWA公式での文字列ロードに関する不具合への対応(W3.14++)
  • 配布マップデータにパスワードがかかっている問題を修正(W3.14++)
  • ランダム選択パーツが初期状態でマップ上に配置されている場合にパスワードセーブの互換性がなくなる問題を修正。(W3.14+)
  • パスワードセーブを実装(Java版との互換なし) (W3.14)
  • ジャンプゲート後に表示される画面領域を原作準拠に変更。(W3.14)
  • 「物を売る」パーツで物体パーツ番号0番を売る場合の挙動を原作準拠に変更。(W3.14)
  • 「物を売る」パーツの結果、アイテムが持てない場合、システムメッセージが反映されない不具合を修正。(W3.14)

W3.13bからW3.14への変更点

  • ランダム選択パーツが最初から配置されているマップでパスワードが使用不可になる不具合を修正。

W3.13bからW3.13cへの変更点

  • パスワードセーブを実装。
  • WWAが設置されているページで、WWAより上の要素にCSSでスタイルを指定した場合に、メッセージのレイアウトが崩れる問題を修正(W3.13cで修正)。
  • 戦闘予測ウィンドウにも$colorを適用するように変更(W3.13cで修正)。
  • メッセージ中の<C>,<P>タグの挙動を原作通りに修正(W3.13cで修正)。
  • 一部メッセージウィンドウのスタイルを修正(W3.13cで修正)。
  • 物を売るパーツによりゲームオーバーになった時にメッセージウィンドウが消えない不具合を修正(W3.13b++で修正)。
  • 戦闘が1フレームで終了する場合に戦闘ウィンドウが出ない問題を修正(W3.13b+で修正)。

W3.13aからW3.13bへの変更点

  • マクロのエラー時の挙動を原作に近い形に修正(空文字列からなる引数を与えた場合、特に末尾にカンマがある場合の対応)
  • マクロ名の大文字と小文字を区別せず実行するように変更(原作通り)

W3.13からW3.13aへの変更点

  • 戦闘ウィンドウとエフェクトの出現タイミングを1フレーム遅らせるように仕様を変更(待ち時間への対応)(W3.13aで修正)
  • メッセージつき壁パーツとメッセージつき物体パーツ(通常と扉が開かない場合を除く)が重なっていた時に物体パーツを優先するよう仕様を変更(W3.13aで修正)
  • マップデータをキャッシュしないように仕様を変更(W3.13+で修正)

W3.12eからW3.13への変更点

  • WWA作成ツール同梱のため、配布ファイルのディレクトリ構成を大幅に変更。
  • WWAのシステムで使うCSSを「style.css」から「wwa.css」に分離。
  • マクロのみをメッセージに含む道の上にプレイヤーがいて、その上に物体パーツがある時に物体パーツイベントがスルーできる問題を修正。
  • 鍵が無くならない扉を開けた時に効果音が鳴らない問題を修正。
  • 使用型アイテムを、キーボード押しっぱなしで無限に使用できてしまう問題を修正。
  • マクロのみをメッセージに含むクリック型アイテムを使用した時にメッセージウィンドウが表示されっぱなしになる問題を修正(W3.12e+で修正)

W3.12dからW3.12eへの変更点

  • マクロの実行を、メッセージの指定から1フレーム遅らせるように挙動を変更(これにより、待ち時間と併用した場合の挙動が原作どおりになる。)(W3.12eで修正)
  • 方向キーを入力しながらメッセージボックスを閉じた時に、すぐには移動できないように仕様を変更。(W3.12eで修正)
  • 扉を開けた時に描画を1フレームスキップするように仕様を変更。(原作3.10と同じ挙動、$dirmapのためにこの仕様になったそうです。)(W3.12eで修正)
  • ゲーム開始時, ロード, リスタート時, プレイヤースタート地点に物体パーツがあった場合に1フレームの間操作を禁止するように修正。
  • モンスター撃破後の指定位置(x,y)=(+0,+0)にパーツを出現が失敗する問題を修正(W3.12d+++で修正)
  • アイテムボックスの上書きが失敗する不具合(同じアイテムボックスを使うアイテム, 物の売り買い, 戦闘など)を修正(W3.12d++で修正)
  • プレイヤー座標でモンスターと戦闘した時に、プレイヤー座標への指定位置にパーツを出現がうまく動作しない問題を修正(W3.12d+で修正)
  • $item, $partsの第2引数を修正できるように変更(W3.12d+で修正)

W3.12cからW3.12dへの変更点

  • アイテムを上書きしたり、指定位置に挿入したりした時のアイテム欄の挙動を修正
  • アイテム位置4のアイテムがクリックできなかった問題を修正(※要アップデートstyle.css)
  • マクロのみを含むメッセージの床を踏んだ時にマウスが効きにくくなる問題を修正

W3.12b+からW3.12cへの変更点

  • 物体ジャンプゲートの接触時にプレイヤーが正しい場所に飛ばなかった問題を修正。
  • メッセージ送りのボタンを押し続けると早送りができるように。
  • 背景URLゲートでBLANK指定が効かなかった問題を修正。
  • wwa.js中のa要素(リンク)で、「wwa-copyright」クラスを持つものに触れたときに確認ダイアログを表示するように変更(このサンプルはアップデート版には含まれておりません。サンプルをご覧になりたい場合はフルパッケージ版をダウンロードしてください)。

サポートブラウザ

PC

OSは不問です。
  • Microsoft Internet Explorer 11
  • Microsoft Edge (最新版)
  • Mozilla Firefox (最新版)
  • Google Chrome/Chromium (最新版)
  • Safari (最新版)

スマートフォン・タブレット

  • Android 上の Google Chrome (最新版)
  • iOS 上の Safari (最新版)

次回予定

本家実装が一段落したので、もう少し考えてみることにします。

遠くない未来に更新予定

  • SuperQuickSave(仮)
  • 超高速戦闘
  • スコア表示Twitter連携機能
  • スマートフォン・タブレット向けゲームパッド
  • スマートフォン・タブレット向けviewport設定
  • その他、提案された多数の新機能