mirror of
https://github.com/jcreek/CosmicClash.git
synced 2026-09-10 16:04:04 +00:00
Josh Creek
4fb7ddfecf
multiplayer-todo.md and multiplayer-next.md tracked overlapping information in two places. Fold everything into multiplayer-next.md (architecture decisions, wire format, task breakdown with checkboxes, gotchas list, testing notes) and delete multiplayer-todo.md. Section numbers are unchanged, so existing code comments citing them by section/task number still resolve; update every such reference to point at the new filename.
48 lines
1.9 KiB
GDScript
48 lines
1.9 KiB
GDScript
extends RefCounted
|
|
|
|
# Plain data holder for one body's snapshot state (§2.4 of multiplayer-next.md).
|
|
# Deliberately not Ship/Ball themselves, and deliberately not a scene-tree
|
|
# node — NetCodec's pack/unpack must stay callable from pure-function tests
|
|
# with no live scene. Phase 2's snapshot writer fills one of these per body
|
|
# per tick from the real RigidBody3D state; Phase 2's interpolator does the
|
|
# reverse.
|
|
#
|
|
# avel_range must match what the sender quantised with (SHIP_AVEL_RANGE vs
|
|
# BALL_AVEL_RANGE in net_codec.gd) — it is not carried on the wire, because
|
|
# slot order already tells both peers which body is which (§1.3: "entities
|
|
# are addressed by integer slot, never by path").
|
|
|
|
var position := Vector3.ZERO
|
|
var rotation := Quaternion.IDENTITY
|
|
var linear_velocity := Vector3.ZERO
|
|
var angular_velocity := Vector3.ZERO
|
|
var frozen := false
|
|
var turbo := false
|
|
var thrust_z := 0.0 # -1..1; re-quantised to a 3-bit bin on the wire
|
|
var stalled := false
|
|
var avel_range := 4.0 # NetCodec.SHIP_AVEL_RANGE; set to BALL_AVEL_RANGE for the ball
|
|
|
|
# Self-referential preload, not get_script().new() — this file deliberately
|
|
# has no class_name (same cache-timing reason as test_case.gd and other
|
|
# path-`extends`d files in this project), and get_script().new() throws
|
|
# "Nonexistent function 'new' in base 'GDScript'" from within the script's
|
|
# own body in this Godot version.
|
|
const _NetBodyState = preload("res://scripts/net_body_state.gd")
|
|
|
|
|
|
# Same contract as ShipAction.copy() (see its own comment): a distinct
|
|
# instance with equal fields, for callers that hold onto a state past the
|
|
# tick/comparison it was returned in.
|
|
func copy() -> RefCounted:
|
|
var c := _NetBodyState.new()
|
|
c.position = position
|
|
c.rotation = rotation
|
|
c.linear_velocity = linear_velocity
|
|
c.angular_velocity = angular_velocity
|
|
c.frozen = frozen
|
|
c.turbo = turbo
|
|
c.thrust_z = thrust_z
|
|
c.stalled = stalled
|
|
c.avel_range = avel_range
|
|
return c
|