Subscribe to download
Sync Data API

Note: If your mod overrides StagingRoom.lua, make sure to add the following code at the start of your OnChat function to filter data:

if toPlayer >= 655000 and toPlayer <= 999999 then
return
end

Implements reliable data synchronization in multiplayer games without causing reloads from frequent data transmissions.

---

• When using SetProperty to store data, other players cannot access it in multiplayer.
• When using ChangeGold or AttachModifierByID to modify game data outside global events, other players won’t receive the update.
• When using custom UI or mechanics that require frequent data exchange, PlayerConfigurations:SetValue can cause reloads.

---

• The chat system triggers the MultiplayerChat event whenever a message is sent to all players.
• Using PlayerConfigurations:SetValue multiple times per turn may cause reloads, while the chat system will not.
• Other in-game mechanisms (e.g., DiplomacyMeet events) require manual setup and may interfere with diplomacy.

---

No.
As long as the message is not sent via port -1 (the “send to all players” chat ID), it will be ignored in the callback.

However, if another mod listens to all MultiplayerChat events, data leakage is inevitable.

---

No.
This system has been tested extensively in the “Multiverse Trading System” mod—over 100 turns and hundreds of modifier bindings—without any reloads or crashes.

---

The mod includes the built-in function:
GameEvents.BroadcastInfo_MTS.Call(iPlayerID, infoString)
Used to send broadcast messages through global chat.

For example:
When playing co-op (PVE) with friends using cheat mods, broadcasting changes via this function prevents hidden cheating.

---

Thank you for using this mod!
If you have better synchronization ideas, feel free to contact me.