From d66a707cad648a08b5ce0bb5cc27cdb37e8da935 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tam=C3=A1s=20G=C3=A1lffy?= <ezittgtx@gmail.com>
Date: Sun, 18 Feb 2024 10:01:03 +0100
Subject: [PATCH 1/3] add node

---
 addons/netfox/icons/state-synchronizer.svg    | 61 +++++++++++++++++++
 .../icons/state-synchronizer.svg.import       | 37 +++++++++++
 addons/netfox/netfox.gd                       |  6 ++
 addons/netfox/state-synchronizer.gd           | 45 ++++++++++++++
 4 files changed, 149 insertions(+)
 create mode 100644 addons/netfox/icons/state-synchronizer.svg
 create mode 100644 addons/netfox/icons/state-synchronizer.svg.import
 create mode 100644 addons/netfox/state-synchronizer.gd

diff --git a/addons/netfox/icons/state-synchronizer.svg b/addons/netfox/icons/state-synchronizer.svg
new file mode 100644
index 00000000..757438d4
--- /dev/null
+++ b/addons/netfox/icons/state-synchronizer.svg
@@ -0,0 +1,61 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<svg
+   height="16"
+   width="16"
+   version="1.1"
+   id="svg3"
+   sodipodi:docname="state-synchronizer.svg"
+   inkscape:version="1.3.2 (091e20ef0f, 2023-11-25)"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <defs
+     id="defs3" />
+  <sodipodi:namedview
+     id="namedview3"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:zoom="1"
+     inkscape:cx="-164"
+     inkscape:cy="-94.5"
+     inkscape:window-width="2560"
+     inkscape:window-height="1048"
+     inkscape:window-x="0"
+     inkscape:window-y="0"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="svg3" />
+  <circle
+     style="fill:none;stroke:#e0e0e0;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1"
+     id="path4"
+     cx="8"
+     cy="8"
+     r="6" />
+  <path
+     d="m8 10-2 4-2-4Z"
+     fill="#5fff97"
+     id="path1" />
+  <path
+     d="m12 14-2-4-2 4Z"
+     fill="#ff5f5f"
+     id="path2" />
+  <g
+     id="g3"
+     transform="translate(0.1760495)">
+    <path
+       style="fill:none;stroke:#e0e0e0;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1"
+       d="M 5,8.0000002 7.8239505,5.1760494"
+       id="path6"
+       sodipodi:nodetypes="cc" />
+    <path
+       style="fill:none;stroke:#e0e0e0;stroke-width:2;stroke-linecap:round;stroke-linejoin:round;stroke-opacity:1"
+       d="M 10.647901,8.0000002 7.8239505,5.1760494"
+       id="path3"
+       sodipodi:nodetypes="cc" />
+  </g>
+</svg>
diff --git a/addons/netfox/icons/state-synchronizer.svg.import b/addons/netfox/icons/state-synchronizer.svg.import
new file mode 100644
index 00000000..18f73f08
--- /dev/null
+++ b/addons/netfox/icons/state-synchronizer.svg.import
@@ -0,0 +1,37 @@
+[remap]
+
+importer="texture"
+type="CompressedTexture2D"
+uid="uid://ogbi1hffcoyh"
+path="res://.godot/imported/state-synchronizer.svg-9cb9447ba79f114a58e468a24d17b860.ctex"
+metadata={
+"vram_texture": false
+}
+
+[deps]
+
+source_file="res://addons/netfox/icons/state-synchronizer.svg"
+dest_files=["res://.godot/imported/state-synchronizer.svg-9cb9447ba79f114a58e468a24d17b860.ctex"]
+
+[params]
+
+compress/mode=0
+compress/high_quality=false
+compress/lossy_quality=0.7
+compress/hdr_compression=1
+compress/normal_map=0
+compress/channel_pack=0
+mipmaps/generate=false
+mipmaps/limit=-1
+roughness/mode=0
+roughness/src_normal=""
+process/fix_alpha_border=true
+process/premult_alpha=false
+process/normal_map_invert_y=false
+process/hdr_as_srgb=false
+process/hdr_clamp_exposure=false
+process/size_limit=0
+detect_3d/compress_to=1
+svg/scale=1.0
+editor/scale_with_editor_scale=false
+editor/convert_colors_with_editor_theme=false
diff --git a/addons/netfox/netfox.gd b/addons/netfox/netfox.gd
index 220f2957..76bd6b13 100644
--- a/addons/netfox/netfox.gd
+++ b/addons/netfox/netfox.gd
@@ -104,6 +104,12 @@ const TYPES = [
 		"script": ROOT + "/rollback/rollback-synchronizer.gd",
 		"icon": ROOT + "/icons/rollback-synchronizer.svg"
 	},
+	{
+		"name": "StateSynchronizer",
+		"base": "Node",
+		"script": ROOT + "/state-synchronizer.gd",
+		"icon": ROOT + "/icons/state-synchronizer.svg"
+	},
 	{
 		"name": "TickInterpolator",
 		"base": "Node",
diff --git a/addons/netfox/state-synchronizer.gd b/addons/netfox/state-synchronizer.gd
new file mode 100644
index 00000000..f8927581
--- /dev/null
+++ b/addons/netfox/state-synchronizer.gd
@@ -0,0 +1,45 @@
+extends Node
+class_name StateSynchronizer
+
+## Synchronizes state from authority.
+
+@export var root: Node
+@export var properties: Array[String]
+
+var _property_cache: PropertyCache
+var _props: Array[PropertyEntry]
+
+var _last_received_tick: int = -1
+var _last_received_state: Dictionary = {}
+
+## Process settings.
+##
+## Call this after any change to configuration.
+func process_settings():
+	_property_cache = PropertyCache.new(root)
+	_props = []
+
+	for property in properties:
+		var pe = _property_cache.get_entry(property)
+		_props.push_back(pe)
+
+func _ready():
+	process_settings()
+	NetworkTime.after_tick.connect(_after_tick)
+
+func _after_tick(_dt, tick):
+	if is_multiplayer_authority():
+		# Submit snapshot
+		var state = PropertySnapshot.extract(_props)
+		rpc("_submit_state", state, tick)
+	else:
+		# Apply last received state
+		PropertySnapshot.apply(_last_received_state, _property_cache)
+
+@rpc("authority", "unreliable", "call_remote")
+func _submit_state(state: Dictionary, tick: int):
+	if tick <= _last_received_tick:
+		return
+		
+	_last_received_state = state
+	_last_received_tick = tick

From ab339e838fab9d89fa2ab639d53b4004f163123e Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tam=C3=A1s=20G=C3=A1lffy?= <ezittgtx@gmail.com>
Date: Sun, 18 Feb 2024 13:29:26 +0100
Subject: [PATCH 2/3] add docs

---
 .../assets/state-synchronizer-config.png      | Bin 0 -> 16897 bytes
 docs/netfox/nodes/state-synchronizer.md       |  74 ++++++++++++++++++
 mkdocs.yml                                    |   1 +
 3 files changed, 75 insertions(+)
 create mode 100644 docs/netfox/assets/state-synchronizer-config.png
 create mode 100644 docs/netfox/nodes/state-synchronizer.md

diff --git a/docs/netfox/assets/state-synchronizer-config.png b/docs/netfox/assets/state-synchronizer-config.png
new file mode 100644
index 0000000000000000000000000000000000000000..f09ddfd5c5e8ffd068d61269fd622cdf3fc76c1d
GIT binary patch
literal 16897
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

literal 0
HcmV?d00001

diff --git a/docs/netfox/nodes/state-synchronizer.md b/docs/netfox/nodes/state-synchronizer.md
new file mode 100644
index 00000000..c4146891
--- /dev/null
+++ b/docs/netfox/nodes/state-synchronizer.md
@@ -0,0 +1,74 @@
+# StateSynchronizer
+
+Synchronizes state from the node's authority to other peers.
+
+Similar to Godot's [MultiplayerSynchronizer], but is tied to the [network tick
+loop]. Works well with [TickInterpolator].
+
+One way to use this node is to synchronize logic that runs only on the server,
+for example NPC's in your games. The NPC's are controlled fully by the server,
+and their state is synchronized to the clients by the *StateSynchronizer*
+nodes.
+
+## Configuring state
+
+To use *StateSynchronizer*, add it as a child to the target node, specify the
+root node, and configure which properties to synchronize:
+
+![StateSynchronizer configuration](../assets/state-synchronizer-config.png)
+
+*Root* specifies the root node for resolving properties. Best practice dictates
+to add *StateSynchronizer* under its target, so *Root* will most often be the
+*StateSynchronizer*'s parent node.
+
+*Properties* are recorded for each tick on the node's authority ( usually the
+server ), and broadcast to other peers. These are analogous to
+[RollbackSynchronizer]'s *state properties*.
+
+See [Property paths] on how to specify properties.
+
+## Changing configuration
+
+*StateSynchronizer* has to do some setup work whenever the state or the
+input properties change.
+
+By default, this work is done upon instantiation. If you need to change
+properties during runtime, make sure to call `process_settings()`, otherwise
+*StateSynchronizer* won't apply the changes.
+
+You can change the node's authority without calling `process_settings()` again.
+Make sure that the authority is changed the same way on all peers, to avoid
+discrepancies.
+
+## When to use StateSynchronizer and MultiplayerSynchronizer
+
+Part of the design philosophy of netfox is to build *on top of* Godot's
+networking tools, instead of *replacing* them.
+
+Both [MultiplayerSynchronizer] and StateSynchronizer can be used to synchronize
+state from authority to the rest of the peers.
+
+[MultiplayerSynchronizer] uses its own timer, and is independent of netfox's
+[network tick loop]. It can also do delta updates, and manage visibility per
+peer. Since it is not tied to netfox's tick loop, it does not work with
+[TickInterpolator].
+
+StateSynchronizer records all the properties specified and broadcasts them
+as-is to all peers. This does not include visiblity or delta updates. The
+broadcast happens on every network tick. This node is explicitly designed to
+work with [TickInterpolator].
+
+---
+
+You can use StateSynchronizer for properties that you want to be interpolated,
+like position, rotation, or any other visual properties.
+
+You can use [MultiplayerSynchronizer] for properties that either don't need
+interpolation ( e.g. a unit's HP ), or specifically need one of
+[MultiplayerSynchronizer]'s features.
+
+[MultiplayerSynchronizer]: https://docs.godotengine.org/en/stable/classes/class_multiplayersynchronizer.html
+[network tick loop]: ../guides/network-time.md
+[TickInterpolator]: ./tick-interpolator.md
+[RollbackSynchronizer]: ./rollback-synchronizer.md
+[Property paths]: ../guides/property-paths.md
diff --git a/mkdocs.yml b/mkdocs.yml
index 53336071..c9db0804 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -21,6 +21,7 @@ nav:
     - Nodes:
       - 'netfox/nodes/tick-interpolator.md'
       - 'netfox/nodes/rollback-synchronizer.md'
+      - 'netfox/nodes/state-synchronizer.md'
   - netfox.noray:
     - Guides:
       - 'netfox.noray/guides/noray.md'

From 47e2cd6b5cf957987ce0b4080e84a97b95b29f32 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tam=C3=A1s=20G=C3=A1lffy?= <ezittgtx@gmail.com>
Date: Sun, 18 Feb 2024 13:29:54 +0100
Subject: [PATCH 3/3] bv

---
 addons/netfox.extras/plugin.cfg    | 2 +-
 addons/netfox.internals/plugin.cfg | 2 +-
 addons/netfox.noray/plugin.cfg     | 2 +-
 addons/netfox/plugin.cfg           | 2 +-
 4 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/addons/netfox.extras/plugin.cfg b/addons/netfox.extras/plugin.cfg
index 9c9b8062..2b5189fa 100644
--- a/addons/netfox.extras/plugin.cfg
+++ b/addons/netfox.extras/plugin.cfg
@@ -3,5 +3,5 @@
 name="netfox.extras"
 description="Game-specific utilities for Netfox"
 author="Tamas Galffy"
-version="1.2.0"
+version="1.3.0"
 script="netfox-extras.gd"
diff --git a/addons/netfox.internals/plugin.cfg b/addons/netfox.internals/plugin.cfg
index 38fb3be0..cac6e55a 100644
--- a/addons/netfox.internals/plugin.cfg
+++ b/addons/netfox.internals/plugin.cfg
@@ -3,5 +3,5 @@
 name="netfox.internals"
 description="Shared internals for netfox addons"
 author="Tamas Galffy"
-version="1.2.0"
+version="1.3.0"
 script="plugin.gd"
diff --git a/addons/netfox.noray/plugin.cfg b/addons/netfox.noray/plugin.cfg
index 0b84cfd5..31df0ca8 100644
--- a/addons/netfox.noray/plugin.cfg
+++ b/addons/netfox.noray/plugin.cfg
@@ -3,5 +3,5 @@
 name="netfox.noray"
 description="Bulletproof your connectivity with noray integration for netfox"
 author="Tamas Galffy"
-version="1.2.0"
+version="1.3.0"
 script="netfox-noray.gd"
diff --git a/addons/netfox/plugin.cfg b/addons/netfox/plugin.cfg
index 3faeef24..d9f3061e 100644
--- a/addons/netfox/plugin.cfg
+++ b/addons/netfox/plugin.cfg
@@ -3,5 +3,5 @@
 name="netfox"
 description="Shared internals for netfox addons"
 author="Tamas Galffy"
-version="1.2.0"
+version="1.3.0"
 script="netfox.gd"