Skip to main content

Net

Basic networking module for creating and handling static RemoteEvents and RemoteFunctions.

Functions​

RemoteEvent​

</>
Net:RemoteEvent(name: string) → RemoteEvent

Gets a RemoteEvent with the given name.

On the server, if the RemoteEvent does not exist, then it will be created with the given name.

On the client, if the RemoteEvent does not exist, then it will wait until it exists for at least 10 seconds. If the RemoteEvent does not exist after 10 seconds, an error will be thrown. 

local remoteEvent = Net:RemoteEvent("PointsChanged")

UnreliableRemoteEvent​

</>
Net:UnreliableRemoteEvent(name: string) → UnreliableRemoteEvent

Gets an UnreliableRemoteEvent with the given name.

On the server, if the UnreliableRemoteEvent does not exist, then it will be created with the given name.

On the client, if the UnreliableRemoteEvent does not exist, then it will wait until it exists for at least 10 seconds. If the UnreliableRemoteEvent does not exist after 10 seconds, an error will be thrown. 

local unreliableRemoteEvent = Net:UnreliableRemoteEvent("PositionChanged")

Connect​

</>
Net:Connect(
name: string,
handler: (...any) → ()
) → RBXScriptConnection

Connects a handler function to the given RemoteEvent.

-- Client
Net:Connect("PointsChanged", function(points)
	print("Points", points)
end)

-- Server
Net:Connect("SomeEvent", function(player, ...) end)

ConnectUnreliable​

</>
Net:ConnectUnreliable(
name: string,
handler: (...any) → ()
) → RBXScriptConnection

Connects a handler function to the given UnreliableRemoteEvent.

-- Client
Net:ConnectUnreliable("PositionChanged", function(position)
	print("Position", position)
end)

-- Server
Net:ConnectUnreliable("SomeEvent", function(player, ...) end)

RemoteFunction​

</>
Net:RemoteFunction(name: string) → RemoteFunction

Gets a RemoteFunction with the given name.

On the server, if the RemoteFunction does not exist, then it will be created with the given name.

On the client, if the RemoteFunction does not exist, then it will wait until it exists for at least 10 seconds. If the RemoteFunction does not exist after 10 seconds, an error will be thrown. 

local remoteFunction = Net:RemoteFunction("GetPoints")

Handle​

This item only works when running on the server. Server
</>
Net:Handle(
name: string,
handler: (
player: Player,
...any
) → ...any
) → ()

Sets the invocation function for the given RemoteFunction.

Net:Handle("GetPoints", function(player)
	return 10
end)

Invoke​

This item only works when running on the client. Client
</>
Net:Invoke(
name: string,
...: any
) → ...any

Invokes the RemoteFunction with the given arguments.

local points = Net:Invoke("GetPoints")

Clean​

This item only works when running on the server. Server
</>
Net:Clean() → ()

Destroys all RemoteEvents and RemoteFunctions. This should really only be used in testing environments and not during runtime.

Show raw api
{
    "functions": [
        {
            "name": "RemoteEvent",
            "desc": "Gets a RemoteEvent with the given name.\n\nOn the server, if the RemoteEvent does not exist, then\nit will be created with the given name.\n\nOn the client, if the RemoteEvent does not exist, then\nit will wait until it exists for at least 10 seconds.\nIf the RemoteEvent does not exist after 10 seconds, an\nerror will be thrown.\n\n```lua\nlocal remoteEvent = Net:RemoteEvent(\"PointsChanged\")\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "RemoteEvent\n"
                }
            ],
            "function_type": "method",
            "source": {
                "line": 25,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "UnreliableRemoteEvent",
            "desc": "Gets an UnreliableRemoteEvent with the given name.\n\nOn the server, if the UnreliableRemoteEvent does not\nexist, then it will be created with the given name.\n\nOn the client, if the UnreliableRemoteEvent does not\nexist, then it will wait until it exists for at least\n10 seconds. If the UnreliableRemoteEvent does not exist\nafter 10 seconds, an error will be thrown.\n\n```lua\nlocal unreliableRemoteEvent = Net:UnreliableRemoteEvent(\"PositionChanged\")\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "UnreliableRemoteEvent\n"
                }
            ],
            "function_type": "method",
            "source": {
                "line": 59,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "Connect",
            "desc": "Connects a handler function to the given RemoteEvent.\n\n```lua\n-- Client\nNet:Connect(\"PointsChanged\", function(points)\n\tprint(\"Points\", points)\nend)\n\n-- Server\nNet:Connect(\"SomeEvent\", function(player, ...) end)\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "handler",
                    "desc": "",
                    "lua_type": "(...any) -> ()"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "RBXScriptConnection\n"
                }
            ],
            "function_type": "method",
            "source": {
                "line": 91,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "ConnectUnreliable",
            "desc": "Connects a handler function to the given UnreliableRemoteEvent.\n\n```lua\n-- Client\nNet:ConnectUnreliable(\"PositionChanged\", function(position)\n\tprint(\"Position\", position)\nend)\n\n-- Server\nNet:ConnectUnreliable(\"SomeEvent\", function(player, ...) end)\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "handler",
                    "desc": "",
                    "lua_type": "(...any) -> ()"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "RBXScriptConnection\n"
                }
            ],
            "function_type": "method",
            "source": {
                "line": 112,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "RemoteFunction",
            "desc": "Gets a RemoteFunction with the given name.\n\nOn the server, if the RemoteFunction does not exist, then\nit will be created with the given name.\n\nOn the client, if the RemoteFunction does not exist, then\nit will wait until it exists for at least 10 seconds.\nIf the RemoteFunction does not exist after 10 seconds, an\nerror will be thrown.\n\n```lua\nlocal remoteFunction = Net:RemoteFunction(\"GetPoints\")\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "RemoteFunction\n"
                }
            ],
            "function_type": "method",
            "source": {
                "line": 135,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "Handle",
            "desc": "Sets the invocation function for the given RemoteFunction.\n\n```lua\nNet:Handle(\"GetPoints\", function(player)\n\treturn 10\nend)\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "handler",
                    "desc": "",
                    "lua_type": "(player: Player, ...any) -> ...any"
                }
            ],
            "returns": [],
            "function_type": "method",
            "realm": [
                "Server"
            ],
            "source": {
                "line": 164,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "Invoke",
            "desc": "Invokes the RemoteFunction with the given arguments.\n\n```lua\nlocal points = Net:Invoke(\"GetPoints\")\n```",
            "params": [
                {
                    "name": "name",
                    "desc": "",
                    "lua_type": "string"
                },
                {
                    "name": "...",
                    "desc": "",
                    "lua_type": "any"
                }
            ],
            "returns": [
                {
                    "desc": "",
                    "lua_type": "...any\n"
                }
            ],
            "function_type": "method",
            "realm": [
                "Client"
            ],
            "source": {
                "line": 176,
                "path": "modules/net/init.luau"
            }
        },
        {
            "name": "Clean",
            "desc": "Destroys all RemoteEvents and RemoteFunctions. This\nshould really only be used in testing environments\nand not during runtime.",
            "params": [],
            "returns": [],
            "function_type": "method",
            "realm": [
                "Server"
            ],
            "source": {
                "line": 186,
                "path": "modules/net/init.luau"
            }
        }
    ],
    "properties": [],
    "types": [],
    "name": "Net",
    "desc": "Basic networking module for creating and handling static\nRemoteEvents and RemoteFunctions.",
    "source": {
        "line": 8,
        "path": "modules/net/init.luau"
    }
}