scene_synchronizer.cpp

#include "scene_synchronizer.h"

#include "core/core.h"
#include "core/data_buffer.h"
#include "core/ensure.h"
#include "core/net_math.h"
#include "core/net_utilities.h"
#include "core/object_data.h"
#include "core/peer_networked_controller.h"
#include "core/snapshot.h"
#include "core/var_data.h"
#include <limits>
#include <string>
#include <vector>

NS_NAMESPACE_BEGIN
void (*SceneSynchronizerBase::var_data_encode_func)(DataBuffer &r_buffer, const NS::VarData &p_val) = nullptr;
void (*SceneSynchronizerBase::var_data_decode_func)(NS::VarData &r_val, DataBuffer &p_buffer, std::uint8_t p_variable_type) = nullptr;
bool (*SceneSynchronizerBase::var_data_compare_func)(const VarData &p_A, const VarData &p_B) = nullptr;
std::string (*SceneSynchronizerBase::var_data_stringify_func)(const VarData &p_var_data, bool p_verbose) = nullptr;
void (*SceneSynchronizerBase::print_line_func)(const std::string &p_str) = nullptr;
void (*SceneSynchronizerBase::print_code_message_func)(const char *p_function, const char *p_file, int p_line, const std::string &p_error, const std::string &p_message, NS::PrintMessageType p_type) = nullptr;
void (*SceneSynchronizerBase::print_flush_stdout_func)() = nullptr;

SceneSynchronizerBase::SceneSynchronizerBase(NetworkInterface *p_network_interface, bool p_pedantic_checks, bool p_disable_client_sub_ticks) :
#ifdef NS_DEBUG_ENABLED
	pedantic_checks(p_pedantic_checks),
	disable_client_sub_ticks(p_disable_client_sub_ticks),
#endif
	network_interface(p_network_interface),
	objects_data_storage(*this) {
	// Avoid too much useless re-allocations.
	changes_listeners.reserve(100);
}

SceneSynchronizerBase::~SceneSynchronizerBase() {
	clear();
	uninit_synchronizer();
	network_interface = nullptr;
}

void SceneSynchronizerBase::install_synchronizer(
		void (*p_var_data_encode_func)(DataBuffer &r_buffer, const VarData &p_val),
		void (*p_var_data_decode_func)(NS::VarData &r_val, DataBuffer &p_buffer, std::uint8_t p_variable_type),
		bool (*p_var_data_compare_func)(const VarData &p_A, const VarData &p_B),
		std::string (*p_var_data_stringify_func)(const VarData &p_var_data, bool p_verbose),
		void (*p_print_line_func)(const std::string &p_str),
		void (*p_print_code_message_func)(const char *p_function, const char *p_file, int p_line, const std::string &p_error, const std::string &p_message, PrintMessageType p_type),
		void (*p_print_flush_stdout_func)()) {
	var_data_encode_func = p_var_data_encode_func;
	var_data_decode_func = p_var_data_decode_func;
	var_data_compare_func = p_var_data_compare_func;
	var_data_stringify_func = p_var_data_stringify_func;

	print_line_func = p_print_line_func;
	print_code_message_func = p_print_code_message_func;
	print_flush_stdout_func = p_print_flush_stdout_func;
}

void SceneSynchronizerBase::setup(SynchronizerManager &p_synchronizer_interface) {
	reset();

	// These can't be triggered because the interface and the debugger are
	// initialized by this class during the constructor.
	NS_ASSERT_COND(network_interface);

	synchronizer_manager = &p_synchronizer_interface;
	synchronizer_manager->set_scene_synchronizer(this);
	network_interface->start_listening_peer_connection(
			[this](int p_peer) {
				on_peer_connected(p_peer);
			},
			[this](int p_peer) {
				on_peer_disconnected(p_peer);
			});

	rpc_handler_state =
			network_interface->rpc_config(
					std::function<void(DataBuffer &)>(std::bind(&SceneSynchronizerBase::rpc_receive_state, this, std::placeholders::_1)),
					true,
					false);

	rpc_handler_notify_need_full_snapshot =
			network_interface->rpc_config(
					std::function<void()>(std::bind(&SceneSynchronizerBase::rpc__notify_need_full_snapshot, this)),
					true,
					false);

	rpc_handler_set_network_enabled =
			network_interface->rpc_config(
					std::function<void(bool)>(std::bind(&SceneSynchronizerBase::rpc_set_network_enabled, this, std::placeholders::_1)),
					true,
					false);

	rpc_handler_notify_peer_status =
			network_interface->rpc_config(
					std::function<void(bool)>(std::bind(&SceneSynchronizerBase::rpc_notify_peer_status, this, std::placeholders::_1)),
					true,
					false);

	rpc_handler_trickled_sync_data =
			network_interface->rpc_config(
					std::function<void(const std::vector<std::uint8_t> &)>(std::bind(&SceneSynchronizerBase::rpc_trickled_sync_data, this, std::placeholders::_1)),
					false,
					false);

	rpc_handle_notify_netstats =
			network_interface->rpc_config(
					std::function<void(DataBuffer &)>(std::bind(&SceneSynchronizerBase::rpc_notify_netstats, this, std::placeholders::_1)),
					false,
					false);

	rpc_handle_notify_scheduled_procedure_start =
			network_interface->rpc_config(
					std::function<void(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id, GlobalFrameIndex p_frame_index, const DataBuffer &p_data)>(std::bind(&SceneSynchronizerBase::rpc_notify_scheduled_procedure_start, this, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3, std::placeholders::_4)),
					false,
					false);

	rpc_handle_notify_scheduled_procedure_stop =
			network_interface->rpc_config(
					std::function<void(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id)>(std::bind(&SceneSynchronizerBase::rpc_notify_scheduled_procedure_stop, this, std::placeholders::_1, std::placeholders::_2)),
					false,
					false);

	rpc_handle_notify_scheduled_procedure_pause =
			network_interface->rpc_config(
					std::function<void(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id, GlobalFrameIndex p_pause_frame)>(std::bind(&SceneSynchronizerBase::rpc_notify_scheduled_procedure_pause, this, std::placeholders::_1, std::placeholders::_2, std::placeholders::_3)),
					false,
					false);

	rpc_handle_receive_input =
			network_interface->rpc_config(
					std::function<void(int, const std::vector<std::uint8_t> &)>(std::bind(&SceneSynchronizerBase::rpc_receive_inputs, this, std::placeholders::_1, std::placeholders::_2)),
					false,
					false);

	reset_synchronizer_mode();

	// Fetch the peers connected from the Network Interface and ini them.
	std::vector<int> peer_ids;
	network_interface->fetch_connected_peers(peer_ids);
	for (int peer_id : peer_ids) {
		on_peer_connected(peer_id);
	}
}

void SceneSynchronizerBase::conclude() {
	network_interface->stop_listening_peer_connection();
	network_interface->reset();

	clear_peers();
	clear();
	uninit_synchronizer();

	// Make sure to reset all the assigned controllers.
	reset_controllers();

	synchronizer_manager->set_scene_synchronizer(nullptr);
	synchronizer_manager = nullptr;

	rpc_handler_state.reset();
	rpc_handler_notify_need_full_snapshot.reset();
	rpc_handler_set_network_enabled.reset();
	rpc_handler_notify_peer_status.reset();
	rpc_handler_trickled_sync_data.reset();
	rpc_handle_notify_netstats.reset();
	rpc_handle_notify_scheduled_procedure_start.reset();
	rpc_handle_notify_scheduled_procedure_stop.reset();
	rpc_handle_notify_scheduled_procedure_pause.reset();
	rpc_handle_receive_input.reset();

	time_bank = 0.0;
}

void SceneSynchronizerBase::process(float p_delta) {
	NS_PROFILE

	if (settings_changed) {
		event_settings_changed.broadcast(settings);
		settings_changed = false;
	}

#ifdef NS_DEBUG_ENABLED
	NS_ASSERT_COND_MSG(synchronizer, "Never execute this function unless this synchronizer is ready.");

	synchronizer_manager->debug_only_validate_objects();
#endif

	try_fetch_unnamed_objects_data_names();

	synchronizer->process(p_delta);

	event_app_process_end.broadcast(p_delta);
}

void SceneSynchronizerBase::on_app_object_removed(ObjectHandle p_app_object_handle) {
	unregister_app_object(find_object_local_id(p_app_object_handle));
}

void SceneSynchronizerBase::var_data_encode(DataBuffer &r_buffer, const NS::VarData &p_val, std::uint8_t p_variable_type) {
	NS_PROFILE
#ifdef NS_DEBUG_ENABLED
	NS_ASSERT_COND_MSG(p_variable_type == p_val.type, "The variable_type differ from the VarData type passed during the encoding. This cause major problems. Please ensure your encoding and decoding properly set the variable type.");
#endif
	var_data_encode_func(r_buffer, p_val);
}

void SceneSynchronizerBase::var_data_decode(VarData &r_val, DataBuffer &p_buffer, std::uint8_t p_variable_type) {
	NS_PROFILE
	var_data_decode_func(r_val, p_buffer, p_variable_type);
#ifdef NS_DEBUG_ENABLED
	NS_ASSERT_COND_MSG(p_variable_type == r_val.type, "The variable_type differ from the VarData type passed during the decoding. This cause major problems. Please ensure your encoding and decoding properly set the variable type.");
#endif
}

bool SceneSynchronizerBase::var_data_compare(const VarData &p_A, const VarData &p_B) {
	NS_PROFILE
	return var_data_compare_func(p_A, p_B);
}

std::string SceneSynchronizerBase::var_data_stringify(const VarData &p_var_data, bool p_verbose) {
	NS_PROFILE
	return var_data_stringify_func(p_var_data, p_verbose);
}

void SceneSynchronizerBase::__print_line(const std::string &p_str) {
	if (print_line_func) {
		print_line_func(p_str);
	}
}

void SceneSynchronizerBase::print_code_message(SceneSynchronizerDebugger *p_debugger, const char *p_function, const char *p_file, int p_line, const std::string &p_error, const std::string &p_message, NS::PrintMessageType p_type) {
	const std::string log_level_str = get_log_level_txt(p_type);
	std::string msg = log_level_str + " The condition " + p_error + " evaluated to false: " + p_message + "\n";
	msg += std::string() + "At: " + p_file + "::" + p_file + "::" + std::to_string(p_line);
	if (p_debugger) {
		p_debugger->__add_message(msg, "SceneSync");
	}
	if (print_code_message_func) {
		print_code_message_func(p_function, p_file, p_line, p_error, p_message, p_type);
	}
}

void SceneSynchronizerBase::print_flush_stdout() {
	if (print_flush_stdout_func) {
		print_flush_stdout_func();
	}
}

void SceneSynchronizerBase::set_frames_per_seconds(int p_fps) {
	frames_per_seconds = std::max(p_fps, 1);
	fixed_frame_delta = 1.0f / frames_per_seconds;
}

int SceneSynchronizerBase::get_frames_per_seconds() const {
	return frames_per_seconds;
}

float SceneSynchronizerBase::get_fixed_frame_delta() const {
	return fixed_frame_delta;
}

void SceneSynchronizerBase::set_max_sub_process_per_frame(std::uint8_t p_max_sub_process_per_frame) {
	max_sub_process_per_frame = p_max_sub_process_per_frame;
}

std::uint8_t SceneSynchronizerBase::get_max_sub_process_per_frame() const {
	return max_sub_process_per_frame;
}

void SceneSynchronizerBase::set_min_server_input_buffer_size(int p_val) {
	min_server_input_buffer_size = p_val;
}

int SceneSynchronizerBase::get_min_server_input_buffer_size() const {
	return min_server_input_buffer_size;
}

void SceneSynchronizerBase::set_max_server_input_buffer_size(int p_val) {
	max_server_input_buffer_size = p_val;
}

int SceneSynchronizerBase::get_max_server_input_buffer_size() const {
	return max_server_input_buffer_size;
}

void SceneSynchronizerBase::set_negligible_packet_loss(float p_val) {
	negligible_packet_loss = p_val;
}

float SceneSynchronizerBase::get_negligible_packet_loss() const {
	return negligible_packet_loss;
}

void SceneSynchronizerBase::set_worst_packet_loss(float p_val) {
	worst_packet_loss = std::clamp(p_val, 0.0001f, 1.0f);
}

float SceneSynchronizerBase::get_worst_packet_loss() const {
	return worst_packet_loss;
}

void SceneSynchronizerBase::set_max_fps_acceleration_percentage(float p_percentage) {
	max_fps_acceleration_percentage = std::max(p_percentage, 0.0f);
}

float SceneSynchronizerBase::get_max_fps_acceleration_percentage() const {
	return max_fps_acceleration_percentage;
}

void SceneSynchronizerBase::set_netstats_update_interval_sec(float p_delay_seconds) {
	netstats_update_interval_sec = p_delay_seconds;
}

float SceneSynchronizerBase::get_netstats_update_interval_sec() const {
	return netstats_update_interval_sec;
}

void SceneSynchronizerBase::set_max_trickled_objects_per_update(int p_rate) {
	max_trickled_objects_per_update = p_rate;
}

int SceneSynchronizerBase::get_max_trickled_objects_per_update() const {
	return max_trickled_objects_per_update;
}

void SceneSynchronizerBase::set_max_trickled_interpolation_alpha(float p_int_alpha) {
	max_trickled_interpolation_alpha = std::max(p_int_alpha, 1.0f);
}

float SceneSynchronizerBase::get_max_trickled_interpolation_alpha() const {
	return max_trickled_interpolation_alpha;
}

void SceneSynchronizerBase::set_frame_confirmation_timespan(float p_interval) {
	frame_confirmation_timespan = p_interval;
}

float SceneSynchronizerBase::get_frame_confirmation_timespan() const {
	return frame_confirmation_timespan;
}

void SceneSynchronizerBase::set_max_predicted_intervals(float p_max_predicted_intevals) {
	max_predicted_intervals = std::max(p_max_predicted_intevals, 1.5f);
}

float SceneSynchronizerBase::get_max_predicted_intervals() const {
	return max_predicted_intervals;
}

void SceneSynchronizerBase::set_objects_relevancy_update_time(float p_time) {
	objects_relevancy_update_time = p_time;
}

float SceneSynchronizerBase::get_objects_relevancy_update_time() const {
	return objects_relevancy_update_time;
}

void SceneSynchronizerBase::set_latency_update_rate(float p_rate_seconds) {
	latency_update_rate = p_rate_seconds;
}

float SceneSynchronizerBase::get_latency_update_rate() const {
	return latency_update_rate;
}

bool SceneSynchronizerBase::is_variable_registered(ObjectLocalId p_id, const std::string &p_variable) const {
	const ObjectData *od = objects_data_storage.get_object_data(p_id);
	if (od != nullptr) {
		return od->find_variable_id(p_variable) != VarId::NONE;
	}
	return false;
}

void SceneSynchronizerBase::set_debug_rewindings_enabled(bool p_enabled) {
	debug_rewindings_enabled = p_enabled;
}

void SceneSynchronizerBase::set_debug_server_speedup(bool p_enabled) {
	debug_server_speedup = p_enabled;
}

void SceneSynchronizerBase::set_debug_log_nodes_relevancy_update(bool p_enabled) {
	debug_log_nodes_relevancy_update = p_enabled;
}

void SceneSynchronizerBase::set_settings(Settings &p_settings) {
	settings = p_settings;
	settings_changed = true;
}

Settings &SceneSynchronizerBase::get_settings_mutable() {
	settings_changed = true;
	return settings;
}

const Settings &SceneSynchronizerBase::get_settings() const {
	return settings;
}

void SceneSynchronizerBase::register_app_object(ObjectHandle p_app_object_handle, ObjectLocalId *out_id) {
	NS_ENSURE(p_app_object_handle != ObjectHandle::NONE);

	ObjectLocalId id = objects_data_storage.find_object_local_id(p_app_object_handle);
	if (out_id) {
		*out_id = id;
	}

	if (id == ObjectLocalId::NONE) {
		ObjectData *od = objects_data_storage.allocate_object_data();
		id = od->get_local_id();
		if (out_id) {
			*out_id = id;
		}

		od->set_net_id(ObjectNetId::NONE);
		od->debug_object_id = synchronizer_manager->debug_only_get_object_id(p_app_object_handle);
		od->set_object_name(synchronizer_manager->fetch_object_name(p_app_object_handle), true);
		od->app_object_handle = p_app_object_handle;

		if (generate_id) {
#ifdef NS_DEBUG_ENABLED
			// When generate_id is true, the id must always be undefined.
			NS_ASSERT_COND(od->get_net_id() == ObjectNetId::NONE);
#endif
			od->set_net_id(objects_data_storage.generate_net_id());
		}

		if (od->has_registered_process_functions()) {
			process_functions__clear();
		}

		synchronizer_manager->setup_synchronizer_for(p_app_object_handle, id);

		if (synchronizer) {
			synchronizer->on_object_data_added(*od);
		}

		synchronizer_manager->on_add_object_data(*od);

		get_debugger().print(INFO, "New object registered" + (generate_id ? " #ID: " + std::to_string(od->get_net_id().id) : "") + " : " + od->get_object_name(), network_interface->get_owner_name());
	}

	NS_ASSERT_COND(id != ObjectLocalId::NONE);
}

void SceneSynchronizerBase::unregister_app_object(ObjectLocalId p_id) {
	if (p_id == ObjectLocalId::NONE) {
		// Nothing to do.
		return;
	}

	ObjectData *od = objects_data_storage.get_object_data(p_id, false);
	if (!od) {
		// Nothing to do.
		return;
	}

	drop_object_data(*od);
}

void SceneSynchronizerBase::setup_controller(
		ObjectLocalId p_id,
		std::function<void(float /*delta*/, DataBuffer & /*r_data_buffer*/)> p_collect_input_func,
		std::function<bool(DataBuffer & /*p_data_buffer_A*/, DataBuffer & /*p_data_buffer_B*/)> p_are_inputs_different_func,
		std::function<void(float /*delta*/, DataBuffer & /*p_data_buffer*/)> p_process_func) {
	NS_ENSURE_MSG(p_id != ObjectLocalId::NONE, "The passed object_id is not valid.");

	NS::ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE(object_data != nullptr);

	object_data->setup_controller(p_collect_input_func, p_are_inputs_different_func, p_process_func);
}

void SceneSynchronizerBase::set_controlled_by_peer(
		ObjectLocalId p_id,
		int p_peer) {
	NS_ENSURE_MSG(p_id != ObjectLocalId::NONE, "The passed object_id is not valid.");

	ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE(object_data != nullptr);

	object_data->set_controlled_by_peer(*this, p_peer);
}

void SceneSynchronizerBase::register_variable(ObjectLocalId p_id, const std::string &p_variable_name, const NS_VarDataSetFunc &p_set_func, const NS_VarDataGetFunc &p_get_func) {
	NS_ENSURE(p_id != ObjectLocalId::NONE);
	NS_ENSURE(!p_variable_name.empty());
	NS_ENSURE(p_set_func);
	NS_ENSURE(p_get_func);

	ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE(object_data);

	VarId var_id = object_data->find_variable_id(p_variable_name);
	if (var_id == VarId::NONE) {
		// The variable is not yet registered.
		VarData old_val;
		p_get_func(
				*synchronizer_manager,
				object_data->app_object_handle,
				p_variable_name.data(),
				old_val);
		var_id = VarId{ { VarId::IdType(object_data->vars.size()) } };
		object_data->vars.push_back(
				VarDescriptor(
						var_id,
						p_variable_name,
						old_val.type,
						std::move(old_val),
						p_set_func,
						p_get_func,
						false,
						true));
	} else {
		// Make sure the var is active.
		object_data->vars[var_id.id].enabled = true;
	}

#ifdef NS_DEBUG_ENABLED
	for (VarId v = VarId{ { 0 } }; v < VarId{ { VarId::IdType(object_data->vars.size()) } }; v += 1) {
		// This can't happen, because the IDs are always consecutive, or NONE.
		NS_ASSERT_COND(object_data->vars[v.id].id == v);
	}
#endif

	get_debugger().print(INFO, "[" + object_data->get_object_name() + "] variable registered ID `" + std::to_string(var_id.id) + "`, name `" + p_variable_name + "`.");

	if (synchronizer) {
		synchronizer->on_variable_added(object_data, p_variable_name);
	}
}

void SceneSynchronizerBase::unregister_variable(ObjectLocalId p_id, const std::string &p_variable) {
	NS_ENSURE(p_id != ObjectLocalId::NONE);
	NS_ENSURE(!p_variable.empty());

	NS::ObjectData *od = objects_data_storage.get_object_data(p_id);
	NS_ENSURE(od);

	const VarId var_id = od->find_variable_id(p_variable);
	NS_ENSURE(var_id != VarId::NONE);

	// Never remove the variable values, because the order of the vars matters.
	od->vars[var_id.id].enabled = false;

	// Remove this var from all the changes listeners.
	for (ChangesListener *cl : od->vars[var_id.id].changes_listeners) {
		for (ListeningVariable lv : cl->watching_vars) {
			if (lv.node_data == od && lv.var_id == var_id) {
				// We can't change the var order, so just invalidate this.
				lv.node_data = nullptr;
				lv.var_id = VarId::NONE;
			}
		}
	}

	// So, clear the changes listener list for this var.
	od->vars[var_id.id].changes_listeners.clear();
}

ObjectNetId SceneSynchronizerBase::get_app_object_net_id(ObjectLocalId p_local_id) const {
	const ObjectData *nd = objects_data_storage.get_object_data(p_local_id);
	if (nd) {
		return nd->get_net_id();
	} else {
		return ObjectNetId::NONE;
	}
}

ObjectNetId SceneSynchronizerBase::get_app_object_net_id(ObjectHandle p_app_object_handle) const {
	return get_app_object_net_id(objects_data_storage.find_object_local_id(p_app_object_handle));
}

ObjectHandle SceneSynchronizerBase::get_app_object_from_id(ObjectNetId p_id, bool p_expected) {
	ObjectData *object_data = get_object_data(p_id, p_expected);
	if (p_expected) {
		NS_ENSURE_V_MSG(object_data, ObjectHandle::NONE, "The ID " + p_id + " is not assigned to any object.");
		return object_data->app_object_handle;
	} else {
		return object_data ? object_data->app_object_handle : ObjectHandle::NONE;
	}
}

ObjectHandle SceneSynchronizerBase::get_app_object_from_id_const(ObjectNetId p_id, bool p_expected) const {
	const ObjectData *object_data = get_object_data(p_id, p_expected);
	if (p_expected) {
		NS_ENSURE_V_MSG(object_data, ObjectHandle::NONE, "The ID " + p_id + " is not assigned to any object.");
		return object_data->app_object_handle;
	} else {
		return object_data ? object_data->app_object_handle : ObjectHandle::NONE;
	}
}

const std::vector<ObjectData *> &SceneSynchronizerBase::get_sorted_objects_data() const {
	return objects_data_storage.get_sorted_objects_data();
}

const std::vector<ObjectData *> &SceneSynchronizerBase::get_all_object_data() const {
	return objects_data_storage.get_objects_data();
}

const std::vector<ObjectData *> *SceneSynchronizerBase::get_peer_controlled_objects_data(int p_peer) const {
	return objects_data_storage.get_peer_controlled_objects_data(p_peer);
}

VarId SceneSynchronizerBase::get_variable_id(ObjectLocalId p_id, const std::string &p_variable) {
	NS_ENSURE_V(p_variable != "", VarId::NONE);

	NS::ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V_MSG(od, VarId::NONE, "This object " + p_id + "is not registered.");

	return od->find_variable_id(p_variable);
}

void SceneSynchronizerBase::set_skip_rewinding(ObjectLocalId p_id, const std::string &p_variable, bool p_skip_rewinding) {
	NS::ObjectData *od = get_object_data(p_id);
	NS_ENSURE(od);

	const VarId id = od->find_variable_id(p_variable);
	NS_ENSURE(id != VarId::NONE);

	od->vars[id.id].skip_rewinding = p_skip_rewinding;
}

ListenerHandle SceneSynchronizerBase::track_variable_changes(
		ObjectLocalId p_id,
		const std::string &p_variable,
		std::function<void(const std::vector<VarData> &p_old_values)> p_listener_func,
		NetEventFlag p_flags) {
	std::vector<ObjectLocalId> object_ids;
	std::vector<std::string> variables;
	object_ids.push_back(p_id);
	variables.push_back(p_variable);
	return track_variables_changes(object_ids, variables, p_listener_func, p_flags);
}

ListenerHandle SceneSynchronizerBase::track_variables_changes(
		const std::vector<ObjectLocalId> &p_object_ids,
		const std::vector<std::string> &p_variables,
		std::function<void(const std::vector<VarData> &p_old_values)> p_listener_func,
		NetEventFlag p_flags) {
	NS_ENSURE_V_MSG(p_object_ids.size() == p_variables.size(), nulllistenerhandle, "object_ids and variables should have the exact same size.");
	NS_ENSURE_V_MSG(p_object_ids.size() != 0, nulllistenerhandle, "object_ids can't be of size 0");
	NS_ENSURE_V_MSG(p_variables.size() != 0, nulllistenerhandle, "object_ids can't be of size 0");

	bool is_valid = true;

	// TODO allocate into a buffer instead of using `new`?
	ChangesListener *listener = new ChangesListener;
	listener->listener_func = p_listener_func;
	listener->flag = p_flags;

	listener->watching_vars.resize(p_object_ids.size());
	listener->old_values.resize(p_object_ids.size());
	for (int i = 0; i < int(p_object_ids.size()); i++) {
		ObjectLocalId id = p_object_ids[i];
		const std::string &variable_name = p_variables[i];

		NS::ObjectData *od = objects_data_storage.get_object_data(id);
		if (!od) {
			get_debugger().print(ERROR, "The passed ObjectHandle `" + std::to_string(id.id) + "` is not pointing to any valid NodeData. Make sure to register the variable first.");
			is_valid = false;
			break;
		}

		const VarId vid = od->find_variable_id(variable_name);
		if (vid == VarId::NONE) {
			get_debugger().print(ERROR, "The passed variable `" + variable_name + "` doesn't exist under this object `" + od->get_object_name() + "`.");
			is_valid = false;
			break;
		}

		listener->watching_vars[i].node_data = od;
		listener->watching_vars[i].var_id = vid;
	}

	if (is_valid) {
		// Now we are sure that everything passed by the user is valid
		// we can connect the other NodeData to this listener.
		for (auto wv : listener->watching_vars) {
			NS::ObjectData *nd = wv.node_data;
			nd->vars[wv.var_id.id].changes_listeners.push_back(listener);
		}

		changes_listeners.push_back(listener);
		return ListenerHandle::to_handle(listener);
	} else {
		delete listener;
		return nulllistenerhandle;
	}
}

void SceneSynchronizerBase::untrack_variable_changes(ListenerHandle p_handle) {
	// Find the listener

	const ChangesListener *unsafe_handle = ListenerHandle::from_handle(p_handle);
	auto it = VecFunc::find(changes_listeners, unsafe_handle);
	if (it == changes_listeners.end()) {
		// Nothing to do.
		return;
	}

	ChangesListener *listener = *it;

	// Before droplatency this listener, make sure to clear the NodeData.
	for (auto &wv : listener->watching_vars) {
		if (wv.node_data) {
			if (wv.node_data->vars.size() > wv.var_id.id) {
				auto wv_cl_it = VecFunc::find(wv.node_data->vars[wv.var_id.id].changes_listeners, unsafe_handle);
				if (wv_cl_it != wv.node_data->vars[wv.var_id.id].changes_listeners.end()) {
					wv.node_data->vars[wv.var_id.id].changes_listeners.erase(wv_cl_it);
				}
			}
		}
	}

	changes_listeners.erase(it);

	// Now it's time to clear the pointer.
	delete listener;
}

PHandler SceneSynchronizerBase::register_process(ObjectLocalId p_id, ProcessPhase p_phase, std::function<void(float)> p_func) {
	NS_ENSURE_V(p_id != NS::ObjectLocalId::NONE, NS::NullPHandler);
	NS_ENSURE_V(p_func, NS::NullPHandler);

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, NS::NullPHandler);

	const PHandler EFH = od->functions[p_phase].bind(p_func);

	process_functions__clear();

	return EFH;
}

void SceneSynchronizerBase::unregister_process(ObjectLocalId p_id, ProcessPhase p_phase, NS::PHandler p_func_handler) {
	NS_ENSURE(p_id != NS::ObjectLocalId::NONE);

	ObjectData *od = get_object_data(p_id);
	if (od) {
		od->functions[p_phase].unbind(p_func_handler);
		process_functions__clear();
	}
}

ScheduledProcedureId SceneSynchronizerBase::register_scheduled_procedure(
		ObjectLocalId p_id,
		const NS_ScheduledProcedureFunc &p_func) {
	ScheduledProcedureId Id = ScheduledProcedureId::NONE;
	NS_ENSURE_V(p_id != NS::ObjectLocalId::NONE, Id);

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, Id);

	return od->scheduled_procedure_add(p_func);
}

void SceneSynchronizerBase::unregister_scheduled_procedure(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) {
	NS_ENSURE(p_id != NS::ObjectLocalId::NONE);
	NS_ENSURE(p_procedure_id != NS::ScheduledProcedureId::NONE);

	ObjectData *od = get_object_data(p_id);
	if (od) {
		od->scheduled_procedure_remove(p_procedure_id);
	}
}

GlobalFrameIndex SceneSynchronizerBase::scheduled_procedure_start(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id,
		float p_execute_in_seconds) {
	NS_PROFILE

	NS_ENSURE_V_MSG(is_server() || is_no_network(), GlobalFrameIndex{0}, "The procedure can be scheduled only by the server.");

	NS_ENSURE_V(p_id != NS::ObjectLocalId::NONE, GlobalFrameIndex{0});
	NS_ENSURE_V(p_procedure_id != NS::ScheduledProcedureId::NONE, GlobalFrameIndex{0});

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, GlobalFrameIndex{0});
	NS_ENSURE_V(od->scheduled_procedure_exist(p_procedure_id), GlobalFrameIndex{0});

	const GlobalFrameIndex execute_on_frame{ std::max(GlobalFrameIndex::IdType(1), global_frame_index.id + GlobalFrameIndex::IdType(std::round(p_execute_in_seconds * float(get_frames_per_seconds())))) };
	od->scheduled_procedure_fetch_args(p_procedure_id, get_synchronizer_manager(), get_debugger());
	od->scheduled_procedure_start(p_procedure_id, execute_on_frame);

	sync_group_notify_scheduled_procedure_changed(*od, p_procedure_id);

	if (is_server()) {
		// Notify all the peers right away, without waiting for the snapshot.
		std::vector<int> peers;
		static_cast<ServerSynchronizer *>(synchronizer)->sync_group_fetch_object_simulating_peers(*od, peers);

		for (int peer : peers) {
			if (peer != network_interface->get_server_peer()) {
				const PeerNetworkedController *peer_controller = get_controller_for_peer(peer);
				if (peer_controller) {
					rpc_handle_notify_scheduled_procedure_start.rpc(
							get_network_interface(),
							peer,
							od->get_net_id(),
							p_procedure_id,
							execute_on_frame,
							od->scheduled_procedure_get_args(p_procedure_id));
				}
			}
		}
	}

	return execute_on_frame;
}

void SceneSynchronizerBase::scheduled_procedure_stop(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) {
	NS_PROFILE

	NS_ENSURE_MSG(is_server() || is_no_network(), "The procedure can be scheduled only by the server.");

	NS_ENSURE(p_id != NS::ObjectLocalId::NONE);
	NS_ENSURE(p_procedure_id != NS::ScheduledProcedureId::NONE);

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE(od);
	NS_ENSURE(od->scheduled_procedure_exist(p_procedure_id));

	od->scheduled_procedure_stop(p_procedure_id);
	sync_group_notify_scheduled_procedure_changed(*od, p_procedure_id);

	if (is_server()) {
		// Notify all the peers right away, without waiting for the snapshot.
		std::vector<int> peers;
		static_cast<ServerSynchronizer *>(synchronizer)->sync_group_fetch_object_simulating_peers(*od, peers);

		for (int peer : peers) {
			if (peer != network_interface->get_server_peer()) {
				const PeerNetworkedController *peer_controller = get_controller_for_peer(peer);
				if (peer_controller) {
					rpc_handle_notify_scheduled_procedure_stop.rpc(
							get_network_interface(),
							peer,
							od->get_net_id(),
							p_procedure_id);
				}
			}
		}
	}
}

void SceneSynchronizerBase::scheduled_procedure_pause(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) {
	NS_PROFILE

	NS_ENSURE_MSG(is_server() || is_no_network(), "The procedure can be scheduled only by the server.");

	NS_ENSURE(p_id != NS::ObjectLocalId::NONE);
	NS_ENSURE(p_procedure_id != NS::ScheduledProcedureId::NONE);

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE(od);
	NS_ENSURE(od->scheduled_procedure_exist(p_procedure_id));

	od->scheduled_procedure_pause(p_procedure_id, global_frame_index);
	sync_group_notify_scheduled_procedure_changed(*od, p_procedure_id);

	if (is_server()) {
		// Notify all the peers right away, without waiting for the snapshot.
		std::vector<int> peers;
		static_cast<ServerSynchronizer *>(synchronizer)->sync_group_fetch_object_simulating_peers(*od, peers);

		for (int peer : peers) {
			if (peer != network_interface->get_server_peer()) {
				const PeerNetworkedController *peer_controller = get_controller_for_peer(peer);
				if (peer_controller) {
					rpc_handle_notify_scheduled_procedure_pause.rpc(
							get_network_interface(),
							peer,
							od->get_net_id(),
							p_procedure_id,
							global_frame_index);
				}
			}
		}
	}
}

GlobalFrameIndex SceneSynchronizerBase::scheduled_procedure_unpause(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) {
	NS_PROFILE

	NS_ENSURE_V_MSG(is_server() || is_no_network(), GlobalFrameIndex{0}, "The procedure can be scheduled only by the server.");

	NS_ENSURE_V(p_id != NS::ObjectLocalId::NONE, GlobalFrameIndex{0});
	NS_ENSURE_V(p_procedure_id != NS::ScheduledProcedureId::NONE, GlobalFrameIndex{0});

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, GlobalFrameIndex{0});
	NS_ENSURE_V(od->scheduled_procedure_exist(p_procedure_id), GlobalFrameIndex{0});

	NS_ENSURE_V(od->scheduled_procedure_is_paused(p_procedure_id), GlobalFrameIndex{0});
	const std::uint32_t remaining_frames = od->scheduled_procedure_remaining_frames(p_procedure_id, global_frame_index);

	const GlobalFrameIndex execute_on_frame = global_frame_index + remaining_frames;
	od->scheduled_procedure_start(p_procedure_id, global_frame_index + remaining_frames);
	sync_group_notify_scheduled_procedure_changed(*od, p_procedure_id);

	if (is_server()) {
		// Notify all the peers right away, without waiting for the snapshot.
		std::vector<int> peers;
		static_cast<ServerSynchronizer *>(synchronizer)->sync_group_fetch_object_simulating_peers(*od, peers);

		for (int peer : peers) {
			if (peer != network_interface->get_server_peer()) {
				const PeerNetworkedController *peer_controller = get_controller_for_peer(peer);
				if (peer_controller) {
					rpc_handle_notify_scheduled_procedure_start.rpc(
							get_network_interface(),
							peer,
							od->get_net_id(),
							p_procedure_id,
							execute_on_frame,
							od->scheduled_procedure_get_args(p_procedure_id));
				}
			}
		}
	}

	return execute_on_frame;
}


float SceneSynchronizerBase::scheduled_procedure_get_remaining_seconds(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) const {
	NS_PROFILE

	const ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, -1.f);
	NS_ENSURE_V(od->scheduled_procedure_exist(p_procedure_id), -1.f);

	return float(od->scheduled_procedure_remaining_frames(p_procedure_id, global_frame_index)) * fixed_frame_delta;
}

bool SceneSynchronizerBase::scheduled_procedure_is_paused(
		ObjectLocalId p_id,
		ScheduledProcedureId p_procedure_id) const {
	NS_PROFILE

	const ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V(od, true);
	NS_ENSURE_V(od->scheduled_procedure_exist(p_procedure_id), true);

	return od->scheduled_procedure_is_paused(p_procedure_id);
}

void SceneSynchronizerBase::setup_trickled_sync(
		ObjectLocalId p_id,
		std::function<void(DataBuffer & /*out_buffer*/, float /*update_rate*/)> p_func_trickled_collect,
		std::function<void(float /*delta*/, float /*interpolation_alpha*/, DataBuffer & /*past_buffer*/, DataBuffer & /*future_buffer*/)> p_func_trickled_apply) {
	NS_ENSURE(p_id != ObjectLocalId::NONE);

	ObjectData *od = get_object_data(p_id);
	NS_ENSURE(od);

	od->func_trickled_collect = p_func_trickled_collect;
	od->func_trickled_apply = p_func_trickled_apply;
	get_debugger().print(INFO, "Setup trickled sync functions for: `" + od->get_object_name() + "`.", network_interface->get_owner_name());
}

int SceneSynchronizerBase::get_peer_latency_ms(int p_peer) const {
	const PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (pd) {
		return (int)pd->get_latency();
	} else {
		return -1;
	}
}

int SceneSynchronizerBase::get_peer_latency_jitter_ms(int p_peer) const {
	const PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (pd) {
		return (int)pd->get_latency_jitter_ms();
	} else {
		return 0;
	}
}

float SceneSynchronizerBase::get_peer_packet_loss_percentage(int p_peer) const {
	const PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (pd) {
		return pd->get_out_packet_loss_percentage();
	} else {
		return 0.0;
	}
}

SyncGroupId SceneSynchronizerBase::sync_group_create() {
	NS_ENSURE_V_MSG(is_server(), SyncGroupId::NONE, "This function CAN be used only on the server.");
	const SyncGroupId id = static_cast<ServerSynchronizer *>(synchronizer)->sync_group_create();
	synchronizer_manager->on_sync_group_created(id);
	return id;
}

const NS::SyncGroup *SceneSynchronizerBase::sync_group_get(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(is_server(), nullptr, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get(p_group_id);
}

void SceneSynchronizerBase::sync_group_add_object(ObjectLocalId p_id, SyncGroupId p_group_id, bool p_realtime) {
	NS::ObjectData *nd = get_object_data(p_id);
	sync_group_add_object(nd, p_group_id, p_realtime);
}

void SceneSynchronizerBase::sync_group_add_object(ObjectNetId p_id, SyncGroupId p_group_id, bool p_realtime) {
	NS::ObjectData *nd = get_object_data(p_id);
	sync_group_add_object(nd, p_group_id, p_realtime);
}

void SceneSynchronizerBase::sync_group_add_object(NS::ObjectData *p_object_data, SyncGroupId p_group_id, bool p_realtime) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_add_object(p_object_data, p_group_id, p_realtime);
}

void SceneSynchronizerBase::sync_group_remove_object(ObjectLocalId p_id, SyncGroupId p_group_id) {
	ObjectData *nd = get_object_data(p_id);
	sync_group_remove_object(nd, p_group_id);
}

void SceneSynchronizerBase::sync_group_remove_object(ObjectNetId p_id, SyncGroupId p_group_id) {
	NS::ObjectData *nd = get_object_data(p_id);
	sync_group_remove_object(nd, p_group_id);
}

void SceneSynchronizerBase::sync_group_remove_object(ObjectData *p_object_data, SyncGroupId p_group_id) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_remove_object(p_object_data, p_group_id);
}

void SceneSynchronizerBase::sync_group_fetch_object_grups(ObjectLocalId p_id, std::vector<SyncGroupId> &r_simulated_groups, std::vector<SyncGroupId> &r_trickled_groups) const {
	const ObjectData *object_data = get_object_data(p_id);
	sync_group_fetch_object_grups(object_data, r_simulated_groups, r_trickled_groups);
}

void SceneSynchronizerBase::sync_group_fetch_object_grups(ObjectNetId p_id, std::vector<SyncGroupId> &r_simulated_groups, std::vector<SyncGroupId> &r_trickled_groups) const {
	const ObjectData *object_data = get_object_data(p_id);
	sync_group_fetch_object_grups(object_data, r_simulated_groups, r_trickled_groups);
}

void SceneSynchronizerBase::sync_group_fetch_object_grups(const ObjectData *p_object_data, std::vector<SyncGroupId> &r_simulated_groups, std::vector<SyncGroupId> &r_trickled_groups) const {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_fetch_object_grups(p_object_data, r_simulated_groups, r_trickled_groups);
}

void SceneSynchronizerBase::sync_group_set_simulated_partial_update_timespan_seconds(ObjectLocalId p_id, SyncGroupId p_group_id, bool p_partial_update_enabled, float p_update_timespan) {
	ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE_MSG(object_data, "The object data with ID `"+p_id+"` wasn't found.");
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_set_simulated_partial_update_timespan_seconds(*object_data, p_group_id, p_partial_update_enabled, p_update_timespan);
}

bool SceneSynchronizerBase::sync_group_is_simulated_partial_updating(ObjectLocalId p_id, SyncGroupId p_group_id) const {
	const ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE_V_MSG(object_data, false, "The object data with ID `"+p_id+"` wasn't found.");
	NS_ENSURE_V_MSG(is_server(), false, "This function CAN be used only on the server.");
	return static_cast<const ServerSynchronizer *>(synchronizer)->sync_group_is_simulated_partial_updating(*object_data, p_group_id);
}

float SceneSynchronizerBase::sync_group_get_simulated_partial_update_timespan_seconds(ObjectLocalId p_id, SyncGroupId p_group_id) const {
	const ObjectData *object_data = get_object_data(p_id);
	NS_ENSURE_V_MSG(object_data, -1.0f, "The object data with ID `"+p_id+"` wasn't found.");
	NS_ENSURE_V_MSG(is_server(), -1.0f, "This function CAN be used only on the server.");
	return static_cast<const ServerSynchronizer *>(synchronizer)->sync_group_get_simulated_partial_update_timespan_seconds(*object_data, p_group_id);
}

void SceneSynchronizerBase::sync_group_replace_objects(SyncGroupId p_group_id, std::vector<NS::SyncGroup::SimulatedObjectInfo> &&p_new_realtime_nodes, std::vector<NS::SyncGroup::TrickledObjectInfo> &&p_new_trickled_nodes) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_replace_object(p_group_id, std::move(p_new_realtime_nodes), std::move(p_new_trickled_nodes));
}

void SceneSynchronizerBase::sync_group_remove_all_objects(SyncGroupId p_group_id) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_remove_all_objects(p_group_id);
}

void SceneSynchronizerBase::sync_group_move_peer_to(int p_peer_id, SyncGroupId p_group_id) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");

	PeerData *pd = MapFunc::get_or_null(peer_data, p_peer_id);
	NS_ENSURE(pd);
	if (pd->authority_data.sync_group_id == p_group_id) {
		// Nothing to do.
		return;
	}

	pd->authority_data.sync_group_id = p_group_id;

	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_move_peer_to(p_peer_id, p_group_id);
}

SyncGroupId SceneSynchronizerBase::sync_group_get_peer_group(int p_peer_id) const {
	NS_ENSURE_V_MSG(is_server(), SyncGroupId::NONE, "This function CAN be used only on the server.");

	// Update the sync group id
	const NS::PeerData *pd = MapFunc::get_or_null(peer_data, p_peer_id);
	if (pd) {
		return pd->authority_data.sync_group_id;
	}

	return SyncGroupId::NONE;
}

const std::vector<int> *SceneSynchronizerBase::sync_group_get_listening_peers(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(is_server(), nullptr, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get_listening_peers(p_group_id);
}

const std::vector<int> *SceneSynchronizerBase::sync_group_get_simulating_peers(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(is_server(), nullptr, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get_simulating_peers(p_group_id);
}

void SceneSynchronizerBase::sync_group_set_trickled_update_rate(ObjectLocalId p_node_id, SyncGroupId p_group_id, float p_update_rate) {
	NS::ObjectData *od = get_object_data(p_node_id);
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_set_trickled_update_rate(od, p_group_id, p_update_rate);
}

void SceneSynchronizerBase::sync_group_set_trickled_update_rate(ObjectNetId p_node_id, SyncGroupId p_group_id, float p_update_rate) {
	NS::ObjectData *od = get_object_data(p_node_id);
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	static_cast<ServerSynchronizer *>(synchronizer)->sync_group_set_trickled_update_rate(od, p_group_id, p_update_rate);
}

float SceneSynchronizerBase::sync_group_get_trickled_update_rate(ObjectLocalId p_id, SyncGroupId p_group_id) const {
	const NS::ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V_MSG(is_server(), 0.0, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get_trickled_update_rate(od, p_group_id);
}

float SceneSynchronizerBase::sync_group_get_trickled_update_rate(ObjectNetId p_id, SyncGroupId p_group_id) const {
	const ObjectData *od = get_object_data(p_id);
	NS_ENSURE_V_MSG(is_server(), 0.0, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get_trickled_update_rate(od, p_group_id);
}

void SceneSynchronizerBase::sync_group_notify_scheduled_procedure_changed(ObjectData &p_object_data, ScheduledProcedureId p_scheduled_procedure_id) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_notify_scheduled_procedure_changed(p_object_data, p_scheduled_procedure_id);
}

void SceneSynchronizerBase::sync_group_set_user_data(SyncGroupId p_group_id, uint64_t p_user_data) {
	NS_ENSURE_MSG(is_server(), "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_set_user_data(p_group_id, p_user_data);
}

uint64_t SceneSynchronizerBase::sync_group_get_user_data(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(is_server(), 0, "This function CAN be used only on the server.");
	return static_cast<ServerSynchronizer *>(synchronizer)->sync_group_get_user_data(p_group_id);
}

bool SceneSynchronizerBase::is_recovered() const {
	return recover_in_progress;
}

bool SceneSynchronizerBase::is_resetted() const {
	return reset_in_progress;
}

bool SceneSynchronizerBase::is_rewinding() const {
	return rewinding_in_progress;
}

bool SceneSynchronizerBase::is_end_sync() const {
	return end_sync;
}

std::size_t SceneSynchronizerBase::get_client_max_frames_storage_size() const {
	const float netsync_frame_per_seconds = (float)get_frames_per_seconds();
	// NOTE The prediction interval can't be less than 10 frames.
	//      This allows the confirmation timespan to be set to a very low value
	//      without issues.
	return (std::size_t)std::ceil(std::max(get_frame_confirmation_timespan(), (get_fixed_frame_delta() * 10.0f)) * get_max_predicted_intervals() * netsync_frame_per_seconds);
}

void SceneSynchronizerBase::force_state_notify(SyncGroupId p_sync_group_id) {
	NS_ENSURE(is_server());
	ServerSynchronizer *r = static_cast<ServerSynchronizer *>(synchronizer);
	NS_ENSURE_MSG(p_sync_group_id.id < r->sync_groups.size(), "The group id `" + p_sync_group_id + "` doesn't exist.");
	r->sync_groups[p_sync_group_id.id].force_state_notify();
}

void SceneSynchronizerBase::force_state_notify_all() {
	NS_ENSURE(is_server());
	ServerSynchronizer *r = static_cast<ServerSynchronizer *>(synchronizer);

	for (SyncGroup &group : r->sync_groups) {
		group.force_state_notify();
	}
}

void SceneSynchronizerBase::set_enabled(bool p_enable) {
	NS_ENSURE_MSG(synchronizer_type != SYNCHRONIZER_TYPE_SERVER, "The server is always enabled.");
	if (synchronizer_type == SYNCHRONIZER_TYPE_CLIENT) {
		rpc_handler_set_network_enabled.rpc(*network_interface, network_interface->get_server_peer(), p_enable);
		if (p_enable == false) {
			// If the peer want to disable, we can disable it locally
			// immediately. When it wants to enable the networking, the server
			// must be notified so it decides when to start the networking
			// again.
			static_cast<ClientSynchronizer *>(synchronizer)->set_enabled(p_enable);
		}
	} else if (synchronizer_type == SYNCHRONIZER_TYPE_NONETWORK) {
		set_peer_networking_enable(0, p_enable);
	}
}

bool SceneSynchronizerBase::is_enabled() const {
	NS_ENSURE_V_MSG(synchronizer_type != SYNCHRONIZER_TYPE_SERVER, false, "The server is always enabled.");
	if make_likely(synchronizer_type == SYNCHRONIZER_TYPE_CLIENT) {
		return static_cast<ClientSynchronizer *>(synchronizer)->enabled;
	} else if (synchronizer_type == SYNCHRONIZER_TYPE_NONETWORK) {
		return static_cast<NoNetSynchronizer *>(synchronizer)->enabled;
	} else {
		return true;
	}
}

void SceneSynchronizerBase::set_peer_networking_enable(int p_peer, bool p_enable) {
	if (synchronizer_type == SYNCHRONIZER_TYPE_SERVER) {
		NS_ENSURE_MSG(p_peer != 1, "Disable the server is not possible.");

		static_cast<ServerSynchronizer *>(synchronizer)->set_peer_networking_enable(p_peer, p_enable);

		// Just notify the peer status.
		rpc_handler_notify_peer_status.rpc(*network_interface, p_peer, p_enable);
	} else {
		NS_ENSURE_MSG(synchronizer_type == SYNCHRONIZER_TYPE_NONETWORK, "At this point no network is expected.");
		static_cast<NoNetSynchronizer *>(synchronizer)->set_enabled(p_enable);
	}
}

bool SceneSynchronizerBase::is_peer_networking_enabled(int p_peer) const {
	if (synchronizer_type == SYNCHRONIZER_TYPE_SERVER) {
		if (p_peer == 1) {
			// Server is always enabled.
			return true;
		}

		const PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
		if (pd) {
			return pd->authority_data.enabled;
		} else {
			return false;
		}
	} else {
		NS_ENSURE_V_MSG(synchronizer_type == SYNCHRONIZER_TYPE_NONETWORK, false, "At this point no network is expected.");
		return static_cast<NoNetSynchronizer *>(synchronizer)->is_enabled();
	}
}

void SceneSynchronizerBase::on_peer_connected(int p_peer) {
	PeerData npd;
	auto pd_it = MapFunc::insert_if_new(peer_data, p_peer, std::move(npd));
	if (pd_it->second.get_controller()) {
		// Nothing to do, already initialized.
		return;
	}

	pd_it->second.make_controller(*this);
	pd_it->second.get_controller()->setup_synchronizer(p_peer);
	// Clear the process function because they need to be rebuild to include the new peer.
	process_functions__clear();
	reset_controller(*pd_it->second.get_controller());

	event_peer_status_updated.broadcast(p_peer, true, true);

	if (synchronizer) {
		synchronizer->on_peer_connected(p_peer);
	}
}

void SceneSynchronizerBase::on_peer_disconnected(int p_peer) {
	// Emit a signal notifying this peer is gone.
	NS::PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (!pd) {
		return;
	}

	event_peer_status_updated.broadcast(p_peer, false, false);

	peer_data.erase(p_peer);

	// Clear the process function to make sure the peer process functions are removed.
	process_functions__clear();

#ifdef NS_DEBUG_ENABLED
	NS_ASSERT_COND_MSG(peer_data.count(p_peer) <= 0, "The peer was just removed. This can't be triggered.");
#endif

	if (synchronizer) {
		synchronizer->on_peer_disconnected(p_peer);
	}
}

void SceneSynchronizerBase::init_synchronizer(bool p_was_generating_ids) {
	if (!network_interface->is_local_peer_networked()) {
		synchronizer_type = SYNCHRONIZER_TYPE_NONETWORK;
		synchronizer = new NoNetSynchronizer(this);
		generate_id = true;
	} else if (network_interface->is_local_peer_server()) {
		synchronizer_type = SYNCHRONIZER_TYPE_SERVER;
		synchronizer = new ServerSynchronizer(this);
		generate_id = true;
	} else {
		synchronizer_type = SYNCHRONIZER_TYPE_CLIENT;
		synchronizer = new ClientSynchronizer(this);
	}

	global_frame_index = GlobalFrameIndex{ 0 };

	if (p_was_generating_ids != generate_id) {
		objects_data_storage.reserve_net_ids((int)objects_data_storage.get_objects_data().size());
		for (ObjectNetId::IdType i = 0; i < objects_data_storage.get_objects_data().size(); i += 1) {
			ObjectData *od = objects_data_storage.get_objects_data()[i];
			if (!od) {
				continue;
			}

			// Handle the node ID.
			if (generate_id) {
				od->set_net_id(ObjectNetId{ { i } });
			} else {
				od->set_net_id(ObjectNetId::NONE);
			}

			// Refresh the object name.
			// When changing synchronizer mode, it's necessary to refresh the
			// name too because each mode may have its own way of generating or
			// handling the names.
			od->set_object_name(synchronizer_manager->fetch_object_name(od->app_object_handle));
		}
	} else {
		// Always refresh the Objects names.
		for (ObjectNetId::IdType i = 0; i < objects_data_storage.get_objects_data().size(); i += 1) {
			ObjectData *od = objects_data_storage.get_objects_data()[i];
			if (!od) {
				continue;
			}

			// Refresh the object name.
			// When changing synchronizer mode, it's necessary to refresh the
			// name too because each mode may have its own way of generating or
			// handling the names.
			od->set_object_name(synchronizer_manager->fetch_object_name(od->app_object_handle));
		}
	}

	// Notify the presence all available nodes and its variables to the synchronizer.
	for (auto od : objects_data_storage.get_objects_data()) {
		if (!od) {
			continue;
		}

		synchronizer->on_object_data_added(*od);
		for (VarId::IdType y = 0; y < od->vars.size(); y += 1) {
			synchronizer->on_variable_added(od, od->vars[y].var.name);
		}
	}

	// Notify the presence all available peers
	for (auto &peer_it : peer_data) {
		synchronizer->on_peer_connected(peer_it.first);
	}

	// Ensure the self peer is spawned too.
	// This is good to have here because the local peer may have changed.
	on_peer_connected(get_network_interface().get_local_peer_id());

	// Ensure the server peer is also spawned for the client.
	if (is_client()) {
		PeerData *server_peer_data = MapFunc::get_or_null(peer_data, get_network_interface().get_server_peer());
		if (!server_peer_data) {
			on_peer_connected(get_network_interface().get_server_peer());
		}
	}

	// Reset the controllers.
	reset_controllers();

	process_functions__clear();

	// Setup debugger mode.
	{
		std::string debugger_mode;
		if (is_server()) {
			debugger_mode = "server";
			get_debugger().set_log_prefix("server");
		} else if (is_client()) {
			debugger_mode = "client";
			get_debugger().set_log_prefix("peer-" + std::to_string(network_interface->get_local_peer_id()));
		} else if (is_no_network()) {
			debugger_mode = "nonet";
			get_debugger().set_log_prefix("nonet");
		}

		get_debugger().setup_debugger(debugger_mode, network_interface->get_local_peer_id());
	}

	synchronizer_manager->on_init_synchronizer(p_was_generating_ids);
	time_bank = 0.0;
}

void SceneSynchronizerBase::uninit_synchronizer() {
	if (synchronizer_manager) {
		synchronizer_manager->on_uninit_synchronizer();
	}

	generate_id = false;

	if (synchronizer) {
		delete synchronizer;
		synchronizer = nullptr;
		synchronizer_type = SYNCHRONIZER_TYPE_NULL;
	}
}

void SceneSynchronizerBase::reset_synchronizer_mode() {
	const bool was_generating_ids = generate_id;
	uninit_synchronizer();
	init_synchronizer(was_generating_ids);
}

void SceneSynchronizerBase::clear() {
	// Drop the node_data.
	std::vector<ObjectData *> objects_tmp = objects_data_storage.get_objects_data();
	for (auto od : objects_tmp) {
		if (od) {
			drop_object_data(*od);
		}
	}

	// The above loop should have cleaned this array entirely.
	NS_ASSERT_COND(objects_data_storage.is_empty());

	for (auto cl : changes_listeners) {
		delete cl;
	}
	changes_listeners.clear();

	if (synchronizer) {
		synchronizer->clear();
	}

	process_functions__clear();
}

void SceneSynchronizerBase::clear_peers() {
	// Copy, so we can safely remove the peers from `peer_data`.
	std::vector<int> peers_tmp;
	peers_tmp.reserve(peer_data.size());
	for (auto &it : peer_data) {
		peers_tmp.push_back(it.first);
	}

	for (int peer : peers_tmp) {
		on_peer_disconnected(peer);
	}

	NS_ASSERT_COND_MSG(peer_data.empty(), "The above loop should have cleared this peer_data by calling `_on_peer_disconnected` for all the peers.");
}

void SceneSynchronizerBase::reset() {
	clear_peers();
	clear();

	global_frame_index = GlobalFrameIndex{ 0 };

	event_sync_started.clear();
	event_sync_paused.clear();
	event_settings_changed.clear();
	event_peer_status_updated.clear();
	event_state_validated.clear();
	event_sent_snapshot.clear();
	event_snapshot_update_finished.clear();
	event_snapshot_applied.clear();
	event_received_server_snapshot.clear();
	event_rewind_frame_begin.clear();
	event_desync_detected_with_info.clear();

	for (int process_phase = PROCESS_PHASE_EARLY; process_phase < PROCESS_PHASE_COUNT; ++process_phase) {
		cached_process_functions[process_phase].clear();
	}
	cached_process_functions_valid = false;

	uninit_synchronizer();

	recover_in_progress = false;
	reset_in_progress = false;
	rewinding_in_progress = false;
	end_sync = false;

	settings_changed = true;

	rpc_handler_state.reset();
	rpc_handler_notify_need_full_snapshot.reset();
	rpc_handler_set_network_enabled.reset();
	rpc_handler_notify_peer_status.reset();
	rpc_handler_trickled_sync_data.reset();
	rpc_handle_notify_netstats.reset();
	rpc_handle_receive_input.reset();
	network_interface->reset();
}

void SceneSynchronizerBase::rpc_receive_state(DataBuffer &p_snapshot) {
	NS_ENSURE_MSG(is_client(), "Only clients are suposed to receive the server snapshot.");
	static_cast<ClientSynchronizer *>(synchronizer)->receive_snapshot(p_snapshot);
}

void SceneSynchronizerBase::rpc__notify_need_full_snapshot() {
	NS_ENSURE_MSG(is_server(), "Only the server can receive the request to send a full snapshot.");

	const int peer = network_interface->rpc_get_sender();
	static_cast<ServerSynchronizer *>(synchronizer)->notify_need_full_snapshot(peer, false);
}

void SceneSynchronizerBase::rpc_set_network_enabled(bool p_enabled) {
	NS_ENSURE_MSG(is_server(), "The peer status is supposed to be received by the server.");
	set_peer_networking_enable(
			network_interface->rpc_get_sender(),
			p_enabled);
}

void SceneSynchronizerBase::rpc_notify_peer_status(bool p_enabled) {
	NS_ENSURE_MSG(is_client(), "The peer status is supposed to be received by the client.");
	static_cast<ClientSynchronizer *>(synchronizer)->set_enabled(p_enabled);
}

void SceneSynchronizerBase::rpc_trickled_sync_data(const std::vector<std::uint8_t> &p_data) {
	NS_ENSURE_MSG(is_client(), "Only clients are supposed to receive this function call.");
	NS_ENSURE_MSG(p_data.size() > 0, "It's not supposed to receive a 0 size data.");

	static_cast<ClientSynchronizer *>(synchronizer)->receive_trickled_sync_data(p_data);
}

void SceneSynchronizerBase::rpc_notify_netstats(DataBuffer &p_data) {
	NS_ENSURE(is_client());
	p_data.begin_read(get_debugger());

	std::uint8_t compressed_latency;
	p_data.read(compressed_latency);
	NS_ENSURE_MSG(!p_data.is_buffer_failed(), "Failed to read the compressed latency.");

	const float packet_loss = p_data.read_positive_unit_real(DataBuffer::COMPRESSION_LEVEL_0);
	NS_ENSURE_MSG(!p_data.is_buffer_failed(), "Failed to read the packet loss.");

	std::uint8_t compressed_jitter;
	p_data.read(compressed_jitter);
	NS_ENSURE_MSG(!p_data.is_buffer_failed(), "Failed to read compressed jitter.");

	std::uint8_t compressed_input_count;
	p_data.read(compressed_input_count);
	NS_ENSURE_MSG(!p_data.is_buffer_failed(), "Failed to read compressed input count.");

	// 1. Updates the peer network statistics
	const int local_peer = network_interface->get_local_peer_id();
	PeerData *local_peer_data = NS::MapFunc::get_or_null(peer_data, local_peer);
	NS_ENSURE_MSG(local_peer_data, "The local peer was not found. This is a bug. PeerID: " + std::to_string(local_peer))
	local_peer_data->set_compressed_latency(compressed_latency);
	local_peer_data->set_out_packet_loss_percentage(packet_loss);
	local_peer_data->set_latency_jitter_ms(compressed_jitter);

	// 2. Updates the acceleration_fps_speed based on the server input_count and
	//    the network health.
	ClientSynchronizer *client_sync = static_cast<ClientSynchronizer *>(synchronizer);

	// The optimal frame count the server should have according to the network
	// conditions.
	float optimal_frame_distance = 0.0f;

	// The connection averate jittering in frames per seconds.
	const float average_jittering_in_FPS = local_peer_data->get_latency_jitter_ms() / (fixed_frame_delta * 1000.0f);

	// This is useful to offset the `optimal_frame_distance` by the time needed
	// for the frames to arrive IN TIME in case the connection is bad.
	optimal_frame_distance += average_jittering_in_FPS;

	// Increase the optima frame distance depending on the packet loss.
	if (local_peer_data->get_out_packet_loss_percentage() > get_negligible_packet_loss()) {
		const float relative_packet_loss = std::min(local_peer_data->get_out_packet_loss_percentage() / get_worst_packet_loss(), 1.0f);
		optimal_frame_distance += MathFunc::lerp(0.0f, float(get_max_server_input_buffer_size()), relative_packet_loss);
	}

	// Round the frame distance.
	optimal_frame_distance = std::ceil(optimal_frame_distance - 0.05f);

	// Clamp it.
	optimal_frame_distance = std::clamp(optimal_frame_distance, float(get_min_server_input_buffer_size()), float(get_max_server_input_buffer_size()));

	// Can be negative. This function contains the amount of frames to offset
	// the client to make sure it catches the server.
	float additional_frames_to_produce = optimal_frame_distance - float(compressed_input_count);

	// Slowdown the acceleration when near the target.
	const float max_frames_to_produce_per_frame = get_max_fps_acceleration_percentage() * float(get_frames_per_seconds());
	client_sync->acceleration_fps_speed = std::clamp(additional_frames_to_produce / max_frames_to_produce_per_frame, -1.0f, 1.0f) * max_frames_to_produce_per_frame;
	const float acceleration_fps_speed_ABS = std::abs(client_sync->acceleration_fps_speed);

	if (acceleration_fps_speed_ABS >= std::numeric_limits<float>::epsilon()) {
		const float acceleration_time = std::abs(additional_frames_to_produce) / acceleration_fps_speed_ABS;
		client_sync->acceleration_fps_timer = acceleration_time;
	} else {
		client_sync->acceleration_fps_timer = 0.0;
	}

#ifdef NS_DEBUG_ENABLED
	if (debug_server_speedup) {
		get_debugger().print(
				INFO,
				std::string() +
				"Client network statistics" +
				"\n  Latency (ms): `" + std::to_string(local_peer_data->get_latency()) + "`" +
				"\n  Packet Loss (%): `" + std::to_string(local_peer_data->get_out_packet_loss_percentage()) + "`" +
				"\n  Average jitter (ms): `" + std::to_string(local_peer_data->get_latency_jitter_ms()) + "`" +
				"\n  Optimal frame count on server: `" + std::to_string(optimal_frame_distance) + "`" +
				"\n  Frame count on server: `" + std::to_string(compressed_input_count) + "`" +
				"\n  Acceleration fps: `" + std::to_string(client_sync->acceleration_fps_speed) + "`" +
				"\n  Acceleration time: `" + std::to_string(client_sync->acceleration_fps_timer) + "`",
				get_network_interface().get_owner_name(),
				true);
	}
#endif
}

void SceneSynchronizerBase::rpc_notify_scheduled_procedure_start(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id, GlobalFrameIndex p_frame_index, const DataBuffer &p_args) {
	ObjectData *od = get_object_data(p_object_id, false);
	NS_ENSURE_MSG(od, "The scheduled event receival failed because the ObjectData for NetId(`"+std::to_string(p_object_id.id)+"`) was not found.");
	NS_ENSURE(od->scheduled_procedure_exist(p_scheduled_procedure_id));

	od->scheduled_procedure_set_args(p_scheduled_procedure_id, p_args);
	od->scheduled_procedure_start(p_scheduled_procedure_id, p_frame_index);
	od->scheduled_procedure_execute(p_scheduled_procedure_id, ScheduledProcedurePhase::RECEIVED, get_synchronizer_manager(), get_debugger());
}

void SceneSynchronizerBase::rpc_notify_scheduled_procedure_stop(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id) {
	ObjectData *od = get_object_data(p_object_id, false);
	NS_ENSURE_MSG(od, "The scheduled event stopping failed because the ObjectData for NetId(`"+std::to_string(p_object_id.id)+"`) was not found.");
	NS_ENSURE(od->scheduled_procedure_exist(p_scheduled_procedure_id));

	od->scheduled_procedure_stop(p_scheduled_procedure_id);
}

void SceneSynchronizerBase::rpc_notify_scheduled_procedure_pause(ObjectNetId p_object_id, ScheduledProcedureId p_scheduled_procedure_id, GlobalFrameIndex p_pause_frame) {
	ObjectData *od = get_object_data(p_object_id, false);
	NS_ENSURE_MSG(od, "The scheduled event pausing failed because the ObjectData for NetId(`"+std::to_string(p_object_id.id)+"`) was not found.");
	NS_ENSURE(od->scheduled_procedure_exist(p_scheduled_procedure_id));

	od->scheduled_procedure_pause(p_scheduled_procedure_id, p_pause_frame);
}

void SceneSynchronizerBase::call_rpc_receive_inputs(int p_recipient, int p_peer, const std::vector<std::uint8_t> &p_data) {
	rpc_handle_receive_input.rpc(
			get_network_interface(),
			p_recipient,
			p_peer,
			p_data);
}

void SceneSynchronizerBase::rpc_receive_inputs(int p_peer, const std::vector<std::uint8_t> &p_data) {
	PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	NS_ENSURE_MSG(pd, "The PeerData was not found during `rpc_receive_inputs` for peer " + std::to_string(p_peer));
	NS_ENSURE_MSG(pd->get_controller(), "The PeerData doesn't have an associated controller and `rpc_receive_inputs` failed for peer " + std::to_string(p_peer));
	pd->get_controller()->notify_receive_inputs(p_data);
}


void SceneSynchronizerBase::detect_and_signal_changed_variables(int p_flags) {
	const std::vector<ObjectData *> &active_objects = synchronizer->get_active_objects();

#ifdef NS_PROFILING_ENABLED
	const std::string info = "objects count: " + std::to_string(active_objects.size());
	NS_PROFILE_WITH_INFO(info);
#endif

	// Pull the changes.
	if (event_flag != p_flags) {
		// The flag was not set yet.
		change_events_begin(p_flags);
	}

	for (auto od : active_objects) {
		if (od) {
			pull_object_changes(*od);
		}
	}
	change_events_flush();
}

void SceneSynchronizerBase::change_events_begin(int p_flag) {
	NS_PROFILE

#ifdef NS_DEBUG_ENABLED
	// This can't happen because at the end these are reset.
	NS_ASSERT_COND(!recover_in_progress);
	NS_ASSERT_COND(!reset_in_progress);
	NS_ASSERT_COND(!rewinding_in_progress);
	NS_ASSERT_COND(!end_sync);
#endif
	event_flag = p_flag;
	recover_in_progress = NetEventFlag::SYNC & p_flag;
	reset_in_progress = NetEventFlag::SYNC_RESET & p_flag;
	rewinding_in_progress = NetEventFlag::SYNC_REWIND & p_flag;
	end_sync = NetEventFlag::END_SYNC & p_flag;
}

void SceneSynchronizerBase::change_event_add(NS::ObjectData *p_object_data, VarId p_var_id, const VarData &p_old) {
	NS_PROFILE

	for (int i = 0; i < int(p_object_data->vars[p_var_id.id].changes_listeners.size()); i += 1) {
		ChangesListener *listener = p_object_data->vars[p_var_id.id].changes_listeners[i];
		// This can't be `nullptr` because when the changes listener is dropped
		// all the pointers are cleared.
		NS_ASSERT_COND(listener);

		if ((listener->flag & event_flag) == 0) {
			// Not listening to this event.
			continue;
		}

		listener->emitted = false;

		int v = 0;
		for (auto wv : listener->watching_vars) {
			if (wv.var_id == p_var_id) {
				wv.old_set = true;
				listener->old_values[v].copy(p_old);
			}
			v += 1;
		}
	}

	// Notify the synchronizer.
	if (synchronizer) {
		synchronizer->on_variable_changed(
				p_object_data,
				p_var_id,
				p_old,
				event_flag);
	}
}

void SceneSynchronizerBase::change_events_flush() {
	NS_PROFILE

	for (uint32_t listener_i = 0; listener_i < changes_listeners.size(); listener_i += 1) {
		ChangesListener &listener = *changes_listeners[listener_i];
		if (listener.emitted) {
			// Nothing to do.
			continue;
		}
		listener.emitted = true;

		for (uint32_t v = 0; v < listener.watching_vars.size(); v += 1) {
			if (!listener.watching_vars[v].old_set) {
				// Old is not set, so set the current valud.
				listener.old_values[v].copy(
						listener.watching_vars[v].node_data->vars[listener.watching_vars[v].var_id.id].var.value);
			}
			// Reset this to false.
			listener.watching_vars[v].old_set = false;
		}

		listener.listener_func(listener.old_values);
	}

	recover_in_progress = false;
	reset_in_progress = false;
	rewinding_in_progress = false;
	end_sync = false;
}

const std::vector<SimulatedObjectInfo> *SceneSynchronizerBase::client_get_simulated_objects() const {
	NS_ENSURE_V_MSG(is_client(), nullptr, "This function CAN be used only on the client.");
	return &(static_cast<ClientSynchronizer *>(synchronizer)->simulated_objects);
}

bool SceneSynchronizerBase::client_is_simulated_object(ObjectLocalId p_id) const {
	NS_ENSURE_V_MSG(is_client(), false, "This function CAN be used only on the client.");
	const ObjectData *od = get_object_data(p_id, true);
	NS_ENSURE_V(od, false);
	return od->realtime_sync_enabled_on_client;
}

void SceneSynchronizerBase::drop_object_data(NS::ObjectData &p_object_data) {
	synchronizer_manager->on_drop_object_data(p_object_data);

	if (synchronizer) {
		synchronizer->on_object_data_removed(p_object_data);
	}

	// Remove the object from the controller.
	{
		PeerData *prev_peer_controller_peer_data = NS::MapFunc::get_or_null(peer_data, p_object_data.get_controlled_by_peer());
		if (prev_peer_controller_peer_data) {
			if (prev_peer_controller_peer_data->get_controller()) {
				prev_peer_controller_peer_data->get_controller()->notify_controllable_objects_changed();
			}
		}
	}

	// Remove this `ObjectData` from any event listener.
	for (auto &cl : changes_listeners) {
		for (auto &wv : cl->watching_vars) {
			if (wv.node_data == &p_object_data) {
				// We can't remove this entirely, otherwise we change the array length.
				wv.node_data = nullptr;
				wv.var_id = VarId::NONE;
			}
		}
	}

	if (p_object_data.has_registered_process_functions()) {
		process_functions__clear();
	}

	objects_data_storage.deallocate_object_data(p_object_data);
}

void SceneSynchronizerBase::notify_object_data_net_id_changed(ObjectData &p_object_data) {
	if (p_object_data.has_registered_process_functions()) {
		process_functions__clear();
	}
	get_debugger().print(INFO, "ObjectNetId: " + p_object_data.get_net_id() + " just assigned to: " + p_object_data.get_object_name(), network_interface->get_owner_name());
}

FrameIndex SceneSynchronizerBase::client_get_last_checked_frame_index() const {
	NS_ENSURE_V_MSG(is_client(), FrameIndex::NONE, "This function can be called only on client scene synchronizer.");
	return static_cast<ClientSynchronizer *>(synchronizer)->last_checked_input;
}

int SceneSynchronizerBase::fetch_sub_processes_count(float p_delta) {
	time_bank += p_delta;
	const float sub_frames = std::floor(time_bank * static_cast<float>(get_frames_per_seconds()));
	time_bank -= sub_frames / static_cast<float>(get_frames_per_seconds());
	// Clamp the maximum possible frames that we can process on a single frame.
	// This is a guard to make sure we do not process way too many frames on a single frame.
	return std::min(static_cast<int>(get_max_sub_process_per_frame()), static_cast<int>(sub_frames));
}

bool SceneSynchronizerBase::is_server() const {
	return synchronizer_type == SYNCHRONIZER_TYPE_SERVER;
}

bool SceneSynchronizerBase::is_client() const {
	return synchronizer_type == SYNCHRONIZER_TYPE_CLIENT;
}

bool SceneSynchronizerBase::is_no_network() const {
	return synchronizer_type == SYNCHRONIZER_TYPE_NONETWORK;
}

bool SceneSynchronizerBase::is_networked() const {
	return is_client() || is_server();
}

void SceneSynchronizerBase::try_fetch_unnamed_objects_data_names() {
	// Copy the unnamed objects, so it's safe to remove stuff from the original
	// array as we go.
	const std::vector<ObjectData *> unnamed_objects = objects_data_storage.get_unnamed_objects_data();
	for (ObjectData *OD : unnamed_objects) {
		OD->set_object_name(synchronizer_manager->fetch_object_name(OD->app_object_handle));
		if (!OD->get_object_name().empty()) {
			// Mark this as changed to ensure the clients are eventually notified.
			synchronizer->on_object_data_name_known(*OD);
		}
	}
}

void SceneSynchronizerBase::update_objects_relevancy() {
	synchronizer_manager->update_objects_relevancy();

	if (debug_log_nodes_relevancy_update) {
		static_cast<ServerSynchronizer *>(synchronizer)->sync_group_debug_print();
	}
}

void SceneSynchronizerBase::process_functions__clear() {
	cached_process_functions_valid = false;
}

void SceneSynchronizerBase::process_functions__execute() {
	const std::string delta_info = "delta: " + std::to_string(get_fixed_frame_delta());
	NS_PROFILE_WITH_INFO(delta_info);

	if (cached_process_functions_valid == false) {
		// Clear all the process_functions.
		for (int process_phase = PROCESS_PHASE_EARLY; process_phase < PROCESS_PHASE_COUNT; ++process_phase) {
			cached_process_functions[process_phase].clear();
		}

		// Add a new process function for each peer
		{
			// Fetch the connected peers and sort them
			std::vector<int> peers;
			for (const auto [peer, _] : peer_data) {
				peers.push_back(peer);
			}
			std::sort(peers.begin(), peers.end());

			// For each peer, add the process function.
			for (int peer : peers) {
				PeerNetworkedController *peer_controller = get_controller_for_peer(peer, false);
				if (peer_controller) {
					cached_process_functions[PROCESS_PHASE_PROCESS].bind(std::bind(&PeerNetworkedController::process, peer_controller, std::placeholders::_1));
				}
			}
		}

		// Build the cached_process_functions, making sure the node data order is kept.
		for (auto od : objects_data_storage.get_sorted_objects_data()) {
			if (od == nullptr || (is_client() && od->realtime_sync_enabled_on_client == false)) {
				// Nothing to process
				continue;
			}

			// For each valid NodeData.
			for (int process_phase = PROCESS_PHASE_EARLY; process_phase < PROCESS_PHASE_COUNT; ++process_phase) {
				// Append the contained functions.
				cached_process_functions[process_phase].append(od->functions[process_phase]);
			}
		}

		cached_process_functions_valid = true;
	}

	if make_unlikely(global_frame_index==GlobalFrameIndex::NONE) {
		// Reset the frame index before overflow.
		// Notice that at 60Hz this is triggered after 2 years of never ever
		// resetting the server, so it's very unlikely.
		global_frame_index.id = 0;
	} else {
		global_frame_index.id++;
	}

	process_functions__execute_scheduled_procedure();

	get_debugger().print(VERBOSE, "Process functions START");
	// Pre process phase
	for (int process_phase = PROCESS_PHASE_EARLY; process_phase < PROCESS_PHASE_COUNT; ++process_phase) {
		const std::string phase_info = "process phase: " + std::to_string(process_phase);
		NS_PROFILE_WITH_INFO(phase_info);
		cached_process_functions[process_phase].broadcast(get_fixed_frame_delta());
	}
}

void SceneSynchronizerBase::process_functions__execute_scheduled_procedure() {
	// NOTE this function is executed inside the process phase but after all
	//      controllers have been executed. check the `process_functions_execute`.

	// Duplicates the procedurs array so we can safely stop the executed one
	// this is important because the array into the objects_data_storage is modified.
	const std::vector<ScheduledProcedureHandle> procedures = objects_data_storage.get_sorted_active_scheduled_procedures();

	for (ScheduledProcedureHandle handle : procedures) {
		ObjectData *od = get_object_data(handle.get_object_net_id());
		if (od) {
#ifdef NS_DEBUG_ENABLED
			// This can't be triggered because the procedure is never added into the storage if doesn't exist.
			NS_ASSERT_COND(od->scheduled_procedure_exist(handle.get_scheduled_procedure_id()));
#endif

			const std::uint32_t remaining_frames = od->scheduled_procedure_remaining_frames(handle.get_scheduled_procedure_id(), global_frame_index);
			if (remaining_frames == 0) {
				// First stop the procedure
				od->scheduled_procedure_stop(handle.get_scheduled_procedure_id());
				if (is_server()) {
					sync_group_notify_scheduled_procedure_changed(*od, handle.get_scheduled_procedure_id());
				}

				// then execute it, so eventually the procedure can be enabled again within the function call.
				od->scheduled_procedure_execute(
						handle.get_scheduled_procedure_id(),
						ScheduledProcedurePhase::EXECUTING,
						get_synchronizer_manager(),
						get_debugger());
			}
		}
	}
}

ObjectLocalId SceneSynchronizerBase::find_object_local_id(ObjectHandle p_app_object) const {
	return objects_data_storage.find_object_local_id(p_app_object);
}

ObjectData *SceneSynchronizerBase::get_object_data(ObjectLocalId p_id, bool p_expected) {
	return objects_data_storage.get_object_data(p_id, p_expected);
}

const NS::ObjectData *SceneSynchronizerBase::get_object_data(ObjectLocalId p_id, bool p_expected) const {
	return objects_data_storage.get_object_data(p_id, p_expected);
}

ObjectData *SceneSynchronizerBase::get_object_data(ObjectNetId p_id, bool p_expected) {
	return objects_data_storage.get_object_data(p_id, p_expected);
}

const ObjectData *SceneSynchronizerBase::get_object_data(ObjectNetId p_id, bool p_expected) const {
	return objects_data_storage.get_object_data(p_id, p_expected);
}

PeerNetworkedController *SceneSynchronizerBase::get_local_authority_controller(bool p_expected) {
	return get_controller_for_peer(get_network_interface().get_local_peer_id(), p_expected);
}

const PeerNetworkedController *SceneSynchronizerBase::get_local_authority_controller(bool p_expected) const {
	return get_controller_for_peer(get_network_interface().get_local_peer_id(), p_expected);
}

PeerNetworkedController *SceneSynchronizerBase::get_controller_for_peer(int p_peer, bool p_expected) {
	PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (p_expected) {
		NS_ENSURE_V_MSG(pd, nullptr, "The peer is unknown `" + std::to_string(p_peer) + "`.");
		return pd->get_controller();
	} else {
		if (pd) {
			return pd->get_controller();
		} else {
			return nullptr;
		}
	}
}

const PeerNetworkedController *SceneSynchronizerBase::get_controller_for_peer(int p_peer, bool p_expected) const {
	const NS::PeerData *pd = MapFunc::get_or_null(peer_data, p_peer);
	if (p_expected) {
		NS_ENSURE_V_MSG(pd, nullptr, "The peer is unknown `" + std::to_string(p_peer) + "`.");
		return pd->get_controller();
	} else {
		if (pd) {
			return pd->get_controller();
		} else {
			return nullptr;
		}
	}
}

const std::map<int, NS::PeerData> &SceneSynchronizerBase::get_peers() const {
	return peer_data;
}

std::map<int, NS::PeerData> &SceneSynchronizerBase::get_peers() {
	return peer_data;
}

NS::PeerData *SceneSynchronizerBase::get_peer_data_for_controller(const PeerNetworkedController &p_controller, bool p_expected) {
	NS::PeerData *pd = MapFunc::get_or_null(peer_data, p_controller.get_authority_peer());
	if (p_expected) {
		NS_ENSURE_V_MSG(pd, nullptr, "The controller was not associated to a peer.");
	}
	return pd;
}

const NS::PeerData *SceneSynchronizerBase::get_peer_data_for_controller(const PeerNetworkedController &p_controller, bool p_expected) const {
	const NS::PeerData *pd = MapFunc::get_or_null(peer_data, p_controller.get_authority_peer());
	if (p_expected) {
		NS_ENSURE_V_MSG(pd, nullptr, "The controller was not associated to a peer.");
	}
	return pd;
}

ObjectNetId SceneSynchronizerBase::get_biggest_object_id() const {
	return objects_data_storage.get_sorted_objects_data().size() == 0 ? ObjectNetId::NONE : ObjectNetId{ { ObjectNetId::IdType(objects_data_storage.get_sorted_objects_data().size() - 1) } };
}

void SceneSynchronizerBase::reset_controllers() {
	for (auto &pd : peer_data) {
		if (pd.second.get_controller()) {
			reset_controller(*pd.second.get_controller());
		}
	}
}

void SceneSynchronizerBase::reset_controller(PeerNetworkedController &p_controller) {
	// Reset the controller type.
	if (p_controller.controller != nullptr) {
		delete p_controller.controller;
		p_controller.controller = nullptr;
		p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_NULL;
	}

	if (!synchronizer_manager) {
		if (synchronizer) {
			synchronizer->on_controller_reset(p_controller);
		}

		// Nothing to do.
		return;
	}

	if (!network_interface->is_local_peer_networked()) {
		p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_NONETWORK;
		p_controller.controller = new NoNetController(&p_controller);
	} else if (network_interface->is_local_peer_server()) {
		if (p_controller.get_authority_peer() == get_network_interface().get_server_peer()) {
			// This is the server controller that is used to control the BOTs / NPCs.
			p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_AUTONOMOUS_SERVER;
			p_controller.controller = new AutonomousServerController(&p_controller);
		} else {
			p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_SERVER;
			p_controller.controller = new ServerController(&p_controller);
		}
	} else if (get_network_interface().get_local_peer_id() == p_controller.get_authority_peer()) {
		p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_PLAYER;
		p_controller.controller = new PlayerController(&p_controller);
	} else {
		p_controller.controller_type = PeerNetworkedController::CONTROLLER_TYPE_DOLL;
		p_controller.controller = new DollController(&p_controller);
	}

	p_controller.controller->ready();
	p_controller.notify_controller_reset();

	if (synchronizer) {
		synchronizer->on_controller_reset(p_controller);
	}
}

void SceneSynchronizerBase::pull_object_changes(NS::ObjectData &p_object_data) {
	NS_PROFILE

	for (VarDescriptor &var_desc : p_object_data.vars) {
		if (var_desc.enabled == false) {
			continue;
		}

		VarData new_val;
		{
			NS_PROFILE_NAMED("get_variable")
			var_desc.get_func(
					*synchronizer_manager,
					p_object_data.app_object_handle,
					var_desc.var.name.c_str(),
					new_val);
		}

		if (!SceneSynchronizerBase::var_data_compare(var_desc.var.value, new_val)) {
			change_event_add(
					&p_object_data,
					var_desc.id,
					var_desc.var.value);
			var_desc.var.value = std::move(new_val);
		}
	}
}

Synchronizer::Synchronizer(SceneSynchronizerBase *p_node) :
	scene_synchronizer(p_node) {
}

NoNetSynchronizer::NoNetSynchronizer(SceneSynchronizerBase *p_node) :
	Synchronizer(p_node) {
}

void NoNetSynchronizer::clear() {
	enabled = true;
	frame_count = 0;
}

void NoNetSynchronizer::process(float p_delta) {
	if make_unlikely(enabled == false) {
		return;
	}

	const int sub_process_count = scene_synchronizer->fetch_sub_processes_count(p_delta);
	for (int i = 0; i < sub_process_count; i++) {
		scene_synchronizer->get_debugger().print(VERBOSE, "NoNetSynchronizer::process", scene_synchronizer->get_network_interface().get_owner_name());

		const uint32_t frame_index = frame_count;
		frame_count += 1;

		scene_synchronizer->get_debugger().scene_sync_process_start(*scene_synchronizer);

		// Process the scene.
		scene_synchronizer->process_functions__execute();
		scene_synchronizer->detect_and_signal_changed_variables(NetEventFlag::CHANGE);

		scene_synchronizer->get_debugger().scene_sync_process_end(*scene_synchronizer);
		scene_synchronizer->get_debugger().write_dump(0, frame_index);
		scene_synchronizer->get_debugger().start_new_frame();
	}
}

void NoNetSynchronizer::on_object_data_added(NS::ObjectData &p_object_data) {
	NS::VecFunc::insert_unique(active_objects, &p_object_data);
}

void NoNetSynchronizer::on_object_data_removed(NS::ObjectData &p_object_data) {
	NS::VecFunc::remove_unordered(active_objects, &p_object_data);
}

void NoNetSynchronizer::set_enabled(bool p_enabled) {
	if (enabled == p_enabled) {
		// Nothing to do.
		return;
	}

	enabled = p_enabled;

	if (enabled) {
		scene_synchronizer->event_sync_started.broadcast();
	} else {
		scene_synchronizer->event_sync_paused.broadcast();
	}
}

bool NoNetSynchronizer::is_enabled() const {
	return enabled;
}

ServerSynchronizer::ServerSynchronizer(SceneSynchronizerBase *p_node) :
	Synchronizer(p_node) {
	NS_ASSERT_COND(NS::SyncGroupId::GLOBAL == sync_group_create());
}

void ServerSynchronizer::clear() {
	objects_relevancy_update_timer = 0.0;
	// Release the internal memory.
	sync_groups.clear();
}

void ServerSynchronizer::process(float p_delta) {
	scene_synchronizer->get_debugger().print(VERBOSE, "ServerSynchronizer::process", scene_synchronizer->get_network_interface().get_owner_name());

	if (objects_relevancy_update_timer >= scene_synchronizer->objects_relevancy_update_time) {
		scene_synchronizer->update_objects_relevancy();
		objects_relevancy_update_timer = 0.0;
	} else {
		objects_relevancy_update_timer += p_delta;
	}

	const int sub_process_count = scene_synchronizer->fetch_sub_processes_count(p_delta);
	for (int i = 0; i < sub_process_count; i++) {
		epoch += 1;

		scene_synchronizer->get_debugger().scene_sync_process_start(*scene_synchronizer);

		// Process the scene
		scene_synchronizer->process_functions__execute();
		scene_synchronizer->detect_and_signal_changed_variables(NetEventFlag::CHANGE);

		process_snapshot_notificator();

		scene_synchronizer->get_debugger().scene_sync_process_end(*scene_synchronizer);

#if NS_DEBUG_ENABLED
		// Write the debug dump for each peer.
		for (auto &peer_it : scene_synchronizer->peer_data) {
			if make_unlikely(!peer_it.second.get_controller()) {
				continue;
			}

			const FrameIndex current_input_id = peer_it.second.get_controller()->get_server_controller()->get_current_frame_index();
			scene_synchronizer->get_debugger().write_dump(peer_it.first, current_input_id.id);
		}
		scene_synchronizer->get_debugger().start_new_frame();
#endif
	}

	process_trickled_sync(p_delta);
	update_peers_net_statistics(p_delta);
}

void ServerSynchronizer::on_peer_connected(int p_peer_id) {
	MapFunc::assign(peers_data, p_peer_id, PeerServerData());
	sync_group_move_peer_to(p_peer_id, SyncGroupId::GLOBAL);
}

void ServerSynchronizer::on_peer_disconnected(int p_peer_id) {
	peers_data.erase(p_peer_id);
	for (NS::SyncGroup &group : sync_groups) {
		group.remove_listening_peer(p_peer_id);
	}
}

void ServerSynchronizer::on_object_data_added(NS::ObjectData &p_object_data) {
#ifdef NS_DEBUG_ENABLED
	// Can't happen on server
	NS_ASSERT_COND(!scene_synchronizer->is_recovered());
	// On server the ID is always known.
	NS_ASSERT_COND(p_object_data.get_net_id() != ObjectNetId::NONE);
#endif

	VecFunc::insert_unique(active_objects, &p_object_data);

	sync_groups[SyncGroupId::GLOBAL.id].add_new_sync_object(&p_object_data, true);
}

void ServerSynchronizer::on_object_data_removed(ObjectData &p_object_data) {
	VecFunc::remove_unordered(active_objects, &p_object_data);

	// Make sure to remove this `ObjectData` from any sync group.
	for (SyncGroup &group : sync_groups) {
		group.remove_sync_object(p_object_data);
	}
}

void ServerSynchronizer::on_object_data_name_known(ObjectData &p_object_data) {
#ifdef NS_DEBUG_ENABLED
	// On server the ID is always known.
	NS_ASSERT_COND(p_object_data.get_net_id() != ObjectNetId::NONE);
#endif

	for (SyncGroup &group : sync_groups) {
		group.notify_sync_object_name_is_known(p_object_data);
	}
}

void ServerSynchronizer::on_object_data_controller_changed(ObjectData &p_object_data, int p_previous_controlling_peer) {
	if (p_object_data.get_controlled_by_peer() == p_previous_controlling_peer) {
		return;
	}

	if (p_object_data.get_controlled_by_peer() > 0) {
		// NOTE 1: Notify the peer ASAP about the new controlling object.
		// NOTE 2: The simulation list on the client is always updated by the server
		//         because the server has the info in which group the object is
		//         and for the client is impossible to infer that information.
		notify_need_snapshot_asap(p_object_data.get_controlled_by_peer());
	}

	for (SyncGroup &sync_group : sync_groups) {
		sync_group.notify_controller_changed(p_object_data, p_previous_controlling_peer);
	}
}

void ServerSynchronizer::on_variable_added(ObjectData *p_object_data, const std::string &p_var_name) {
#ifdef NS_DEBUG_ENABLED
	// Can't happen on server
	NS_ASSERT_COND(!scene_synchronizer->is_recovered());
	// On server the ID is always known.
	NS_ASSERT_COND(p_object_data->get_net_id() != ObjectNetId::NONE);
#endif

	const VarId var_id = p_object_data->find_variable_id(p_var_name);
	NS_ASSERT_COND_MSG(var_id != VarId::NONE, "The variable doesn't exist: " + p_var_name);

	for (SyncGroup &group : sync_groups) {
		group.notify_new_variable(p_object_data, var_id);
	}
}

void ServerSynchronizer::on_variable_changed(NS::ObjectData *p_object_data, VarId p_var_id, const VarData &p_old_value, int p_flag) {
#ifdef NS_DEBUG_ENABLED
	// Can't happen on server
	NS_ASSERT_COND(!scene_synchronizer->is_recovered());
	// On server the ID is always known.
	NS_ASSERT_COND(p_object_data->get_net_id() != ObjectNetId::NONE);
#endif

	for (SyncGroup &group : sync_groups) {
		group.notify_variable_changed(p_object_data, p_var_id);
	}
}

void ServerSynchronizer::notify_need_snapshot_asap(int p_peer) {
	PeerServerData *psd = MapFunc::get_or_null(peers_data, p_peer);
	NS_ENSURE(psd);
	psd->force_notify_snapshot = true;
}

void ServerSynchronizer::notify_need_full_snapshot(int p_peer, bool p_notify_ASAP) {
	PeerServerData *psd = MapFunc::get_or_null(peers_data, p_peer);
	NS_ENSURE(psd);
	psd->need_full_snapshot = true;
	if (p_notify_ASAP) {
		psd->force_notify_snapshot = true;
	}
}

SyncGroupId ServerSynchronizer::sync_group_create() {
	SyncGroupId id;
	id.id = (SyncGroupId::IdType)sync_groups.size();
	sync_groups.resize(id.id + 1);
	sync_groups[id.id].group_id = id;
	sync_groups[id.id].scene_sync = scene_synchronizer;
	return id;
}

const SyncGroup *ServerSynchronizer::sync_group_get(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), nullptr, "The group id `" + p_group_id + "` doesn't exist.");
	return &sync_groups[p_group_id.id];
}

void ServerSynchronizer::sync_group_add_object(ObjectData *p_object_data, SyncGroupId p_group_id, bool p_realtime) {
	NS_ENSURE(p_object_data);
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + p_group_id + "` doesn't exist.");
	NS_ENSURE_MSG(p_group_id != SyncGroupId::GLOBAL, "You can't change this SyncGroup in any way. Create a new one.");
	sync_groups[p_group_id.id].add_new_sync_object(p_object_data, p_realtime);
}

void ServerSynchronizer::sync_group_remove_object(ObjectData *p_object_data, SyncGroupId p_group_id) {
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + (p_group_id) + "` doesn't exist.");
	NS_ENSURE(p_object_data);
	NS_ENSURE_MSG(p_group_id != SyncGroupId::GLOBAL, "You can't change this SyncGroup in any way. Create a new one.");
	sync_groups[p_group_id.id].remove_sync_object(*p_object_data);
}

void ServerSynchronizer::sync_group_fetch_object_grups(const ObjectData *p_object_data, std::vector<SyncGroupId> &r_simulated_groups, std::vector<SyncGroupId> &r_trickled_groups) const {
	NS_ENSURE(p_object_data);

	r_simulated_groups.clear();
	r_trickled_groups.clear();

	SyncGroupId id = SyncGroupId{ { 0 } };
	for (const SyncGroup &group : sync_groups) {
		if (group.has_simulated(*p_object_data)) {
			r_simulated_groups.push_back(id);
		}

		if (group.has_trickled(*p_object_data)) {
			r_trickled_groups.push_back(id);
		}

		id += 1;
	}
}

void ServerSynchronizer::sync_group_fetch_object_simulating_peers(const ObjectData &p_object_data, std::vector<int> &r_simulating_peers) const {
	r_simulating_peers.clear();

	for (const SyncGroup &group : sync_groups) {
		if (group.has_simulated(p_object_data)) {
			if (r_simulating_peers.size() == 0) {
				r_simulating_peers = group.get_simulating_peers();
			} else {
				for (int peer : group.get_simulating_peers()) {
					VecFunc::insert_unique(r_simulating_peers, peer);
				}
			}
		}
	}
}

void ServerSynchronizer::sync_group_set_simulated_partial_update_timespan_seconds(const ObjectData &p_object_data, SyncGroupId p_group_id, bool p_partial_update_enabled, float p_update_timespan) {
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + (p_group_id) + "` doesn't exist.");
	sync_groups[p_group_id.id].set_simulated_partial_update_timespan_seconds(p_object_data, p_partial_update_enabled, p_update_timespan);
}

bool ServerSynchronizer::sync_group_is_simulated_partial_updating(const ObjectData &p_object_data, SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), false, "The group id `" + (p_group_id) + "` doesn't exist.");
	return sync_groups[p_group_id.id].is_simulated_partial_updating(p_object_data);
}

float ServerSynchronizer::sync_group_get_simulated_partial_update_timespan_seconds(const ObjectData &p_object_data, SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), -1.0f, "The group id `" + (p_group_id) + "` doesn't exist.");
	return sync_groups[p_group_id.id].get_simulated_partial_update_timespan_seconds(p_object_data);
}

void ServerSynchronizer::sync_group_replace_object(SyncGroupId p_group_id, std::vector<NS::SyncGroup::SimulatedObjectInfo> &&p_new_realtime_nodes, std::vector<NS::SyncGroup::TrickledObjectInfo> &&p_new_trickled_nodes) {
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + p_group_id + "` doesn't exist.");
	NS_ENSURE_MSG(p_group_id != SyncGroupId::GLOBAL, "You can't change this SyncGroup in any way. Create a new one.");
	sync_groups[p_group_id.id].replace_objects(std::move(p_new_realtime_nodes), std::move(p_new_trickled_nodes));
}

void ServerSynchronizer::sync_group_remove_all_objects(SyncGroupId p_group_id) {
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + p_group_id + "` doesn't exist.");
	NS_ENSURE_MSG(p_group_id != SyncGroupId::GLOBAL, "You can't change this SyncGroup in any way. Create a new one.");
	sync_groups[p_group_id.id].remove_all_nodes();
}

void ServerSynchronizer::sync_group_move_peer_to(int p_peer_id, SyncGroupId p_group_id) {
	// Update the sync group id
	sync_group_update(p_peer_id);
}

void ServerSynchronizer::sync_group_update(int p_peer_id) {
	NS::PeerData *pd = MapFunc::get_or_null(scene_synchronizer->peer_data, p_peer_id);
	NS_ASSERT_COND_MSG(pd, "The caller MUST make sure the peer server data exists before calling this function.");

	auto psd_it = MapFunc::insert_if_new(peers_data, p_peer_id, PeerServerData());

	// remove the peer from any sync_group.
	for (NS::SyncGroup &group : sync_groups) {
		group.remove_listening_peer(p_peer_id);
	}

	if (pd->authority_data.sync_group_id == SyncGroupId::NONE || !pd->authority_data.enabled) {
		// This peer is not listening to anything.
		return;
	}

	NS_ENSURE_MSG(pd->authority_data.sync_group_id.id < sync_groups.size(), "The group id `" + pd->authority_data.sync_group_id + "` doesn't exist.");
	sync_groups[pd->authority_data.sync_group_id.id].add_listening_peer(p_peer_id);

	// Also mark the peer as need full snapshot, as it's into a new group now.
	psd_it->second.force_notify_snapshot = true;
	psd_it->second.need_full_snapshot = true;
}

const std::vector<int> *ServerSynchronizer::sync_group_get_listening_peers(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), nullptr, "The group id `" + std::string(p_group_id) + "` doesn't exist.");
	return &sync_groups[p_group_id.id].get_listening_peers();
}

const std::vector<int> *ServerSynchronizer::sync_group_get_simulating_peers(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), nullptr, "The group id `" + std::string(p_group_id) + "` doesn't exist.");
	return &sync_groups[p_group_id.id].get_simulating_peers();
}

void ServerSynchronizer::set_peer_networking_enable(int p_peer, bool p_enable) {
	PeerData *pd = MapFunc::get_or_null(scene_synchronizer->peer_data, p_peer);
	NS_ENSURE(pd);

	if (pd->authority_data.enabled == p_enable) {
		// Nothing to do.
		return;
	}

	pd->authority_data.enabled = p_enable;

	sync_group_update(p_peer);
}

void ServerSynchronizer::sync_group_set_trickled_update_rate(NS::ObjectData *p_object_data, SyncGroupId p_group_id, float p_update_rate) {
	NS_ENSURE(p_object_data);
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + (p_group_id) + "` doesn't exist.");
	NS_ENSURE_MSG(p_group_id != SyncGroupId::GLOBAL, "You can't change this SyncGroup in any way. Create a new one.");
	sync_groups[p_group_id.id].set_trickled_update_rate(p_object_data, p_update_rate);
}

float ServerSynchronizer::sync_group_get_trickled_update_rate(const ObjectData *p_object_data, SyncGroupId p_group_id) const {
	NS_ENSURE_V(p_object_data, 0.0);
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), 0.0, "The group id `" + (p_group_id) + "` doesn't exist.");
	NS_ENSURE_V_MSG(p_group_id != SyncGroupId::GLOBAL, 0.0, "You can't change this SyncGroup in any way. Create a new one.");
	return sync_groups[p_group_id.id].get_trickled_update_rate(p_object_data);
}

void ServerSynchronizer::sync_group_notify_scheduled_procedure_changed(ObjectData &p_object_data, ScheduledProcedureId p_scheduled_procedure_id) {
	for (SyncGroup &group : sync_groups) {
		group.notify_scheduled_procedure_changed(p_object_data, p_scheduled_procedure_id);
	}
}

void ServerSynchronizer::sync_group_set_user_data(SyncGroupId p_group_id, uint64_t p_user_data) {
	NS_ENSURE_MSG(p_group_id.id < sync_groups.size(), "The group id `" + (p_group_id) + "` doesn't exist.");
	sync_groups[p_group_id.id].user_data = p_user_data;
}

uint64_t ServerSynchronizer::sync_group_get_user_data(SyncGroupId p_group_id) const {
	NS_ENSURE_V_MSG(p_group_id.id < sync_groups.size(), 0, "The group id `" + (p_group_id) + "` doesn't exist.");
	return sync_groups[p_group_id.id].user_data;
}

void ServerSynchronizer::sync_group_debug_print() {
	scene_synchronizer->get_debugger().print(INFO, "ServerSynchronizer::process", scene_synchronizer->get_network_interface().get_owner_name());
	scene_synchronizer->get_debugger().print(INFO, "", scene_synchronizer->get_network_interface().get_owner_name());
	scene_synchronizer->get_debugger().print(INFO, "|-----------------------", scene_synchronizer->get_network_interface().get_owner_name());
	scene_synchronizer->get_debugger().print(INFO, "| Sync groups", scene_synchronizer->get_network_interface().get_owner_name());
	scene_synchronizer->get_debugger().print(INFO, "|-----------------------", scene_synchronizer->get_network_interface().get_owner_name());

	for (int g = 0; g < int(sync_groups.size()); ++g) {
		SyncGroup &group = sync_groups[g];

		scene_synchronizer->get_debugger().print(INFO, "| [Group " + std::to_string(g) + "#]", scene_synchronizer->get_network_interface().get_owner_name());
		scene_synchronizer->get_debugger().print(INFO, "|    Listening peers", scene_synchronizer->get_network_interface().get_owner_name());
		for (int peer : group.get_listening_peers()) {
			scene_synchronizer->get_debugger().print(INFO, "|      |- " + std::to_string(peer), scene_synchronizer->get_network_interface().get_owner_name());
		}

		const std::vector<NS::SyncGroup::SimulatedObjectInfo> &realtime_node_info = group.get_simulated_sync_objects();
		scene_synchronizer->get_debugger().print(INFO, "|", scene_synchronizer->get_network_interface().get_owner_name());
		scene_synchronizer->get_debugger().print(INFO, "|    [Realtime nodes]", scene_synchronizer->get_network_interface().get_owner_name());
		for (auto info : realtime_node_info) {
			scene_synchronizer->get_debugger().print(INFO, "|      |- " + info.od->get_object_name(), scene_synchronizer->get_network_interface().get_owner_name());
		}

		scene_synchronizer->get_debugger().print(INFO, "|", scene_synchronizer->get_network_interface().get_owner_name());

		const std::vector<NS::SyncGroup::TrickledObjectInfo> &trickled_node_info = group.get_trickled_sync_objects();
		scene_synchronizer->get_debugger().print(INFO, "|    [Trickled nodes (UR: Update Rate)]", scene_synchronizer->get_network_interface().get_owner_name());
		for (auto info : trickled_node_info) {
			scene_synchronizer->get_debugger().print(INFO, "|      |- [UR: " + std::to_string(info.update_rate) + "] " + info.od->get_object_name().c_str(), scene_synchronizer->get_network_interface().get_owner_name());
		}
	}
	scene_synchronizer->get_debugger().print(INFO, "|-----------------------", scene_synchronizer->get_network_interface().get_owner_name());
	scene_synchronizer->get_debugger().print(INFO, "", scene_synchronizer->get_network_interface().get_owner_name());
}

// This function MUST be processed with a fixed delta time.
void ServerSynchronizer::process_snapshot_notificator() {
	if (scene_synchronizer->peer_data.empty()) {
		// No one is listening.
		return;
	}

	for (SyncGroup &group : sync_groups) {
		if (group.get_listening_peers().empty()) {
			// No one is interested in this group.
			continue;
		}

		// Notify the state if needed
		bool notify_state;
		std::vector<std::size_t> partial_update_simulated_objects_info_indices;
		group.advance_timer_state_notifier(
				scene_synchronizer->get_fixed_frame_delta(),
				scene_synchronizer->get_frame_confirmation_timespan(),
				scene_synchronizer->get_max_objects_count_per_partial_update(),
				notify_state,
				partial_update_simulated_objects_info_indices);

		bool full_snapshot_need_init = true;
		DataBuffer full_snapshot(get_debugger());
		full_snapshot.begin_write(get_debugger(), 0);

		bool delta_snapshot_need_init = true;
		DataBuffer delta_snapshot(get_debugger());
		delta_snapshot.begin_write(get_debugger(), 0);

		for (int peer_id : group.get_listening_peers()) {
			if (peer_id == scene_synchronizer->get_network_interface().get_local_peer_id()) {
				// Never send the snapshot to self (notice `self` is the server).
				continue;
			}

			PeerData *peer = MapFunc::get_or_null(scene_synchronizer->peer_data, peer_id);
			if (peer == nullptr) {
				scene_synchronizer->get_debugger().print(ERROR, "The `process_snapshot_notificator` failed to lookup the peer_id `" + std::to_string(peer_id) + "`. Was it removed but never cleared from sync_groups. Report this error, as this is a bug.");
				continue;
			}
			auto pd_it = MapFunc::insert_if_new(peers_data, peer_id, PeerServerData());

			if (pd_it->second.force_notify_snapshot == false && notify_state == false) {
				// Nothing to sync.
				continue;
			}

			pd_it->second.force_notify_snapshot = false;

			PeerNetworkedController *controller = peer->get_controller();

			// Fetch the peer input_id for this snapshot
			FrameIndex input_id = FrameIndex::NONE;
			if (controller) {
				input_id = controller->get_current_frame_index();
			}

			DataBuffer *snap;
			if (pd_it->second.need_full_snapshot) {
				pd_it->second.need_full_snapshot = false;
				if (full_snapshot_need_init) {
					full_snapshot_need_init = false;
					generate_snapshot(true, group, std::vector<std::size_t>(), full_snapshot);
				}

				snap = &full_snapshot;
				get_debugger().print(VERBOSE, "Sending full snapshot to peer: " + std::to_string(pd_it->first));
			} else {
				if (delta_snapshot_need_init) {
					delta_snapshot_need_init = false;
					generate_snapshot(false, group, partial_update_simulated_objects_info_indices, delta_snapshot);
				}

				snap = &delta_snapshot;
				get_debugger().print(VERBOSE, "Sending incremental snapshot to peer: " + std::to_string(pd_it->first));
			}

			scene_synchronizer->rpc_handler_state.rpc(
					scene_synchronizer->get_network_interface(),
					peer_id,
					*snap);
			scene_synchronizer->event_sent_snapshot.broadcast(input_id, peer_id);

			if (controller) {
				controller->get_server_controller()->notify_send_state();
			}
		}

		// TODO ensure the changes are tracked per peer, avoiding to send redundant information.
		if (notify_state) {
			// The state got notified, mark this as checkpoint so the next state
			// will contains only the changed variables.
			group.mark_changes_as_notified(
					partial_update_simulated_objects_info_indices.size() > 0,
					partial_update_simulated_objects_info_indices);
		}
	}
}

void ServerSynchronizer::generate_snapshot(
		bool p_force_full_snapshot,
		const SyncGroup &p_group,
		const std::vector<std::size_t> &p_partial_update_simulated_objects_info_indices,
		DataBuffer &r_snapshot_db) const {
	const std::vector<SyncGroup::SimulatedObjectInfo> &relevant_node_data = p_group.get_simulated_sync_objects();

	// First insert the snapshot update mode
	const bool is_partial_update = p_force_full_snapshot == false && p_partial_update_simulated_objects_info_indices.size() > 0;
	r_snapshot_db.add(is_partial_update);

	r_snapshot_db.add(scene_synchronizer->global_frame_index.id);

	for (int peer_id : p_group.get_simulating_peers()) {
		const PeerData *pd = MapFunc::get_or_null(scene_synchronizer->peer_data, peer_id);
		if (pd) {
			// Specify that we have info for a new peer.
			r_snapshot_db.add(true);

			// Set the peer
			r_snapshot_db.add(peer_id);

			// Set the FrameIndex
			r_snapshot_db.add(pd->get_controller()->get_current_frame_index().id);

			// Latency
			if (VecFunc::has(p_group.get_peers_with_newly_calculated_latency(), peer_id)) {
				// Specify that it contains the peer latency.
				r_snapshot_db.add(true);
				const std::uint8_t compressed_latency = pd->get_compressed_latency();
				r_snapshot_db.add(compressed_latency);
			} else {
				r_snapshot_db.add(false);
			}

			// Adds the simulated objects controlled by this peer.
			if (p_force_full_snapshot) {
				// Since a full snapshot is needed, here we are packaging ALL the simulated nodes.
				// Add a `TRUE` to signal the SyncGroup changed.
				r_snapshot_db.add(true);

				for (uint32_t i = 0; i < relevant_node_data.size(); i += 1) {
					const ObjectData *od = relevant_node_data[i].od;
					NS_ASSERT_COND(od->get_net_id() != ObjectNetId::NONE);
					NS_ASSERT_COND(od->get_net_id().id <= std::numeric_limits<uint16_t>::max());
					if (od->get_controlled_by_peer() == peer_id) {
						r_snapshot_db.add(od->get_net_id().id);
					}
				}

				// Add `uint16_max to signal its end.
				r_snapshot_db.add(ObjectNetId::NONE.id);
			} else {
				// Add a `FALSE` to specify this is a PARTIAL update.
				r_snapshot_db.add(false);

				for (ObjectNetId added_to_sync_group_net_id : p_group.get_simulated_sync_objects_ADDED()) {
					NS_ASSERT_COND(added_to_sync_group_net_id != ObjectNetId::NONE);
					NS_ASSERT_COND(added_to_sync_group_net_id.id <= std::numeric_limits<uint16_t>::max());
					const ObjectData *od = scene_synchronizer->get_object_data(added_to_sync_group_net_id, false);
					if (od && od->get_controlled_by_peer() == peer_id) {
						// Add a `TRUE` to signal we have another ObjectNetId into this sync group.
						r_snapshot_db.add(true);
						r_snapshot_db.add(added_to_sync_group_net_id.id);
					}
				}

				// Add `FALSE` to signal the array end.
				r_snapshot_db.add(false);
			}
		}
	}

	// Signal that the array of peers is empty
	r_snapshot_db.add(false);

	// Then insert the list of ALL simulated ObjectData, for all the objects not controlled by a peer.
	if (p_force_full_snapshot) {
		// Add a `TRUE` to specify this is a full update.
		r_snapshot_db.add(true);

		for (uint32_t i = 0; i < relevant_node_data.size(); i += 1) {
			const ObjectData *od = relevant_node_data[i].od;
			NS_ASSERT_COND(od->get_net_id() != ObjectNetId::NONE);
			NS_ASSERT_COND(od->get_net_id().id <= std::numeric_limits<uint16_t>::max());
			if (od->get_controlled_by_peer() <= 0) {
				r_snapshot_db.add(od->get_net_id().id);
			}
		}

		// Add `uint16_max to signal its end.
		r_snapshot_db.add(ObjectNetId::NONE.id);
	} else {
		// Add a `FALSE` to specify this is a PARTIAL update.
		r_snapshot_db.add(false);

		for (ObjectNetId added_to_sync_group_net_id : p_group.get_simulated_sync_objects_ADDED()) {
			NS_ASSERT_COND(added_to_sync_group_net_id != ObjectNetId::NONE);
			NS_ASSERT_COND(added_to_sync_group_net_id.id <= std::numeric_limits<uint16_t>::max());
			const ObjectData *od = scene_synchronizer->get_object_data(added_to_sync_group_net_id, false);
			if (od && od->get_controlled_by_peer() <= 0) {
				// Add a `TRUE` to signal we have another ObjectNetId into this sync group.
				r_snapshot_db.add(true);
				r_snapshot_db.add(added_to_sync_group_net_id.id);
				// Add a `TRUE` to signal this NetId was added into the sync group.
				r_snapshot_db.add(true);
			}
		}

		for (ObjectNetId removed_from_sync_group_net_id : p_group.get_simulated_sync_objects_REMOVED()) {
			NS_ASSERT_COND(removed_from_sync_group_net_id != ObjectNetId::NONE);
			NS_ASSERT_COND(removed_from_sync_group_net_id.id <= std::numeric_limits<uint16_t>::max());
			// Add a `TRUE` to signal we have another ObjectNetId into this sync group.
			r_snapshot_db.add(true);
			r_snapshot_db.add(removed_from_sync_group_net_id.id);
			// Add a `FALSE` to signal this NetId was removed from the sync group.
			r_snapshot_db.add(false);
		}

		// Add `FALSE` to signal the array end.
		r_snapshot_db.add(false);
	}

	// Calling this function to allow to customize the snapshot per group.
	VarData vd;
	if (scene_synchronizer->synchronizer_manager->snapshot_get_custom_data(
			&p_group,
			is_partial_update,
			p_partial_update_simulated_objects_info_indices,
			vd)) {
#ifdef NS_DEBUG_ENABLED
		NS_ASSERT_COND_MSG(vd.type == scene_synchronizer->synchronizer_manager->snapshot_get_custom_data_type(), "Ensure the custom data type equals the one returned by `snapshot_get_custom_data_type`.");
#endif
		r_snapshot_db.add(true);
		SceneSynchronizerBase::var_data_encode(r_snapshot_db, vd, scene_synchronizer->synchronizer_manager->snapshot_get_custom_data_type());
	} else {
		r_snapshot_db.add(false);
	}

	if (p_group.is_trickled_node_list_changed() || p_force_full_snapshot) {
		for (int i = 0; i < int(p_group.get_trickled_sync_objects().size()); ++i) {
			if (p_group.get_trickled_sync_objects()[i]._unknown || p_force_full_snapshot) {
				generate_snapshot_object_data(
						p_group.get_trickled_sync_objects()[i].od,
						SnapshotObjectGeneratorMode::FORCE_NODE_PATH_ONLY,
						NS::SyncGroup::Change(),
						r_snapshot_db);
			}
		}
	}

	const SnapshotObjectGeneratorMode object_generator_mode = p_force_full_snapshot ? SnapshotObjectGeneratorMode::FORCE_FULL : SnapshotObjectGeneratorMode::NORMAL;

	// Then, generate the snapshot for the relevant objects.
	if (is_partial_update) {
		// This is a partial update, insert only the specified objects.
		for (std::size_t index : p_partial_update_simulated_objects_info_indices) {
			if (relevant_node_data[index].od) {
				generate_snapshot_object_data(
						relevant_node_data[index].od,
						object_generator_mode,
						relevant_node_data[index].change,
						r_snapshot_db);
			}
		}
	} else {
		// Insert all the simulated and changed objects.
		for (uint32_t i = 0; i < relevant_node_data.size(); i += 1) {
			if (relevant_node_data[i].od) {
				generate_snapshot_object_data(
						relevant_node_data[i].od,
						object_generator_mode,
						relevant_node_data[i].change,
						r_snapshot_db);
			}
		}
	}

	// Mark the end.
	r_snapshot_db.add(ObjectNetId::NONE.id);
}

void ServerSynchronizer::generate_snapshot_object_data(
		const ObjectData *p_object_data,
		SnapshotObjectGeneratorMode p_mode,
		const SyncGroup::Change &p_change,
		DataBuffer &r_snapshot_db) const {
	if (p_object_data->app_object_handle == ObjectHandle::NONE || p_object_data->get_object_name().empty()) {
		return;
	}

	const bool force_using_node_path = p_mode == SnapshotObjectGeneratorMode::FORCE_FULL || p_mode == SnapshotObjectGeneratorMode::FORCE_NODE_PATH_ONLY;
	const bool force_snapshot_variables = p_mode == SnapshotObjectGeneratorMode::FORCE_FULL;
	const bool force_snapshot_procedures = p_mode == SnapshotObjectGeneratorMode::FORCE_FULL;
	const bool skip_snapshot_variables = p_mode == SnapshotObjectGeneratorMode::FORCE_NODE_PATH_ONLY;
	const bool skip_snapshot_scheduled_procedures = p_mode == SnapshotObjectGeneratorMode::FORCE_NODE_PATH_ONLY;

	const bool unknown = p_change.unknown;
	const bool object_has_vars_changes = p_change.vars.empty() == false;
	const bool object_has_procedure_changes = p_change.changed_scheduled_procedures.empty() == false;

	if (!unknown && !object_has_vars_changes && !object_has_procedure_changes && !force_snapshot_variables && !force_snapshot_procedures) {
		// Nothing to network for this object.
		return;
	}

	// Insert OBJECT DATA NetId.
	r_snapshot_db.add(p_object_data->get_net_id().id);

	if (force_using_node_path || unknown) {
		// This object is unknown.
		r_snapshot_db.add(true); // Has the object name?
		r_snapshot_db.add(p_object_data->get_object_name());
	} else {
		// This node is already known on clients, just set the node ID.
		r_snapshot_db.add(false); // Has the object name?
	}

	const bool allow_vars =
			force_snapshot_variables ||
			(object_has_vars_changes && !skip_snapshot_variables) ||
			unknown;

	const bool allow_scheduled_procedures =
			force_snapshot_procedures ||
			(object_has_procedure_changes && !skip_snapshot_scheduled_procedures) ||
			unknown;

	// This is necessary to allow the client decode the snapshot even if it
	// doesn't know this object.
	const int buffer_offset_for_vars_size_bits = r_snapshot_db.get_bit_offset();
	std::uint16_t vars_size_bits = 0;
	r_snapshot_db.add(vars_size_bits);
	const int buffer_offset_start_vars = r_snapshot_db.get_bit_offset();

	// This is assuming the client and the server have the same vars registered
	// with the same order.
	for (VarId::IdType i = 0; i < p_object_data->vars.size(); i += 1) {
		const VarDescriptor &var = p_object_data->vars[i];

		bool var_has_value = allow_vars;

		if (var.enabled == false) {
			var_has_value = false;
		}

		if (var_has_value && !force_snapshot_variables && !VecFunc::has(p_change.vars, VarId{ i })) {
			// This is a delta snapshot and this variable is the same as before.
			// Skip this value
			var_has_value = false;
		}

#ifdef NS_DEBUG_ENABLED
		if (scene_synchronizer->pedantic_checks) {
			// Make sure the value read from `var.var.value` equals to the one
			// set on the scene.
			VarData current_val;
			var.get_func(
					scene_synchronizer->get_synchronizer_manager(),
					p_object_data->app_object_handle,
					var.var.name.c_str(),
					current_val);
			NS_ASSERT_COND(scene_synchronizer->var_data_compare(current_val, var.var.value));
		}
#endif

		r_snapshot_db.add(var_has_value);
		if (var_has_value) {
			SceneSynchronizerBase::var_data_encode(r_snapshot_db, var.var.value, var.type);
		}
	}

	// This is assuming the client and the server have the same procedures registered
	// with the same order.
	for (ScheduledProcedureId::IdType i = 0; i < p_object_data->get_scheduled_procedures().size(); i += 1) {
		const ScheduledProcedureId procedure_id{ i };
		const ObjectData::ScheduledProcedureInfo &proc_info = p_object_data->get_scheduled_procedures()[i];

		bool procedure_has_value = allow_scheduled_procedures;

		if (!p_object_data->scheduled_procedure_exist(procedure_id)) {
			procedure_has_value = false;
		}

		if (procedure_has_value && !force_snapshot_procedures && !VecFunc::has(p_change.changed_scheduled_procedures, ScheduledProcedureHandle(p_object_data->get_net_id(), procedure_id))) {
			// This is a delta snapshot and this procedure didn't change.
			// Skip it.
			procedure_has_value = false;
		}

		r_snapshot_db.add(procedure_has_value);
		if (procedure_has_value) {
			r_snapshot_db.add(p_object_data->scheduled_procedure_is_inprogress(procedure_id));
			if (p_object_data->scheduled_procedure_is_inprogress(procedure_id)) {
				// In progress
				r_snapshot_db.add(p_object_data->get_scheduled_procedures()[procedure_id.id].execute_frame.id);
				r_snapshot_db.add(p_object_data->get_scheduled_procedures()[procedure_id.id].args);
			} else if (p_object_data->scheduled_procedure_is_paused(procedure_id)) {
				// Paused
				r_snapshot_db.add(true);
				r_snapshot_db.add(p_object_data->get_scheduled_procedures()[procedure_id.id].execute_frame.id);
				r_snapshot_db.add(p_object_data->get_scheduled_procedures()[procedure_id.id].paused_frame.id);
				// NOTE: No need to network the args here because as soon as we restart this the arguments are
				//       networked again.
			} else {
				// Stopped
				r_snapshot_db.add(false);
			}
		}
	}

	// Now write the buffer size in bits.
	const int buffer_offset_end_vars = r_snapshot_db.get_bit_offset();
	const int size = buffer_offset_end_vars - buffer_offset_start_vars;
	NS_ENSURE_MSG(size <= std::numeric_limits<std::uint16_t>::max(), "The variables size excede the allows max size. Please report this issue ASAP.")
	vars_size_bits = size;
	r_snapshot_db.seek(buffer_offset_for_vars_size_bits);
	r_snapshot_db.add(vars_size_bits);
	r_snapshot_db.seek(buffer_offset_end_vars);
}

void ServerSynchronizer::process_trickled_sync(float p_delta) {
	DataBuffer tmp_buffer(get_debugger());

	// Since the `update_rate` is a rate relative to the fixed_frame_delta,
	// we need to compute this factor to correctly scale the `update_rate`.
	const float current_frame_factor = p_delta / scene_synchronizer->get_fixed_frame_delta();

	for (auto &group : sync_groups) {
		if (group.get_listening_peers().empty()) {
			// No one is interested to this group.
			continue;
		}

		std::vector<NS::SyncGroup::TrickledObjectInfo> &objects_info = group.get_trickled_sync_objects();
		if (objects_info.size() == 0) {
			// Nothing to sync.
			continue;
		}

		int update_node_count = 0;

		group.sort_trickled_node_by_update_priority();

		DataBuffer global_buffer(get_debugger());
		global_buffer.begin_write(get_debugger(), 0);
		global_buffer.add_uint(epoch, DataBuffer::COMPRESSION_LEVEL_1);

		for (auto &object_info : objects_info) {
			bool send = true;
			if (object_info._update_priority < 1.0 || update_node_count >= scene_synchronizer->max_trickled_objects_per_update) {
				send = false;
			}

			if (send) {
				// TODO use `NS_DEBUG_ENABLED` here?
				if (object_info.od->get_net_id().id > UINT16_MAX) {
					scene_synchronizer->get_debugger().print(ERROR, "[FATAL] The `process_trickled_sync` found a node with ID `" + object_info.od->get_net_id() + "::" + object_info.od->get_object_name() + "` that exceedes the max ID this function can network at the moment. Please report this, we will consider improving this function.", scene_synchronizer->get_network_interface().get_owner_name());
					continue;
				}

				// TODO use `NS_DEBUG_ENABLED` here?
				if (!object_info.od->func_trickled_collect) {
					scene_synchronizer->get_debugger().print(ERROR, "The `process_trickled_sync` found a node `" + object_info.od->get_net_id() + "::" + object_info.od->get_object_name() + "` with an invalid function `func_trickled_collect`. Please use `setup_deferred_sync` to correctly initialize this node for deferred sync.", scene_synchronizer->get_network_interface().get_owner_name());
					continue;
				}

				object_info._update_priority = 0.0;

				// Read the state and write into the tmp_buffer:
				tmp_buffer.begin_write(get_debugger(), 0);

				object_info.od->func_trickled_collect(tmp_buffer, object_info.update_rate);
				if (tmp_buffer.total_size() > UINT16_MAX) {
					scene_synchronizer->get_debugger().print(ERROR, "The `process_trickled_sync` failed because the method `trickled_collect` for the node `" + object_info.od->get_net_id() + "::" + object_info.od->get_object_name() + "` collected more than " + std::to_string(UINT16_MAX) + " bits. Please optimize your netcode to send less data.", scene_synchronizer->get_network_interface().get_owner_name());
					continue;
				}

				++update_node_count;

				if (object_info.od->get_net_id().id > UINT8_MAX) {
					global_buffer.add_bool(true);
					global_buffer.add_uint(object_info.od->get_net_id().id, DataBuffer::COMPRESSION_LEVEL_2);
				} else {
					global_buffer.add_bool(false);
					global_buffer.add_uint(object_info.od->get_net_id().id, DataBuffer::COMPRESSION_LEVEL_3);
				}

				// Collapse the two DataBuffer.
				global_buffer.add_uint(std::uint32_t(tmp_buffer.total_size()), DataBuffer::COMPRESSION_LEVEL_2);
				global_buffer.add_bits(tmp_buffer.get_buffer().get_bytes().data(), tmp_buffer.total_size());
			} else {
				object_info._update_priority += object_info.update_rate * current_frame_factor;
			}
		}

		if (update_node_count > 0) {
			global_buffer.dry();
			for (int peer : group.get_listening_peers()) {
				scene_synchronizer->rpc_handler_trickled_sync_data.rpc(
						scene_synchronizer->get_network_interface(),
						peer,
						global_buffer.get_buffer().get_bytes());
			}
		}
	}
}

void ServerSynchronizer::update_peers_net_statistics(float p_delta) {
	for (auto &[peer, peer_data] : scene_synchronizer->get_peers()) {
		if (peer == scene_synchronizer->get_network_interface().get_local_peer_id()) {
			// No need to update the ping for `self` (the server).
			continue;
		}
		if (!peer_data.get_controller()) {
			// There is no controller, nothing to do.
			continue;
		}
#ifdef NS_DEBUG_ENABLED
		NS_ASSERT_COND(peer_data.get_controller()->is_server_controller());
#endif

		std::map<int, PeerServerData>::iterator peer_server_data_it = NS::MapFunc::insert_if_new(peers_data, peer, PeerServerData());
		peer_server_data_it->second.latency_update_via_snapshot_sec += p_delta;
		peer_server_data_it->second.netstats_peer_update_sec += p_delta;

		const bool requires_latency_update = peer_server_data_it->second.latency_update_via_snapshot_sec >= scene_synchronizer->latency_update_rate;
		const bool requires_netstats_update = peer_server_data_it->second.netstats_peer_update_sec >= scene_synchronizer->get_netstats_update_interval_sec();

		if make_likely(!requires_latency_update && !requires_netstats_update) {
			// No need to update the peer network statistics for now.
			continue;
		}

		// Time to update the network stats for this peer.
		scene_synchronizer->get_network_interface().server_update_net_stats(peer, peer_data);

		// Notify all sync groups about this peer having newly calculated latency.
		if (requires_latency_update) {
			for (auto &group : sync_groups) {
				group.notify_peer_has_newly_calculated_latency(peer);
			}

			// Reset the timer.
			peer_server_data_it->second.latency_update_via_snapshot_sec = 0.0;
		}

		if (requires_netstats_update) {
			send_net_stat_to_peer(peer, peer_data);
			peer_server_data_it->second.netstats_peer_update_sec = 0.0;
		}
	}
}

void ServerSynchronizer::send_net_stat_to_peer(int p_peer, PeerData &p_peer_data) {
	PeerNetworkedController &controller = *p_peer_data.get_controller();
	if (controller.get_server_controller_unchecked()->streaming_paused) {
		return;
	}

	DataBuffer db(get_debugger());
	db.begin_write(get_debugger(), 0);

	// Latency
	db.add(p_peer_data.get_compressed_latency());

	// Packet loss from 0.0 to 1.0
	db.add_positive_unit_real(p_peer_data.get_out_packet_loss_percentage(), DataBuffer::COMPRESSION_LEVEL_0);

	// Average jitter - from 0ms to 255ms.
	const std::uint8_t compressed_jitter = std::clamp(int(p_peer_data.get_latency_jitter_ms()), int(0), int(std::numeric_limits<std::uint8_t>::max()));
	db.add(compressed_jitter);

	// Compressed input count - from 0 to 255
	const std::uint8_t compressed_input_count =
			std::clamp(int(controller.get_server_controller_unchecked()->get_inputs_count()), int(0), int(std::numeric_limits<std::uint8_t>::max()));
	db.add(compressed_input_count);

	scene_synchronizer->rpc_handle_notify_netstats.rpc(
			scene_synchronizer->get_network_interface(),
			p_peer,
			db);
}

ClientSynchronizer::ClientSynchronizer(SceneSynchronizerBase *p_node) :
	Synchronizer(p_node) {
	clear();

	notify_server_full_snapshot_is_needed();
}

void ClientSynchronizer::clear() {
	player_controller = nullptr;
	objects_names.clear();
	last_received_snapshot.input_id = FrameIndex::NONE;
	last_received_snapshot.objects.clear();
	client_snapshots.clear();
	last_received_server_snapshot_index = FrameIndex::NONE;
	last_received_server_snapshot.reset();
	last_checked_input = FrameIndex::NONE;
	enabled = true;
	need_full_snapshot_notified = false;
}

void ClientSynchronizer::process(float p_delta) {
	NS_PROFILE

	try_fetch_pending_snapshot_objects();

	scene_synchronizer->get_debugger().print(VERBOSE, "ClientSynchronizer::process", scene_synchronizer->get_network_interface().get_owner_name());

#ifdef NS_DEBUG_ENABLED
	if make_unlikely(p_delta > (scene_synchronizer->get_fixed_frame_delta() + (scene_synchronizer->get_fixed_frame_delta() * 0.2))) {
		scene_synchronizer->get_debugger().print(WARNING, "Current FPS is " + std::to_string(p_delta > 0.0001 ? 1.0 / p_delta : 0.0) + ", but the minimum required FPS is " + std::to_string(scene_synchronizer->get_frames_per_seconds()) + ", the client is unable to generate enough inputs for the server.", scene_synchronizer->get_network_interface().get_owner_name());
	}
#endif

	process_server_sync();
	process_simulation(p_delta);
	process_trickled_sync(p_delta);

#if NS_DEBUG_ENABLED
	if (player_controller && player_controller->can_simulate()) {
		const int client_peer = scene_synchronizer->network_interface->get_local_peer_id();
		scene_synchronizer->get_debugger().write_dump(client_peer, player_controller->get_current_frame_index().id);
		scene_synchronizer->get_debugger().start_new_frame();
	}
#endif
}

void ClientSynchronizer::receive_snapshot(DataBuffer &p_snapshot) {
	// The received snapshot is parsed and stored into the `last_received_snapshot`
	// that contains always the last received snapshot.
	// Later, the snapshot is stored into the server queue.
	// In this way, we are free to pop snapshot from the queue without wondering
	// about losing the data. Indeed the received snapshot is just and
	// incremental update so the last received data is always needed to fully
	// reconstruct it.

	scene_synchronizer->get_debugger().print(VERBOSE, "The Client received the server snapshot.", scene_synchronizer->get_network_interface().get_owner_name());

	// Parse server snapshot.
	const bool success = parse_snapshot(p_snapshot, true);

	if (success == false) {
		return;
	}

	// Finalize data.
	store_controllers_snapshot(last_received_snapshot);
}

void ClientSynchronizer::on_object_data_added(ObjectData &p_object_data) {
	finalize_object_data_synchronization(p_object_data);
}

void ClientSynchronizer::on_object_data_removed(NS::ObjectData &p_object_data) {
	VecFunc::remove_unordered(simulated_objects, p_object_data.get_net_id());
	VecFunc::remove_unordered(active_objects, &p_object_data);

	if (p_object_data.get_net_id().id < uint32_t(last_received_snapshot.objects.size())) {
		last_received_snapshot.objects[p_object_data.get_net_id().id].vars.clear();
		last_received_snapshot.objects[p_object_data.get_net_id().id].procedures.clear();
	}

	remove_object_from_trickled_sync(&p_object_data);
}

void ClientSynchronizer::on_object_data_name_known(ObjectData &p_object_data) {
	finalize_object_data_synchronization(p_object_data);
}

void ClientSynchronizer::on_variable_changed(NS::ObjectData *p_object_data, VarId p_var_id, const VarData &p_old_value, int p_flag) {
	if (p_flag & NetEventFlag::SYNC) {
		const EndSyncEvent ese(
				p_object_data,
				p_var_id,
				p_old_value);
		auto see_it = VecFunc::find(sync_end_events, ese);
		if (see_it == sync_end_events.end()) {
			sync_end_events.push_back(ese);
		} else {
			see_it->old_value.copy(p_old_value);
		}
	}
}

void ClientSynchronizer::signal_end_sync_changed_variables_events() {
	NS_PROFILE

	scene_synchronizer->change_events_begin(NetEventFlag::END_SYNC);
	for (auto &e : sync_end_events) {
		// Check if the values between the variables before the sync and the
		// current one are different.
		if (SceneSynchronizerBase::var_data_compare(
				e.object_data->vars[e.var_id.id].var.value,
				e.old_value) == false) {
			// Are different so we need to emit the `END_SYNC`.
			scene_synchronizer->change_event_add(
					e.object_data,
					e.var_id,
					e.old_value);
		}
	}
	sync_end_events.clear();

	scene_synchronizer->change_events_flush();
}

void ClientSynchronizer::on_controller_reset(PeerNetworkedController &p_controller) {
	if (p_controller.is_player_controller()) {
		// This can't trigger because the reset function creates the player
		// controller when the following condition is true.
		NS_ASSERT_COND(p_controller.get_authority_peer() == scene_synchronizer->get_network_interface().get_local_peer_id());

		// Reset the node_data.
		player_controller = &p_controller;
		last_received_server_snapshot_index = FrameIndex::NONE;
		last_received_server_snapshot.reset();
		client_snapshots.clear();
	}
}

const std::vector<ObjectData *> &ClientSynchronizer::get_active_objects() const {
	if make_likely(player_controller && player_controller->can_simulate() && enabled) {
		return active_objects;
	} else {
		// Since there is no player controller or the sync is disabled, this
		// assumes that all registered objects are relevant and simulated.
		return scene_synchronizer->get_all_object_data();
	}
}

void ClientSynchronizer::try_fetch_pending_snapshot_objects() {
	NS_PROFILE

	std::vector<ObjectNetId> pending_objects;
	for (const auto &[net_id, snapshots] : objects_pending_snapshots) {
		pending_objects.push_back(net_id);
		if (snapshots.size() > 60) {
			// We have more than 60 snapshots for this objects and still it doesn't exist yet.
			// this is a bug.
			get_debugger().print(ERROR, "The object with NetId `" + std::to_string(net_id.id) + "` have more than " + std::to_string(snapshots.size()) + " and still it's not yet registered on the client. This is likely a bug that you should investigate or report. Requesting a full snapshot to try recovering it, but still this is likely a bug that you have to fix anyway.");
			notify_server_full_snapshot_is_needed();
			return;
		}
	}

	for (ObjectNetId pending_registration_net_id : pending_objects) {
		const std::string *object_name = MapFunc::get_or_null(objects_names, pending_registration_net_id);
		if (object_name) {
			const ObjectHandle app_object_handle =
					scene_synchronizer->synchronizer_manager->fetch_app_object(*object_name);
			if (app_object_handle != ObjectHandle::NONE) {
				ObjectLocalId reg_obj_id;
				scene_synchronizer->register_app_object(app_object_handle, &reg_obj_id);
				ObjectData *od = scene_synchronizer->get_object_data(reg_obj_id);
				od->set_net_id(pending_registration_net_id);
				finalize_object_data_synchronization(*od);
				NS_ASSERT_COND(MapFunc::get_or_null(objects_pending_snapshots, pending_registration_net_id)==nullptr);
			}
		}
	}
}

void ClientSynchronizer::store_snapshot() {
	NS_PROFILE

#ifdef NS_DEBUG_ENABLED
	if make_unlikely(client_snapshots.size() > 0 && player_controller->get_current_frame_index() <= client_snapshots.back().input_id) {
		NS_ASSERT_NO_ENTRY_MSG("During snapshot creation, for controller " + std::to_string(player_controller->get_authority_peer()) + ", was found an ID for an older snapshots. New input ID: " + std::string(player_controller->get_current_frame_index()) + " Last saved snapshot input ID: " + std::string(client_snapshots.back().input_id) + ".");
	}
#endif

	client_snapshots.push_back(Snapshot());

	Snapshot &snap = client_snapshots.back();
	snap.input_id = player_controller->get_current_frame_index();

	update_client_snapshot(snap);
}

void ClientSynchronizer::store_controllers_snapshot(
		const RollingUpdateSnapshot &p_snapshot) {
	// Put the parsed snapshot into the queue.

	if make_unlikely(!scene_synchronizer->synchronizer_manager->can_client_store_server_snapshot(p_snapshot)) {
		// Do not store this snapshot.
		return;
	}

	if (p_snapshot.input_id == FrameIndex::NONE) {
		scene_synchronizer->get_debugger().print(VERBOSE, "The Client received the server snapshot WITHOUT `input_id`.", scene_synchronizer->get_network_interface().get_owner_name());
		// The controller node is not registered so just assume this snapshot is the most up-to-date.
		last_received_server_snapshot.emplace(Snapshot::make_copy(p_snapshot));
		last_received_server_snapshot_index = p_snapshot.input_id;
	} else {
		NS_ENSURE_MSG(
				last_received_server_snapshot_index == FrameIndex::NONE ||
				last_received_server_snapshot_index <= p_snapshot.input_id,
				"The client received a too old snapshot. If this happens back to back for a long period it's a bug, otherwise can be ignored. last_received_server_snapshot_index: " + std::to_string(last_received_server_snapshot_index.id) + " p_snapshot.input_id: " + std::to_string(p_snapshot.input_id.id));

		if (p_snapshot.was_partially_updated) {
			// Since this is a partial update, the current snapshot can't be
			// used as is to check the sync.
			// The reason is that, since we do a delta update, all the objects
			// contained into `p_snapshot` that didn't get updated have a state 
			// which is old and most likely invalid.
			// This is the reason we can't just use it as synchronization ground.
			//
			// For this reason we need to first take the locally generated snapshot,
			// then override the objects value with the one received.
			// The resulting snapshot is not a fully accurate one, but it's good
			// enough to (eventually) rewind part of the scene objects, without
			// breaking the sync.
			scene_synchronizer->get_debugger().print(VERBOSE, "The Client received the server [PARTIAL] snapshot: " + p_snapshot.input_id, scene_synchronizer->get_network_interface().get_owner_name());
			for (const Snapshot &client_snapshot : client_snapshots) {
				if (client_snapshot.input_id == p_snapshot.input_id) {
					last_received_server_snapshot.emplace(Snapshot::make_copy(client_snapshot));
					break;
				}
			}
			NS_ENSURE_MSG(last_received_server_snapshot.has_value(), "The Client received a partial snapshot `" + p_snapshot.input_id+"` from the server but it was not possible to find a locally generated snapshot with the same ID. This should not be possible and it's a bug.");

			// Now copy the update objects.
			Snapshot &the_storing_snapshot = last_received_server_snapshot.value();
			if (p_snapshot.is_just_updated_custom_data) {
				the_storing_snapshot.has_custom_data = scene_synchronizer->get_synchronizer_manager().snapshot_merge_custom_data_for_partial_update(
						p_snapshot.just_updated_object_vars,
						the_storing_snapshot.custom_data,
						p_snapshot.custom_data);
			}
			if (p_snapshot.is_just_updated_simulated_objects) {
				the_storing_snapshot.simulated_objects = p_snapshot.simulated_objects;
			}
			for (ObjectNetId net_id : p_snapshot.just_updated_object_vars) {
				if (uint32_t(the_storing_snapshot.objects.size()) <= net_id.id) {
					// Ensure the vector is big enough.
					the_storing_snapshot.objects.resize(net_id.id + 1);
				}

				the_storing_snapshot.objects[net_id.id].vars.resize(p_snapshot.get_object_vars(net_id)->size());
				for (int i = 0; i < p_snapshot.get_object_vars(net_id)->size(); i++) {
					if ((*p_snapshot.get_object_vars(net_id))[i].has_value()) {
						the_storing_snapshot.objects[net_id.id].vars[i].emplace(VarData::make_copy((*p_snapshot.get_object_vars(net_id))[i].value()));
					} else {
						the_storing_snapshot.objects[net_id.id].vars[i].reset();
					}
				}

				the_storing_snapshot.objects[net_id.id].procedures = *p_snapshot.get_object_procedures(net_id);
			}

			last_received_server_snapshot_index = p_snapshot.input_id;
		} else {
			// The current snapshot represent the full server copy, so just copy it.
			scene_synchronizer->get_debugger().print(VERBOSE, "The Client received the server snapshot: " + p_snapshot.input_id, scene_synchronizer->get_network_interface().get_owner_name());
			last_received_server_snapshot.emplace(Snapshot::make_copy(p_snapshot));
			last_received_server_snapshot_index = p_snapshot.input_id;
		}
	}

	NS_ASSERT_COND(last_received_server_snapshot_index == p_snapshot.input_id);

	// NOTE 1: At this point last_received_server_snapshot is guaranteed to have a value.
	// NOTE 2: Using the last_received_server_snapshot instead of last_received_snapshot
	//         because on the former we do extra stuff in order to properly parse
	//         it in case the received one is a partial update.
	scene_synchronizer->event_received_server_snapshot.broadcast(last_received_server_snapshot.value());
}

void ClientSynchronizer::process_server_sync() {
	NS_PROFILE
	process_received_server_state();

	// Now trigger the END_SYNC event.
	signal_end_sync_changed_variables_events();
}

void ClientSynchronizer::process_received_server_state() {
	NS_PROFILE

	// --- Phase one: find the snapshot to check. ---
	if (!last_received_server_snapshot) {
		// No snapshots to recover for this controller. Nothing to do.
		return;
	}

	if (last_received_server_snapshot->input_id == FrameIndex::NONE) {
		// The server last received snapshot is a no input snapshot. Just assume it's the most up-to-date.
		scene_synchronizer->get_debugger().print(VERBOSE, "The client received a \"no input\" snapshot, so the client is setting it right away assuming is the most updated one.", scene_synchronizer->get_network_interface().get_owner_name());

		apply_snapshot(*last_received_server_snapshot, NetEventFlag::SERVER_UPDATE, 0, nullptr);
		last_received_server_snapshot.reset();
		return;
	}

	NS_ENSURE_MSG(player_controller && player_controller->can_simulate(), "There is no player controller and the only allowed snapshot are the one with `FrameIndex` set to NONE. The current one is set to " + last_received_server_snapshot->input_id + " so it's ignored.");

	PlayerController *inner_player_controller = player_controller->get_player_controller();

#ifdef NS_DEBUG_ENABLED
	if (client_snapshots.empty() == false) {
		// The SceneSynchronizer and the PlayerController are always in sync.
		NS_ASSERT_COND_MSG(client_snapshots.back().input_id == inner_player_controller->last_known_frame_index(), "This should not be possible: snapshot input: " + std::string(client_snapshots.back().input_id) + " last_know_input: " + std::string(inner_player_controller->last_known_frame_index()));
	}
#endif

	if (client_snapshots.empty()) {
		// No client input, this happens when the stream is paused.
		process_paused_controller_recovery();
		scene_synchronizer->event_state_validated.broadcast(last_checked_input, false);
		// Clear the server snapshot.
		last_received_server_snapshot.reset();
		return;
	}

	// Find the best recoverable input_id.
	last_checked_input = last_received_server_snapshot->input_id;

	// Drop all the old client snapshots until the one that we need.
	while (client_snapshots.front().input_id < last_checked_input) {
		client_snapshots.pop_front();
	}

#ifdef NS_DEBUG_ENABLED
	// This can't be triggered because this case is already handled above,
	// by checking last_received_server_snapshot->input_id == FrameIndex::NONE.
	NS_ASSERT_COND(last_checked_input != FrameIndex::NONE);
	if (!client_snapshots.empty()) {
		// This can't be triggered because the client accepts snapshots that are
		// newer (or at least the same) of the last checked one.
		// The client keep all the unprocessed snapshots.
		// NOTE: the -1 check is needed for the cases when the same snapshot is
		//       processed twice (in that case the input_id is already cleared).
		NS_ASSERT_COND(client_snapshots.front().input_id == last_checked_input || (client_snapshots.front().input_id - 1) == last_checked_input);
	}
#endif

	const int frame_count_after_input_id = inner_player_controller->count_frames_after(last_checked_input);

	bool need_rewind;
	Snapshot no_rewind_recover;
	if make_likely(!client_snapshots.empty() && client_snapshots.front().input_id == last_checked_input) {
		// In this case the client is checking the frame for the first time, and
		// this is the most common case.

		need_rewind = __pcr__fetch_recovery_info(
				last_checked_input,
				frame_count_after_input_id,
				*inner_player_controller,
				no_rewind_recover);

		// Popout the client snapshot.
		client_snapshots.pop_front();
	} else {
		// This case is less likely to happen, and in this case the client
		// received the same frame (from the server) twice, so just assume we
		// need a rewind.
		// The server may send the same snapshot twice in case the client has
		// stopped sending their inputs. By rewinding we can make sure the client
		// is not stuck in a dead loop.
		need_rewind = true;
	}

	// --- Phase three: recover and rewind. ---

	if (need_rewind) {
		scene_synchronizer->get_debugger().notify_event(SceneSynchronizerDebugger::FrameEvent::CLIENT_DESYNC_DETECTED);
		scene_synchronizer->get_debugger().print(
				scene_synchronizer->debug_rewindings_log_level,
				std::string("Recover input: ") + std::string(last_checked_input) + " - Last input: " + std::string(inner_player_controller->get_stored_frame_index(-1)),
				scene_synchronizer->get_network_interface().get_owner_name());

		// Sync.
		__pcr__sync__rewind(
				last_checked_input,
				frame_count_after_input_id,
				*inner_player_controller);

		// Emit this signal here, which is when we are 100% sure the snapshot is applied and can be cleared.
		scene_synchronizer->event_state_validated.broadcast(last_checked_input, need_rewind);

		// Rewind.
		__pcr__rewind(
				last_checked_input,
				frame_count_after_input_id,
				player_controller,
				inner_player_controller);
	} else {
		if (no_rewind_recover.input_id == FrameIndex{ { 0 } }) {
			scene_synchronizer->get_debugger().notify_event(SceneSynchronizerDebugger::FrameEvent::CLIENT_DESYNC_DETECTED_SOFT);

			// Sync.
			__pcr__sync__no_rewind(no_rewind_recover);
		}

		// Emit this signal here, which is when we are 100% sure the snapshot is applied and can be cleared.
		scene_synchronizer->event_state_validated.broadcast(last_checked_input, need_rewind);

		// No rewind.
		__pcr__no_rewind(last_checked_input, inner_player_controller);
	}

	// Clear the server snapshot.
	last_received_server_snapshot.reset();
}

bool ClientSynchronizer::__pcr__fetch_recovery_info(
		const FrameIndex p_input_id,
		const int p_rewind_frame_count,
		const PlayerController &p_local_player_controller,
		Snapshot &r_no_rewind_recover) {
	NS_PROFILE
	std::vector<std::string> differences_info;

#ifdef NS_DEBUG_ENABLED
	std::vector<ObjectNetId> different_node_data;
#endif

	bool is_equal = Snapshot::compare(
			*scene_synchronizer,
			*last_received_server_snapshot,
			client_snapshots.front(),
			scene_synchronizer->network_interface->get_local_peer_id(),
			&r_no_rewind_recover,
			scene_synchronizer->debug_rewindings_enabled ? &differences_info : nullptr
#ifdef NS_DEBUG_ENABLED
			,
			&different_node_data
#endif
			);

	if (is_equal) {
		// The snapshots are equals, make sure the dolls doesn't need to be reconciled.
		for (auto &[peer, data] : scene_synchronizer->peer_data) {
			if (data.get_controller() && data.get_controller()->is_doll_controller()) {
				const bool is_doll_state_valid = data.get_controller()->get_doll_controller()->__pcr__fetch_recovery_info(
						p_input_id,
						p_rewind_frame_count,
						&r_no_rewind_recover,
						scene_synchronizer->debug_rewindings_enabled ? &differences_info : nullptr
#ifdef NS_DEBUG_ENABLED
						,
						&different_node_data
#endif
						);

				if (!is_doll_state_valid) {
					// This doll needs a reconciliation.
					is_equal = false;
					break;
				}
			}
		}
	}

#ifdef NS_DEBUG_ENABLED
	// Emit the de-sync detected signal.
	if (!is_equal) {
		std::vector<std::optional<VarData>> server_values;
		std::vector<std::optional<VarData>> client_values;

		for (
			int i = 0;
			i < int(different_node_data.size());
			i += 1) {
			const ObjectNetId net_node_id = different_node_data[i];
			ObjectData *rew_node_data = scene_synchronizer->get_object_data(net_node_id);

			const ObjectDataSnapshot *server_object_vars = ObjectNetId{ { ObjectNetId::IdType(last_received_server_snapshot->objects.size()) } } <= net_node_id ? nullptr : &(last_received_server_snapshot->objects[net_node_id.id]);
			const ObjectDataSnapshot *client_node_vars = ObjectNetId{ { ObjectNetId::IdType(client_snapshots.front().objects.size()) } } <= net_node_id ? nullptr : &(client_snapshots.front().objects[net_node_id.id]);

			const std::size_t count = std::max(server_object_vars ? server_object_vars->vars.size() : 0, client_node_vars ? client_node_vars->vars.size() : 0);

			server_values.resize(count);
			client_values.resize(count);

			for (std::size_t g = 0; g < count; ++g) {
				if (server_object_vars && g < server_object_vars->vars.size() && server_object_vars->vars[g].has_value()) {
					server_values[g].emplace(VarData::make_copy(server_object_vars->vars[g].value()));
				} else {
					server_values[g].reset();
				}

				if (client_node_vars && g < client_node_vars->vars.size() && client_node_vars->vars[g].has_value()) {
					client_values[g].emplace(VarData::make_copy(client_node_vars->vars[g].value()));
				} else {
					client_values[g].reset();
				}
			}

			scene_synchronizer->event_desync_detected_with_info.broadcast(p_input_id, rew_node_data->app_object_handle, client_values, server_values);
		}
	}
#endif

	// Prints the comparison info.
	if (differences_info.size() > 0 && scene_synchronizer->debug_rewindings_enabled) {
		scene_synchronizer->get_debugger().print(scene_synchronizer->debug_rewindings_log_level, "Rewind on frame " + p_input_id + " is needed because:", scene_synchronizer->get_network_interface().get_owner_name());
		for (int i = 0; i < int(differences_info.size()); i++) {
			scene_synchronizer->get_debugger().print(scene_synchronizer->debug_rewindings_log_level, "|- " + differences_info[i], scene_synchronizer->get_network_interface().get_owner_name());
		}
	}

	return !is_equal;
}

void ClientSynchronizer::__pcr__sync__rewind(
		FrameIndex p_last_checked_input_id,
		const int p_rewind_frame_count,
		const PlayerController &p_local_player_controller) {
	NS_PROFILE
	// Apply the server snapshot so to go back in time till that moment,
	// so to be able to correctly reply the movements.

	std::vector<std::string> applied_data_info;

	const Snapshot &server_snapshot = *last_received_server_snapshot;
	apply_snapshot(
			server_snapshot,
			NetEventFlag::SERVER_UPDATE | NetEventFlag::SYNC_RESET,
			p_rewind_frame_count,
			scene_synchronizer->debug_rewindings_enabled ? &applied_data_info : nullptr);

	if (applied_data_info.size() > 0) {
		scene_synchronizer->get_debugger().print(VERBOSE, "Full reset:", scene_synchronizer->get_network_interface().get_owner_name());
		for (int i = 0; i < int(applied_data_info.size()); i++) {
			scene_synchronizer->get_debugger().print(VERBOSE, "|- " + applied_data_info[i], scene_synchronizer->get_network_interface().get_owner_name());
		}
	}
}

void ClientSynchronizer::__pcr__rewind(
		const FrameIndex p_checkable_frame_index,
		const int p_rewind_frame_count,
		PeerNetworkedController *p_local_controller,
		PlayerController *p_local_player_controller) {
	NS_PROFILE
	// At this point the old inputs are cleared out and the remaining one are
	// the predicted inputs it need to rewind.
	const int frames_to_rewind = p_local_player_controller->get_frames_count();
	// The `p_rewind_frame_count` is the same as `frames_to_rewind`, though
	// calculated in a different way. This is just a sanity check.
	NS_ASSERT_COND(frames_to_rewind == p_rewind_frame_count);

#ifdef NS_DEBUG_ENABLED
	// Unreachable because the SceneSynchronizer and the PlayerController
	// have the same stored data at this point: thanks to the `event_state_validated`
	// the NetController clears its stored frames.
	NS_ASSERT_COND_MSG(client_snapshots.size() == size_t(frames_to_rewind), "Beware that `client_snapshots.size()` (" + std::to_string(client_snapshots.size()) + ") and `remaining_inputs` (" + std::to_string(frames_to_rewind) + ") should be the same.");
#endif

#ifdef NS_DEBUG_ENABLED
	// Used to double check all the instants have been processed.
	bool has_next = false;
#endif
	for (int i = 0; i < frames_to_rewind; i += 1) {
		const FrameIndex frame_id_to_process = p_local_player_controller->get_stored_frame_index(i);
#ifdef NS_PROFILING_ENABLED
		std::string prof_info = "Index: " + std::to_string(i) + " Frame ID: " + std::to_string(frame_id_to_process.id);
		NS_PROFILE_NAMED_WITH_INFO("Rewinding frame", prof_info);
#endif

		scene_synchronizer->change_events_begin(NetEventFlag::SERVER_UPDATE | NetEventFlag::SYNC_REWIND);

		// Step 1 -- Notify the local controller about the instant to process
		//           on the next process.
		scene_synchronizer->event_rewind_frame_begin.broadcast(frame_id_to_process, i, frames_to_rewind);
#ifdef NS_DEBUG_ENABLED
		has_next = p_local_controller->has_another_instant_to_process_after(i);
		scene_synchronizer->get_debugger().print(
				VERBOSE,
				"Rewind, processed controller: " + std::to_string(p_local_controller->get_authority_peer()) + " Frame: " + std::string(frame_id_to_process),
				scene_synchronizer->get_network_interface().get_owner_name(),
				scene_synchronizer->debug_rewindings_enabled);
#endif

		// Step 2 -- Process the scene.
		{
			NS_PROFILE_NAMED("process_functions__execute");
			scene_synchronizer->process_functions__execute();
		}

		// Step 3 -- Pull node changes.
		{
			NS_PROFILE_NAMED("detect_and_signal_changed_variables");
			scene_synchronizer->detect_and_signal_changed_variables(NetEventFlag::SERVER_UPDATE | NetEventFlag::SYNC_REWIND);
		}

		// Step 4 -- Update snapshots.
		{
			NS_PROFILE_NAMED("update_client_snapshot");
			update_client_snapshot(client_snapshots[i]);
		}
	}

#ifdef NS_DEBUG_ENABLED
	// Unreachable because the above loop consume all instants, so the last
	// process will set this to false.
	NS_ASSERT_COND(!has_next);
#endif
}

void ClientSynchronizer::__pcr__sync__no_rewind(const Snapshot &p_no_rewind_recover) {
	NS_PROFILE
	NS_ASSERT_COND_MSG(p_no_rewind_recover.input_id == FrameIndex{ { 0 } }, "This function is never called unless there is something to recover without rewinding.");

	// Apply found differences without rewind.
	std::vector<std::string> applied_data_info;

	apply_snapshot(
			p_no_rewind_recover,
			NetEventFlag::SERVER_UPDATE,
			0,
			scene_synchronizer->debug_rewindings_enabled ? &applied_data_info : nullptr,
			// ALWAYS skips custom data because partial snapshots don't contain custom_data.
			true);

	if (applied_data_info.size() > 0) {
		scene_synchronizer->get_debugger().print(VERBOSE, "Partial reset:", scene_synchronizer->get_network_interface().get_owner_name());
		for (int i = 0; i < int(applied_data_info.size()); i++) {
			scene_synchronizer->get_debugger().print(VERBOSE, "|- " + applied_data_info[i], scene_synchronizer->get_network_interface().get_owner_name());
		}
	}

	// Update the last client snapshot.
	if (!client_snapshots.empty()) {
		update_client_snapshot(client_snapshots.back());
	}
}

void ClientSynchronizer::__pcr__no_rewind(
		const FrameIndex p_checkable_input_id,
		PlayerController *p_player_controller) {
	NS_PROFILE
}

void ClientSynchronizer::process_paused_controller_recovery() {
	NS_PROFILE

#ifdef NS_DEBUG_ENABLED
	NS_ASSERT_COND(last_received_server_snapshot);
	NS_ASSERT_COND(client_snapshots.empty());
#endif

	std::vector<std::string> applied_data_info;

	apply_snapshot(
			*last_received_server_snapshot,
			NetEventFlag::SERVER_UPDATE,
			0,
			&applied_data_info);

	last_received_server_snapshot.reset();

	if (applied_data_info.size() > 0) {
		scene_synchronizer->get_debugger().print(VERBOSE, "Paused controller recover:", scene_synchronizer->get_network_interface().get_owner_name());
		for (int i = 0; i < int(applied_data_info.size()); i++) {
			scene_synchronizer->get_debugger().print(VERBOSE, "|- " + applied_data_info[i], scene_synchronizer->get_network_interface().get_owner_name());
		}
	}
}

int ClientSynchronizer::calculates_sub_ticks(const float p_delta) {
	const float frames_per_seconds = 1.0f / p_delta;
	// Extract the frame acceleration:
	// 1. convert the Accelerated Tick Hz to second.
	const float fully_accelerated_delta = 1.0f / (frames_per_seconds + acceleration_fps_speed);

	// 2. Subtract the `accelerated_delta - delta` to obtain the acceleration magnitude.
	const float acceleration_delta = std::abs(fully_accelerated_delta - p_delta);

	// 3. Avoids overshots by taking the smallest value between `acceleration_delta` and the `remaining timer`.
	const float frame_acceleration_delta = std::max(0.0f, std::min(acceleration_delta, acceleration_fps_timer));

	// Updates the timer by removing the extra acceleration.
	acceleration_fps_timer = std::max(acceleration_fps_timer - frame_acceleration_delta, 0.0f);

	// Calculates the pretended delta.
	pretended_delta = p_delta + (frame_acceleration_delta * NS::sign(acceleration_fps_speed));

	// Fetch the process count using the pretended delta.
	const int sub_ticks = scene_synchronizer->fetch_sub_processes_count(pretended_delta);

#ifdef NS_DEBUG_ENABLED
	if (scene_synchronizer->disable_client_sub_ticks) {
		if (sub_ticks > 1) {
			return 1;
		}
	}
#endif

	NS_ENSURE_V_MSG(
			sub_ticks <= scene_synchronizer->get_max_sub_process_per_frame(),
			scene_synchronizer->get_max_sub_process_per_frame(),
			"This client generated a sub tick count of `" + std::to_string(sub_ticks) + "` that is higher than the `max_sub_process_per_frame` specified of `" + std::to_string(scene_synchronizer->get_max_sub_process_per_frame()) + "`. If the number is way too high (like 100 or 1k) it's a bug in the algorithm that you should notify, if it's just above the threshould you set, make sure the threshold is correctly set or ignore it if the client perfs are too poor." +
			" (in delta: " + std::to_string(p_delta) +
			" iteration per seconds: " + std::to_string(scene_synchronizer->get_frames_per_seconds()) +
			" fully_accelerated_delta: " + std::to_string(fully_accelerated_delta) +
			" acceleration_delta: " + std::to_string(acceleration_delta) +
			" frame_acceleration_delta: " + std::to_string(frame_acceleration_delta) +
			" acceleration_fps_speed: " + std::to_string(acceleration_fps_speed) +
			" acceleration_fps_timer: " + std::to_string(acceleration_fps_timer) +
			" pretended_delta: " + std::to_string(pretended_delta) +
			" time_bank: " + std::to_string(scene_synchronizer->get_time_bank()) +
			")");

	return sub_ticks;
}

void ClientSynchronizer::process_simulation(float p_delta) {
	NS_PROFILE

	if make_unlikely(player_controller == nullptr || enabled == false || !player_controller->can_simulate()) {
		// No player controller so can't process the simulation.
		// TODO Remove this constraint?

		// Make sure to fetch changed variable anyway.
		scene_synchronizer->detect_and_signal_changed_variables(NetEventFlag::CHANGE);
		return;
	}

	// Due to some lag we may want to speed up the input_packet
	// generation, for this reason here I'm performing a sub tick.
	//
	// keep in mind that we are just pretending that the time
	// is advancing faster, for this reason we are still using
	// `delta` to step the controllers_node_data.
	//
	// The dolls may want to speed up too, so to consume the inputs faster
	// and get back in time with the server.
	int sub_ticks = calculates_sub_ticks(p_delta);
#ifdef NS_PROFILING_ENABLED
	std::string perf_info = "In delta: " + std::to_string(p_delta) + " sub ticks: " + std::to_string(sub_ticks) + " net frames per seconds: " + std::to_string(scene_synchronizer->get_frames_per_seconds());
	NS_PROFILE_SET_INFO(perf_info);
#endif

	if (sub_ticks == 0) {
		scene_synchronizer->get_debugger().print(VERBOSE, "No sub ticks: this is not bu a bug; it's the lag compensation algorithm.", scene_synchronizer->get_network_interface().get_owner_name());
	}

	while (sub_ticks > 0) {
#ifdef NS_PROFILING_ENABLED
		std::string sub_perf_info = "Fixed delta: " + std::to_string(scene_synchronizer->get_fixed_frame_delta()) + " remaining ticks: " + std::to_string(sub_ticks);
		NS_PROFILE_NAMED_WITH_INFO("PROCESS", sub_perf_info)
#endif
		scene_synchronizer->get_debugger().print(VERBOSE, "ClientSynchronizer::process::sub_process " + std::to_string(sub_ticks), scene_synchronizer->get_network_interface().get_owner_name());
		scene_synchronizer->get_debugger().scene_sync_process_start(*scene_synchronizer);

		// Process the scene.
		scene_synchronizer->process_functions__execute();

		scene_synchronizer->detect_and_signal_changed_variables(NetEventFlag::CHANGE);

		if (player_controller->player_has_new_input()) {
			store_snapshot();
		}

		sub_ticks -= 1;
		scene_synchronizer->get_debugger().scene_sync_process_end(*scene_synchronizer);

#if NS_DEBUG_ENABLED
		if (sub_ticks > 0) {
			// This is an intermediate sub tick, so store the dumlatency.
			// The last sub frame is not dumped, untile the end of the frame, so we can capture any subsequent message.
			const int client_peer = scene_synchronizer->network_interface->get_local_peer_id();
			scene_synchronizer->get_debugger().write_dump(client_peer, player_controller->get_current_frame_index().id);
			scene_synchronizer->get_debugger().start_new_frame();
		}
#endif
	}
}

bool ClientSynchronizer::parse_sync_data(
		DataBuffer &p_snapshot,
		void *p_user_pointer,
		void (*p_notify_update_mode)(void *p_user_pointer, bool p_is_partial_update),
		void (*p_parse_global_frame_index)(void *p_user_pointer, GlobalFrameIndex p_global_frame_index),
		void (*p_custom_data_parse)(void *p_user_pointer, VarData &&p_custom_data),
		void (*p_object_parse)(void *p_user_pointer, ObjectData *p_object_data),
		bool (*p_peers_frame_index_parse)(void *p_user_pointer, std::map<int, FrameIndexWithMeta> &&p_frames_index),
		void (*p_variable_parse)(void *p_user_pointer, ObjectData &p_object_data, VarId p_var_id, VarData &&p_value),
		void (*p_scheduled_procedure_parse)(void *p_user_pointer, ObjectData &p_object_data, ScheduledProcedureId p_procedure_id, ScheduledProcedureSnapshot &&p_value),
		void (*p_simulated_object_add_or_remove_parse)(void *p_user_pointer, bool p_add, SimulatedObjectInfo &&p_simulated_objects),
		void (*p_simulated_objects_parse)(void *p_user_pointer, std::vector<SimulatedObjectInfo> &&p_simulated_objects)) {
	NS_PROFILE

	// The snapshot is a DataBuffer that contains the scene information.
	// NOTE: Check generate_snapshot to see the DataBuffer format.
	std::map<int, FrameIndexWithMeta> frames_index;

	p_snapshot.begin_read(get_debugger());
	if (p_snapshot.size() <= 0) {
		// Nothing to do.
		return true;
	}

	{
		// Fetch the update mode of this snapshot.
		bool is_partial_update;
		p_snapshot.read(is_partial_update);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as the `is_partial_update` boolean expected is not set.");
		p_notify_update_mode(p_user_pointer, is_partial_update);
	}

	{
		// Fetch the global frame index
		GlobalFrameIndex GFI;
		p_snapshot.read(GFI.id);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as the `GlobalFrameIndex` expected is not set.");
		p_parse_global_frame_index(p_user_pointer, GFI);
	}

	std::vector<SimulatedObjectInfo> sd_simulated_objects_full_array;
	sd_simulated_objects_full_array.reserve(scene_synchronizer->get_all_object_data().size());

	{
		// Fetch the peer information
		while (true) {
			bool has_next_peer_info = false;
			p_snapshot.read(has_next_peer_info);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `has_next_peer_info` failed.");

			if (!has_next_peer_info) {
				// Array is empty now.
				break;
			}

			// Fetch the peer
			int peer;
			p_snapshot.read(peer);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `peer` failed.");

			std::map<int, PeerData>::iterator peer_data_it = MapFunc::insert_if_new(scene_synchronizer->peer_data, peer, PeerData());

			// Fetch the frame index
			FrameIndex frame_index;
			p_snapshot.read(frame_index.id);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching the peer `frame_index` failed.");

			MapFunc::assign(frames_index, peer, FrameIndexWithMeta(frame_index));

			// Fetch the latency
			bool has_latency;
			p_snapshot.read(has_latency);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching the peer `has_latency` failed.");

			if (has_latency) {
				std::uint8_t compressed_latency;
				p_snapshot.read(compressed_latency);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `compressed_latency` failed.");

				peer_data_it->second.set_compressed_latency(compressed_latency);
			}

			// Fetch the controlled objects?
			// Fetch the simulated object info for all the objects controlled by this peer.
			// Fetch the update type (FULL | INCREMENTAL)
			bool is_simulated_object_array_full_update;
			p_snapshot.read(is_simulated_object_array_full_update);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as the `is_full_update` boolean expected is not set.");

			if (is_simulated_object_array_full_update) {
				// Fetch the array.
				while (true) {
					ObjectNetId id;
					p_snapshot.read(id.id);
					NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `ObjectNetId` failed.");

					if (id == ObjectNetId::NONE) {
						// The end.
						break;
					}

					sd_simulated_objects_full_array.push_back(SimulatedObjectInfo(id, peer));
				}
			} else {
				// Fetch the array.
				while (true) {
					bool has_net_id;
					p_snapshot.read(has_net_id);
					NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `has_net_id` failed.");

					if (!has_net_id) {
						// We reached the end of the array.
						break;
					}

					ObjectNetId id;
					p_snapshot.read(id.id);
					NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `ObjectNetId` failed.");

					// NOTE: No need to fetch the was_added as done below because
					// objects associated to a peer are always added;
					// When they are removed the peer is not assigned and they
					// are retrieved below.
					const bool was_added = true;

					p_simulated_object_add_or_remove_parse(p_user_pointer, was_added, SimulatedObjectInfo(id, peer));
				}
			}
		}
	}

	{
		// Fetch the simulated object info for all the objects not controlled by a peer.
		// Fetch the update type (FULL | PARTIAL)
		bool is_simulated_object_array_full_update;
		p_snapshot.read(is_simulated_object_array_full_update);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as the `is_full_update` boolean expected is not set.");

		if (is_simulated_object_array_full_update) {
			// Fetch the array.
			while (true) {
				ObjectNetId id;
				p_snapshot.read(id.id);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `ObjectNetId` failed.");

				if (id == ObjectNetId::NONE) {
					// The end.
					break;
				}

				sd_simulated_objects_full_array.push_back(SimulatedObjectInfo(id, -1));
			}

			p_simulated_objects_parse(p_user_pointer, std::move(sd_simulated_objects_full_array));
		} else {
			// In normal conditions this can't trigger because the generator
			// can't compose a snapshot that has both full array and incremental changes.
			NS_ENSURE_V_MSG(sd_simulated_objects_full_array.empty(), false, "This snapshot is corrupted because the sd_simulated_object_full_array is expected to be empty at this point.");

			// Fetch the array.
			while (true) {
				bool has_net_id;
				p_snapshot.read(has_net_id);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `has_net_id` failed.");

				if (!has_net_id) {
					// We reached the end of the array.
					break;
				}

				ObjectNetId id;
				p_snapshot.read(id.id);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `ObjectNetId` failed.");

				bool was_added;
				p_snapshot.read(was_added);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted as fetching `was_added` failed.");

				p_simulated_object_add_or_remove_parse(p_user_pointer, was_added, SimulatedObjectInfo(id, -1));
			}
		}
	}

	{
		bool has_custom_data = false;
		p_snapshot.read(has_custom_data);
		if (has_custom_data) {
			VarData vd;
			SceneSynchronizerBase::var_data_decode(vd, p_snapshot, scene_synchronizer->get_synchronizer_manager().snapshot_get_custom_data_type());
			p_custom_data_parse(p_user_pointer, std::move(vd));
		}
	}

	while (true) {
		// First extract the object data
		ObjectData *synchronizer_object_data = nullptr;
		ObjectNetId net_id = ObjectNetId::NONE;
		{
			p_snapshot.read(net_id.id);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The NetId was expected at this point.");

			if (net_id == ObjectNetId::NONE) {
				// All the Objects fetched.
				break;
			}

			bool has_object_name = false;
			p_snapshot.read(has_object_name);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `has_object_name` was expected at this point.");

			std::string object_name;
			if (has_object_name) {
				// Extract the object name
				p_snapshot.read(object_name);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `object_name` was expected at this point.");

				// Associate the ID with the path.
				objects_names.insert(std::pair(net_id, object_name));
			}

			// Fetch the ObjectData.
			synchronizer_object_data = scene_synchronizer->get_object_data(net_id, false);
			if (!synchronizer_object_data) {
				// ObjectData not found, fetch it using the object name.

				if (object_name.empty()) {
					// The object_name was not specified by this snapshot, so fetch it.
					const std::string *object_name_ptr = MapFunc::get_or_null(objects_names, net_id);

					if (object_name_ptr == nullptr) {
						// The name for this `NetId` doesn't exists yet.
						scene_synchronizer->get_debugger().print(WARNING, "The object with ID `" + net_id + "` is not know by this peer yet.");
						notify_server_full_snapshot_is_needed();
					} else {
						object_name = *object_name_ptr;
					}
				}

				// Now fetch the object handle
				const ObjectHandle app_object_handle =
						scene_synchronizer->synchronizer_manager->fetch_app_object(object_name);

				if (app_object_handle == ObjectHandle::NONE) {
					// The node doesn't exists.
					scene_synchronizer->get_debugger().print(WARNING, "The object `" + object_name + "` still doesn't exist. NetId: " + std::to_string(net_id.id), scene_synchronizer->get_network_interface().get_owner_name());
				} else {
					// Register this object, so to make sure the client is tracking it.
					ObjectLocalId reg_obj_id;
					scene_synchronizer->register_app_object(app_object_handle, &reg_obj_id);
					if (reg_obj_id != ObjectLocalId::NONE) {
						synchronizer_object_data = scene_synchronizer->get_object_data(reg_obj_id);
						// Set the NetId.
						synchronizer_object_data->set_net_id(net_id);
					} else {
						scene_synchronizer->get_debugger().print(ERROR, "[BUG] This object `" + object_name + "` was known on this client. Though, was not possible to register it as sync object.", scene_synchronizer->get_network_interface().get_owner_name());
					}
				}
			}
		}

		const bool skip_object = synchronizer_object_data == nullptr;

		if (!skip_object) {
#ifdef NS_DEBUG_ENABLED
			// At this point the ID is never ObjectNetId::NONE thanks to the above
			// mechanism.
			NS_ASSERT_COND(synchronizer_object_data->get_net_id() != ObjectNetId::NONE);
#endif

			p_object_parse(p_user_pointer, synchronizer_object_data);
		}

		// Now it's time to fetch the variables.
		std::uint16_t vars_size_in_bits;
		p_snapshot.read(vars_size_in_bits);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `vars_count` was expected here.");

		if (skip_object) {
			if (net_id != ObjectNetId::NONE) {
				// Store the snapshot information so we can use them to sync the
				// late registered object as soon as it's registered.
				DataBuffer object_snapshot_buffer;
				object_snapshot_buffer.begin_write(get_debugger(), 0);
				const bool slicing_success = p_snapshot.slice(object_snapshot_buffer, p_snapshot.get_bit_offset(), vars_size_in_bits);
#if NS_DEBUG_ENABLED
				if (scene_synchronizer->pedantic_checks) {
					NS_ASSERT_COND(slicing_success);
					NS_ASSERT_COND(object_snapshot_buffer.get_bit_offset() == vars_size_in_bits);
				}
#endif
				if (!slicing_success || object_snapshot_buffer.get_bit_offset() != vars_size_in_bits) {
					get_debugger().print(ERROR, "The received snapshot is corrupted because it was impossible to properly slice the Object info using the encoded size. This should never happen.");
					notify_server_full_snapshot_is_needed();
					return false;
				}
				// Store the extracted object info.
				std::vector<DataBuffer> &pending_snapshots = MapFunc::insert_if_new(objects_pending_snapshots, net_id, std::vector<DataBuffer>())->second;
				pending_snapshots.push_back(std::move(object_snapshot_buffer));
				get_debugger().print(INFO, "The object info snapshot was sliced and stored into the pending snapshots. ObjectID: " + std::to_string(net_id.id));
			} else {
				// This is not possible because NetID NONE signals the end of the
				// buffer and this is never reached.
				NS_ASSERT_NO_ENTRY_MSG("The parse_sync_data function was unable to store the object information for a late restore because the NetId is NONE.");
			}

			// Skip the object data now.
			p_snapshot.seek(p_snapshot.get_bit_offset() + vars_size_in_bits);
		} else {
			if (!parse_sync_data_object_info(
					p_snapshot,
					p_user_pointer,
					*synchronizer_object_data,
					p_variable_parse,
					p_scheduled_procedure_parse)) {
				return false;
			}
		}
	}

	NS_ENSURE_V_MSG(p_peers_frame_index_parse(p_user_pointer, std::move(frames_index)), false, "This snapshot is corrupted as the frame index parsing failed.");

	return true;
}

bool ClientSynchronizer::parse_sync_data_object_info(
		DataBuffer &p_snapshot,
		void *p_user_pointer,
		ObjectData &p_object_data,
		void (*p_variable_parse)(void *p_user_pointer, ObjectData &p_object_data, VarId p_var_id, VarData &&p_value),
		void (*p_scheduled_procedure_parse)(void *p_user_pointer, ObjectData &p_object_data, ScheduledProcedureId p_procedure_id, ScheduledProcedureSnapshot &&p_value)) {
	for (auto &var_desc : p_object_data.vars) {
		bool var_has_value = false;
		p_snapshot.read(var_has_value);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `var_has_value` was expected at this point. Object: `" + p_object_data.get_object_name() + "` Var: `" + var_desc.var.name + "`");

		if (var_has_value) {
			VarData value;
			SceneSynchronizerBase::var_data_decode(value, p_snapshot, var_desc.type);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `variable value` was expected at this point. Object: `" + p_object_data.get_object_name() + "` Var: `" + var_desc.var.name + "`");

			// Variable fetched, now parse this variable.
			p_variable_parse(
					p_user_pointer,
					p_object_data,
					var_desc.id,
					std::move(value));
		}
	}

	for (ScheduledProcedureId procedure_id = { 0 }; procedure_id.id < p_object_data.get_scheduled_procedures().size(); procedure_id += 1) {
		bool has_procedure_value = false;
		p_snapshot.read(has_procedure_value);
		NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `has_procedure_value` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
		if (has_procedure_value) {
			bool is_procedure_in_progress = false;
			p_snapshot.read(is_procedure_in_progress);
			NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `is_procedure_in_progress` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");

			ScheduledProcedureSnapshot procedure_snapshot;
			if (is_procedure_in_progress) {
				p_snapshot.read(procedure_snapshot.execute_frame.id);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `execute_frame` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
				p_snapshot.read(procedure_snapshot.args);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `args` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
			} else {
				bool is_procedure_paused = false;
				p_snapshot.read(is_procedure_paused);
				NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `is_procedure_paused` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
				if (is_procedure_paused) {
					p_snapshot.read(procedure_snapshot.execute_frame.id);
					NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `execute_frame` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
					p_snapshot.read(procedure_snapshot.paused_frame.id);
					NS_ENSURE_V_MSG(!p_snapshot.is_buffer_failed(), false, "This snapshot is corrupted. The `paused_frame` was expected at this point. Object: `" + p_object_data.get_object_name() + "`");
				}
			}

			p_scheduled_procedure_parse(p_user_pointer, p_object_data, procedure_id, std::move(procedure_snapshot));
		}
	}

	return true;
}


void ClientSynchronizer::set_enabled(bool p_enabled) {
	if (enabled == p_enabled) {
		// Nothing to do.
		return;
	}

	if (p_enabled) {
		// Postpone enabling when the next server snapshot is received.
		want_to_enable = true;
	} else {
		// Disabling happens immediately.
		enabled = false;
		want_to_enable = false;
		scene_synchronizer->event_sync_paused.broadcast();
	}
}

void ClientSynchronizer::receive_trickled_sync_data(const std::vector<std::uint8_t> &p_data) {
	DataBuffer future_epoch_buffer(BitArray(get_debugger(), p_data));
	future_epoch_buffer.begin_read(get_debugger());

	int remaining_size = future_epoch_buffer.size() - future_epoch_buffer.get_bit_offset();
	if (remaining_size < future_epoch_buffer.get_bit_taken(DataBuffer::DATA_TYPE_UINT, DataBuffer::COMPRESSION_LEVEL_1)) {
		scene_synchronizer->get_debugger().print(ERROR, "[FATAL] The function `receive_trickled_sync_data` received malformed data.", scene_synchronizer->get_network_interface().get_owner_name());
		// Nothing to fetch.
		return;
	}

	const uint32_t epoch = (std::uint32_t)future_epoch_buffer.read_uint(DataBuffer::COMPRESSION_LEVEL_1);

	DataBuffer db(get_debugger());

	while (true) {
		// 1. Decode the received data.
		remaining_size = future_epoch_buffer.size() - future_epoch_buffer.get_bit_offset();
		if (remaining_size < future_epoch_buffer.get_bool_size()) {
			// buffer entirely consumed, nothing else to do.
			break;
		}

		// Fetch the `node_id`.
		ObjectNetId object_id = ObjectNetId::NONE;
		if (future_epoch_buffer.read_bool()) {
			remaining_size = future_epoch_buffer.size() - future_epoch_buffer.get_bit_offset();
			if (remaining_size < future_epoch_buffer.get_uint_size(DataBuffer::COMPRESSION_LEVEL_2)) {
				// buffer entirely consumed, nothing else to do.
				break;
			}

			object_id.id = (ObjectNetId::IdType)future_epoch_buffer.read_uint(DataBuffer::COMPRESSION_LEVEL_2);
		} else {
			if (remaining_size < future_epoch_buffer.get_uint_size(DataBuffer::COMPRESSION_LEVEL_3)) {
				// buffer entirely consumed, nothing else to do.
				break;
			}
			object_id.id = (ObjectNetId::IdType)future_epoch_buffer.read_uint(DataBuffer::COMPRESSION_LEVEL_3);
		}

		remaining_size = future_epoch_buffer.size() - future_epoch_buffer.get_bit_offset();
		if (remaining_size < future_epoch_buffer.get_uint_size(DataBuffer::COMPRESSION_LEVEL_2)) {
			// buffer entirely consumed, nothing else to do.
			break;
		}
		const int buffer_bit_count = (int)future_epoch_buffer.read_uint(DataBuffer::COMPRESSION_LEVEL_2);

		remaining_size = future_epoch_buffer.size() - future_epoch_buffer.get_bit_offset();
		if (remaining_size < buffer_bit_count) {
			scene_synchronizer->get_debugger().print(ERROR, "The function `receive_trickled_sync_data` failed applying the epoch because the received buffer is malformed. The node with ID `" + object_id + "` reported that the sub buffer size is `" + std::to_string(buffer_bit_count) + "` but the main-buffer doesn't have so many bits.", scene_synchronizer->get_network_interface().get_owner_name());
			break;
		}

		const int current_offset = future_epoch_buffer.get_bit_offset();
		const int expected_bit_offset_after_apply = current_offset + buffer_bit_count;

		ObjectData *od = scene_synchronizer->get_object_data(object_id, false);
		if (od == nullptr) {
			scene_synchronizer->get_debugger().print(VERBOSE, "The function `receive_trickled_sync_data` is skip latency the object with ID `" + object_id + "` as it was not found locally.", scene_synchronizer->get_network_interface().get_owner_name());
			future_epoch_buffer.seek(expected_bit_offset_after_apply);
			continue;
		}

		std::vector<uint8_t> future_buffer_data;
		future_buffer_data.resize(std::size_t(std::ceil(float(buffer_bit_count) / 8.0f)));
		future_epoch_buffer.read_bits(future_buffer_data.data(), buffer_bit_count);
		NS_ASSERT_COND_MSG(future_epoch_buffer.get_bit_offset() == expected_bit_offset_after_apply, "At this point the buffer is expected to be exactly at this bit.");

		std::size_t index = VecFunc::find_index(trickled_sync_array, TrickledSyncInterpolationData(od, get_debugger()));
		if (index == VecFunc::index_none()) {
			index = trickled_sync_array.size();
			trickled_sync_array.push_back(TrickledSyncInterpolationData(od, get_debugger()));
		}
		TrickledSyncInterpolationData &stream = trickled_sync_array[index];
#ifdef NS_DEBUG_ENABLED
		NS_ASSERT_COND(stream.od == od);
#endif
		stream.future_epoch_buffer.copy(BitArray(get_debugger(), future_buffer_data));

		stream.past_epoch_buffer.begin_write(get_debugger(), 0);

		// 2. Now collect the past epoch buffer by reading the current values.
		db.begin_write(get_debugger(), 0);

		if (!stream.od->func_trickled_collect) {
			scene_synchronizer->get_debugger().print(VERBOSE, "The function `receive_trickled_sync_data` is skip latency the object `" + stream.od->get_object_name() + "` as the function `trickled_collect` failed executing.", scene_synchronizer->get_network_interface().get_owner_name());
			future_epoch_buffer.seek(expected_bit_offset_after_apply);
			continue;
		}

		if (stream.past_epoch != UINT32_MAX) {
			stream.od->func_trickled_collect(db, 1.0);
			stream.past_epoch_buffer.copy(db);
		} else {
			// Streaming not started.
			stream.past_epoch_buffer.copy(stream.future_epoch_buffer);
		}

		// 3. Initialize the past_epoch and the future_epoch.
		stream.past_epoch = stream.future_epoch;
		stream.future_epoch = epoch;

		// Reset the alpha so we can start interpolating.
		stream.alpha = 0.0;
		if (stream.past_epoch < stream.future_epoch) {
			stream.epochs_timespan = (float(stream.future_epoch) - float(stream.past_epoch)) * scene_synchronizer->get_fixed_frame_delta();
		} else {
			// The interpolation didn't start yet, so put the span to 0.0
			stream.epochs_timespan = 0.0;
		}
	}
}

void ClientSynchronizer::process_trickled_sync(float p_delta) {
	NS_PROFILE

	DataBuffer db1(get_debugger());
	DataBuffer db2(get_debugger());

	for (TrickledSyncInterpolationData &stream : trickled_sync_array) {
		if (stream.epochs_timespan <= 0.001) {
			// The stream is not yet started.
			// OR
			// The stream for this node is stopped as the data received is old.
			continue;
		}

		NS::ObjectData *od = stream.od;
		if (od == nullptr) {
			scene_synchronizer->get_debugger().print(ERROR, "The function `process_received_trickled_sync_data` found a null NodeData into the `trickled_sync_array`; this is not supposed to happen.", scene_synchronizer->get_network_interface().get_owner_name());
			continue;
		}

#ifdef NS_DEBUG_ENABLED
		if (!od->func_trickled_apply) {
			scene_synchronizer->get_debugger().print(ERROR, "The function `process_received_trickled_sync_data` skip the node `" + od->get_object_name() + "` has an invalid apply epoch function named `trickled_apply`. Remotely you used the function `setup_trickled_sync` properly, while locally you didn't. Fix it.", scene_synchronizer->get_network_interface().get_owner_name());
			continue;
		}
#endif

		stream.alpha += p_delta / stream.epochs_timespan;
		stream.alpha = std::min(stream.alpha, scene_synchronizer->get_max_trickled_interpolation_alpha());
		stream.past_epoch_buffer.begin_read(get_debugger());
		stream.future_epoch_buffer.begin_read(get_debugger());

		db1.copy(stream.past_epoch_buffer);
		db2.copy(stream.future_epoch_buffer);
		db1.begin_read(get_debugger());
		db2.begin_read(get_debugger());

		od->func_trickled_apply(p_delta, stream.alpha, db1, db2);
	}
}

void ClientSynchronizer::remove_object_from_trickled_sync(NS::ObjectData *p_object_data) {
	VecFunc::remove_unordered(trickled_sync_array, TrickledSyncInterpolationData(p_object_data, get_debugger()));
}

bool ClientSynchronizer::parse_snapshot(DataBuffer &p_snapshot, bool p_is_server_snapshot) {
	if (want_to_enable) {
		if (enabled) {
			scene_synchronizer->get_debugger().print(ERROR, "At this point the client is supposed to be disabled. This is a bug that must be solved.", scene_synchronizer->get_network_interface().get_owner_name());
		}
		// The netwroking is disabled and we can re-enable it.
		enabled = true;
		want_to_enable = false;
		scene_synchronizer->event_sync_started.broadcast();
	}

	need_full_snapshot_notified = false;

	RollingUpdateSnapshot received_snapshot;
	received_snapshot.copy(last_received_snapshot);
	received_snapshot.input_id = FrameIndex::NONE;

#ifdef NS_DEBUG_ENABLED
	// Ensure these properties are not set at this point.
	NS_ASSERT_COND(!received_snapshot.was_partially_updated);
	NS_ASSERT_COND(!received_snapshot.is_just_updated_simulated_objects);
	NS_ASSERT_COND(!received_snapshot.is_just_updated_custom_data);
	NS_ASSERT_COND(received_snapshot.just_updated_object_vars.size() == 0);
#endif

	struct ParseData {
		RollingUpdateSnapshot &snapshot;
		PeerNetworkedController *player_controller;
		SceneSynchronizerBase *scene_synchronizer;
		ClientSynchronizer *client_synchronizer;
		bool is_server_snapshot;
	};

	ParseData parse_data{
		received_snapshot,
		player_controller,
		scene_synchronizer,
		this,
		p_is_server_snapshot
	};

	const bool success = parse_sync_data(
			p_snapshot,
			&parse_data,

			// Notify update mode:
			[](void *p_user_pointer, bool p_is_partial_update) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);
				// When the partial update is set to true the server didn't
				// send all the changed objects of the SyncGroup.
				pd->snapshot.was_partially_updated = p_is_partial_update;
			},

			[](void *p_user_pointer, GlobalFrameIndex p_global_frame_index) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);
				pd->snapshot.global_frame_index = p_global_frame_index;
			},

			// Custom data:
			[](void *p_user_pointer, VarData &&p_custom_data) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);
				pd->snapshot.has_custom_data = true;
				pd->snapshot.custom_data = std::move(p_custom_data);
				pd->snapshot.is_just_updated_custom_data = true;
			},

			// Parse object:
			[](void *p_user_pointer, ObjectData *p_object_data) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);

#ifdef NS_DEBUG_ENABLED
				// This function should never receive undefined IDs.
				NS_ASSERT_COND(p_object_data->get_net_id() != ObjectNetId::NONE);
#endif

				pd->snapshot.just_updated_object_vars.push_back(p_object_data->get_net_id());

				// Make sure this node is part of the server node too.
				if (uint32_t(pd->snapshot.objects.size()) <= p_object_data->get_net_id().id) {
					pd->snapshot.objects.resize(p_object_data->get_net_id().id + 1);
				}
			},

			// Parse peer frames index
			[](void *p_user_pointer, std::map<int, FrameIndexWithMeta> &&p_peers_frames_index) -> bool {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);

				// Extract the InputID for the controller processed as Authority by this client.
				const FrameIndexWithMeta authority_frame_index_meta = pd->player_controller ? MapFunc::at(p_peers_frames_index, pd->player_controller->get_authority_peer(), FrameIndexWithMeta()) : FrameIndexWithMeta();

				// Store it.
				pd->snapshot.input_id = authority_frame_index_meta.frame_index;

				for (auto &[peer, meta] : p_peers_frames_index) {
					meta.is_server_validated = pd->is_server_snapshot;
				}

				// Store the frames index.
				pd->snapshot.peers_frames_index = std::move(p_peers_frames_index);

#ifdef NS_DEBUG_ENABLED
				// Assert that the FrameIndex were properly moved.
				for (const auto &[peer, meta] : pd->snapshot.peers_frames_index) {
					NS_ASSERT_COND(meta.is_server_validated == pd->is_server_snapshot);
				}
#endif

				return true;
			},

			// Parse variable:
			[](void *p_user_pointer, ObjectData &p_object_data, VarId p_var_id, VarData &&p_value) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);

				if (p_object_data.vars.size() != uint32_t(pd->snapshot.objects[p_object_data.get_net_id().id].vars.size())) {
					// The parser may have added a variable, so make sure to resize the vars array.
					pd->snapshot.objects[p_object_data.get_net_id().id].vars.resize(p_object_data.vars.size());
				}

				if (pd->snapshot.objects[p_object_data.get_net_id().id].vars.size() > p_var_id.id) {
					pd->snapshot.objects[p_object_data.get_net_id().id].vars[p_var_id.id].emplace(std::move(p_value));
				}
			},

			// Parse scheduled procedure:
			[](void *p_user_pointer, ObjectData &p_object_data, ScheduledProcedureId p_procedure_id, ScheduledProcedureSnapshot &&p_procedure_snapshot) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);

				if (p_object_data.get_scheduled_procedures().size() != uint32_t(pd->snapshot.objects[p_object_data.get_net_id().id].procedures.size())) {
					// The parser may have added a procedure, so make sure to resize the procedure array.
					pd->snapshot.objects[p_object_data.get_net_id().id].procedures.resize(p_object_data.get_scheduled_procedures().size());
				}

				if (pd->snapshot.objects[p_object_data.get_net_id().id].procedures.size() > p_procedure_id.id) {
					pd->snapshot.objects[p_object_data.get_net_id().id].procedures[p_procedure_id.id] = std::move(p_procedure_snapshot);
				}
			},

			// Parse object activation:
			[](void *p_user_pointer, bool p_add, SimulatedObjectInfo &&p_simulated_objects) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);
				if (p_add) {
					VecFunc::insert_unique(pd->snapshot.simulated_objects, std::move(p_simulated_objects));
				} else {
					VecFunc::remove_unordered(pd->snapshot.simulated_objects, p_simulated_objects);
				}
				pd->snapshot.is_just_updated_simulated_objects = true;
			},

			// Parse objects activation:
			[](void *p_user_pointer, std::vector<SimulatedObjectInfo> &&p_simulated_objects) {
				ParseData *pd = static_cast<ParseData *>(p_user_pointer);
				pd->snapshot.simulated_objects = std::move(p_simulated_objects);
				pd->snapshot.is_just_updated_simulated_objects = true;
			});

	if (success == false) {
		scene_synchronizer->get_debugger().print(ERROR, "Snapshot parsing failed.", scene_synchronizer->get_network_interface().get_owner_name());
		return false;
	}

	if make_unlikely(received_snapshot.input_id == FrameIndex::NONE && player_controller && player_controller->can_simulate()) {
		// We espect that the player_controller is updated by this new snapshot,
		// so make sure it's done so.
		scene_synchronizer->get_debugger().print(ERROR, "The player controller (" + std::to_string(player_controller->get_authority_peer()) + ") was not part of the received snapshot, this happens when the server destroys the peer controller.");
	}

	last_received_snapshot = std::move(received_snapshot);

	// Success.
	return true;
}

void ClientSynchronizer::finalize_object_data_synchronization(ObjectData &p_object_data) {
	if (p_object_data.get_net_id() == ObjectNetId::NONE) {
		// The NetId is not assigned but it might already be sync, check it.
		if (p_object_data.get_object_name().empty()) {
			// The object name is not specified either, so there is no way to retrieve the NetId for now.
			return;
		}
		for (auto &[net_id,name] : objects_names) {
			if (name == p_object_data.get_object_name()) {
				// NetId found!
				p_object_data.set_net_id(net_id);
				get_debugger().print(INFO, "The object data finalization was able to fetch the object NetID using the object name. Object name `" + p_object_data.get_object_name() + "`, NetId `" + std::to_string(p_object_data.get_net_id().id) + "`");
				break;
			}
		}
	}

	if (p_object_data.get_net_id() == ObjectNetId::NONE) {
		// The NetId is still unknown for this ObjectData, nothing to.
		get_debugger().print(INFO, "The object data finalization failed because it was unable to retrive the NetID for the object with name `" + p_object_data.get_object_name() + "`. It will re-try later.");
		return;
	}

	std::vector<DataBuffer> *pending_snapshots = MapFunc::get_or_null(objects_pending_snapshots, p_object_data.get_net_id());
	if (!pending_snapshots || pending_snapshots->size() <= 0) {
		// Nothing pending to initialize.
		return;
	}

	struct PendingObjectSnapshotsParseData {
		RollingUpdateSnapshot &snapshot;
		SceneSynchronizerBase *scene_synchronizer;
		ClientSynchronizer *client_synchronizer;
	};

	PendingObjectSnapshotsParseData parse_data{
		last_received_snapshot,
		scene_synchronizer,
		this,
	};

	// Make sure this node is part of the server node too.
	if (uint32_t(parse_data.snapshot.objects.size()) <= p_object_data.get_net_id().id) {
		parse_data.snapshot.objects.resize(p_object_data.get_net_id().id + 1);
	}

	for (DataBuffer &snapshot : *pending_snapshots) {
		snapshot.begin_read(get_debugger());
		const bool parsing_success = parse_sync_data_object_info(
				snapshot,
				&parse_data,
				p_object_data,

				// Parse variable:
				[](void *p_user_pointer, ObjectData &p_object_data, VarId p_var_id, VarData &&p_value) {
					PendingObjectSnapshotsParseData *pd = static_cast<PendingObjectSnapshotsParseData *>(p_user_pointer);

					if (p_object_data.vars.size() != uint32_t(pd->snapshot.objects[p_object_data.get_net_id().id].vars.size())) {
						// The parser may have added a variable, so make sure to resize the vars array.
						pd->snapshot.objects[p_object_data.get_net_id().id].vars.resize(p_object_data.vars.size());
					}

					if (pd->snapshot.objects[p_object_data.get_net_id().id].vars.size() > p_var_id.id) {
						// Updates the actual value.
						p_object_data.vars[p_var_id.id].set_func(
								pd->scene_synchronizer->get_synchronizer_manager(),
								p_object_data.app_object_handle,
								p_object_data.vars[p_var_id.id].var.name,
								p_value);

						// Save the variable into the local snapshot, so increamental updates works fine.
						pd->snapshot.objects[p_object_data.get_net_id().id].vars[p_var_id.id].emplace(std::move(p_value));
					}
				},

				// Parse scheduled procedure:
				[](void *p_user_pointer, ObjectData &p_object_data, ScheduledProcedureId p_procedure_id, ScheduledProcedureSnapshot &&p_procedure_snapshot) {
					PendingObjectSnapshotsParseData *pd = static_cast<PendingObjectSnapshotsParseData *>(p_user_pointer);

					if (p_object_data.get_scheduled_procedures().size() != uint32_t(pd->snapshot.objects[p_object_data.get_net_id().id].procedures.size())) {
						// The parser may have added a procedure, so make sure to resize the procedure array.
						pd->snapshot.objects[p_object_data.get_net_id().id].procedures.resize(p_object_data.get_scheduled_procedures().size());
					}

					if (pd->snapshot.objects[p_object_data.get_net_id().id].procedures.size() > p_procedure_id.id) {
						// Updates the actual value.
						p_object_data.scheduled_procedure_reset_to(p_procedure_id, p_procedure_snapshot);

						// Save the variable into the local snapshot, so incremental updates works fine.
						pd->snapshot.objects[p_object_data.get_net_id().id].procedures[p_procedure_id.id] = std::move(p_procedure_snapshot);
					}
				});

#if NS_DEBUG_ENABLED
		if (scene_synchronizer->pedantic_checks) {
			NS_ASSERT_COND(!snapshot.is_buffer_failed());
			NS_ASSERT_COND(snapshot.is_end_of_buffer());
			NS_ASSERT_COND_MSG(parsing_success, "This can't be triggered unless there is a bug because in the context of integration tests the snapshot can't corrupt, so if this triggered there is a bug.");
		}
#endif

		if (!parsing_success) {
			get_debugger().print(ERROR, "A parsing error occurred while reading a pending object info. The parsing was aborted, but the snapshot parsing is not supposed to be corrupted, investigate!");
			notify_server_full_snapshot_is_needed();
			return;
		}

		get_debugger().print(INFO, "The object data finalization applied " + std::to_string(pending_snapshots->size()) + " pending snapshots on the object name `" + p_object_data.get_object_name() + "`, NetId `" + std::to_string(p_object_data.get_net_id().id) + "`.");
	}

	// Object initialize, we can finally erase it.
	objects_pending_snapshots.erase(p_object_data.get_net_id());
}

void ClientSynchronizer::notify_server_full_snapshot_is_needed() {
	if (need_full_snapshot_notified) {
		return;
	}

	// Notify the server that a full snapshot is needed.
	need_full_snapshot_notified = true;
	scene_synchronizer->rpc_handler_notify_need_full_snapshot.rpc(
			scene_synchronizer->get_network_interface(),
			scene_synchronizer->network_interface->get_server_peer());

	// No need to keep track of these, since a new snapshot is going to override everything.
	objects_pending_snapshots.clear();
}

void ClientSynchronizer::update_client_snapshot(Snapshot &r_snapshot) {
	NS_PROFILE

	r_snapshot.simulated_objects = simulated_objects;
	r_snapshot.global_frame_index = scene_synchronizer->global_frame_index;

	{
		NS_PROFILE_NAMED("Fetch `custom_data`");
		r_snapshot.has_custom_data = scene_synchronizer->synchronizer_manager->snapshot_get_custom_data(nullptr, false, std::vector<std::size_t>(), r_snapshot.custom_data);
#ifdef NS_DEBUG_ENABLED
		if (r_snapshot.has_custom_data) {
			NS_ASSERT_COND_MSG(r_snapshot.custom_data.type == scene_synchronizer->synchronizer_manager->snapshot_get_custom_data_type(), "Ensure the custom data type equals the one returned by `snapshot_get_custom_data_type`.");
		}
#endif
	}

	// Make sure we have room for all the NodeData.
	r_snapshot.objects.resize(scene_synchronizer->objects_data_storage.get_sorted_objects_data().size());

	// Updates the Peers executed FrameIndex
	r_snapshot.peers_frames_index.clear();
	for (const auto &[peer, data] : scene_synchronizer->peer_data) {
		if (data.controller) {
			MapFunc::assign(r_snapshot.peers_frames_index, peer, FrameIndexWithMeta(false, data.controller->get_current_frame_index()));
		}
	}

	// Create the snapshot, even for the objects controlled by the dolls.
	for (const ObjectData *od : scene_synchronizer->objects_data_storage.get_sorted_objects_data()) {
		NS_PROFILE_NAMED("Update object data");

		if (od == nullptr || od->realtime_sync_enabled_on_client == false) {
			continue;
		}

#ifdef NS_PROFILING_ENABLED
		std::string perf_info = "Object Name: " + od->get_object_name();
		NS_PROFILE_SET_INFO(perf_info);
#endif

		// Make sure this ID is valid.
		NS_ENSURE_MSG(od->get_net_id() != ObjectNetId::NONE, "[BUG] It's not expected that the client has an uninitialized NetNodeId into the `organized_node_data` ");

#ifdef NS_DEBUG_ENABLED
		NS_ASSERT_COND_MSG(od->get_net_id().id < uint32_t(r_snapshot.objects.size()), "This array was resized above, this can't be triggered.");
#endif

		ObjectDataSnapshot *object_data_snap = r_snapshot.objects.data() + od->get_net_id().id;
		object_data_snap->vars.resize(od->vars.size());

		std::optional<VarData> *od_snap_vars_ptr = object_data_snap->vars.data();
		for (std::size_t v = 0; v < od->vars.size(); v += 1) {
#ifdef NS_PROFILING_ENABLED
			std::string sub_perf_info = "Var: " + od->vars[v].var.name;
			NS_PROFILE_NAMED_WITH_INFO("Update object data variable", sub_perf_info);
#endif
			if (od->vars[v].enabled) {
				od_snap_vars_ptr[v].emplace(VarData::make_copy(od->vars[v].var.value));
			} else {
				od_snap_vars_ptr[v].reset();
			}
		}

		object_data_snap->procedures.resize(od->get_scheduled_procedures().size());
		for (std::size_t p = 0; p < od->get_scheduled_procedures().size(); p += 1) {
			object_data_snap->procedures[p].execute_frame = od->get_scheduled_procedures()[p].execute_frame;
			object_data_snap->procedures[p].paused_frame = od->get_scheduled_procedures()[p].paused_frame;
			object_data_snap->procedures[p].args = od->get_scheduled_procedures()[p].args;
		}
	}

	scene_synchronizer->event_snapshot_update_finished.broadcast(r_snapshot);
}

void ClientSynchronizer::update_simulated_objects_list(const std::vector<SimulatedObjectInfo> &p_simulated_objects) {
	NS_PROFILE

	// Reset the simulated object first.
	for (auto od : scene_synchronizer->get_all_object_data()) {
		if (!od) {
			continue;
		}
		auto simulated_object_info = VecFunc::find(p_simulated_objects, od->get_net_id());
		const bool is_simulating = simulated_object_info != p_simulated_objects.end();
		if (od->realtime_sync_enabled_on_client != is_simulating) {
			od->realtime_sync_enabled_on_client = is_simulating;

			// Make sure the process_function cache is cleared.
			scene_synchronizer->process_functions__clear();

			// Make sure this node is NOT into the trickled sync list.
			if (is_simulating) {
				remove_object_from_trickled_sync(od);
			}

			// Make sure the controller updates its controllable objects list.
			if (od->get_controlled_by_peer() > 0) {
				PeerNetworkedController *controller = scene_synchronizer->get_controller_for_peer(od->get_controlled_by_peer(), false);
				if (controller) {
					controller->notify_controllable_objects_changed();
				}
			}
		}

		if (is_simulating) {
			od->set_controlled_by_peer(*scene_synchronizer, simulated_object_info->controlled_by_peer);
		} else {
			od->set_controlled_by_peer(*scene_synchronizer, -1);
		}
	}

	simulated_objects = p_simulated_objects;
	active_objects.clear();
	for (const SimulatedObjectInfo &info : simulated_objects) {
		active_objects.push_back(scene_synchronizer->get_object_data(info.net_id));
	}
}

void ClientSynchronizer::apply_snapshot(
		const Snapshot &p_snapshot,
		const int p_flag,
		const int p_frame_count_to_rewind,
		std::vector<std::string> *r_applied_data_info,
		const bool p_skip_custom_data,
		const bool p_skip_simulated_objects_update,
		const bool p_disable_apply_non_doll_controlled_only,
		const bool p_skip_snapshot_applied_event_broadcast,
		const bool p_skip_change_event) {
	NS_PROFILE

	const ObjectDataSnapshot *snap_objects_vars = p_snapshot.objects.data();

	if (!p_skip_change_event) {
		scene_synchronizer->change_events_begin(p_flag);
	}
	const int this_peer = scene_synchronizer->network_interface->get_local_peer_id();

	if (!p_skip_simulated_objects_update) {
		scene_synchronizer->global_frame_index = p_snapshot.global_frame_index;
		update_simulated_objects_list(p_snapshot.simulated_objects);
	}

	for (const SimulatedObjectInfo &info : p_snapshot.simulated_objects) {
		ObjectData *object_data = scene_synchronizer->get_object_data(info.net_id);

		if (object_data == nullptr) {
			// This can happen, and it's totally expected, because the server
			// doesn't always sync ALL the object_data: so that will result in a
			// not registered object.
			continue;
		}

		if (p_snapshot.objects.size() <= info.net_id.id) {
			// This object was not received yet, nothing to do.
			continue;
		}

#ifdef NS_DEBUG_ENABLED
		if (!p_skip_simulated_objects_update) {
			// This can't trigger because the `update_simulated_objects_list` make sure to set this.
			NS_ASSERT_COND(object_data->realtime_sync_enabled_on_client);
		}
#endif

		if (
			!p_disable_apply_non_doll_controlled_only &&
			object_data->get_controlled_by_peer() > 0 &&
			object_data->get_controlled_by_peer() != this_peer) {
			// This object is controlled by a doll, which simulation / reconcilation
			// is mostly doll-controller driven.
			// The dolls are notified at the end of this loop, when the event
			// `event_snapshot_applied` is emitted.
			continue;
		}

		const ObjectDataSnapshot &object_data_snapshot = snap_objects_vars[info.net_id.id];

		if (r_applied_data_info) {
			r_applied_data_info->push_back("Applied snapshot on the object: " + object_data->get_object_name());
		}

		// NOTE: The vars may not contain ALL the variables: it depends on how
		//       the snapshot was captured.
		for (VarId v = VarId{ { 0 } }; v < VarId{ { VarId::IdType(object_data_snapshot.vars.size()) } }; v += 1) {
			if (!object_data_snapshot.vars[v.id].has_value()) {
				// This variable was not set, skip it.
				continue;
			}

			const std::string &variable_name = object_data->vars[v.id].var.name;
			const VarData &snap_value = object_data_snapshot.vars[v.id].value();
			VarData current_val;
			object_data->vars[v.id].get_func(
					*scene_synchronizer->synchronizer_manager,
					object_data->app_object_handle,
					variable_name.c_str(),
					current_val);

			if (!SceneSynchronizerBase::var_data_compare(current_val, snap_value)) {
				object_data->vars[v.id].var.value.copy(snap_value);

				object_data->vars[v.id].set_func(
						*scene_synchronizer->synchronizer_manager,
						object_data->app_object_handle,
						variable_name.c_str(),
						snap_value);

				scene_synchronizer->change_event_add(
						object_data,
						v,
						current_val);

#ifdef NS_DEBUG_ENABLED
				if (scene_synchronizer->pedantic_checks) {
					// Make sure the set value matches the one just set.
					object_data->vars[v.id].get_func(
							*scene_synchronizer->synchronizer_manager,
							object_data->app_object_handle,
							variable_name.c_str(),
							current_val);
					NS_ASSERT_COND_MSG(SceneSynchronizerBase::var_data_compare(current_val, snap_value), "There was a fatal error while setting the propertly `" + variable_name + "` on the object `" + object_data->get_object_name() + "`. The set data differs from the property set by the NetSync: set data `" + scene_synchronizer->var_data_stringify(current_val, true) + "` NetSync data `" + scene_synchronizer->var_data_stringify(snap_value, true) + "`");
				}
#endif

				if (r_applied_data_info) {
					r_applied_data_info->push_back(std::string() + " |- Variable: " + variable_name + " New value: " + SceneSynchronizerBase::var_data_stringify(snap_value));
				}
			}
		}

		for (ScheduledProcedureId procedure_id = { 0 }; procedure_id.id < ScheduledProcedureId::IdType(object_data_snapshot.procedures.size()); procedure_id += 1) {
			if (object_data->scheduled_procedure_exist(procedure_id)) {
				const ScheduledProcedureSnapshot &procedure_snapshot = object_data_snapshot.procedures[procedure_id.id];
				object_data->scheduled_procedure_reset_to(procedure_id, procedure_snapshot);
			}
		}
	}

	if (p_snapshot.has_custom_data && !p_skip_custom_data) {
		scene_synchronizer->synchronizer_manager->snapshot_set_custom_data(p_snapshot.custom_data);
	}

	if (!p_skip_snapshot_applied_event_broadcast) {
		scene_synchronizer->event_snapshot_applied.broadcast(p_snapshot, p_frame_count_to_rewind);
	}

	if (!p_skip_change_event) {
		scene_synchronizer->change_events_flush();
	}
}

NS_NAMESPACE_END