N8: Keep connections serviced while islands are made, and stop servers gracefully

The soak's drops under loss came from stalls: the server's island (#79) and
each client process making islands on its main thread fed ENet second-long
round-trip samples, its retransmission timer grew, and two losses of one
reliable message in the busy drop that followed reached the 15 s timeout.

- ClientGame.build_in_background makes a new match's island on a
  WorkerThreadPool task and holds the packets that arrive meanwhile, then
  takes them in order. The networked client and the soak's clients use it;
  the soak's own one-island-a-frame holding is gone.
- NetServer.close(grace_msec) sends the shutdown notice reliably and
  services the socket while clients acknowledge it. The headless server
  waits up to 2 s. A notice sent once was lost under 2% loss, and that
  client timed out instead of hearing the server stop.
- Tests: background island holding and ordering, freeing mid-build, a
  graceful shutdown reaching four clients behind 50% loss (it fails with
  the old one-shot notice), and the scripted UDP match and client capture
  wait for the client's island the way a real 20 s lobby would.

The soak at 2% loss and +/-20 ms now keeps all 24 clients for both matches,
with 0 of 3,758 world hashes differing and every client told of the stop.
It still fails on client memory growth between matches in two of three
processes (17 and 20 MB), which is not yet explained, so #39 stays open.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-13 01:28:08 -05:00
co-authored by Claude Opus 5.5
parent ad0fd2695d
commit 09d663e647
9 changed files with 259 additions and 64 deletions
+54
View File
@@ -151,3 +151,57 @@ func test_a_new_match_starts_everything_again() -> void:
assert_false(client.remote.started)
assert_eq(worlds, [first_seed, first_seed + 1])
assert_eq(client.match_index, 1)
## N8: with build_in_background the island is made on a worker thread, and the packets
## that arrive meanwhile are held, then taken in order once it's made.
func test_a_background_island_holds_packets_and_takes_them_in_order() -> void:
var worlds: Array[int] = []
var client: ClientGame = ClientGame.new()
client.build_in_background = true
client.make_world = func(match_seed: int) -> Simulation:
# Slow enough that the packets below certainly arrive while it runs.
OS.delay_msec(300)
worlds.append(match_seed)
return Simulation.new(match_seed, SimGround.flat())
loop.match_flow.rules.min_players = 5
assert_true(loop.match_flow.join(7))
game.adopt(7)
client.receive(NetProtocol.CHANNEL_CONTROL, game.match_notice())
assert_true(client.building_world(), "the notice starts the island in the background")
assert_null(client.world, "and nothing waits for it")
client.receive(NetProtocol.CHANNEL_CONTROL, game.world_notice())
loop.run_tick()
game.after_tick()
client.receive(NetProtocol.CHANNEL_STATE, game.snapshot_for(7))
assert_eq(client.held_count(), 3, "the notice, the world and the snapshot are held")
assert_eq(client.receiver.malformed, 0)
var started: int = Time.get_ticks_msec()
while client.building_world() and Time.get_ticks_msec() - started < 5000:
client.advance(DT)
OS.delay_msec(5)
assert_false(client.building_world())
assert_eq(client.held_count(), 0, "everything held was taken in")
assert_eq(worlds, [loop.match_flow.current_seed()], "one island, for the notice's seed")
assert_not_null(client.world)
assert_eq(client.world_seed, loop.match_flow.current_seed())
assert_eq(client.match_index, 0)
assert_true(client.replica.applied >= 1, "the WORLD message went on the new island")
assert_eq(client.outbox.size(), 1, "and the snapshot was answered")
assert_eq(client.bad_packets, 0)
# The same seed again doesn't make another island.
client.receive(NetProtocol.CHANNEL_CONTROL, game.match_notice())
assert_false(client.building_world())
assert_eq(worlds.size(), 1)
func test_a_client_freed_while_its_island_is_made_waits_for_it() -> void:
var client: ClientGame = ClientGame.new()
client.build_in_background = true
client.make_world = func(match_seed: int) -> Simulation:
OS.delay_msec(100)
return Simulation.new(match_seed, SimGround.flat())
client.receive(NetProtocol.CHANNEL_CONTROL, game.match_notice())
assert_true(client.building_world())
client = null
assert_true(true, "freeing it with a task running raises no error")