17
0
mirror of https://github.com/MaSzyna-EU07/maszyna.git synced 2026-10-18 10:19:20 +02:00
Files
maszyna/network/session.h
Hirek193 30fa68cfd8 multiplayer stage 8: state correction and surviving a dropped connection
Two things were still missing once a session ran for a while: a peer that had
drifted apart from the authority had no way back short of restarting, and a
connection that blinked cost the player their seat and handed their vehicle to
the AI while the other driver was still sitting in it.

- a client that disagrees with the authoritative digest for 120 steps in a row
  asks to be put back in line, and the server answers with a fresh snapshot.
  There is a cooldown between requests, so a correction that needs a moment to
  take hold does not turn into a stream of them
- the server hands out a session token with its hello and remembers it. Present
  it again on the next connection and you come back as the same peer, with the
  same id
- a lost connection no longer removes the peer from its crews: the seat is held
  for a minute. Come back in time and nothing changed; stay away and the seat
  is given up properly, handing the vehicle back to the AI only when that
  leaves the crew empty and the AI was driving it in the first place
- after applying a snapshot a peer that finds itself on a crew walks into that
  cab, which is what makes a reconnect land the player back where they were
- the vehicle roster is sent to a joining peer right before its snapshot, so
  the crew section resolves to names instead of waiting for the next broadcast
2026-09-06 19:48:06 +00:00

132 lines
4.6 KiB
C++

/*
This Source Code Form is subject to the
terms of the Mozilla Public License, v.
2.0. If a copy of the MPL was not
distributed with this file, You can
obtain one at
http://mozilla.org/MPL/2.0/.
*/
#pragma once
#include "network/entities.h"
#include "input/command.h"
#include <string>
#include <unordered_map>
#include <vector>
namespace network
{
// who is working on a given vehicle. a vehicle can hold more than one person, which is
// the whole point of the crew model - the container is not limited by design, only by
// the capacity the server advertises
struct vehicle_crew
{
NetworkEntityId entity_id{ENTITY_NONE};
std::vector<PeerId> crew;
// whether the AI was actually driving before the first human arrived. a vehicle that
// nobody was driving must not suddenly acquire an AI driver when its crew leaves
bool ai_before_claim{false};
// set on the 1 -> 0 transition, cleared once the AI has been handed the vehicle back
bool ai_restore_pending{false};
// keeps reconcile() from re-posting the same request every single frame while the
// previous one is still on its way through the command queue
int action_cooldown{0};
};
enum class claim_result
{
granted,
already_member,
unknown_vehicle,
vehicle_missing,
crew_full
};
std::string describe(claim_result Result);
// crew bookkeeping. authoritative on the server; on a client this is a read only mirror
// fed by CREW_UPDATE, used by the lobby
class crew_registry
{
public:
claim_result claim(PeerId Peer, NetworkEntityId Id);
// returns true when the peer really was part of the crew
bool leave(PeerId Peer, NetworkEntityId Id);
// removes a peer from every crew it belonged to
void drop_peer(PeerId Peer);
// the peer lost its connection. its seat is held for a while, so that a short dropout
// does not empty a cab and hand a vehicle back to the AI under the other driver's nose
void suspend_peer(PeerId Peer);
// the peer made it back in time and keeps everything it had
void resume_peer(PeerId Peer);
// actually removes the peers whose grace period ran out
void expire_absences();
// true while the peer is gone but still holding its seat
bool is_absent(PeerId Peer) const;
std::vector<PeerId> crew_of(NetworkEntityId Id) const;
bool is_member(PeerId Peer, NetworkEntityId Id) const;
uint8_t count(NetworkEntityId Id) const;
NetworkEntityId vehicle_of(PeerId Peer) const;
// client side: takes over the crew of one vehicle as published by the server
void mirror(NetworkEntityId Id, std::vector<PeerId> const &Crew);
// server side: brings the world in line with the crew roster - creates the cab of a
// claimed vehicle, hands the vehicle over from the AI and hands it back when the last
// person leaves. safe to call every frame, it only acts when something is out of place
void reconcile();
// ids whose crew changed since the last call
std::vector<NetworkEntityId> take_pending_updates();
// queues every crew for republication, so that a peer which just went active learns
// about the vehicles that were taken over before it arrived
void mark_all_pending();
void clear();
private:
vehicle_crew &entry(NetworkEntityId Id);
std::unordered_map<NetworkEntityId, vehicle_crew> m_vehicles;
std::vector<NetworkEntityId> m_pending;
// peers that dropped out, with the moment their seat stops being held
std::unordered_map<PeerId, double> m_absent;
};
extern crew_registry Crews;
// how long a disconnected peer keeps its place in the crew
constexpr double RECONNECT_GRACE_SECONDS = 60.0;
// resolves the identity of a connecting peer. an unknown or empty token means somebody
// new and gets a fresh peer id together with a token of their own; a token this server
// handed out before brings back the peer id that went with it, and with it the seat in
// whatever crew the peer was on
PeerId resolve_peer_identity(uint64_t &Token);
// what a peer is allowed to ask the simulation for
enum class command_verdict
{
accepted,
not_in_crew,
privileged,
unsupported_target
};
std::string describe(command_verdict Verdict);
// the whole of the authority check for an incoming command. the host passes it too, it
// simply holds every right - there is no separate path for the local participant
command_verdict validate_command(PeerId Peer, user_command Command, uint32_t Recipient);
// drops everything the peer is not allowed to ask for and stamps the rest with its
// identity. used for the local participant as well, so that host input goes through the
// very same authority layer as input arriving over the wire, only without the transport
void filter_commands(PeerId Peer, command_queue::commands_map &Commands);
} // namespace network