https://github.com/pietras333/unity-networking-parenting-solution-for-distributed-authority
A robust solution for parenting network objects under deeply nested GameObjects in Unity Netcode for GameObjects with Distributed Authority topology.
https://github.com/pietras333/unity-networking-parenting-solution-for-distributed-authority
csharp gamedev multiplayer netcode-for-gameobjects networking unity3d
Last synced: 10 months ago
JSON representation
A robust solution for parenting network objects under deeply nested GameObjects in Unity Netcode for GameObjects with Distributed Authority topology.
- Host: GitHub
- URL: https://github.com/pietras333/unity-networking-parenting-solution-for-distributed-authority
- Owner: pietras333
- Created: 2025-08-02T18:53:34.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-08-02T19:02:22.000Z (11 months ago)
- Last Synced: 2025-08-02T20:55:18.427Z (11 months ago)
- Topics: csharp, gamedev, multiplayer, netcode-for-gameobjects, networking, unity3d
- Language: C#
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🎮 Unity Network Parenting Solution
A robust solution for parenting network objects under deeply nested GameObjects in Unity Netcode for GameObjects with **Distributed Authority** topology.
https://github.com/user-attachments/assets/8fa29e3c-a4e0-425f-a970-83b45b1c3d80
## 🚀 Features
- ✨ **Deep Nesting Support**: Parent network objects to deeply nested child GameObjects
- 🔄 **Automatic Synchronization**: All clients receive parenting changes automatically
- 🕐 **Late Join Support**: Players joining mid-game see correct object hierarchy
- 🎯 **Simple API**: One method call to parent any network object
- 🏗️ **Distributed Authority**: Designed for distributed authority network topology
## 📋 Prerequisites
- Unity Netcode for GameObjects
- Network Manager with **Distributed Authority** topology
- Target network objects must have **Auto Object Parent Sync turned OFF**
- Network objects to be parented must have **Ownership set to None**
## 🔧 Setup
### 1️⃣ Add Network Parent Centre
Attach the `NetworkParentCentre` component to the **root GameObject** of your network object (e.g., Player):
```
Player (Network Object) ← NetworkParentCentre goes here
├── Arm (child)
│ └── Hand (child) ← NetworkParent goes here
└── Other components...
```
### 2️⃣ Configure Network Parents
Add `NetworkParent` components to any child GameObject where you want to enable parenting:
```csharp
// On the Hand GameObject
NetworkParent networkParent = handGameObject.GetComponent();
networkParent.NetworkParentId = "Object Holder Network Parent";
```
### 3️⃣ Parent Network Objects
Use the simple API to parent any spawned network object:
```csharp
// Get reference to the Network Parent Centre
NetworkParentCentre parentCentre = playerGameObject.GetComponent();
// Parent the network item (e.g., weapon) to the specified parent
bool success = parentCentre.TryToParentNetworkObject(weaponNetworkObject, "Object Holder Network Parent");
```
## 💡 Example Use Case
Perfect for scenarios like:
- 🗡️ **Weapon Systems**: Parenting weapons to player hands
- 📦 **Inventory Items**: Attaching items to specific body parts
- 🎒 **Equipment**: Mounting gear to character attachment points
- 🚗 **Vehicle Interactions**: Placing objects inside vehicles
## ⚙️ Configuration Requirements
| Setting | Value | Location |
|---------|--------|----------|
| Network Manager Topology | `Distributed Authority` | Network Manager |
| Auto Object Parent Sync | `OFF` | Network Object to be parented |
| Object Ownership | `None` | Network Object to be parented |
## 📝 API Reference
### NetworkParentCentre
```csharp
public bool TryToParentNetworkObject(NetworkObjectReference networkObjectReference, string networkParentId)
```
**Parameters:**
- `networkObjectReference`: The network object to be parented
- `networkParentId`: The identifier of the target parent
**Returns:** `bool` - Success status of the parenting operation
### NetworkParent
```csharp
public string NetworkParentId; // Set this to identify the parent location
```
## 🔍 How It Works
1. **Initialization**: `NetworkParentCentre` discovers all `NetworkParent` components in children
2. **Parenting Request**: Call `TryToParentNetworkObject()` with target object and parent ID
3. **Local Parenting**: Object is immediately parented locally on the owner
4. **Network Sync**: `ClientRpc` synchronizes the parenting across all clients
5. **Late Join Support**: New clients automatically receive the correct hierarchy
## 🚨 Important Notes
- ⚠️ Only the **owner** of the NetworkParentCentre can initiate parenting operations
- 🏗️ NetworkParentCentre must be on a **root GameObject** (no parent)
- 🔒 Target network objects must have **ownership set to None**
- 📴 Ensure **Auto Object Parent Sync is disabled** on objects to be parented