Phase 7: netfox + godot-jolt stack upgrade

Stack installed:
- netfox v1.35.3 (core + extras + noray + internals)
- godot-jolt v0.16.0-stable

Architecture:
- Server: ENet transport (works headless, no netfox deps)
- Client/Editor: netfox rollback (RollbackSynchronizer, TickInterpolator)

New/modified:
- docs/migration-netfox-plan.md — migration architecture
- scripts/network/network_manager.gd — netfox-aware ENet fallback
- scripts/network/player.gd — clean base player
- client/characters/player_netfox.gd — rollback player w/ WeaponManager
- client/characters/input/player_net_input.gd — BaseNetInput subclass
- client/characters/character/fps_character_controller.gd — netfox input feed
- client/weapons/ — weapon data, registry, TacticalWeaponHitscan, WeaponManager
- client/scripts/round_replicator.gd — client-side round state bridge
- server/scripts/round_manager.gd — improved state machine
- server/scripts/plugin_api/plugin_manager.gd — refined plugin system
- config: enemy_tag, ally_tag for meatball targeting

Removed: old C++ SimulationServer GDExtension (replaced by netfox rollback)
This commit is contained in:
2026-07-02 17:38:50 -04:00
parent e2dc429caa
commit e7299b17e9
3237 changed files with 523530 additions and 18 deletions
@@ -0,0 +1,21 @@
extends RefCounted
class_name NetworkClockSample
var ping_sent: float
var ping_received: float
var pong_sent: float
var pong_received: float
func get_rtt() -> float:
return pong_received - ping_sent
func get_offset() -> float:
# See: https://datatracker.ietf.org/doc/html/rfc5905#section-8
# See: https://support.huawei.com/enterprise/en/doc/EDOC1100278232/729da750/ntp-fundamentals
return ((ping_received - ping_sent) + (pong_sent - pong_received)) / 2.
func _to_string() -> String:
return "(theta=%.2fms; delta=%.2fms; t1=%.4fs; t2=%.4fs; t3=%.4fs; t4=%.4fs)" % [
get_offset() * 1000., get_rtt() * 1000.,
ping_sent, ping_received, pong_sent, pong_received
]
@@ -0,0 +1 @@
uid://cdmch34dx2uhe
+41
View File
@@ -0,0 +1,41 @@
extends Object
class_name NetworkClocks
class SystemClock:
var offset: float = 0.
func get_raw_time() -> float:
return Time.get_unix_time_from_system()
func get_time() -> float:
return get_raw_time() + offset
func adjust(p_offset: float) -> void:
offset += p_offset
func set_time(p_time: float) -> void:
offset = p_time - get_raw_time()
class SteppingClock:
var time: float = 0.
var last_step: float = get_raw_time()
func get_raw_time() -> float:
return Time.get_unix_time_from_system()
func get_time() -> float:
return time
func adjust(p_offset: float) -> void:
time += p_offset
func set_time(p_time: float) -> void:
last_step = get_raw_time()
time = p_time
func step(p_multiplier: float = 1.) -> void:
var current_step := get_raw_time()
var step_duration := current_step - last_step
last_step = current_step
adjust(step_duration * p_multiplier)
+1
View File
@@ -0,0 +1 @@
uid://dnp07ns6cpc70
@@ -0,0 +1,98 @@
extends Node
class_name NetworkTickrateHandshake
## Internal class to manage the tickrate handshake.
##
## Whenever a new peer joins, they exchange their configured tickrate with the
## host. If the tickrate mismatches, a warning is emitted by default, as this is
## assumed to be a developer mistake.
## [br][br]
## However, if this is expected, different actions can be configured.
## Emit a warning on tickrate mismatch
const WARN := 0
## Disconnect peer on tickrate mismatch[br]
## This is enforced by the host.
const DISCONNECT := 1
## Adjust tickrate to the host's on mismatch
const ADJUST := 2
## Emit [signal on_tickrate_mismatch] on mismatch[br]
## This is emitted on both host and client.
const SIGNAL := 3
## Configures what happens on a tickrate mismatch.[br]
## Defaults to [constant WARN], based on project settings.
var mismatch_action: int = ProjectSettings.get_setting(&"netfox/time/tickrate_mismatch_action", WARN)
static var _logger := NetfoxLogger._for_netfox("NetworkTickrateHandshake")
## Emitted when a tickrate mismatch is encountered, and [member mismatch_action] is set to
## [constant SIGNAL].
signal on_tickrate_mismatch(peer: int, tickrate: int)
## Run the tickrate handshake.
## [br][br]
## This will connect to signals, so that every new peer receives tickrate info
## from the host.
## [br][br]
## Called by [_NetworkTime], no need to call manually.
func run() -> void:
if multiplayer.is_server():
# Broadcast tickrate
_submit_tickrate.rpc(NetworkTime.tickrate)
# Submit tickrate to anyone joining
multiplayer.peer_connected.connect(_handle_new_peer)
else:
# Submit tickrate to host
_submit_tickrate.rpc_id(1, NetworkTime.tickrate)
## Stop the tickrate handshake.
## [br][br]
## Called by [_NetworkTime], no need to call manually.
func stop() -> void:
if multiplayer.peer_connected.is_connected(_handle_new_peer):
multiplayer.peer_connected.disconnect(_handle_new_peer)
func _ready() -> void:
name = "NetworkTickrateHandshake"
func _handle_new_peer(peer: int) -> void:
if multiplayer.is_server():
_submit_tickrate.rpc_id(peer, NetworkTime.tickrate)
func _handle_tickrate_mismatch(peer: int, tickrate: int) -> void:
match mismatch_action:
WARN:
_logger.warning(
"Local tickrate %dtps differs from tickrate of peer #%d at %dtps! " +
"Make sure that tickrates are correctly configured in the Project settings! " +
"See netfox/Time/Tickrate.", [
NetworkTime.tickrate, peer, tickrate
])
DISCONNECT:
if multiplayer.is_server():
_logger.warning("Peer #%d's tickrate of %dtps differs from expected %dtps! Disconnecting.", [
peer, tickrate, NetworkTime.tickrate
])
multiplayer.multiplayer_peer.disconnect_peer(peer)
ADJUST:
if not multiplayer.is_server():
_logger.info("Local tickrate %dtps differs from tickrate of host at %dtps! Adjusting.", [
NetworkTime.tickrate, tickrate
])
# TODO: Make tickrate mutable at user's digression
ProjectSettings.set_setting(&"netfox/time/tickrate", tickrate)
SIGNAL:
on_tickrate_mismatch.emit(peer, tickrate)
@rpc("any_peer", "reliable", "call_remote")
func _submit_tickrate(tickrate: int) -> void:
var sender := multiplayer.get_remote_sender_id()
_logger.debug("Received tickrate %d from peer %d", [tickrate, sender])
if tickrate != NetworkTime.tickrate:
_handle_tickrate_mismatch(sender, tickrate)
@@ -0,0 +1 @@
uid://ododt6lhpbvq