1.16.17 • Published 9 months ago

@akashic/akashic-cli-serve v1.16.17

Weekly downloads
512
License
MIT
Repository
-
Last release
9 months ago

akashic-cli-serve

akashic-cli-serve は、 Akashic Engine で作成されたゲームの動作確認環境です。 サーバとして起動して、ブラウザからマルチプレイのゲームを動作させることができます。

このモジュールは、akashic-cli に組み込まれています。 通常、ゲーム開発者がこのモジュールを直接利用する必要はありません。 akashic-cli は Akashic Engine を使ったゲーム作成を補助するコマンドラインツールです。 Akashic Engineの詳細な利用方法については、 公式ページ を参照してください。

現時点では、マルチプレイの動作確認環境です。 シングルプレイの動作確認には、より多機能な akashic-sandbox をご利用ください。

インストール

npm install -g @akashic/akashic-cli-serve

利用方法

akashic-cli-serve [<options>] [<path>]

<path> に、起動するゲームの game.json があるディレクトリを与えてください。 省略された場合、 . と解釈されます。

<options> に指定可能なオプションは次のとおりです。

オプション短縮名効果デフォルト値
--hostname <hostname>-H起動するサーバのホスト名を指定します。localhost
--port <port>-p起動するサーバのポート番号を指定します。3300
--verbose-v詳細情報をログ出力します。false
--no-auto-start-Aブラウザを開いた時、コンテンツを自動開始しないようにします。N/A
--target-service <name>-s指定されたサービスの挙動を模擬します。(後述)none
--watch-wアセットディレクトリを監視し、変更時に新規プレイを作成します。N/A
--server-external-script <filepath>N/A指定ファイルの js を評価し、アクティブインスタンスの g.game.external に代入します。N/A
--debug-playlog <path>N/A指定した playlog.json を読み込みます(エンジン開発用、または開発中のオプションです)。N/A
--debug-pause-activeN/Aアクティブインスタンスをポーズした状態でプレイを開始します。(エンジン開発用のオプションです)N/A
--allow-externalN/A外部アセットを許可します。許可する値は sandbox.config.js から読み込みます。N/A
--no-open-browserN/A起動時に自動でブラウザを開かないようにします。N/A
--preserve-disconnectedN/Aサーバ切断時に開いている子ウィンドウを閉じないようにします。N/A
--experimental-open <num>N/A起動時に子ウィンドウを指定数開いて起動します。上限は 10 です。試験中の機能です。通常、利用しないでください。N/A
--ssl-cert <certificatePath>N/AHTTPS で起動するための SSL 証明書のパスを指定します。N/A
--ssl-key <privatekeyPath>N/AHTTPS で起動するための 秘密鍵のパスを指定します。N/A
--cors-allow-origin <origin>N/AAccess-Control-Allow-Origin レスポンスヘッダーの値を指定します。N/A
--help-hヘルプを表示して終了します。N/A
--version-Vバージョンを表示して終了します。N/A

オプション --target-service には下記の値を指定できます。

  • nicolive: ニコニコ生放送
  • none: なし (デフォルト値)

環境変数

環境変数説明注釈
ENGINE_FILES_V3_PATHengine-files v3 のビルド成果物のパス。 (e.g. ./engineFilesV3_x_y.js) この値が指定された場合、 対象の engine-files を akashic-engine v3 コンテンツ実行時に利用します。エンジン開発用のオプションです。通常、ゲーム開発時に利用する必要はありません。
PLAYLOG_CLIENT_PATHplaylog-client のビルド成果物のパス。 (e.g. ./playlogClientVx_y_z.js) この値が指定された場合、 /contents/:contentId/content.raw.json からも参照され利用されます。エンジン開発用のオプションです。通常、ゲーム開発時に利用する必要はありません。

外部参照できる DOM 要素

akashic-cli-serveの自動実行テストでDOMを参照できるようにするために、以下のように各DOMにclass名を付与しました。

class名要素
external-ref_button_display-option表示オプションボタン
external-ref_checkbox_shows-background-image背景表示チェックボックス
external-ref_checkbox_shows-gridグリッド表示チェックボックス
external-ref_button_select-entity-from-screenゲーム画面からエンティティ選択ボタン
external-ref_button_refresh-entity-treeエンティティツリー更新ボタン
external-ref_button_dump-to-console選択エンティティをコンソールにダンプするボタン
external-ref_button_send-eventイベント送信ボタン
external-ref_button_copy-eventイベントコピーボタン
external-ref_button_shows-event-listイベントリストの表示・非表示を切り替えるボタン
external-ref_button_send-editing-event編集したイベントを送信するボタン
external-ref_button_download-snapshotスナップショット保存ボタン
external-ref_button_seek-snapshotスナップショットへシークするボタン
external-ref_button_pauseインスタンスポーズボタン
external-ref_button_real-time-executionリアルタイム実行ボタン
external-ref_button_add-instanceインスタンス追加ボタン
external-ref_checkbox_auto-send-eventセッションパラメータ送信チェックボックス
external-ref_text_total-time-limit制限時間入力テキストボックス
external-ref_checkbox_use-preferred-total-time-limitgame.jsonのpreferredSessionParametersの値を利用チェックボックス
external-ref_checkbox_stops-game-on-timeout時間経過後にゲームを停止チェックボックス
external-ref_button_new-play新規プレイ作成ボタン
external-ref_button_active-pauseアクティブインスタンスをポーズ/解除ボタン
external-ref_button_join-leaveインスタンスのプレイヤーのJoin/Leaveを送信するボタン
external-ref_button_player-info-acceptコンテンツでのプレイヤー名表示許諾ボタン
external-ref_button_player-info-rejectコンテンツでのプレイヤー名表示拒否ボタン
external-ref_img_background背景画像
external-ref_div_game-contentコンテンツ表示エリア
external-ref_canvas_gridグリッド
external-ref_div_player-info-dialogプレイヤー名表示に関するダイアログ
external-ref_checkbox_joins-automatically自動的にJoinするチェックボックス
external-ref_button_start-contentコンテンツ開始ボタン
external-ref_button_dev-toolsDevtools表示ボタン

開発

初期化:

npm i

ビルド:

npm run build

Storybook 起動:

npm run storybook

内部モジュール更新: 実行には optionalDependencies が解決できる必要があります。

npm run copy:agv

Docker での起動

以下コマンドで Docker イメージを作成します。

docker build -t akashic-cli-serve .

その後 Docker コンテナを起動してください。

docker run \
  -p 3300:3300 \
  --name akashic-cli-serve \
  --rm \
  -it \
  --mount type=bind,src=/path/to/game,dst=/game,readonly akashic-cli-serve

--mountsrc にコンテンツの絶対パス (game.json が存在するディレクトリ) を指定してください。 akashic-cli-serve への引数を省略すると、 Docker コンテナ内部の /game をデフォルトのコンテンツのパスとして実行します。

カレントディレクトリに game.json が存在する場合、Linux では以下のように実行できます。

docker run \
  -p 3300:3300 \
  --name akashic-cli-serve \
  --rm \
  -it \
  --mount type=bind,src=$(pwd),dst=/game,readonly akashic-cli-serve

任意のオプション引数を akashic-cli-serve へ与える場合、akashic-cli-serve に対してコンテンツのパスを引数として明示的に指定してください。 以下は akashic-cli-serve--verbose オプションを与えて実行する例です。 Docker コンテナ内の /game をコンテンツのパスとして末尾で指定している点に注意してください。

docker run \
  -p 3300:3300 \
  --name serve \
  --rm \
  -it \
  --mount type=bind,src=/path/to/game,dst=/game,readonly akashic-cli-serve \
  --verbose /game

Windows 環境においては バインドマウントの利用 および Windows におけるパス変換 を参考に適宜コンテンツのパスを変換してください。

Mac の Apple Silicon (M1/M2) 環境において正常にビルドできない場合は Docker のベースイメージのアーキテクチャを linux/amd64 に指定してください。

FROM --platform=linux/amd64 node:***

また、起動時に --platform=linux/amd64 をオプションに加えてください。

docker run \
  --platform linux/x86_64 \
  ...

ライセンス

本リポジトリは MIT License の元で公開されています。 詳しくは LICENSE をご覧ください。

ただし、画像ファイルおよび音声ファイルは CC BY 2.1 JP の元で公開されています。

1.16.17

9 months ago

1.16.14

10 months ago

1.16.16

10 months ago

1.16.15

10 months ago

1.16.10

11 months ago

1.16.13

11 months ago

1.16.12

11 months ago

1.16.11

11 months ago

1.16.3

1 year ago

1.16.7

12 months ago

1.16.6

12 months ago

1.16.5

1 year ago

1.16.4

1 year ago

1.16.9

11 months ago

1.16.8

11 months ago

1.16.2

1 year ago

1.16.1

1 year ago

1.16.0

1 year ago

1.15.54

1 year ago

1.15.53

1 year ago

1.15.52

1 year ago

1.15.51

1 year ago

1.15.50

1 year ago

1.15.49

1 year ago

1.15.47

1 year ago

1.15.48

1 year ago

1.15.46

1 year ago

1.15.45

2 years ago

1.15.43

2 years ago

1.15.44

2 years ago

1.15.40

2 years ago

1.15.41

2 years ago

1.15.42

2 years ago

1.15.32

2 years ago

1.15.33

2 years ago

1.15.34

2 years ago

1.15.35

2 years ago

1.15.30

2 years ago

1.15.31

2 years ago

1.15.36

2 years ago

1.15.37

2 years ago

1.15.38

2 years ago

1.15.39

2 years ago

1.15.29

2 years ago

1.15.28

2 years ago

1.15.22

2 years ago

1.15.23

2 years ago

1.15.24

2 years ago

1.15.25

2 years ago

1.15.26

2 years ago

1.15.27

2 years ago

1.15.18

2 years ago

1.15.19

2 years ago

1.15.17

2 years ago

1.15.21

2 years ago

1.15.20

2 years ago

1.15.12

2 years ago

1.15.13

2 years ago

1.15.14

2 years ago

1.15.15

2 years ago

1.15.16

2 years ago

1.15.10

2 years ago

1.15.11

2 years ago

1.15.8

2 years ago

1.15.7

2 years ago

1.15.6

3 years ago

1.15.9

2 years ago

1.14.80

3 years ago

1.14.81

3 years ago

1.14.75

3 years ago

1.14.76

3 years ago

1.14.77

3 years ago

1.14.78

3 years ago

1.14.79

3 years ago

1.15.0

3 years ago

1.15.4

3 years ago

1.15.3

3 years ago

1.15.2

3 years ago

1.15.1

3 years ago

1.15.5

3 years ago

1.14.73

3 years ago

1.14.74

3 years ago

1.14.70

3 years ago

1.14.71

3 years ago

1.14.72

3 years ago

1.14.64

3 years ago

1.14.65

3 years ago

1.14.66

3 years ago

1.14.67

3 years ago

1.14.62

3 years ago

1.14.63

3 years ago

1.14.68

3 years ago

1.14.69

3 years ago

1.14.61

3 years ago

1.14.60

3 years ago

1.14.53

3 years ago

1.14.54

3 years ago

1.14.55

3 years ago

1.14.56

3 years ago

1.14.51

3 years ago

1.14.52

3 years ago

1.14.57

3 years ago

1.14.58

3 years ago

1.14.59

3 years ago

1.14.42

3 years ago

1.14.43

3 years ago

1.14.44

3 years ago

1.14.45

3 years ago

1.14.41

3 years ago

1.14.46

3 years ago

1.14.47

3 years ago

1.14.48

3 years ago

1.14.49

3 years ago

1.14.50

3 years ago

1.14.40

3 years ago

1.14.31

3 years ago

1.14.32

3 years ago

1.14.33

3 years ago

1.14.34

3 years ago

1.14.30

3 years ago

1.14.39

3 years ago

1.14.35

3 years ago

1.14.36

3 years ago

1.14.37

3 years ago

1.14.38

3 years ago

1.13.9

4 years ago

1.14.1

4 years ago

1.14.0

4 years ago

1.14.5

3 years ago

1.14.4

3 years ago

1.14.3

3 years ago

1.14.2

4 years ago

1.14.9

3 years ago

1.13.31

4 years ago

1.14.8

3 years ago

1.13.30

4 years ago

1.14.7

3 years ago

1.13.33

4 years ago

1.14.6

3 years ago

1.13.32

4 years ago

1.13.38

4 years ago

1.13.35

4 years ago

1.13.34

4 years ago

1.13.37

4 years ago

1.13.36

4 years ago

1.13.20

4 years ago

1.13.22

4 years ago

1.13.21

4 years ago

1.13.28

4 years ago

1.13.27

4 years ago

1.13.29

4 years ago

1.13.24

4 years ago

1.13.23

4 years ago

1.13.26

4 years ago

1.13.25

4 years ago

1.14.20

3 years ago

1.14.21

3 years ago

1.14.22

3 years ago

1.14.23

3 years ago

1.14.28

3 years ago

1.14.29

3 years ago

1.14.24

3 years ago

1.14.25

3 years ago

1.14.26

3 years ago

1.14.27

3 years ago

1.14.10

3 years ago

1.14.11

3 years ago

1.14.12

3 years ago

1.14.17

3 years ago

1.14.18

3 years ago

1.14.19

3 years ago

1.14.13

3 years ago

1.14.14

3 years ago

1.14.15

3 years ago

1.14.16

3 years ago

1.13.11

4 years ago

1.13.10

4 years ago

1.13.17

4 years ago

1.13.16

4 years ago

1.13.19

4 years ago

1.13.18

4 years ago

1.13.13

4 years ago

1.13.12

4 years ago

1.13.15

4 years ago

1.13.14

4 years ago

1.12.1

4 years ago

1.12.0

4 years ago

1.13.2

4 years ago

1.13.1

4 years ago

1.13.0

4 years ago

1.13.6

4 years ago

1.13.5

4 years ago

1.13.4

4 years ago

1.13.3

4 years ago

1.13.8

4 years ago

1.13.7

4 years ago

1.11.1

4 years ago

1.10.5

4 years ago

1.10.4

4 years ago

1.10.3

4 years ago

1.11.0

4 years ago

1.10.2

4 years ago

1.10.1

4 years ago

1.10.0

4 years ago

1.9.20

4 years ago

1.9.19

4 years ago

1.9.18

4 years ago

1.9.17

4 years ago

1.9.16

4 years ago

1.9.15

4 years ago

1.9.14

4 years ago

1.9.13

4 years ago

1.9.12

4 years ago

1.9.11

4 years ago

1.9.10

4 years ago

1.9.9

4 years ago

1.9.8

4 years ago

1.9.7

4 years ago

1.9.6

4 years ago

1.9.5

4 years ago

1.9.4

4 years ago

1.9.3

4 years ago

1.9.2

4 years ago

1.9.1

4 years ago

1.9.0

4 years ago

1.8.1

4 years ago

1.8.0

4 years ago

1.7.0

4 years ago

1.6.0

4 years ago

1.5.8

4 years ago

1.5.7

4 years ago

1.5.6

4 years ago

1.5.5

4 years ago

1.5.4

4 years ago

1.5.3

4 years ago

1.5.2

4 years ago

1.5.1

4 years ago

1.5.0

4 years ago

1.4.11

4 years ago

1.4.10

4 years ago

1.4.9

4 years ago

1.4.8

4 years ago

1.4.6

4 years ago

1.4.7

4 years ago

1.4.5

4 years ago

1.4.4

4 years ago

1.4.3

4 years ago

1.4.2

4 years ago

1.4.1

4 years ago

1.4.0

4 years ago

1.3.0

4 years ago

1.2.2

5 years ago

1.2.1

5 years ago

1.2.0

5 years ago

1.1.3

5 years ago

1.1.2

5 years ago

1.1.1

5 years ago

1.1.0

5 years ago

1.0.2

5 years ago

1.0.1

5 years ago

1.0.0

5 years ago

0.8.96

5 years ago

0.8.97

5 years ago

0.8.95

5 years ago

0.8.94

5 years ago

0.8.93

5 years ago

0.8.92

5 years ago

0.8.91

5 years ago

0.8.89

5 years ago

0.8.90

5 years ago

0.8.88

5 years ago

0.8.87

5 years ago

0.8.86

5 years ago

0.8.85

5 years ago

0.8.84

5 years ago

0.8.83

5 years ago

0.8.82

5 years ago

0.8.81

5 years ago

0.8.80

5 years ago

0.8.79

5 years ago

0.8.78

5 years ago

0.8.77

5 years ago

0.8.76

5 years ago

0.8.75

5 years ago

0.8.74

5 years ago

0.8.73

5 years ago

0.8.72

5 years ago

0.8.70

5 years ago

0.8.71

5 years ago

0.8.69

5 years ago

0.8.68

5 years ago

0.8.67

5 years ago

0.8.66

5 years ago

0.8.65

5 years ago

0.8.64

5 years ago

0.8.63

5 years ago

0.8.62

5 years ago

0.8.61

5 years ago

0.8.60

5 years ago

0.8.59

5 years ago

0.8.58

5 years ago

0.8.57

5 years ago

0.8.56

5 years ago

0.8.55

5 years ago

0.8.54

5 years ago

0.8.53

5 years ago

0.8.52

5 years ago

0.8.51

5 years ago

0.8.50

5 years ago

0.8.49

5 years ago

0.8.48

5 years ago

0.8.47

5 years ago

0.8.46

5 years ago

0.8.45

5 years ago

0.8.44

5 years ago

0.8.43

5 years ago

0.8.42

5 years ago

0.8.41

5 years ago

0.8.40

5 years ago

0.8.39

5 years ago

0.8.38

5 years ago

0.8.37

5 years ago

0.8.36

5 years ago

0.8.34

5 years ago

0.8.33

5 years ago

0.8.35

5 years ago

0.8.32

5 years ago

0.8.30

5 years ago

0.8.31

5 years ago

0.8.29

5 years ago

0.8.27

5 years ago

0.8.26

5 years ago

0.8.28

5 years ago

0.8.25

5 years ago

0.8.24

5 years ago

0.8.23

5 years ago

0.8.22

5 years ago

0.8.21

5 years ago

0.8.20

5 years ago

0.8.19

5 years ago

0.8.18

5 years ago

0.8.17

5 years ago

0.8.16

5 years ago

0.8.15

5 years ago

0.8.14

5 years ago

0.8.13

5 years ago

0.8.11

5 years ago

0.8.10

5 years ago

0.8.9

5 years ago

0.8.8

5 years ago

0.8.7

5 years ago

0.8.6

5 years ago

0.8.5

5 years ago

0.8.4

5 years ago

0.8.3

5 years ago

0.8.2

5 years ago

0.8.1

5 years ago

0.8.0

5 years ago

0.7.24

5 years ago

0.7.25

5 years ago

0.7.23

5 years ago

0.7.22

5 years ago

0.7.21

5 years ago

0.7.20

5 years ago

0.7.19

5 years ago

0.7.18

5 years ago

0.7.17

5 years ago

0.7.16

5 years ago

0.7.15

5 years ago

0.7.14

5 years ago

0.7.13

5 years ago

0.7.11

5 years ago

0.7.12

5 years ago

0.7.10

5 years ago

0.7.9

5 years ago

0.7.8

5 years ago

0.7.7

5 years ago

0.7.4

5 years ago

0.7.6

5 years ago

0.7.5

5 years ago

0.7.2

5 years ago

0.7.1

5 years ago

0.7.3

5 years ago

0.7.0

5 years ago

0.6.1

5 years ago

0.6.0

5 years ago

0.5.2

5 years ago

0.5.1

5 years ago

0.5.0

5 years ago

0.4.0

5 years ago

0.2.25

5 years ago

0.3.0

5 years ago

0.2.24

5 years ago

0.2.23

5 years ago

0.2.22

5 years ago

0.2.21

6 years ago

0.2.20

6 years ago

0.2.19

6 years ago

0.2.18

6 years ago

0.2.17

6 years ago

0.2.16

6 years ago

0.2.15

6 years ago

0.2.14

6 years ago

0.2.13

6 years ago

0.2.12

6 years ago

0.2.11

6 years ago

0.2.10

6 years ago

0.2.9

6 years ago

0.2.8

6 years ago

0.2.7

6 years ago

0.2.6

6 years ago

0.2.5

6 years ago

0.2.4

6 years ago

0.2.3

6 years ago

0.2.2

6 years ago

0.2.1

6 years ago

0.2.0

6 years ago

0.1.27

6 years ago

0.1.26

6 years ago

0.1.25

6 years ago

0.1.24

6 years ago

0.1.23

6 years ago

0.1.22

6 years ago

0.1.21

6 years ago

0.1.20

6 years ago

0.1.19

6 years ago

0.1.18

6 years ago

0.1.17

6 years ago

0.1.16

6 years ago

0.1.15

6 years ago

0.1.14

6 years ago

0.1.13

6 years ago

0.1.12

6 years ago

0.1.11

6 years ago

0.1.10

6 years ago

0.1.9

6 years ago

0.1.8

6 years ago

0.1.7

6 years ago

0.1.6

6 years ago

0.1.5

6 years ago

0.1.4

6 years ago

0.1.3

6 years ago

0.1.2

6 years ago

0.1.1

6 years ago

0.1.0

6 years ago

0.0.35

6 years ago

0.0.34

6 years ago

0.0.33

6 years ago

0.0.32

6 years ago

0.0.31

6 years ago

0.0.30

6 years ago

0.0.29

6 years ago

0.0.28

6 years ago

0.0.27

6 years ago

0.0.26

6 years ago

0.0.25

6 years ago

0.0.24

6 years ago

0.0.23

6 years ago

0.0.22

6 years ago

0.0.21

6 years ago

0.0.20

6 years ago

0.0.19

6 years ago

0.0.18

6 years ago

0.0.17

6 years ago

0.0.16

6 years ago

0.0.15

6 years ago

0.0.14

6 years ago

0.0.13

6 years ago

0.0.12

6 years ago

0.0.11

6 years ago

0.0.11-alpha.0

6 years ago

0.0.10-alpha.0

6 years ago

0.0.10

6 years ago

0.0.9

6 years ago

0.0.9-alpha.1

6 years ago

0.0.8

6 years ago

0.0.7

6 years ago

0.0.6

6 years ago

0.0.5

6 years ago