update networking readme

Author: SpaceWalkerRS

libraries/networking/README.md

@@ -23,32 +23,25 @@ Custom payloads are sent over specific channels. Channels are namespaced identif
 Channels identifiers should be constructed through the `ChannelIdentifieres` class. The convention is to use your mod id as the namespace,
 and snake case for the identifier.
 
-You are expected to register your packet listeners in your mod initializer.
-
-
 ```java
-package com.example;
+public static final NamespacedIdentifier COOKIE_CHANNEL = ChannelIdentifiers.from("example", "cookie");
+```
 
-import net.ornithemc.osl.core.api.util.NamespacedIdentifier;
-import net.ornithemc.osl.entrypoints.api.ModInitializer;
-import net.ornithemc.osl.networking.api.ChannelIdentifiers;
-import net.ornithemc.osl.networking.api.client.ClientPlayNetworking;
+You are expected to register your channels through the `ChannelRegistry`.
 
-public class ExampleInitializer implements ModInitializer {
+```java
+ChannelRegistry.register(COOKIE_CHANNEL);
+```
 
-	public static final NamespacedIdentifier COOKIE_CHANNEL = ChannelIdentifiers.from("example", "cookie");
+You are expected to register your packet listeners in your mod initializer through `ClientPlayNetworking` and `ServerPlayNetworking`.
 
-	@Override
-	public void init() {
-		ClientPlayNetworking.registerListener(COOKIE_CHANNEL, (context, buffer) -> {
-			// handle custom payload
-		});
-	}
-}
+```java
+ClientPlayNetworking.registerListener(COOKIE_CHANNEL, (context, buffer) -> { });
 ```
 
-For ease of use data can be wrapped in custom payload objects. These must implement the `CustomPayload` interface
-and must have a public constructor without parameters. An example can be seen below.
+For ease of use data can be wrapped in custom payload objects.
+These must implement the `CustomPayload` interface and must have a public constructor without parameters.
+An example can be seen below.
 
 ```java
 package com.example;
@@ -81,7 +74,8 @@ public class CookiePayload implements CustomPayload {
 }
 ```
 
-Listeners for these custom payload objects can be registered as follows:
+A basic networking setup might look as follows.
+
 
 ```java
 package com.example;
@@ -97,7 +91,15 @@ public class ExampleInitializer implements ModInitializer {
 
 	@Override
 	public void init() {
+		ChannelRegistry.register(COOKIE_CHANNEL, true, false);
+	}
+
+	@Override
+	public void initClient() {
 		ClientPlayNetworking.registerListener(COOKIE_CHANNEL, CookiePayload::new, (context, payload) -> {
+			// ensure this listener is running on the main thread
+			context.ensureOnMainThread();
+
 			// handle custom payload
 		});
 	}