sock.lua

sock.lua is a networking library for LÖVE games. Its goal is to make getting started with networking as easy as possible.

Documentation

sock requires enet (which comes with LÖVE 0.9 and up.)

Features

• Event trigger system makes it easy to add behavior to network events.
• Can send images and files over the network.
• Can use a custom serialization library.
• Logs events, errors, and warnings that occur.

Installation

1. Clone or download sock.lua.
2. Clone or download bitser.*
3. Place bitser.lua in the same directory as sock.lua.
4. Require the library and start using it. sock = require 'sock'

* If custom serialization support is needed, look at setSerialization.

Example

localsock=require"sock"-- client.luafunctionlove.load()
-- Creating a new client on localhost:22122client=sock.newClient("localhost", 22122)
-- Creating a client to connect to some ip addressclient=sock.newClient("198.51.100.0", 22122)
-- Called when a connection is made to the serverclient:on("connect", function(data)
print("Client connected to the server.")
end)
-- Called when the client disconnects from the serverclient:on("disconnect", function(data)
print("Client disconnected from the server.")
end)
-- Custom callback, called whenever you send the event from the serverclient:on("hello", function(msg)
print("The server replied: " ..msg)
end)
client:connect()
-- You can send different types of dataclient:send("greeting", "Hello, my name is Inigo Montoya.")
client:send("isShooting", true)
client:send("bulletsLeft", 1)
client:send("position", {
x=465.3,
y=50,
})
endfunctionlove.update(dt)
client:update()
end

-- server.luafunctionlove.load()
-- Creating a server on any IP, port 22122server=sock.newServer("*", 22122)
-- Called when someone connects to the serverserver:on("connect", function(data, client)
-- Send a message back to the connected clientlocalmsg="Hello from the server!"client:send("hello", msg)
end)
endfunctionlove.update(dt)
server:update()
end