Skip to content

News and Updates

21/03/2024 Rework of Server Setup Tutorial

The Server Setup Tutorial was rewritten by @taste based on real life experience going through the previous version of the document. Installing an full adaptor:ex instance with docker compose on your own remote server should be way more easy now.

20/03/2024 Update Version 2.6

  • Add logic Iterate action
  • Add atIndex() and length() functions
  • Add options to sort and narrow down item selections. See respective section in Variables chapter
  • Add option to create arrays inline inside form fields just like with JS objects
  • Allow nested inline queries and inline regex
  • Some minor bug fixes

10/01/2024 Update Version 2.5

  • Add On Error action to catch and react on errors in States and Sessions
  • Add Keep listening and queue option for listeners
  • Fix Items not shown when collection was deleted and added again
  • Allow number type distinction into integer and float for OSC message
  • Fix Telegram On Incoming Message gets stuck if respond list is empty
  • Fix fatal error in sound play action if there is no audio player available
  • Several minor bug fixes

09/11/2023 Update Version 2.4

  • Add "now" option for dateFormat and dateOffset functions
  • Added Button support for Telegram Bots (see Telegram Buttons action)
  • Added option to sort arrays in action form editor
  • Added animation to highlight lines coming from selected states
  • Added text filter for Action, Variables and Media Toolbar
  • Fixed and improved Cancel Session action
  • Auto select new or latest Sessions in Editor Live Mode
  • Convert manually entered dates to improve compatibility with auto generated dates
  • Allow regex in database query strings
  • Add case sensitive option to regex in all condition capable actions
  • Many minor bug fixes and improvements

01/08/2023 Update Version 2.3

  • Added create next state from action next field
  • Added Multiselect States
  • Added editor minimap
  • Added "lock editor" option
  • Added "view all states" option
  • Added step by step and scroll zoom/scale
  • Added "multiple items" option to data actions (see Variables Chapter)
  • Allow directories inside functions folder (see Functions Chapter)
  • Several bug fixes

19/06/2023 Update Version 2.2

  • Fixed: permissions could not be set for telegram group chats using Edit Chat
  • Added MQTT Plugin that allows to send MQTT messages and to react on messages that have been published to the network.
  • In addition to Accounts, Telegram Bots can now be connected to adaptor:ex via the Telegram plugin.
  • Improved error feedback when setting up plugins and plugin items
  • Level names can be now be edited
  • Some smaller bug fixes and minor adjustments

03/04/2023 Update Version 2.1

  • Added random function to embedded functions
  • Fixed: Could not change duration of Telegram "is typing" feature
  • Fixed: reply option in Telegram On Message not working anymore since version 2.0.
  • A few smaller bug fixes and minor adjustments

27/02/2023 Update Version 2.0

Besides many major and minor bug fixes and improvements, the update to Version 2.0.0 includes the following changes:


  • Improved line routing
  • Duplicate state option
  • Drag and Drop action from one state to another
  • Copy action option
  • Reorder actions inside a state
  • Improved multi user and multi browser collaboration
  • Instantly update level changes for all users in all browsers
  • Visualize remote users editing the same level
  • Added loading animation
  • Fixed: Console log stops updating when there are more than 11000 Lines

Live Mode

  • Added information about referenced items in level view and overview


  • Improved function action with next state outlets
  • Inline functions arguments allow string type, number type and variables (see functions as variables)
  • Add new functions and properties to game and session context


  • Events are now bound to an event source (see events)
  • Sessions, Plugins, Plugin Items and Data items can now dispatch events

Telegram Plugin

  • Replaced python telegram API library "telethon" with native javascript/nodejs module "gramjs". Therefor it is no longer required to install python.
  • Added typing delay option to Send Message action
  • Improved working with polls
  • Added invite link option to Create Chat action


  • You can now add plugins from the data or any custom directory

Documentation for version 1.x

Older versions of the documentation can be found in the source repository on gitlab.

From the branches selection choose the required version under tags.

Latest 1.x version can be found here.

Migrate from previous version

Version 2 includes several changes that will break most games that were created in previous versions.

Important changes to the server configuration are:

  • The default data directory is now called "adaptorex" instead of "data"
  • The "user" option in "config.json" is now called "users" (see Readme)

If you want to migrate levels created with version 1.x you need to consider the following changes if you use any of the respective elements:

  • Data action load ("Load Item") is now called getItem ("Get Item")
  • Data action create ("Create Item") is now called addItem ("Add Item")
  • "name" property in data action addItem (fka. create) is now called "reference".
  • The property name in the function action is now called function
  • The syntax for functions that are called inside variables has changed

Functions that are called inside variables are now referenced by functions (plural) instead of function and functions that are called inside variables require to define the arguments type. You will need to wrap all arguments in quotes to update your level.

E.g. [[function.test(value1,value2)]] should become [[functions.test("value1","value2")]]

  • Telegram action dialog ("Dialog") is now called onMessage ("On Incoming Message")
  • Telegram On Incoming Message timeout structure changed and is now separated into while idle and finally option.
  • Twilio Action smsout is now called sendSms.
  • Twilio Action smsin is now called onSms.
  • Twilio Action callin is now called onCall.
  • Telegram and Twilio telnumber property is now called phone_number

To make sure you get hold of all changes, download each level and find and replace the above names, before you upload your levels to the updated adaptor:ex editor.

Even though it is possible to adapt all elements of a game to fit Version 2 we recommend to create a new game and recreate your plugins and copy your data collections from the original project.

If you need help migrating your project join our Discord Channel or send us an e-mail.