Skip to content
/ com.unity.netcode.gameobjects Public

Netcode for GameObjects is a high-level netcode SDK that provides networking capabilities to GameObject/MonoBehaviour workflows within Unity and sits on top of underlying transport layer.

License

MIT license
2k stars 417 forks Activity
Star
Notifications

Unity-Technologies/com.unity.netcode.gameobjects

develop
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
254 branches 194 tags
Code

Latest commit

@NoelStephensUnity
NoelStephensUnity fix: CreateObjectMessage created NetworkObjects can get destroyed dur…
0f959eb Nov 14, 2023
fix: CreateObjectMessage created NetworkObjects can get destroyed dur… 
…ing client synchronization [MTT-7539] (#2735)

* fix

This resolves the issue where any NetworkObjects created during client synchronization when scene management is enabled. client synchronization mode is set to LoadSceneMode.Single, and the active scene (where the NetworkObjects are created) is unloaded during synchronization.

* fix

This fixes the exception that can occur when there are many (100's) NetworkObjects spawned and the application instance is exited (or you exit play mode in the editor).

* style

removing auto-added namespace

* test

Updating WhenManyObjectsAreSpawnedAtOnce_AllAreReceived test as it was not using the right logic to validate all NetworkObjects had been spawned.

Adding WhenManyObjectsAreSpawnedDuringSynchronization_AllAreReceived to validate this PR.

* update

adding changelog entry

* test

Migrating WhenManyObjectsAreSpawnedDuringSynchronization_AllAreReceived  to SpawnNetworkObjectsDuringSynchronizationTest.SpawnNetworkObjectsDuringSynchronization.

* fix

Scenes loaded in single mode, after a client is connected, will defer CreateObjectMessage driven spawning until the scene loading event is completed. Consolidated the logic into a single method.

Added two new SceneEventProgress enums to be returned when a client attempts to load or unload a scene using NetworkSceneManager or any instance type tries to use the NetworkSceneManager when scene management is disabled (as opposed to throwing an exception it just logs a warning and returns the relative SceneEventProgress value).

* test

Made modifications due to SceneEventProgress adjustments.
Renamed SpawnNetworkObjectsDuringSynchronizationTest to SpawnNetworkObjectsDuringSceneEventsTest and migrated it to the test project tests runtime NetworkSceneManager  folder.
Added an additional

* update

Updated the change log entry.

* style

removing unused namespace.

* Update CHANGELOG.md

* Update CHANGELOG.md

Fixing bad changelog merge

* Update SceneEventProgress.cs

Fixing the issue with the enum changes breaking the InternalNetcodeError value

* Update SceneEventProgress.cs

* update

Made adjustments based on PR review suggestions.
Added additional changelog entries to better reflect the PR.
0f959eb

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
.github
chore: Change code owner from server to workflows (#2607)
November 8, 2023 20:11
.yamato
ci: add 2023.1 (#2453)
March 14, 2023 20:02
com.unity.netcode.gameobjects
fix: CreateObjectMessage created NetworkObjects can get destroyed dur…
November 14, 2023 14:57
dotnet-tools
chore: .gitattributes line endings config & renormalize (#2457)
March 16, 2023 12:17
minimalproject
refactor: NetworkMessageSystem (formerly MessagingSystem) (#2505)
April 12, 2023 23:42
testproject-tools-integration
refactor: NetworkMessageSystem (formerly MessagingSystem) (#2505)
April 12, 2023 23:42
testproject
fix: CreateObjectMessage created NetworkObjects can get destroyed dur…
November 14, 2023 14:57
.buginfo
Update .buginfo
October 25, 2023 13:31
.editorconfig
style: add braces
March 25, 2023 13:31
.gitattributes
chore: .gitattributes line endings config & renormalize (#2457)
March 16, 2023 12:17
.gitignore
test: enable multiprocess tests on windows mac and ubuntu (#1195)
October 5, 2021 21:07
CODE_OF_CONDUCT.md
docs: Add code of conduct
December 3, 2020 18:52
CONTRIBUTING.md
chore: replace MLAPI with Netcode in Markdown files (#1025)
August 5, 2021 19:50
LICENSE.md
docs: cleaned up readme, 3rd party license, etc. (#524)
March 3, 2021 23:58
README.md
chore: Update README.md (#2758)
November 8, 2023 18:43
Netcode for GameObjects Welcome! Getting Started Community and Feedback Compatibility Development Contributing Issues and missing features

README.md

Netcode for GameObjects

Forums Discord Manual API

GitHub Release

Welcome!

Welcome to the Netcode for GameObjects repository.

Netcode for GameObjects is a Unity package that provides networking capabilities to GameObject & MonoBehaviour workflows. The framework is interoperable with many low-level transports, including the official Unity Transport Package.

Getting Started

Visit the Multiplayer Docs Site for package & API documentation, as well as information about several samples which leverage the Netcode for GameObjects package.

You can also jump right into our Hello World guide for a taste of how to use the framework for basic networked tasks.

Community and Feedback

For general questions, networking advice or discussions about Netcode for GameObjects, please join our Discord Community or create a post in the Unity Multiplayer Forum.

Compatibility

Netcode for GameObjects targets the following Unity versions:

  • Unity 2021.3(LTS), and 2022.3(LTS)

On the following runtime platforms:

  • Windows, MacOS, and Linux
  • iOS and Android
  • Most closed platforms, such as consoles. Contact us for more information about specific closed platforms.

Development

This repository is broken into multiple components, each one implemented as a Unity Package.

    .
    ├── com.unity.netcode.gameobjects           # The core netcode SDK unity package (source + tests)
    └── testproject                             # A Unity project with various test implementations & scenes which exercise the features in the above packages.

Contributing

We are an open-source project and we encourage and welcome contributions. If you wish to contribute, please be sure to review our contribution guidelines.

Issues and missing features

If you have an issue, bug or feature request, please follow the information in our contribution guidelines to submit an issue.

You can also check out our public roadmap to get an idea for what we might be working on next!

About

Netcode for GameObjects is a high-level netcode SDK that provides networking capabilities to GameObject/MonoBehaviour workflows within Unity and sits on top of underlying transport layer.

Topics

networking csharp unity multiplayer unity3d unity-3d unity-networking netcode mlapi hlapi owner-multiplayer-sdk

Resources

Readme

License

MIT license

Code of conduct

Code of conduct
Activity

Stars

2k stars

Watchers

468 watching

Forks

417 forks
Report repository

Releases 188

1.7.0 Latest
Oct 26, 2023
+ 187 releases

Contributors 89

+ 78 contributors

Languages