Ore Factory Squad — Anatomi Teknis

Co-op host/listen-server lewat Steam — tanpa server dedicated, tanpa port-forwarding. Satu pemain jadi host, sisanya join via lobby Steam.

Mirror sebagai HLAPI (abstraksi [Command] [ClientRpc] SyncVar di atas transport), FizzySteamworks sebagai transport di atas Steam P2P/relay, dan Heathen Steamworks untuk lobby + matchmaking. Ada NetworkRoomManager/NetworkLobbyManager (room dulu, baru masuk game), plus NetworkDiscovery untuk LAN.

• Join lewat Steam lobby + lobby code (SetSteamLobbyID, currentSteamLobbyID, invite). Identitas pemain dari Steam: NetworkplayerSteamId.
• Dunia besar di-load additive & disinkron progresnya antar client: AdditiveNetworkManager, NetworkLoadingSync — semua nunggu sampai scene siap.
• Aksi yang mengubah dunia bersifat server-authoritative: client minta, server yang eksekusi lalu broadcast. Contoh menggali: Cmd_RequestDigSingle → server apply → sync ke semua.
• State frekuensi tinggi di-bit-pack manual untuk hemat bandwidth: TrafficStatePacker (FloatIntUnion), CompressQuaternion, CompressVarInt.
• Voice chat dua jalur: Steam voice (GetVoice/DecompressVoice) dan Opus via CmdSendVoiceData/RpcReceiveVoiceData.

Bukan voxel dari nol. Unity Terrain sebagai dasar, Digger PRO menempelkan lapisan voxel untuk lubang, gua, dan overhang yang bisa digali real-time.

Digger PRO — voxel + MarchingCubesPolygonizer di atas Unity Terrain, dengan generasi mesh di Burst Jobs (AdvancedVoxelGenerationJob) dan native collections. Ditambah BurstTriangulator dan UnityMeshSimplifier untuk LOD hasil galian.

• Dunia dibagi chunk voxel: ChunkVoxelPosition, CalculateTerrainChunkLayout — hanya chunk terdampak yang di-regenerate.
• Setelah menggali, voxel mengambang dideteksi & dibuang lewat connected-component labeling (VoxelPhysics.ConnectedComponentLabeling, HandleFloatingVoxels) — jadi tanah tidak menggantung tak wajar.
• Gameplay dibungkus konsep "Digsite" (zona tambang): digBrush, digDepthThreshold, DigableAreaCheck, gua tersimpan sebagai CaveSystemSaveData.
• Menggali diintegrasikan ke netcode: server yang apply (Cmd_RequestDigSingle), bukan tiap client bikin mesh sendiri.

Dua sisi: menjaga frame-rate di dunia besar, dan menulis/membaca save yang besar tanpa nge-freeze — dengan trik "simpan delta, bukan dunia".

• Per-sistem, bukan per-GameObject. Tiap manager serialisasi struct ringkasnya sendiri: ConveyorBeltSaveData, BankSaveData, ContractManagerSaveData, CaveSystemSaveData, dst. Dunia direkonstruksi saat load, bukan menyimpan scene mentah.
• Segmented + coroutine. Save dipecah jadi segmen yang ditulis lintas frame: _numberOfSegmentsForMostRecentSave, NanoSaveCoroutineHelper — tidak ada freeze walau save besar.
• Simpan delta, bukan dunia. Terrain dibangkitkan prosedural (GenerateTerrainChunks); yang disimpan hanya edit galian + objek yang ditaruh pemain. Ini yang bikin save tetap kecil di dunia raksasa.
• Satu serializer, dua fungsi. Save yang sama dikirim host ke pemain yang baru join sebagai file snapshot: Co_SendFileSnapshotTo, Co_ApplyFileSnapshot. Persistence dan late-join pakai jalur serialisasi yang sama.

Setiap sistem gameplay yang perlu disimpan meng-implement satu kontrak — bukan sekadar "serialize", tapi lengkap dengan identitas & mode load:

interface IGameSave {
    string   SaveID   { get; }   // kunci unik per sistem
    bool     IsShared { get; }   // state dunia (shared) vs per-pemain
    Type     SaveType { get; }   // tipe objek *SaveData
    LoadMode LoadMode { get; }   // enum: kapan/bagaimana di-load
    object   GetSaveData(bool includeNonSavable);  // serialize
    Task     OnLoad(object value);                 // deserialize + apply (async)
}

Yang meng-implement (semua sekaligus NetworkBehaviour): FactoryManager T_ConveyorBelt CaveSystemManager T_MinerVehicle DigSiteHazardManager FactoryCustomizationManager — SaveLoadGameManager enumerasi semua, panggil GetSaveData(), lalu saat load panggil OnLoad(value) async (Task) supaya sistem berat tidak nge-block. Flag includeNonSavable membuat satu method melayani dua mode (save penuh vs capture ringan).

Menggali disinkron ke client dengan dua strategi lewat Mirror NetworkMessage:

struct ReplayOp { Vector3 pos; byte brush; byte action; float size, opacity; sbyte textureIndex; } — tiap galian jadi op mungil (perhatikan tipe hemat: byte/sbyte). Dikirim batch via ReplayChunkMsg(List<ReplayOp>) dengan ReplayBeginMsg{startIndex} dan ClientReadyForReplayMsg{lastKnownIndex} → client hanya menerima op setelah yang sudah dimilikinya (catch-up inkremental), lalu memutar ulang untuk merekonstruksi terrain.

FileSnapshotBeginMsg{totalFiles} → FileDataMsg{fileName, byte[] compressedData, uncompressedSize} per file → FileSnapshotEndMsg → FileBatchAckMsg. File voxel Digger dikirim gzip, per-batch, dengan ack, diterapkan lewat coroutine Co_ApplyFileSnapshot.

Pelajaran: kirim intent kecil saat bisa (op-list deterministik), fallback ke transfer file terkompresi berbatch untuk state besar. Persistence & late-join memakai serializer yang sama.

Dari NewNetworkManager : NetworkManager dan SaveLoadGameManager — lima pola yang bikin dunia besar + multiplayer tetap stabil.

• Late-join = load scene → stream terrain. OnServerAddPlayer → HandlePlayerLoadingCompletion(conn), dan di dalamnya server menyerahkan ke DiggerReplayMessenger untuk men-stream state galian ke pemain baru. Traffic juga: SendTrafficInitialStateNextFrame.
• Load bergerbang reference-count. RegisterPendingLoadOperation(reasonKey) / CompletePendingLoadOperation + _activeReasons — tiap subsistem mendaftar "masih loading"; UI hilang saat semua selesai (HasPendingOperations). Cara bersih menangani load multi-sistem tanpa menebak "kapan siap".
• Freeze fisika saat load. RegisterKinematicForLoad(Rigidbody) → ReleaseAllKinematics() — rigidbody dibekukan selama world streaming lalu dilepas serentak. Cegah benda nembus lantai sebelum collider siap.
• Save async + UX multiplayer. Task SaveGame() (non-blocking) dengan ShowSavingPanelOnAllClients() / HideSavingPanelOnAllClients(). Autosave dipicu event OnDayStarted (batas hari), bukan timer sembarang.
• Wrapper "Safe" + alasan disconnect. StartHostSafe / StartServerOnlySafe / StartClientSafe, dan DisconnectReason + DisconnectReasonMessage → client tahu kenapa terputus (kick, lobby penuh, host stop) dan tampilkan pesan tepat.

State pemain disebar lewat SyncVar (auto server→client, dengan hook): playerName playerSteamId isInDigsite customizationIDs vehicleNetId. Aksi memakai satu pola konsisten — wrapper publik → [Command] → Server* → [ClientRpc]/[TargetRpc]: mis. NetworkTeleport → CmdTeleport → RpcTeleport → ApplyTeleportLocal; damage SendDamage → CmdReceiveDamage → ServerReceiveDamage → TargetReceiveDamage. Semua mutasi lewat server. Voice: field SteamVoiceChat voiceChat per pemain.

Nilai yang menentukan mulus-tidaknya transfer terrain besar (semua di Inspector): REPLAY_CHUNK_SIZE (op per pesan), APPLY_PER_FRAME (op diterapkan per frame — anti-hitch), FILES_PER_BATCH, FILE_BATCH_DELAY, COMPRESS_FILE_DATA (gzip), USE_ACK_FLOW_CONTROL + ACK_TIMEOUT (tunggu ack sebelum batch berikut). Per-koneksi dilacak _lastSentIndex/_lastAckReceived untuk catch-up inkremental.

Dua implementasi nyata — pola save + netcode yang paling layak ditiru tim.

• Save = struct kecil, dunia direkonstruksi. FactorySaveData hanya { money, currentXP, level, name }; CaveSystemSaveData hanya List<CaveSaveEntry> berisi flag ringkas (aktif/pecah/item-spawned + jumlah node). OnLoad(object) cast balik & terapkan. Tidak ada GameObject/mesh yang di-serialize.
• Versi per-entry. Tiap CaveSaveEntry.saveVersion + CURRENT_SAVE_VERSION → migrasi save bisa per-item, bukan hanya per-file global.
• Mutasi 100% server-authoritative. UI panggil AddMoney → CmdAddMoney (client→server) → ServerAddMoney (validasi + tulis SyncVar _money) → auto-propagate → OnMoneyChangedHook update UI di semua client. Client tak pernah ubah uang langsung — anti-cheat + konsisten.
• Pisahkan angka mentah dari tampilan. SyncVar _money/_currentXP/_level → properti read-only terhitung (XPProgress, RequiredXPForNextLevel) dari LevelConfigSO. UI tidak menyentuh field mentah.
• State dunia via SyncList + simpan delta. CaveSystemManager menyebar status gua lewat Mirror SyncList (ApplyCaveActive/ApplyDoorBroken), tapi yang disimpan hanya List<CaveSaveEntry> — delta, bukan geometri.
• Gating demo jadi warga kelas satu. IsDemoLevelLimitReached + CmdSetLevel menolak naik di atas cap demo (Level 3) di sisi server — tak bisa dibypass client.

Item cuma data: ItemStack { string itemId; int count; } — bukan GameObject. Semua yang memegang item mewarisi satu base:

abstract class ItemContainerBase : NetworkBehaviour, IItemContainer {
    protected SyncList<ItemStack> storedItemStacks;   // sumber kebenaran (auto-sync)
    protected Dictionary<string,int> itemCounts;       // cache turunan (perf)
    public virtual void ServerSetItems(...); ServerRemoveItems(...); ServerClear();
}

Storage, mesin, kendaraan, pallet — semua turunan ItemContainerBase, jadi dapat inventory yang networked + savable "gratis". Peran ditambah lewat interface kecil: IItemContainer (punya item), ICargoSource (bisa diambil cargo-nya + ServerTakeLastSackData), IEntityInfo (nama/status untuk UI). Contoh komposisi: T_MinerVehicle : NetworkBehaviour, IGameSave, ICargoSource, IItemContainer, IEntityInfo.

T_Employee — SyncVar-nya hanya identitas + state (employeeId type _workState _isCarrying _isWorking), bukan posisi. AI berjalan sebagai state machine server: EnterState + ServerUpdateIdle / GoingToTruck / PickingUp / GoingToDropOff / Dropping / ReturningHome / Error. Gerak pakai A* FollowerEntity lokal di tiap client + recovery macet (HasPathFailed, RetryReachDestination, RequestUnstuck). Cargo diambil via ICargoSource dengan sistem reservasi (GetCargoReservations/ReleaseCargoReservation) supaya dua pekerja tak rebutan. Save = EmployeeSaveData{ employeeId, position, rotation, isWorking }.

Belt = SplineContainer + speed. Item tidak punya transform sendiri di belt — posisinya parameter (laneIndex, t) sepanjang spline (EvaluateOnSpline(lane, t, out pos, out tan), multi-lane via GetLaneCount). Server yang mendaftar item: Server_RegisterItem(item, startT, laneIndex). Belt nyambung otomatis by jarak (FindNextBelt + connectionRadius + RefreshAllConnections) — taruh belt, langsung tersambung. Splitter pakai round-robin (GetNextSplitterExitIndex). Save = ConveyorBeltSaveData{ bool[] savedExitStates } + UniqueConveyorBeltId — cuma state gerbang + id stabil.

MarketPriceManager menyimpan multiplier harga per item. Jual → OnItemSold → ServerApplyPriceChange menurunkan harga (decreasePerSale), dibatasi [minPriceMultiplier, maxPriceMultiplier]. Tiap hari OnDayStarted → ServerApplyDailyDecay menarik harga kembali ke baseline. Save = List<ItemPriceModifierSaveEntry{ itemId, priceMultiplier }>.