浏览代码

Document requirement of having client + server RPCs in High-level multiplayer (#7932)

Co-authored-by: A Thousand Ships <[email protected]>
Co-authored-by: Hugo Locurcio <[email protected]>
Paul PINA-GHERARDI 1 年之前
父节点
当前提交
f6baf555b9
共有 1 个文件被更改,包括 10 次插入0 次删除
  1. 10 0
      tutorials/networking/high_level_multiplayer.rst

+ 10 - 0
tutorials/networking/high_level_multiplayer.rst

@@ -196,6 +196,16 @@ For a remote call to be successful, the sending and receiving node need to have
 must have the same name. When using ``add_child()`` for nodes which are expected to use RPCs, set the argument
 ``force_readable_name`` to ``true``.
 
+.. warning:: 
+
+    If a function is annotated with ``@rpc`` on the client script (resp. server script),
+    then this function must also be declared on the server script (resp. client script),
+    and both must have the same signature, **even if this function is not currently used**.
+
+    If these conditions are not fulfilled, the script may print an error or
+    cause unwanted behavior. See further explanation and troubleshooting on
+    `this post <https://github.com/godotengine/godot/issues/57869#issuecomment-1034215138>`__.
+
 The annotation can take a number of arguments, which have default values. ``@rpc`` is equivalent to:
 
 ::