colyseus-hxjs

Haxe externs for Colyseus v0.17 multiplayer framework (colyseus + @colyseus/schema v4).

Write Colyseus servers in Haxe and compile to Node.js via haxe ... -js server.js.

Target versions

• Colyseus v0.17.x
• @colyseus/schema v4.x

Server externs

Module	Provides
colyseus.server.Colyseus	defineServer, defineRoom, Server, createRouter, createEndpoint, monitor, playground
colyseus.server.Room	RoomOf<State, Metadata>, Room, Clock, CloseCode, ErrorCode, AuthContext
colyseus.server.Client	Client, ClientState, ClientArray, SendOptions
colyseus.server.schema.Schema	Schema, ArraySchema, MapSchema, SetSchema, CollectionSchema, StateView
colyseus.server.schema.Decorator	Build macro -- @:type and @:view metadata on Schema fields
colyseus.server.presence.Presence	Presence typedef (Redis-like pub/sub, hash, list ops)
colyseus.server.MatchMaker	matchMaker static methods, SeatReservation
colyseus.server.matchmaker.RegisteredHandler	Room handler registration with filterBy / sortBy
colyseus.server.Delayed	Timer tasks from @colyseus/timer
colyseus.server.LobbyRoom	Built-in lobby room

Schema decorators

Schema fields use Haxe metadata processed by a build macro (@:autoBuild):

class PlayerState extends Schema {
    @:type(NUMBER) public var x:Float;
    @:type(STRING) public var name:String;

    @:type(INT32) @:view public var score:Int;       // view-filtered (default tag)
    @:type(STRING) @:view(1) public var secret:String; // view-filtered (tag 1)
}

The macro emits runtime type() / view() decorator calls on the JS prototype at class init.

Examples

See colyseus-hxjs-examples for working rooms:

• ChatRoom -- messaging, broadcast, onMessage callback
• StateHandlerRoom -- MapSchema state, player tracking, allowReconnection
• ViewRoom -- @:view decorators, StateView per-client, conditional view grant based on score
• NotAllowedRoom -- async onJoin rejection

Build & run:

haxe server.hxml        # compile to bin/server/index.js
node ./bin/server        # start on port 2567