

Defold Client¶

Defold Engine is a Free 2D Game Engine for Cross-Platform Publishing.

The colyseus-defold client has been tested on all major platforms supported by Defold, such as HTML5, iOS, Android, Mac and Windows.

Installation¶

You will need to add colyseus-defold, as well as its dependencies into your game.project dependencies section in order to use the client.

Open your game.project file, and add the following URLs to the Dependencies section (under Project -> Dependencies):

https://github.com/colyseus/colyseus-defold/archive/master.zip
https://github.com/britzl/defold-websocket/archive/master.zip
https://github.com/britzl/defold-luasocket/archive/0.11.zip
https://github.com/britzl/defold-luasec/archive/master.zip

Read more about Defold library dependencies

You can also specify a specific release of the client, by copying its respective zip archive URL.

Usage¶

local ColyseusClient = require "colyseus.client"

local client
local room

function init(self)
    -- Add initialization code here
    client = ColyseusClient.new("ws://localhost:2567")

    -- join chat room
    client:join_or_create("chat", {}, function(err, _room)
      if err then
        print("JOIN ERROR: " .. err)
        return
      end

      room = _room
    end)
end

function update(self, dt)
   client:loop()
end

See client-side documentation.

Example¶

Check out the tic-tac-toe example made by @selimanac

FAQ¶

"I can't connect to the local server!"¶

When running on localhost, make sure you don't have any service running on port 80, otherwise the client won't connect into the specified port number.

Alternatively, you can bind the Colyseus server to port 80.

"`reconnect()` is not working on iOS!"¶

If you lock your phone, all WebSocket connections will be closed. You can call reconnect() to reestablish the session, which needs a workaround for iOS:

function window_callback(self, event, data)
    if event == window.WINDOW_EVENT_FOCUS_GAINED then
        -- iOS workaround to re-active WebSocket connection after phone is unlocked
        room:send({"whatever"})
    end
end

window.set_listener(window_callback)

Dependencies¶

The colyseus-defold depends on the WebSocket, LuaSocket and LuaSec projects: