Home

GAMEE Connector addon for Construct 3

Addon wraps gamee-js framework v2.0.6 and offers some of framework functions in Construct 3 editor.

Video tutorial

Template used in tutorial

Final result from tutorial

Updates

2.1

• Read more about Request social method

2.0

• In video tutorial we didn't put instance of plugin into layout (old version).
• Final result from tutorial was updated so it contains latest version of the plugin and includes some other updates (sound usage).

Connector functions and startup

Addon is using Construct ACE (Actions, Conditions, Expressions). Once addon is in your project, you need to put exactly one instance into inital layout. This layout must not be reinitalized. Then you can use ACE from any event sheet (multiple layouts are possible, but keep that one instance and never destroy it).

There is a list of all ACEs. For more information how to use plugin or how to make game for GAMEE please visit gamee-js wiki.

Condition	Mandatory	Description
Start	Yes	When on start occurs it means player hit the start button or wish to restart game. You should start fresh game and previously running game must have no impact (Save state is exception).
Pause & Resume	Yes	When on pause or on resume event occurs player hits the pause button and you are supposed to pause or resume the game.
Mute & Unmute	Yes	When on mute or on unmute event occurs player selected this from GAMEE options and you are supposed to mute or resume sound in the game.
Receive saved data		When this condition occurs it just notifies expression Save state contains data.
Receive social data		When this condition occurs it notifies expressions Social data and Social data friends count contains new data.

Action	Mandatory	Description
Update score	Yes	Call this action anytime during gameplay only after Start condition occured and you didn't call Game over action yet. Passed value will increase the score visualy to player.
Game over	Yes	Calling this will immediately result in overlay with replay button. Should use after game is over
Save state		Use this anytime during gameplay to save some data as string. Last saved data will be available as Save state expression when player leaves platform and get back. If you need more complicated structure, use JSON.stringify or RegExp
Request social		Can be used anytime during gameplay and also mutliple times. Will return data about up to five friends of currently playing player and only friends that has higher score than current player. Updating score during gameplay has impact on results of calling this method, means if player during gameplay beats his friends, new friends are returned (if possible). After calling this, you must check condition Receive social data. Then data are available.

Expression	Mandatory	Description
Save state		Contains data previously saved. Data are available after on Receive saved data condition occurs.
Inital sound	Yes	Is available instantly. Has value 0|1 [int] meaning sound should be off|on.
Social data		Has two input params, At and Friend Property. At [int] accepting values 0-4, and is friend we are asking about. Friend Property [string] can be one of "name", "highScore" or "avatar". Result of this expression string, in case of avatar base64 or valid URL with image. This is available after on Receive social data condition occurs.
Social data friends count		Is amount of friends returned. Is int between 0-5. In case it is 0, there are no friends and you can't use expression Social data. This is available after on Receive social data condition occurs.