@rbxts/replecs 0.1.0-alpha9 → 0.2.0-cdtest.2

package/out/replecs/server.luau

@@ -4,34 +4,61 @@
 local jecs = require "../jecs"
 local utils = require "./utils"
 local common = require "./common"
+local customid = require "./customid"
 local masking_controller = require "./masking"
 
+local cursor = utils.cursor
+
 type Cursor = utils.Cursor
+type CustomId = customid.CustomId
 
 type World = jecs.World
 type Entity<T = any> = jecs.Entity<T>
+type Component = Entity
 
 type Set<T> = { [T]: boolean }
 type Map<K, V> = { [K]: V }
 type Array<T> = { T }
 
-type FunctionFilter = (player: Player) -> boolean
+type FunctionFilter = common.FunctionFilter
+type AnyFilter = common.AnyFilter
+
+type CustomIdSerialization = {
+	required: Map<Entity, CustomId>,
+	cursor_skip: number,
+}
 
 type TrackInfo = {
-	entities: Map<Entity, boolean>,
-	components: { [Entity]: { [Entity]: number } },
+	networked: Set<Entity>,
+	entities: Map<Entity, Map<Component, number>>,
+	components: Map<Component, Map<Entity, number>>,
 }
 
 type EntityStorage = {
-	tags: { [Entity]: boolean },
-	values: { [Entity]: any },
-	pairs: { [Entity]: Set<Entity> },
-	pairs_values: { [Entity]: Map<Entity, any> },
+	tags: { [Component]: boolean },
+	values: { [Component]: any },
+	pairs: { [Component]: Set<Entity> },
+	pairs_values: { [Component]: Map<Entity, any> },
 }
 
 type Storage = { [Entity]: EntityStorage }
 
-export type Server = {
+export type ServerImp = {
+	set_networked: (server: Server, entity: Entity, filter: AnyFilter?) -> (),
+	stop_networked: (server: Server, entity: Entity) -> (),
+
+	set_reliable: (server: Server, entity: Entity, component: Component, filter: AnyFilter?) -> (),
+	set_unreliable: (server: Server, entity: Entity, component: Component, filter: AnyFilter?) -> (),
+	set_pair: (server: Server, entity: Entity, relation: Component, filter: AnyFilter?) -> (),
+	set_custom: (server: Server, entity: Entity, component: Component | CustomId) -> (),
+
+	stop_reliable: (server: Server, entity: Entity, component: Component) -> (),
+	stop_unreliable: (server: Server, entity: Entity, component: Component) -> (),
+	stop_pair: (server: Server, entity: Entity, relation: Component) -> (),
+	remove_custom: (server: Server, entity: Entity) -> (),
+}
+
+export type Server = ServerImp & {
 	world: World,
 	inited: boolean?,
 
@@ -41,12 +68,12 @@ export type Server = {
 	hooks: common.WorldHooks,
 	alive_tracked: Set<Entity>,
 
-	is_dirty: boolean,
+	is_shared_dirty: boolean,
 	requires_shared_lookup: { Entity },
 
 	track_info: TrackInfo,
 	additions: Set<Entity>,
-	custom_ids: Map<Entity, Entity<any>>,
+	custom_ids: Map<Entity, CustomId | Entity>,
 	global_ids: Map<Entity, number>,
 	storage: Storage,
 	hooked: Array<() -> ()>,
@@ -55,22 +82,31 @@ export type Server = {
 	connections: Array<RBXScriptConnection>,
 	function_filters: masking_controller.EntityComponentIndex<FunctionFilter>,
 
+	registered_custom_ids: Map<CustomId, boolean>,
+
 	init: (self: Server, world: World?) -> (),
 	destroy: (self: Server) -> (),
 
-	encode_component: (self: Server, component: Entity) -> number,
-	decode_component: (self: Server, component: number) -> Entity,
+	encode_component: (self: Server, component: Component) -> number,
+	decode_component: (self: Server, component: number) -> Component,
+	register_custom_id: (self: Server, custom_id: CustomId) -> (),
 
 	get_full: (self: Server, player: Player) -> (buffer, { { any } }),
 	collect_updates: (self: Server) -> () -> (Player, buffer, { { any } }),
 	collect_unreliable: (self: Server) -> () -> (Player, buffer, { { any } }),
+
 	mark_player_ready: (self: Server, player: Player) -> (),
 	is_player_ready: (self: Server, player: Player) -> boolean,
+
 	add_player_alias: (self: Server, client: Player, alias: any) -> (),
 	remove_player_alias: (self: Server, alias: any) -> (),
+
+	generate_handshake: (self: Server) -> common.HandshakeInfo,
+	verify_handshake: (self: Server, handshake: common.HandshakeInfo) -> (boolean, string?),
 }
 
-local cursor = utils.cursor
+local server_replicator = {}
+server_replicator.__index = server_replicator
 
 local NIL_COMPONENT_VALUE = newproxy()
 local GLOBAL_ID_OFFSET = 10
@@ -92,15 +128,26 @@ local PACKET_TYPES = {
 local MAX_PACKET_SIZE = 900
 local ENTITY_ID_TYPES = {
 	entity = 1,
-	custom = 2,
-	shared = 3,
+	custom_handler = 2,
+	custom_id = 3,
+	shared = 4,
 }
+
 local ECS_COMPONENT = jecs.Component
+local WILDCARD = jecs.Wildcard
 
-local function IS_PAIR(id: Entity): boolean
+local function IS_PAIR(id: Component): boolean
 	return jecs.IS_PAIR(id)
 end
+
+local function PAIR(relation: Entity, target: Entity): Entity
+	return jecs.pair(relation, target)
+end
+
 local function PAIR_SECOND(world: World, id: Entity): Entity
+	if not IS_PAIR(id) then
+		error(`expected a pair, got: {utils.logcomponent(world, id)}`)
+	end
 	return jecs.pair_second(world, id)
 end
 
@@ -128,17 +175,42 @@ local function get_or_set_entity_storage(server: Server, entity: Entity): Entity
 	return storage
 end
 
-local function allocate_component_change(server: Server, entity: Entity, component: Entity, value: any)
+local function add_entity_tracked(server: Server, entity: Entity, component: Component, track_type: number)
+	local track = server.track_info.entities[entity]
+	if track == nil then
+		track = {
+			[component] = track_type,
+		}
+		server.track_info.entities[entity] = track
+	else
+		track[component] = track_type
+	end
+end
+
+local function remove_entity_tracked(server: Server, entity: Entity, component: Component)
+	local track = server.track_info.entities[entity]
+	if track then
+		track[component] = nil
+	end
+end
+
+local function allocate_component_change(server: Server, entity: Entity, component: Component, value: any)
 	local storage = get_or_set_entity_storage(server, entity)
 
 	local non_nil = if value == nil then NIL_COMPONENT_VALUE else value
 
 	storage.values[component] = non_nil
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_component_change(entity, component, non_nil)
 	end
 end
-local function allocate_pair_value_change(server: Server, entity: Entity, relation: Entity, target: Entity, value: any)
+local function allocate_pair_value_change(
+	server: Server,
+	entity: Entity,
+	relation: Component,
+	target: Entity,
+	value: any
+)
 	local storage = get_or_set_entity_storage(server, entity)
 
 	local non_nil = if value == nil then NIL_COMPONENT_VALUE else value
@@ -150,20 +222,20 @@ local function allocate_pair_value_change(server: Server, entity: Entity, relati
 	end
 	values[target] = non_nil
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_pair_value_change(entity, relation, target, non_nil)
 	end
 end
 
-local function allocate_tag_addition(server: Server, entity: Entity, tag: Entity)
+local function allocate_tag_addition(server: Server, entity: Entity, tag: Component)
 	local storage = get_or_set_entity_storage(server, entity)
 	storage.tags[tag] = true
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_tag_addition(entity, tag)
 	end
 end
-local function allocate_pair_addition(server: Server, entity: Entity, relation: Entity, target: Entity)
+local function allocate_pair_addition(server: Server, entity: Entity, relation: Component, target: Entity)
 	local storage = get_or_set_entity_storage(server, entity)
 	local targets = storage.pairs[relation]
 	if targets == nil then
@@ -172,47 +244,47 @@ local function allocate_pair_addition(server: Server, entity: Entity, relation:
 	end
 	targets[target] = true
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_pair_addition(entity, relation, target)
 	end
 end
 
-local function allocate_component_removal(server: Server, entity: Entity, component: Entity)
+local function allocate_component_removal(server: Server, entity: Entity, component: Component)
 	local storage = get_or_set_entity_storage(server, entity)
 	storage.values[component] = nil
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_component_removal(entity, component)
 	end
 end
-local function allocate_pair_value_removal(server: Server, entity: Entity, relation: Entity, target: Entity)
+local function allocate_pair_value_removal(server: Server, entity: Entity, relation: Component, target: Entity)
 	local storage = get_or_set_entity_storage(server, entity)
 	local values = storage.pairs_values[relation]
 	if values then
 		values[target] = nil
 	end
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_pair_value_removal(entity, relation, target)
 	end
 end
 
-local function allocate_tag_removal(server: Server, entity: Entity, tag: Entity)
+local function allocate_tag_removal(server: Server, entity: Entity, tag: Component)
 	local storage = get_or_set_entity_storage(server, entity)
 	storage.tags[tag] = nil
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_tag_removal(entity, tag)
 	end
 end
-local function allocate_pair_removal(server: Server, entity: Entity, relation: Entity, target: Entity)
+local function allocate_pair_removal(server: Server, entity: Entity, relation: Component, target: Entity)
 	local storage = get_or_set_entity_storage(server, entity)
 	local targets = storage.pairs[relation]
 	if targets then
 		targets[target] = nil
 	end
 
-	if not server.additions[entity] and server.track_info.entities[entity] then
+	if not server.additions[entity] and server.track_info.networked[entity] then
 		server.masking:allocate_pair_removal(entity, relation, target)
 	end
 end
@@ -224,13 +296,28 @@ local function cleanup_entity(server: Server, entity: Entity)
 	server.custom_ids[entity] = nil
 	server.additions[entity] = nil
 	server.masking:cleanup_entity(entity)
+
+	local track_info = server.track_info.entities[entity]
+	if track_info then
+		for component in track_info do
+			local track_component = server.track_info.components[component]
+			if track_component then
+				track_component[entity] = nil
+			end
+		end
+		server.track_info.entities[entity] = nil
+	end
 end
 
-local function track_component(server: Server, component: Entity<any>)
+local function track_component(server: Server, component: Component)
 	local world = server.world
 	local hooks = server.hooks
 
-	local info = {}
+	if server.track_info.components[component] then
+		error(`attemped to track a component twice: {utils.logcomponent(server.world, component)}`)
+	end
+
+	local info = {} :: Map<Entity, number>
 	server.track_info.components[component] = info
 
 	local function hook(unhook: () -> ())
@@ -320,13 +407,16 @@ local function track_entity_component(server: Server, entity: Entity, component:
 		end
 
 		info[entity] = TRACK_TYPES.component
+		add_entity_tracked(server, entity, component, TRACK_TYPES.component)
 
 		return COMPONENT_TYPES.component
 	else
 		if world:has(entity, component) then
 			entity_storage.tags[component] = true
 		end
+
 		info[entity] = TRACK_TYPES.tag
+		add_entity_tracked(server, entity, component, TRACK_TYPES.tag)
 
 		return COMPONENT_TYPES.tag
 	end
@@ -354,8 +444,11 @@ local function track_entity_pair(server: Server, entity: Entity, relation: Entit
 			local value = world:get(entity, jecs.pair(relation, target))
 			targets[target] = if value == nil then NIL_COMPONENT_VALUE else value :: any
 		end
+
 		entity_storage.pairs_values[relation] = targets
 		info[entity] = TRACK_TYPES.pair_value
+		add_entity_tracked(server, entity, relation, TRACK_TYPES.pair_value)
+
 		return COMPONENT_TYPES.pair_value
 	else
 		local targets = {} :: Set<Entity>
@@ -369,8 +462,11 @@ local function track_entity_pair(server: Server, entity: Entity, relation: Entit
 			index += 1
 			targets[target] = true
 		end
+
 		entity_storage.pairs[relation] = targets
 		info[entity] = TRACK_TYPES.pair
+		add_entity_tracked(server, entity, relation, TRACK_TYPES.pair)
+
 		return COMPONENT_TYPES.pair
 	end
 end
@@ -389,6 +485,13 @@ local function untrack_entity_component(server: Server, entity: Entity, componen
 		storage.tags[component] = nil
 	end
 
+	local entity_tracked = server.track_info.entities[entity]
+	if entity_tracked then
+		entity_tracked[component] = nil
+	end
+
+	remove_entity_tracked(server, entity, component)
+
 	return listen_type
 end
 
@@ -405,11 +508,18 @@ local function untrack_entity_pair(server: Server, entity: Entity, relation: Ent
 		storage.pairs[relation] = nil
 		storage.pairs_values[relation] = nil
 	end
+
+	local entity_tracked = server.track_info.entities[entity]
+	if entity_tracked then
+		entity_tracked[relation] = nil
+	end
+
+	remove_entity_tracked(server, entity, relation)
 	return listen_type
 end
 
-local function encode_component(server: Server, component: Entity): number
-	local encoded = server.shared.ids[component]
+function server_replicator.encode_component(server: Server, component: Entity): number
+	local encoded = server.shared.components.members[component]
 	if not encoded then
 		utils.logerror(`attempted to encode a non-shared component `, utils.logcomponent(server.world, component))
 		return 0
@@ -417,8 +527,8 @@ local function encode_component(server: Server, component: Entity): number
 	return encoded
 end
 
-local function decode_component(server: Server, encoded: number): Entity
-	local component = server.shared.components[encoded]
+function server_replicator.decode_component(server: Server, encoded: number): Entity
+	local component = server.shared.components.indexes[encoded]
 	if not component then
 		print("NON SHARED COMPONENTS", encoded, server.shared.components)
 		error "attemped to decode a non shared component"
@@ -426,16 +536,23 @@ local function decode_component(server: Server, encoded: number): Entity
 	return component
 end
 
-local function write_component_id(server: Server, c: Cursor, component: Entity)
-	local encoded = server.shared.ids[component]
+function server_replicator.write_component_id(server: Server, c: Cursor, component: Entity)
+	local shared_componens = server.shared.components
+	local encoded = shared_componens.members[component]
 	if not encoded then
 		utils.logerror(`attempted to replicate a non-shared component `, utils.logcomponent(server.world, component))
 		return
 	end
-	cursor.writeu8(c, encoded)
+	cursor.write_span(c, encoded, #shared_componens.keys)
 end
 
-local function write_component_value(server: Server, c: Cursor, component: Entity, value: any, variants: { any })
+function server_replicator.write_component_value(
+	server: Server,
+	c: Cursor,
+	component: Entity,
+	value: any,
+	variants: { any }
+)
 	local serdes = server.shared.serdes[component]
 	if serdes then
 		local output, serdes_variants = serdes.serialize(if value == NIL_COMPONENT_VALUE then nil else value)
@@ -459,7 +576,7 @@ local function write_component_value(server: Server, c: Cursor, component: Entit
 			)
 		end
 
-		local bytespan = server.shared.bytespan[component]
+		local bytespan = serdes.bytespan
 		cursor.write_buffer(c, output)
 		if bytespan then
 			if bytespan ~= buffer.len(output) then
@@ -483,23 +600,29 @@ local function write_component_value(server: Server, c: Cursor, component: Entit
 	end
 end
 
-local function write_component(server: Server, c: Cursor, component: Entity, value: any, variants: { any })
-	write_component_value(server, c, component, value, variants)
-	write_component_id(server, c, component)
+function server_replicator.write_component(server: Server, c: Cursor, component: Entity, value: any, variants: { any })
+	server_replicator.write_component_value(server, c, component, value, variants)
+	server_replicator.write_component_id(server, c, component)
 end
 
-local function write_entity_id(server: Server, c: Cursor, entity: Entity, variants: { any })
+function server_replicator.write_entity_id(server: Server, c: Cursor, entity: Entity)
 	local custom = server.custom_ids[entity]
 	local global_id = server.global_ids[entity]
 
 	if global_id then
 		cursor.writeu8(c, global_id + GLOBAL_ID_OFFSET)
 	elseif custom then
-		local value = server.world:get(entity, custom)
-		write_component(server, c, custom, value, variants)
-		cursor.writeu8(c, ENTITY_ID_TYPES.custom)
+		if type(custom) == "number" then
+			server_replicator.write_component_id(server, c, (custom :: any) :: Entity)
+			cursor.writeu40(c, entity :: any)
+			cursor.writeu8(c, ENTITY_ID_TYPES.custom_id)
+		else
+			cursor.writeu8(c, server.shared.custom_ids.members[custom :: CustomId])
+			cursor.writeu40(c, entity :: any)
+			cursor.writeu8(c, ENTITY_ID_TYPES.custom_handler)
+		end
 	else
-		local shared_id = server.shared.ids[entity]
+		local shared_id = server.shared.components.members[entity]
 		if shared_id then
 			cursor.writeu8(c, shared_id)
 			cursor.writeu8(c, ENTITY_ID_TYPES.shared)
@@ -510,25 +633,19 @@ local function write_entity_id(server: Server, c: Cursor, entity: Entity, varian
 	end
 end
 
-local function write_entity_relations(
-	server: Server,
-	storage: EntityStorage,
-	c: Cursor,
-	relation: Entity,
-	variants: { any }
-)
+function server_replicator.write_entity_relations(server: Server, storage: EntityStorage, c: Cursor, relation: Entity)
 	local targets = storage.pairs[relation]
 	local total_targets = 0
 
 	for target in targets do
-		write_entity_id(server, c, target, variants)
+		server_replicator.write_entity_id(server, c, target)
 		total_targets += 1
 	end
 	cursor.write_vlq(c, total_targets)
-	write_component_id(server, c, relation)
+	server_replicator.write_component_id(server, c, relation)
 end
 
-local function write_entity_relations_values(
+function server_replicator.write_entity_relations_values(
 	server: Server,
 	storage: EntityStorage,
 	c: Cursor,
@@ -539,15 +656,15 @@ local function write_entity_relations_values(
 	local total_targets = 0
 
 	for target, value in targets do
-		write_entity_id(server, c, target, variants)
-		write_component_value(server, c, relation, value, variants)
+		server_replicator.write_entity_id(server, c, target)
+		server_replicator.write_component_value(server, c, relation, value, variants)
 		total_targets += 1
 	end
 	cursor.write_vlq(c, total_targets)
-	write_component_id(server, c, relation)
+	server_replicator.write_component_id(server, c, relation)
 end
 
-local function write_entity(
+function server_replicator.write_entity(
 	server: Server,
 	c: Cursor,
 	entity: Entity,
@@ -558,14 +675,14 @@ local function write_entity(
 
 	local all_pairs_values = 0
 	for relation in active.components[COMPONENT_TYPES.pair_value] do
-		write_entity_relations_values(server, storage, c, relation, variants)
+		server_replicator.write_entity_relations_values(server, storage, c, relation, variants)
 		all_pairs_values += 1
 	end
 	cursor.write_vlq(c, all_pairs_values)
 
 	local all_pairs = 0
 	for relation in active.components[COMPONENT_TYPES.pair] do
-		write_entity_relations(server, storage, c, relation, variants)
+		server_replicator.write_entity_relations(server, storage, c, relation)
 		all_pairs += 1
 	end
 	cursor.write_vlq(c, all_pairs)
@@ -577,7 +694,7 @@ local function write_entity(
 			continue
 		end
 
-		write_component(server, c, component, value, variants)
+		server_replicator.write_component(server, c, component, value, variants)
 		components += 1
 	end
 	cursor.write_vlq(c, components)
@@ -586,18 +703,18 @@ local function write_entity(
 	for tag in active.components[COMPONENT_TYPES.tag] do
 		local has_tag = storage.tags[tag]
 		if has_tag then
-			write_component_id(server, c, tag)
+			server_replicator.write_component_id(server, c, tag)
 			tags += 1
 		end
 	end
 	cursor.write_vlq(c, tags)
-	write_entity_id(server, c, entity, variants)
+	server_replicator.write_entity_id(server, c, entity)
 end
 
-local function resolve_dirty(server: Server)
-	if server.is_dirty then
-		server.shared = utils.create_shared_lookup(server.world, server.components)
-		server.is_dirty = false :: true -- wtf
+function server_replicator.resolve_dirty(server: Server)
+	if server.is_shared_dirty then
+		server.shared = utils.resolved_shared(server.world, server.components, server.registered_custom_ids)
+		server.is_shared_dirty = false
 	end
 end
 
@@ -619,6 +736,10 @@ local function append_packet(
 )
 	local len = buffer.len(output)
 	for _, member in members do
+		if not utils.is_client_valid(member) then
+			continue
+		end
+
 		local member_packets = packets[member]
 
 		if member_packets then
@@ -665,6 +786,12 @@ local function create_packet_iterator(packets: { [Player]: MemberPackets }, id:
 	local iterated: Player? = nil
 	local function iterator()
 		local player, data = next(packets, iterated)
+		while not utils.is_client_valid(player) do
+			if not player and not data then
+				break
+			end
+			player, data = next(packets, iterated)
+		end
 		if not player then
 			return nil :: any
 		end
@@ -679,6 +806,10 @@ end
 local function create_unreliable_packet_iterator(packets: { [Player]: MemberPackets })
 	return coroutine.wrap(function()
 		for player, data in packets do
+			if not utils.is_client_valid(player) then
+				continue
+			end
+
 			table.sort(data.packets, function(a, b)
 				return buffer.len(a.buffer) < buffer.len(b.buffer)
 			end)
@@ -714,8 +845,8 @@ local function create_unreliable_packet_iterator(packets: { [Player]: MemberPack
 	end) :: PacketIterator
 end
 
-local function get_full(server: Server, client: Player): (buffer, { { any } })
-	resolve_dirty(server)
+function server_replicator.get_full(server: Server, client: Player): (buffer, { { any } })
+	server_replicator.resolve_dirty(server)
 	local index = server.masking.client_indexes[client]
 	if index == nil then
 		utils.logerror "attempted to replicate for a non registered client"
@@ -726,6 +857,9 @@ local function get_full(server: Server, client: Player): (buffer, { { any } })
 
 	-- maybe edges to quickly find all relevant storages improves performance?
 	for _, storage in server.masking.storages do
+		if storage.active_count == 0 then
+			continue
+		end
 		if not storage.mask.bitmask:get(index) then
 			continue
 		end
@@ -734,7 +868,7 @@ local function get_full(server: Server, client: Player): (buffer, { { any } })
 
 		local total_entities = 0
 		for entity, active in storage.active do
-			write_entity(server, c, entity, active, variants)
+			server_replicator.write_entity(server, c, entity, active, variants)
 			total_entities += 1
 		end
 		cursor.write_vlq(c, total_entities)
@@ -759,20 +893,21 @@ local function write_vlq_bitmask(c: Cursor, value: number, mask: number, bit: nu
 	end
 end
 
-local function collect_updates(server: Server)
-	resolve_dirty(server)
+function server_replicator.collect_updates(server: Server)
+	server_replicator.resolve_dirty(server)
 	local packets: { [Player]: MemberPackets } = {}
 
 	for _, storage in server.masking.storages do
 		local c = cursor.new()
 
 		local variants = {}
+
 		local storage_mask = 0
 
 		local total_deleted = 0
 		local entity_deletions = storage.deletions.entities
 		for entity in entity_deletions do
-			write_entity_id(server, c, entity, variants)
+			server_replicator.write_entity_id(server, c, entity)
 			total_deleted += 1
 		end
 		table.clear(entity_deletions)
@@ -782,28 +917,29 @@ local function collect_updates(server: Server)
 		local component_deletions = storage.deletions.components
 		for entity, deleted in component_deletions do
 			local total_pairs = 0
+
 			for relation in deleted[COMPONENT_TYPES.pair_value] do
-				write_component_id(server, c, relation)
+				server_replicator.write_component_id(server, c, relation)
 				total_pairs += 1
 			end
 			for relation in deleted[COMPONENT_TYPES.pair] do
-				write_component_id(server, c, relation)
+				server_replicator.write_component_id(server, c, relation)
 				total_pairs += 1
 			end
 			cursor.write_vlq(c, total_pairs)
 
 			local total_removed = 0
 			for component in deleted[COMPONENT_TYPES.component] do
-				write_component_id(server, c, component)
+				server_replicator.write_component_id(server, c, component)
 				total_removed += 1
 			end
 			for tag in deleted[COMPONENT_TYPES.tag] do
-				write_component_id(server, c, tag)
+				server_replicator.write_component_id(server, c, tag)
 				total_removed += 1
 			end
 			cursor.write_vlq(c, total_removed)
 
-			write_entity_id(server, c, entity, variants)
+			server_replicator.write_entity_id(server, c, entity)
 			total_component_deleted += 1
 		end
 		table.clear(component_deletions)
@@ -819,12 +955,12 @@ local function collect_updates(server: Server)
 				local total_targets = 0
 
 				for target, value in targets do
-					write_entity_id(server, c, target, variants)
-					write_component_value(server, c, relation, value, variants)
+					server_replicator.write_entity_id(server, c, target)
+					server_replicator.write_component_value(server, c, relation, value, variants)
 					total_targets += 1
 				end
 				cursor.write_vlq(c, total_targets)
-				write_component_id(server, c, relation)
+				server_replicator.write_component_id(server, c, relation)
 				total_pairs_values += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_pairs_values, changed_mask, 5)
@@ -834,11 +970,11 @@ local function collect_updates(server: Server)
 				local total_targets = 0
 
 				for target in targets do
-					write_entity_id(server, c, target, variants)
+					server_replicator.write_entity_id(server, c, target)
 					total_targets += 1
 				end
 				cursor.write_vlq(c, total_targets)
-				write_component_id(server, c, relation)
+				server_replicator.write_component_id(server, c, relation)
 				total_pairs_values_removed += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_pairs_values_removed, changed_mask, 4)
@@ -848,7 +984,7 @@ local function collect_updates(server: Server)
 				local total_targets = 0
 
 				for target, added in targets do
-					write_entity_id(server, c, target, variants)
+					server_replicator.write_entity_id(server, c, target)
 					if added then
 						cursor.writei8(c, 1)
 					else
@@ -857,35 +993,35 @@ local function collect_updates(server: Server)
 					total_targets += 1
 				end
 				cursor.write_vlq(c, total_targets)
-				write_component_id(server, c, relation)
+				server_replicator.write_component_id(server, c, relation)
 				total_pairs += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_pairs, changed_mask, 3)
 
 			local total_removed = 0
 			for component in changes.removed do
-				write_component_id(server, c, component)
+				server_replicator.write_component_id(server, c, component)
 				total_removed += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_removed, changed_mask, 2)
 
 			local total_components = 0
 			for component, value in changes.component do
-				write_component(server, c, component, value, variants)
+				server_replicator.write_component(server, c, component, value, variants)
 				total_components += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_components, changed_mask, 1)
 
 			local total_tagged = 0
 			for tag in changes.tagged do
-				write_component_id(server, c, tag)
+				server_replicator.write_component_id(server, c, tag)
 				total_tagged += 1
 			end
 			changed_mask = write_vlq_bitmask(c, total_tagged, changed_mask, 0)
 
 			if changed_mask ~= 0 then
 				cursor.writeu8(c, changed_mask)
-				write_entity_id(server, c, entity, variants)
+				server_replicator.write_entity_id(server, c, entity)
 				changed += 1
 			end
 		end
@@ -899,14 +1035,14 @@ local function collect_updates(server: Server)
 
 			local total_pairs_values = 0
 			for relation in components[COMPONENT_TYPES.pair_value] do
-				write_entity_relations_values(server, entity_storage, c, relation, variants)
+				server_replicator.write_entity_relations_values(server, entity_storage, c, relation, variants)
 				total_pairs_values += 1
 			end
 			added_mask = write_vlq_bitmask(c, total_pairs_values, added_mask, 3)
 
 			local total_pairs = 0
 			for relation in components[COMPONENT_TYPES.pair] do
-				write_entity_relations(server, entity_storage, c, relation, variants)
+				server_replicator.write_entity_relations(server, entity_storage, c, relation)
 				total_pairs += 1
 			end
 			added_mask = write_vlq_bitmask(c, total_pairs, added_mask, 2)
@@ -917,7 +1053,7 @@ local function collect_updates(server: Server)
 				if value == nil then
 					continue
 				end
-				write_component(server, c, component, value, variants)
+				server_replicator.write_component(server, c, component, value, variants)
 				total_components += 1
 			end
 			added_mask = write_vlq_bitmask(c, total_components, added_mask, 1)
@@ -926,7 +1062,7 @@ local function collect_updates(server: Server)
 			for component in components[COMPONENT_TYPES.tag] do
 				local has_tag = entity_storage.tags[component]
 				if has_tag then
-					write_component_id(server, c, component)
+					server_replicator.write_component_id(server, c, component)
 					total_tags += 1
 				end
 			end
@@ -934,7 +1070,7 @@ local function collect_updates(server: Server)
 
 			if added_mask ~= 0 then
 				cursor.writeu8(c, added_mask)
-				write_entity_id(server, c, entity, variants)
+				server_replicator.write_entity_id(server, c, entity)
 				total_components_added += 1
 			end
 		end
@@ -948,7 +1084,7 @@ local function collect_updates(server: Server)
 				continue
 			end
 
-			write_entity(server, c, entity, active, variants)
+			server_replicator.write_entity(server, c, entity, active, variants)
 			total_added += 1
 		end
 		table.clear(storage_changes.added)
@@ -964,26 +1100,32 @@ local function collect_updates(server: Server)
 	return create_packet_iterator(packets, PACKET_TYPES.reliable)
 end
 
-local function collect_unreliable(server: Server)
-	resolve_dirty(server)
+function server_replicator.collect_unreliable(server: Server)
+	server_replicator.resolve_dirty(server)
 	local world = server.world
 	local packets: { [Player]: MemberPackets } = {}
 
 	for _, mask_storage in server.masking.storages do
+		if mask_storage.active_count == 0 then
+			continue
+		end
 		local active = mask_storage.active
 
 		local c = cursor.new()
 		local variants = {} :: { { any } }
+		local custom_ids: Set<Entity> = {}
 		local total_entities = 0
 
 		local checkpoint_offset = 0
 		local checkpoint_variants_count = 0
 		local checkpoint_total_entities = 0
+		local checkpoint_entity: Entity? = nil
 
-		local function create_checkpoint()
+		local function create_checkpoint(entity: Entity)
 			checkpoint_offset = c.offset
 			checkpoint_variants_count = #variants
 			checkpoint_total_entities = total_entities
+			checkpoint_entity = entity
 		end
 
 		local function rollback_checkpoint()
@@ -996,6 +1138,14 @@ local function collect_unreliable(server: Server)
 			for _ = #variants, checkpoint_variants_count + 1, -1 do
 				table.insert(new_variants, 1, table.remove(variants))
 			end
+
+			local new_custom_ids = {} :: Set<Entity>
+			if checkpoint_entity then
+				new_custom_ids[checkpoint_entity] = true
+				custom_ids[checkpoint_entity] = nil
+			end
+			custom_ids = new_custom_ids
+
 			variants = new_variants
 			total_entities = total_entities - checkpoint_total_entities
 		end
@@ -1011,7 +1161,7 @@ local function collect_unreliable(server: Server)
 		end
 
 		for entity, actives in active do
-			create_checkpoint()
+			create_checkpoint(entity)
 
 			local total_unreliable = 0
 			for component in actives.components[COMPONENT_TYPES.unreliable] do
@@ -1020,7 +1170,7 @@ local function collect_unreliable(server: Server)
 					continue
 				end
 
-				write_component(server, c, component, value, variants)
+				server_replicator.write_component(server, c, component, value, variants)
 				total_unreliable += 1
 			end
 
@@ -1029,11 +1179,12 @@ local function collect_unreliable(server: Server)
 			end
 			total_entities += 1
 			cursor.write_vlq(c, total_unreliable)
-			write_entity_id(server, c, entity, variants)
+			server_replicator.write_entity_id(server, c, entity)
 
 			if c.offset > MAX_PACKET_SIZE then
 				local commit_cursor = c
 				local commit_variants = variants
+
 				rollback_checkpoint()
 				commit_checkpoint(commit_cursor, commit_variants, checkpoint_total_entities)
 			end
@@ -1044,6 +1195,188 @@ local function collect_unreliable(server: Server)
 	return create_unreliable_packet_iterator(packets)
 end
 
+function server_replicator.start_networked(server: Server, entity: Entity, filter: AnyFilter?)
+	local masking = server.masking
+
+	masking:unregister_stop_entity(entity)
+	masking:start_entity(entity, filter)
+	masking:propagate_entity_addition(entity)
+
+	server.additions[entity] = true
+	server.track_info.networked[entity] = true
+	track_entity_lifetime(server, entity)
+end
+function server_replicator.start_reliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local masking = server.masking
+
+	local component_type = track_entity_component(server :: Server, entity, component)
+	masking:unregister_stop_component(entity, component, component_type)
+	masking:start_component(entity, component, component_type, filter)
+	if server.additions[entity] then
+		masking:allocate_entity_addition(entity, component, component_type)
+	elseif server.track_info.networked[entity] then
+		masking:register_component_addition(entity, component, component_type)
+	end
+end
+
+function server_replicator.start_unreliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local masking = server.masking
+
+	masking:unregister_stop_component(entity, component, COMPONENT_TYPES.unreliable)
+	masking:start_component(entity, component, COMPONENT_TYPES.unreliable, filter)
+	if server.additions[entity] then
+		masking:allocate_entity_addition(entity, component, COMPONENT_TYPES.unreliable)
+	end
+end
+
+function server_replicator.start_pair(server: Server, entity: Entity, relation: Component, filter: AnyFilter?)
+	local masking = server.masking
+
+	local component_type = track_entity_pair(server, entity, relation)
+	masking:unregister_stop_component(entity, relation, component_type)
+	masking:start_component(entity, relation, component_type, filter)
+	if server.additions[entity] then
+		masking:allocate_entity_addition(entity, relation, component_type)
+	elseif server.track_info.networked[entity] then
+		masking:register_component_addition(entity, relation, component_type)
+	end
+end
+
+function server_replicator.change_networked(server: Server, entity: Entity, filter: AnyFilter?)
+	local masking = server.masking
+	masking:set_entity(entity, filter)
+end
+function server_replicator.change_reliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local world = server.world
+	local masking = server.masking
+
+	if world:has(component, ECS_COMPONENT) then
+		masking:set_component(entity, component, COMPONENT_TYPES.component, filter)
+	else
+		masking:set_component(entity, component, COMPONENT_TYPES.tag, filter)
+	end
+end
+function server_replicator.change_unreliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local masking = server.masking
+	masking:set_component(entity, component, COMPONENT_TYPES.unreliable, filter)
+end
+function server_replicator.change_pair(server: Server, entity: Entity, relation: Component, filter: AnyFilter?)
+	local world = server.world
+	local masking = server.masking
+
+	if world:has(relation, ECS_COMPONENT) then
+		masking:set_component(entity, relation, COMPONENT_TYPES.pair_value, filter)
+	else
+		masking:set_component(entity, relation, COMPONENT_TYPES.pair, filter)
+	end
+end
+
+function server_replicator.stop_networked(server: Server, entity: Entity)
+	if not server.track_info.networked[entity] then
+		return
+	end
+
+	local masking = server.masking
+	masking:register_stop_entity(entity)
+	masking:stop_entity(entity)
+
+	server.additions[entity] = nil
+	server.track_info.networked[entity] = nil
+end
+function server_replicator.stop_reliable(server: Server, entity: Entity, component: Component)
+	local masking = server.masking
+	if not server.track_info.entities[entity] then
+		return
+	end
+
+	local component_type = untrack_entity_component(server, entity, component)
+	if not component_type then
+		return
+	end
+
+	if server.track_info.networked[entity] then
+		masking:unregister_component_addition(entity, component, component_type)
+		masking:register_stop_component(entity, component, component_type)
+	end
+	masking:stop_component(entity, component, component_type)
+end
+function server_replicator.stop_unreliable(server: Server, entity: Entity, component: Component)
+	local masking = server.masking
+	if not server.track_info.entities[entity] then
+		return
+	end
+
+	local component_type = untrack_entity_component(server, entity, component)
+	if not component_type then
+		return
+	end
+
+	if server.track_info.networked[entity] then
+		masking:register_stop_component(entity, component, COMPONENT_TYPES.unreliable)
+	end
+	masking:stop_component(entity, component, COMPONENT_TYPES.unreliable)
+end
+function server_replicator.stop_pair(server: Server, entity: Entity, relation: Component)
+	local masking = server.masking
+	if not server.track_info.entities[entity] then
+		return
+	end
+
+	local component_type = untrack_entity_pair(server, entity, relation)
+	if not component_type then
+		return
+	end
+
+	if server.track_info.networked[entity] then
+		masking:unregister_component_addition(entity, relation, component_type)
+		masking:register_stop_component(entity, relation, component_type)
+	end
+	masking:stop_component(entity, relation, component_type)
+end
+
+function server_replicator.set_networked(server: Server, entity: Entity, filter: AnyFilter?)
+	if server.track_info.networked[entity] then
+		server_replicator.change_networked(server, entity, filter)
+	else
+		server_replicator.start_networked(server, entity, filter)
+	end
+end
+function server_replicator.set_reliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local entity_tracked = server.track_info.entities[entity]
+	if entity_tracked and entity_tracked[component] then
+		server_replicator.change_reliable(server, entity, component, filter)
+	else
+		server_replicator.start_reliable(server, entity, component, filter)
+	end
+end
+function server_replicator.set_unreliable(server: Server, entity: Entity, component: Component, filter: AnyFilter?)
+	local entity_tracked = server.track_info.entities[entity]
+	if entity_tracked and entity_tracked[component] then
+		server_replicator.change_unreliable(server, entity, component, filter)
+	else
+		server_replicator.start_unreliable(server, entity, component, filter)
+	end
+end
+function server_replicator.set_pair(server: Server, entity: Entity, relation: Component, filter: AnyFilter?)
+	local entity_tracked = server.track_info.entities[entity]
+	if entity_tracked and entity_tracked[relation] then
+		server_replicator.change_pair(server, entity, relation, filter)
+	else
+		server_replicator.start_pair(server, entity, relation, filter)
+	end
+end
+function server_replicator.set_custom(server: Server, entity: Entity, handler: Component | CustomId)
+	if server.custom_ids[entity] then
+		utils.logwarn("attempted to register a custom_id twice for the same entity", debug.traceback())
+		return
+	end
+	server.custom_ids[entity] = handler
+end
+
+function server_replicator.remove_custom(server: Server, entity: Entity)
+	server.custom_ids[entity] = nil
+end
+
 local function check_created(server: Server)
 	if server.inited == true then
 		warn "attempted to init a server twice"
@@ -1056,13 +1389,37 @@ local function check_created(server: Server)
 	return true
 end
 
-function init(server: Server, _world: World?)
+local function query_tracking_type(server: Server, track_type: Component)
+	for entity in server.world:query(PAIR(track_type, WILDCARD)):iter() do
+		local index = 0
+		while true do
+			local target = server.world:target(entity, track_type, index)
+			if not target then
+				break
+			end
+			server.set_reliable(server, entity, target, server.world:get(entity, PAIR(track_type, target)))
+			index += 1
+		end
+	end
+end
+
+local function query_current_networked(server: Server)
+	for entity, filter in server.world:query(server.components.networked):iter() do
+		server.set_networked(server, entity, filter)
+	end
+
+	query_tracking_type(server, server.components.reliable)
+	query_tracking_type(server, server.components.unreliable)
+	query_tracking_type(server, server.components.pair)
+end
+
+function server_replicator.init(server: Server, wrd: World?)
 	if not check_created(server) then
 		return
 	end
 	server.inited = true :: any
 
-	local world = _world or server.world
+	local world = wrd or server.world
 	server.world = world
 
 	if not world then
@@ -1077,159 +1434,59 @@ function init(server: Server, _world: World?)
 	server.hooks = hooks
 
 	local components = server.components
-	local masking = server.masking
-
-	server.shared = utils.create_shared_lookup(world, components)
+	server.shared = utils.resolved_shared(world, components, server.registered_custom_ids)
 
 	local function hook(unhook: () -> ())
 		table.insert(server.hooked, unhook)
 	end
 
-	hook(hooks.added(world, components.networked, function(entity, _id, filter)
-		masking:unregister_stop_entity(entity)
-		masking:start_entity(entity, filter)
-		masking:propagate_entity_addition(entity)
-
-		server.additions[entity] = true
-		server.track_info.entities[entity] = true
-		track_entity_lifetime(server, entity)
+	hook(hooks.added(world, components.networked, function(entity, _, filter)
+		server_replicator.start_networked(server, entity, filter)
 	end))
-	hook(hooks.changed(world, components.networked, function(entity, _id, filter)
-		masking:set_entity(entity, filter)
+	hook(hooks.changed(world, components.networked, function(entity, _, filter)
+		server_replicator.change_networked(server, entity, filter)
 	end))
 	hook(hooks.removed(world, components.networked, function(entity)
-		masking:register_stop_entity(entity)
-		masking:stop_entity(entity)
-
-		if server.pending_cleanups[entity] then
-			server.pending_cleanups[entity] = nil
-			cleanup_entity(server, entity)
-		end
-
-		server.additions[entity] = nil
-		server.track_info.entities[entity] = nil
+		server_replicator.stop_networked(server, entity)
 	end))
 
 	hook(hooks.added(world, components.reliable, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "reliable should be used with a pair relationship"
-		end
 		local component = PAIR_SECOND(world, id)
-
-		local component_type = track_entity_component(server :: Server, entity, component)
-		masking:unregister_stop_component(entity, component, component_type)
-		masking:start_component(entity, component, component_type, filter)
-		if server.additions[entity] then
-			masking:allocate_entity_addition(entity, component, component_type)
-		elseif server.track_info.entities[entity] then
-			masking:register_component_addition(entity, component, component_type)
-		end
+		server_replicator.start_reliable(server, entity, component, filter)
 	end))
 	hook(hooks.changed(world, components.reliable, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "reliable should be used with a pair relationship"
-		end
 		local component = PAIR_SECOND(world, id)
-
-		if world:has(component, ECS_COMPONENT) then
-			masking:set_component(entity, component, COMPONENT_TYPES.component, filter)
-		else
-			masking:set_component(entity, component, COMPONENT_TYPES.tag, filter)
-		end
+		server_replicator.change_reliable(server, entity, component, filter)
 	end))
 	hook(hooks.removed(world, components.reliable, function(entity, id)
-		if not IS_PAIR(id) then
-			utils.logerror "reliable should be used with a pair relationship"
-		end
-		if not server.track_info.entities[entity] then
-			return
-		end
-
 		local component = PAIR_SECOND(world, id)
-		local component_type = untrack_entity_component(server, entity, component)
-		if not component_type then
-			return
-		end
-		masking:unregister_component_addition(entity, component, component_type)
-		masking:register_stop_component(entity, component, component_type)
-		masking:stop_component(entity, component, component_type)
+		server_replicator.stop_reliable(server, entity, component)
 	end))
 
 	hook(hooks.added(world, components.pair, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "pair should be used with a relationship"
-		end
 		local relation = PAIR_SECOND(world, id)
-
-		local component_type = track_entity_pair(server, entity, relation)
-		masking:unregister_stop_component(entity, relation, component_type)
-		masking:start_component(entity, relation, component_type, filter)
-		if server.additions[entity] then
-			masking:allocate_entity_addition(entity, relation, component_type)
-		elseif server.track_info.entities[entity] then
-			masking:register_component_addition(entity, relation, component_type)
-		end
+		server_replicator.start_pair(server, entity, relation, filter)
 	end))
 	hook(hooks.changed(world, components.pair, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "reliable should be used with a pair relationship"
-		end
 		local relation = PAIR_SECOND(world, id)
-
-		if world:has(relation, ECS_COMPONENT) then
-			masking:set_component(entity, relation, COMPONENT_TYPES.pair_value, filter)
-		else
-			masking:set_component(entity, relation, COMPONENT_TYPES.pair, filter)
-		end
+		server_replicator.change_pair(server, entity, relation, filter)
 	end))
 	hook(hooks.removed(world, components.pair, function(entity, id)
-		if not IS_PAIR(id) then
-			utils.logerror "reliable should be used with a pair relationship"
-		end
-		if not server.track_info.entities[entity] then
-			return
-		end
-
 		local relation = PAIR_SECOND(world, id)
-		local component_type = untrack_entity_pair(server, entity, relation)
-		if not component_type then
-			return
-		end
-		masking:unregister_component_addition(entity, relation, component_type)
-		masking:register_stop_component(entity, relation, component_type)
-		masking:stop_component(entity, relation, component_type)
+		server_replicator.stop_pair(server, entity, relation)
 	end))
 
 	hook(hooks.added(world, components.unreliable, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "unreliable should be used with a pair relationship"
-		end
 		local component = PAIR_SECOND(world, id)
-		masking:unregister_stop_component(entity, component, COMPONENT_TYPES.unreliable)
-		masking:start_component(entity, component, COMPONENT_TYPES.unreliable, filter)
-		if server.additions[entity] then
-			masking:allocate_entity_addition(entity, component, COMPONENT_TYPES.unreliable)
-		end
+		server_replicator.start_unreliable(server, entity, component, filter)
 	end))
 	hook(hooks.changed(world, components.unreliable, function(entity, id, filter)
-		if not IS_PAIR(id) then
-			utils.logerror "unreliable should be used with a pair relationship"
-		end
 		local component = PAIR_SECOND(world, id)
-		masking:set_component(entity, component, COMPONENT_TYPES.unreliable, filter)
+		server_replicator.change_unreliable(server, entity, component, filter)
 	end))
 	hook(hooks.removed(world, components.unreliable, function(entity, id)
-		if not IS_PAIR(id) then
-			utils.logerror "unreliable should be used with a pair relationship"
-		end
-		if not server.track_info.entities[entity] then
-			return
-		end
-
 		local component = PAIR_SECOND(world, id)
-		untrack_entity_component(server, entity, component)
-		masking:register_stop_component(entity, component, COMPONENT_TYPES.unreliable)
-		masking:stop_component(entity, component, COMPONENT_TYPES.unreliable)
+		server_replicator.stop_unreliable(server, entity, component)
 	end))
 
 	hook(hooks.added(world, components.custom, function(entity, id)
@@ -1237,15 +1494,10 @@ function init(server: Server, _world: World?)
 			utils.logerror "replecs.custom should be used with a relationship in the server"
 		end
 		local target = PAIR_SECOND(world, id)
-		if server.custom_ids[entity] then
-			utils.logwarn("attempted to register a custom_id twice for the same entity", debug.traceback())
-			return
-		end
-
-		server.custom_ids[entity] = target
+		server_replicator.set_custom(server, entity, target)
 	end))
 	hook(hooks.removed(world, components.custom, function(entity)
-		server.custom_ids[entity] = nil
+		server_replicator.remove_custom(server, entity)
 	end))
 	hook(hooks.added(world, components.global, function(entity, _, value)
 		if value > 245 then
@@ -1265,53 +1517,76 @@ function init(server: Server, _world: World?)
 	end))
 
 	hook(hooks.removed(world, components.__alive_tracking__, function(entity)
-		if server.track_info.entities[entity] then
-			-- This is in case alive tracking removal is called before networked removal
-			server.pending_cleanups[entity] = true
-		else
-			cleanup_entity(server, entity)
+		if server.track_info.networked[entity] then
+			server_replicator.stop_networked(server, entity)
 		end
+		cleanup_entity(server, entity)
 	end))
 
 	for _, component in server.requires_shared_lookup do
 		hook(hooks.added(world, component, function()
-			server.is_dirty = true
+			server.is_shared_dirty = true
+		end))
+		hook(hooks.changed(world, component, function()
+			server.is_shared_dirty = true
 		end))
 		hook(hooks.removed(world, component, function()
-			server.is_dirty = true
+			server.is_shared_dirty = true
 		end))
 	end
 
+	query_current_networked(server)
+
 	if game and game:GetService("RunService"):IsServer() then
-		local added = game:GetService("Players").PlayerAdded:Connect(function(player)
+		local Players = game:GetService "Players"
+
+		local added = Players.PlayerAdded:Connect(function(player)
 			server.masking:register_client(player)
 		end)
-		local removed = game:GetService("Players").PlayerRemoving:Connect(function(player)
-			server.masking:register_client(player)
+		local removed = Players.PlayerRemoving:Connect(function(player)
+			server.masking:unregister_client(player)
 		end)
+		for _, player in Players:GetPlayers() do
+			server.masking:register_client(player)
+		end
 
 		table.insert(server.connections, added)
 		table.insert(server.connections, removed)
 	end
 end
 
-local function mark_player_ready(server: Server, player: Player)
+function server_replicator.mark_player_ready(server: Server, player: Player)
 	server.masking:activate_client(player)
 end
 
-local function is_player_ready(server: Server, player: Player): boolean
+function server_replicator.is_player_ready(server: Server, player: Player): boolean
 	return server.masking:member_is_active(player)
 end
 
-local function add_player_alias(server: Server, client: Player, alias: any)
+function server_replicator.add_player_alias(server: Server, client: Player, alias: any)
 	server.masking.client_aliases[alias] = client
 end
 
-local function remove_player_alias(server: Server, alias: any)
+function server_replicator.remove_player_alias(server: Server, alias: any)
 	server.masking.client_aliases[alias] = nil
 end
 
-local function destroy(server: Server)
+function server_replicator.register_custom_id(server: Server, custom_id: CustomId)
+	server.registered_custom_ids[custom_id] = true
+	server.is_shared_dirty = true
+end
+
+function server_replicator.generate_handshake(server: Server): common.HandshakeInfo
+	server_replicator.resolve_dirty(server)
+	return utils.generate_handshake(server.world, server.shared)
+end
+
+function server_replicator.verify_handshake(server: Server, handshake: common.HandshakeInfo): (boolean, string?)
+	server_replicator.resolve_dirty(server)
+	return utils.verify_handshake(server.world, server.shared, handshake, "client", "server")
+end
+
+function server_replicator.destroy(server: Server)
 	if server.inited == nil then
 		return warn "attempted to destroy a server twice"
 	end
@@ -1325,20 +1600,6 @@ local function destroy(server: Server)
 	end
 end
 
-local server = {}
-server.__index = server
-server.init = init
-server.destroy = destroy
-server.get_full = get_full
-server.collect_updates = collect_updates
-server.collect_unreliable = collect_unreliable
-server.encode_component = encode_component
-server.decode_component = decode_component
-server.mark_player_ready = mark_player_ready
-server.is_player_ready = is_player_ready
-server.add_player_alias = add_player_alias
-server.remove_player_alias = remove_player_alias
-
 local function create(world: World?, components: common.Components): Server
 	local self = {} :: Server
 
@@ -1349,10 +1610,11 @@ local function create(world: World?, components: common.Components): Server
 	self.additions = {}
 	self.storage = {}
 	self.hooked = {}
-	self.is_dirty = false
+	self.is_shared_dirty = false
 	self.global_ids = {}
 	self.pending_cleanups = {}
 	self.track_info = {
+		networked = {},
 		entities = {},
 		components = {},
 	}
@@ -1361,16 +1623,17 @@ local function create(world: World?, components: common.Components): Server
 	self.masking = masking_controller.create()
 	self.alive_tracked = {}
 	self.custom_ids = {}
+	self.registered_custom_ids = {}
 	self.requires_shared_lookup = {
 		self.components.shared,
 		self.components.serdes,
-		self.components.bytespan,
 		jecs.Name,
 	}
 
-	return setmetatable(self, server) :: any
+	return setmetatable(self, server_replicator) :: any
 end
 
-server.create = create
-
-return server :: { create: typeof(create) }
+return {
+	create = create,
+	server_replicator = server_replicator,
+}