Tech Blog > Announcing WorkAdventure v1.12

Announcing WorkAdventure v1.12

New release

What's New in WorkAdventure 1.12?

First of all, let me tell you this v1.12 release is HUGE!

It has been 3 months since the last release, and the team and community have been doing an amazing work at improving and extending WorkAdventure.

There are very visible changes, like a super sleek new design, or a brand new user list! 🀩

There is also under the hood a number of improvements that will make WorkAdventure more powerful and more interoperable in the future.

Let's review those new features together πŸ‘‡

Announcing WorkAdventure v1.12

A brand new design! 🎨

Good bye pixels, hello rounded corners!

This release marks the beginning of a new default theme for WorkAdventure.

New design

The redesign is not completely finished so you will still find a few pixelated icons and popups, but in the coming releases, those will be replaced by the new design.

For those of you that are pixel lovers, I want to say I understand (I also deeply love the pixelated design). But the new design allows us to cram more information in a single page, and that was much needed for the upcoming chat system!

And don't worry, the world itself will stay in your beloved 2D pixelated universe, only the UI elements are sleeker!

A big thanks to Benedicte and Hugo for their work on this redesign. ❀️

A reusable design πŸͺ„

The new design is now using Tailwind CSS and will soon be exported in a dedicated NPM package. This means anyone will be able to easily use the new design to create interfaces that blend seemlessly into WorkAdventure!

So if you are developing maps with a lot of scripting, additional cowebsites that open, etc..., it will be easy for you to provide a feeling of continuity between WorkAdventure and the extensions you build!

A new user list πŸ”–

You can now view the list of all users connected to your world (and you can walk to them automatically), thanks to the new user list!

New user list

This means you will no longer need to wander through the maps to find your beloved colleagues or friends! A quick look at the user list and you will know if the user is here. You can also directly walk to him/her in a single click!

But wait, there is more! πŸš€

An improved chat system πŸ’¬

The user list will be the basis of completely revamped chat system in the upcoming versions.

You will notice that the chat system has already been migrated to the new design.

You are now notified when someone is chatting with you with a new "chat notification sound". Also, when someone is in the process of typing a message, you are notified too.

But this is just the beginning.

In the future, the chat system will expand up to the point where it can replace a Slack or Discord channel! And the real beauty is how it works behind the scene! ✨

To track the availability of the users and the chat messages, we are using a XMPP server (Ejabberd). If you have never heard about XMPP, this is a federated protocol for building messaging applications.

This is a strategic move for WorkAdventure because this will allow us to interact with all the XMPP ecosystem in the future!

Just imagine. You are out of office. A colleague needs to talk to you. She clicks your user name, you are offline. She writes a quick message. On your phone, you get a notification through your XMPP messaging client.

You read the message and with a click, decide to connect to WorkAdventure to chat with her. This is the future we envision and where we are headed.


In the upcoming versions, and thanks to this integration with an XMPP server, you will also be able to:

πŸ‘‰ create special zones that will allow you to enter in a chat room

πŸ‘‰ add friends

πŸ‘‰ create private "teams"

πŸ‘‰ connect to the chat system without going through WorkAdventure

πŸ‘‰ build a federated multiverse of WorkAdventure servers (!)

Player variables πŸ•Ή

This is a major new feature from the scripting API. It is now possible to attach and save variables per player. Previously, variables were attached to a map. Now, you can create variables attached to a given user.

Β This can be very useful in a number of situations.

Β πŸ‘‰ If you build a game, you can track the score of a user, or you can build an inventory system easily

πŸ‘‰ If you build a waiting room, you can attach the arrival time of each user to the user itself

πŸ‘‰ ...


Player variables can be:

πŸš€ persisted or transient (persisted variables are stored in MongoDB for connected users and LocalStorage for anonymous users)

πŸš€ public or private (public variables can be read by other players)

πŸš€ attached to a room or to a world (variables attached to a world will be available in all the rooms of this world)


Additionally, the new `WA.players` object will allow you to track players around you in real-time using the scripting API.

Β In the end, you will be able to create new advanced behaviors based on the presence of players around you!

More scripting API features 🀩

The scripting API continues its expansion!

You can now open and close the chat window using the Scripting API. You can force turning off the microphone or the webcam of the current user from the Scripting API.

You can also be notified when a user enters / leaves your bubble.


... and much more! πŸ”₯

Edit your OpenID settings in the "developers section"

For those of you that connect WorkAdventure to a single-sign on server, a brand new section in the developer settings (in the admin dashboard) allows you to set up a connection to your OpenID connect provided all by yourself!

OpenID settings

Translations 🌍

Our community rocks and keeps providing (and kindly updating) the translations in many languages.

For the v1.12, we welcome the Brazilian Portuguese translation, thanks to @MaximilianoVeiga! ❀️

Metadata in the scripting API πŸ—£

If you have implemented your own Admin API, you can now send any data from the admin to the Scriting API, thanks to the new notion of "metadata".

In the future, we will use those metadata to send data related to the user, like the list of NFTs the user has (if the user did connected with its Metamask wallet).

Start / Exit areas πŸšͺ

The new "area" objects (that supersedes layers) can now be used as start and exit positions.

Faster startup on big maps πŸ—Ί

Thanks to an optimized collision grid generation, big maps should now be faster to load in WorkAdventure (especially on low-end hardware like phones)

A better code πŸ§‘β€πŸ’»

Behind the scene, we keep striving for a robust and clean code. This release is no exception and brings its bunch of improvements regarding end-to-end tests, linting, openId connection, library upgrades, optimized and faster builds, etc...

Compatibility with Tiled 1.9 πŸ€Έβ€β™‚οΈ

The format of JSON maps changed in Tiled 1.9. Maps generated with Tiled 1.9 were not fully compatible with WorkAdventure before 1.12.

This version of WorkAdventure brings compatibility with Tiled 1.9 while keeping compatibility with older Tiled versions.

Easier network setup πŸ› 

For big corporations that have protected networks, we are happy to now offer a list of fixed IP addresses that they can whitelist to allow smooth WorkAdventure integration.

They are listed in the brand new "Preparing your network" page:

Updated Woka administration page 🧍🏽

The user experience of the "Woka" page in the administration panel has been improved!

Administration page

To conclude ...

A big thanks goes to the community. For this release, we've had 4 first-time committers! ❀️

If you want more details, you can check the release notes:

Instagram logo in the footer of this web page. LinkedIn logo in the footer of this web page. Twitter logo in the footer of this web page. Facebook logo in the footer of this web page. Discord logo in the footer of this web page. YouTube logo in the footer of this web page. GitHub logo in the footer of this web page.

Copyright © 2024 WorkAdventure - All Rights Reserved