@casual-simulation/aux-vm - npm Package Versions

• Fixed an issue where the "Create Empty Bot" button in the bot table was hidden when a mod was selected.

Improvements

• Made the menu item count badge a lighter gray.
• Removed the item count badge from the menu.
• Removed the dropdown aspect of the menu.

Changes

• Made the menu item count badge a lighter gray.
• Removed the admin channel and admin-channel specific functionality.
  • This means that there are no more user account bots or channel bots.
    • You can login as anyone from any device without requiring additional authentication.
    • You can access any channel. No need to create a channel first. (because there are no channel bots anymore)
    • The connection counts are now stored in the config bot of the channel.
    • Connection limits no longer work since they were set on the channel bot in the admin channel.
    • Username whitelists and blacklists still work, but they rely on client-side script execution instead of server-side execution.
  • It also means there is no admin role. For now, everyone has admin permissions.
  • action.perform() now needs to be used to run actions on the server.
    • You can send an action to the server using the remote() function.
    • The server will receive the action in its onAnyAction() as that.action.type === "device"
    • onAnyAction() has to detect remove events and execute the inner action via action.perform(that.action.event).
  • The following functions have been removed:
    • server.grantRole()
    • server.revokeRole()
  • The following functions are not executed by default and require a custom onAnyAction() to handle them.
    • server.backupAsDownload()
    • server.backupToGithub()
    • server.shell()
  • server.backupAsDownload() has been updated to accept a "session selector" which determines which session the ZIP file should be sent to.
    • ex. server.backupAsDownload({ username: getTag(player.getBot(), "#aux._user") })
  • Removed the aux._lastEditedBy tag.
    • This tag was automatically set to the ID of the user whenever a bot was edited.
    • Currently, it is extra cruft that is not needed and could be easily implemented via onAnyAction().
• Centered the menu above the player inventory.
• Increased menu text size.
• Added in new camera range tags: aux.context.zoomable.min, aux.context.zoomable.max aux.context.pannable.min.x, aux.context.pannable.max.x, aux.context.pannable.min.y, aux.context.pannable.max.y.

Bug Fixes

• Removed hidden inventory dragging hitboxes when inventory is set to non-visible.

• Fixed an issue where sometimes DependencyManager would be given a bot that was undefined which would crash the simulation.

• Added the player.showHtml(html) function that shows a modal with the given HTML.
  • Optimized for embedding YouTube videos but works with any arbitrary HTML.
  • Embedding JavaScript is not supported.

• Fixed an issue that prevented tabs with the same URL from seeing each other's changes to the local bot.

• Added onAnyAction() action tag to intercept and change actions before they are executed.
  • onAnyAction() runs for every action, including when a bot is created, changed, or deleted.
  • Every action is an object with a type property.
    • The type property is a string that indicates what the action does.
    • Here is a partial list of types:
      • add_bot: A bot should be added (i.e. created).
      • remove_bot: A bot should be removed (i.e. deleted).
      • update_bot: A bot should be updated.
      • apply_state: The given bot state should be applied. (i.e. a set of bots should be created/updated)
      • shout: A shout should be executed.
      • show_toast: A toast message should be shown on the device.
      • show_barcode: A barcode should be shown.
      • tween_to: The camera should be tweened to show a bot.
  • that is an object with the following properties:
    • action: The action that is going to be executed.
  • Forking a channel clears the onAnyAction() on the config bot.
    • This is so that you can recover from broken states and also gives the person who forked the AUX full control over the fork.
• Added two new script functions:
  • action.reject(action): Prevents the given action from being performed. Returns the rejection action.
  • action.perform(action): Adds the given action to the performance queue so it will be performed. This can be used to re-enable an action after it has been rejected (you can also reject the rejection action). Returns the action that will be performed.
• Added a local bot which is stored in the browser's local storage.
  • The local bot is a bot that is unique to the device and channel.
  • You can access the bot by querying for it: getBot("#id", "local").
• Renamed onShout() to onAnyListen().
• Added onListen() which is an alternative to onAnyListen() that is only called on the targeted bots.
• Added ability to set duration of toast, plater.toast("message", durationNum).
• Made the background for the menu label gray.

• Added tags to control panning, zooming, and rotating the main camera.
  • aux.context.pannable: Controls whether the main camera is able to be panned.
  • aux.context.zoomable: Controls whether the main camera is able to be zoomed.
  • aux.context.rotatable: Controls whether the main camera is able to be rotated.
• Added player.moveTo() to instantly tween the camera to a bot.
  • In the future, custom tween durations will be supported.
• Changed the low camera angle limit to 32 degrees from 10 degrees.
• onCombineExit action will now fire alongside the onCombine action.
• Newly created contexts will no longer be autoselected.
• Toast messages will now only remain on screen for 2 seconds.
• Added the ability to send webhooks from the server.
  • You can also tell the server to send a webhook via remote(webhook()).
  • This is useful for getting around CORS issues.

• Fixed player.tweenTo() to not change the zoom level when it is not specified.
• Tweens will now work better with the onPlayerEnterContext action.

• Resolved issues with context changing affecting base simulation identifier.
• Invoke a camera reset upon changing contexts via player.goToContext().

• Fixed an issue where sometimes DependencyManager would be given a bot that was undefined which would crash the simulation.

• Added the ability to send and receive webhooks.
  • Send webhooks using the following functions:
    • webhook(options) - options is an object that takes the following properties:
      • method - The HTTP Method that should be used for the request.
      • url - The URL that the request should be made to.
      • responseShout - (Optional) The shout that should happen when a response is received from the server.
      • headers - (Optional) The HTTP headers that should be sent with the request.
      • data - (Optional) The data that should be sent with the request.
    • webhook.post(url, data, options) - Sends a HTTP Post request.
      • url - The URL that the request should be made to.
      • data - (Optional) The data that should be sent with the request.
      • options - (Optional) An object that takes the following properties:
        • responseShout - (Optional) The shout that should happen when a response is received from the server.
        • headers - (Optional) The headers that should be sent with the request.
  • Receive webhooks by registering a handler for the onWebhook() action and send requests to https://auxplayer.com/{context}/{channel}/whatever-you-want.
    • onWebhook() is shouted to the channel that the request was made to and that is an object with the following properties:
      • method - The HTTP Method that the request was made with.
      • url - The URL that the request was made to.
      • data - The JSON data that the request included.
      • headers - The HTTP headers that were included with the request.
• Added the ability to spy on shouts and whispers via the onShout() event.
  • onShout() is executed on every bot whenever a shout or whisper happens.
    • It is useful for tracking what shouts are being made and modifying responses.
    • Also useful for providing default behaviors.
    • that is an object with the following properties:
      • name is the name of the action being shouted.
      • that is the argument which was provided for the shout.
      • targets is an array of bots that the shout was sent to.
      • listeners is an array of bots that ran a script for the shout.
      • responses is an array of responses that were returned from the listeners.
• Added events to notify scripts when channels become available.
  • The following events have been added:
    • onChannelSubscribed() - happens the first time a channel is loaded. Sent to every channel that is currently loaded.
    • onChannelUnsubscribed() - happens when a channel is unloaded. Sent to every channel that remains after the channel is unloaded.
    • onChannelStreaming() - happens when a channel is connected and fully synced. Sent to every channel that is currently loaded.
    • onChannelStreamLost() - happens when a channel is disconnected and may not be fully synced. Sent to every channel that is currently loaded.
    • For all events, that is an object with the following properties:
      • channel - The channel that the event is for.
  • The following events have been removed:
    • onConnected()
    • onDisconnected()
• Added in tags to change the state of the inventory's camera controls:
  • aux.context.inventory.pannable enables and disables the inventory's ability to pan, off by default.
  • aux.context.inventory.resizable enables and disables the inventory's drag to resize functionality, on by default.
  • aux.context.inventory.rotatable enables and disables the inventory's ability to rotate, on by default.
  • aux.context.inventory.zoomable enables and disables the inventory's ability to zoom, on by default.

• Resolved issue with the near cliiping plane for the sheet's minifile image.
• Resolved issues with the create empty bot button not functioning sometimes on mobile.

• Reworked the login functionality to use popups instead of dedicated pages.
  • The login page has been split into two popups:
    • The login popup (account selector).
    • The authorization popup (QR Scanner).
  • The login popup has the following functions:
    • It can be opened by the "Login/Logout" button in the menu.
    • It will display a list of accounts that can be used to login.
    • If no accounts are available, then a username box will be shown.
    • If accounts are available, a new account can be added by clicking the "+" button at the bottom of the list.
    • At any time, the user can close the popup to keep their current login.
    • They can also select the "Continue as Guest" option to login as a guest.
  • The authorization popup has the following functions:
    • It is opened automatically when the user needs to scan an account code.
    • It contains the QR Code scanner to scan the account code.
    • It also contains an input box to manually enter the code.
    • Closing the popup automatically logs the user in as a guest.
• Made the account QR Code blue.
• Added the ability to click the account QR Code to copy it to the clipboard.

• Fixed a couple communication issues between the server and client during login.
  • One such issue could potentially leave the client in state where future changes would not be synced to the server.