gdドキュメント0.8.0

English | 日本語

Godot Online 最初に読む手引き

作り始めるのに要る分だけです。全部の説明はONLINE.mdにあります。

世界の形

Node2D
└── Online          ← Online側の世界。ここのgdにOnline側の処理を書く
    ├── Secret      ← Online側だけで動く。設定・login処理・鍵はここ
    └── Paddle_7    ← spawn()で持ち主を付けたNode

作る

1. 世界。 根がOnlineのsceneを1つ作り、本文を付け、子にSecretを置きます。 プレイヤーのsceneをSecretのplayer_sceneに入れると、入ってきた人に1つ置かれます。

extends Online

func _on_player_joining(my):   # _on_<合図> は _ready と同じく自分で繋がる
	print(my.name, " joined")

2. プレイヤー。 根は好きな型。@onlineが1つでもあれば、Node2D/Node3Dの位置と向きは書かなくても配られます。

extends CharacterBody2D

@online var color := Color.WHITE    # 全員へ配る
@online_input var axis := 0.0       # 本人の手元が書き、Online側が読む

func _process(_delta):              # 印が無い本文は全員の手元で走る
	axis = Input.get_axis("ui_left", "ui_right")

@online                             # Online側だけで走る
func _physics_process(_delta):
	velocity.x = clampf(axis, -1.0, 1.0) * 220.0
	move_and_slide()

3. Online側を1回動かす。 鍵を作り、証明書の場所を表示します。表示されたcertificate.pemをres://online-ca.pemとして置きます。

godot --headless --path . -- --online-server

4. 遊ぶ。 Online側を動かしたまま、projectを普通に実行するとClientとして繋がります。

覚える名前

種類名前
印@online @online_my @online_save @online_save_my @online_input、位置を配らない@online("auto_off")
型Online Secret
関数spawn(scene, my, properties)(後ろは型で読む。どれも省ける)
語my(本人。my.id my.guest my.name)、world(その物が居るOnline)
Onlineの合図player_joining(my) player_left(my) logged_in(my) login_failed(reason) spawned(node)。_on_<名前>を書けば繋がる
全Nodeの合図disconnected
外部口座Online.login_with("提供者名") Online.logout()。使う場合はSecretに提供者を設定
印誰に配るか保存
@online var hp全員しない
@online_my var hand本人とOnline側だけしない
@online_save var level全員する(Redis)
@online_save_my var coins本人とOnline側だけする
@online_input var axis本人の手元が書き、Online側が読むしない

したいこと

したいこと書きかた
世界に物を置くOnline側でspawn(BULLET)。誰かの物ならspawn(BULLET, my)
跳ぶ・撃つ(出来事)@online func jump()を手元から呼ぶ
押している間の入力(状態)@online_input var axisを_processで書く
Online側の値をLabelへ@online($Score.text) var score := 0
再起動しても残す@online_save var level := 1。Secretのredis_host
部屋の人数、切れた人を待つ秒数Secretのroom_max keep_sec
別のPCのサーバへSecretのroom_host
手元で試すProject ▸ Tools ▸「Online: 手元の試験用コンテナを起動」(Dockerが要る)

困ったとき

出たものどうする
Cannot read the CA certificateサーバが表示した場所から証明書を写す
Cannot reach the roomOnline側を先に動かす
The room is fullroom_max を増やす。異常ではない。手元は5秒ごとに入り直し、席が空けば入る
Too many new players from this address新しい口座は同じアドレスから10分に8つまで。在る口座はそのまま入れる
... is decided by the Online sideClientで @online 値を書いた。その行を @online func へ移す
Signed in from another device同じ口座で別の端末が入ったので、この端末は止まった。起動し直せばこちらに戻る
The save store is not reachableOnline側のRedisが落ちている。手元は勝手に入り直す
this is a client build--online-server はエディターかサーバ用のbuildで
相手が急に切れる同じプロジェクト名の写しが2つある。片方の名前を変える

次に読む

読む場所(ONLINE.md)分かること
印配れる型、保存の置き場、signalと関数の印
どこで何が走るか印の無い本文とある本文、出来事だけを配る書き方
SecretOnline側だけの本文と、インスペクタの19個の設定
Loginゲストの口座、任意の外部口座との紐付け
サーバ実行 / サーバを選ばない / ホストが世界を持つ専用サーバ、マッチング、プレイヤーが部屋を持つ形
細かい調整回数、寄せかた、先読み。書かなくても動く
配布境界ClientのPCKに入らない物

サンプルは samples/ の pong と shobon_jump です。