feat: a player's construction can leave out its position and world transition

For the one construction a client gets of its own player after a seamless instance move. The client applies a
construction's frame to its player at once (LWOBasePhysComponent::Deserialize, 0x00bf5a10), and world transition
state 0 makes it fade the screen in from white (LWOCharacterComponent::PostCharacterLoaded, 0x00c71660). State 3 is
read but nothing acts on it. Nothing sets either flag yet.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
This commit is contained in:
Aaron Kimbrell
2026-11-10 15:15:16 -06:00
parent 7695445c4c
commit f081dafb94
5 changed files with 124 additions and 8 deletions

View File

@@ -225,12 +225,20 @@ void CharacterComponent::Serialize(RakNet::BitStream& outBitStream, bool bIsInit
outBitStream.Write(m_RacesFinished);
outBitStream.Write(m_FirstPlaceRaceFinishes);
outBitStream.Write0();
outBitStream.Write(m_IsLanding);
if (m_IsLanding) {
outBitStream.Write<uint16_t>(m_LastRocketConfig.size());
for (uint16_t character : m_LastRocketConfig) {
outBitStream.Write(character);
// The world transition state, two bits: 0 none, 1 arriving by rocket, 2 leaving. The client's
// LWOCharacterComponent::PostCharacterLoaded (0x00c71660) fades the screen in from white and pushes its
// gameplay state again when it reads 0. A client that kept its scene gets 3, which nothing acts on.
if (m_KeepClientScene) {
outBitStream.Write1();
outBitStream.Write1();
} else {
outBitStream.Write0();
outBitStream.Write(m_IsLanding);
if (m_IsLanding) {
outBitStream.Write<uint16_t>(m_LastRocketConfig.size());
for (uint16_t character : m_LastRocketConfig) {
outBitStream.Write(character);
}
}
}
}

View File

@@ -71,6 +71,13 @@ public:
void SetLastCustomBuild(const std::u16string& tokenizedLOTList) { m_LastRocketConfig = tokenizedLOTList; }
bool GetIsLanding() const { return m_IsLanding; }
/**
* Constructions written while this is set tell the client there is no world transition to show (state 3 instead
* of 0 or the rocket landing). For the one construction a client gets of its own player after a seamless instance
* move (docs/SeamlessTransfer.md).
*/
void SetKeepClientScene(const bool value) { m_KeepClientScene = value; }
/**
* Find a player's rocket
* @param player the entity that triggered the event
@@ -418,6 +425,11 @@ private:
*/
bool m_IsLanding;
/**
* Whether constructions say there is no world transition to show (SetKeepClientScene)
*/
bool m_KeepClientScene = false;
/**
* The configuration of the last used rocket, essentially a string of LOTs separated by commas
*/