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

• Fixed an issue where having duplicate bot atoms could cause the bot values to be locked because it would chose the wrong bot to update.

• Fixed an issue where script bots were not being converted back into normal bots correctly.

Breaking Changes

• Changed create() and createTemp() to automatically set auxCreator to the current this bot.
  • create() no longer takes a bot/bot ID as the first parameter. Instead, you need to use the from() function to set the creator ID.
  • e.g. create(from(bot)).
• Renamed all listen tags to not use the () at the end.
  • Every tag is now the same. This means that () to the end of a tag does nothing special.
  • i.e. There is no difference between a "normal" tag and a "listen" tag.
  • Instead, tags can listen by prefixing their script with a @ symbol.
  • e.g. player.toast("Hi!") becomes @player.toast("Hi!").
• Renamed mod() to applyMod().
• Renamed mod.addToMenu() to addToMenuMod().
• Renamed mod.removeFromMenu() to removeFromMenuMod().
• Renamed mod.addToContext() to addToContextMod().
• Renamed mod.removeFromContext() to removeFromContextMod().
• Renamed mod.setPosition() to setPositionMod().
• Renamed mod.subtract() to subtractMods().
• Renamed mod.import() to getMod().
• Removed mod.export().

Improvements

• Added a creator variable to scripts and formulas which gets the bot that created the this bot.
  • creator is null if the current bot has no creator.
• Added a raw variable to scripts and formulas which gets direct access to the this bot's tag values.
  • This is similar to the tags variable but does not do any pre-processing on the tag value. This means you will get formula scripts back instead of the calculated formula values.
• Improved the tags variable to handle setting tag values on it.
  • This lets you write scripts like tags.name = "joe" or bot.tags.myContext = true.
  • Also works with the raw variable.
• Improved bots returned from getBots() and getBot() to support setting tag values on their tags property.
  • This lets you write things like myBot.tags.name = "bob".
  • Should also work with bots in the that variable.
• Added a data variable which equals that.
• Added the player.hideHtml() function which hides the HTML modal.
• Added in inventory tags to limit panning movements on the inventory context: auxContextInventoryPannableMinX, auxContextInventoryPannableMaxX, auxContextInventoryPannableMinY, auxContextInventoryPannableMaxY.
• Reformatted new selection id logic by removing the ._ character from its return.

• Resolved issue of hidden tags showing up when no filter has been selected on the table.

• removeTags() now checks if a tag starts with the given search value.
  • Previously it would check if the search value matched the first part of a tag up do the dot (.).
  • Now, it will remove all tags that start with the given search value.
  • e.g. removeTags(bot, "hello") will remove hello, helloAbc, and helloX.
• The bot table tag blacklist has been updated to support camel cased tags.
• Renamed several functions:
  • Renamed onAnyAction() to onChannelAction().
  • Renamed player.currentChannel() to player.getCurrentChannel().
  • Renamed player.currentContext() to player.getCurrentContext().
  • Renamed mod.apply() to mod().
    • All the other mod. functions remain the same.
    • ex. mod.export() still works.
• Renamed all of the built-in tags to use camelCase instead of dot.case.
  • Renamed all the scene tags to channel tags.
    • aux.scene.color is now auxChannelColor
    • aux.scene.user.player.color is now auxChannelUserPlayerColor
    • aux.scene.user.builder.color is now auxChannelUserBuilderColor
  • Renamed aux.inventory.height to auxInventoryHeight.
  • Renamed aux.channel to auxChannel.
  • Renamed aux.connectedSessions to auxConnectedSessions.
  • Renamed aux.color to auxColor.
  • Renamed aux.creator to auxCreator.
  • Renamed aux.draggable to auxDraggable.
  • Renamed aux.draggable.mode to auxDraggableMode.
  • Renamed aux.stackable to auxStackable.
  • Renamed aux.destroyable to auxDestroyable.
  • Renamed aux.editable to auxEditable.
  • Renamed aux.stroke.color to auxStrokeColor.
  • Renamed aux.stroke.width to auxStrokeWidth.
  • Renamed aux.line.to to auxLineTo.
  • Renamed aux.line.width to auxLineWidth.
  • Renamed aux.line.style to auxLineStyle.
  • Renamed aux.line.color to auxLineColor.
  • Renamed aux.label to auxLabel.
  • Renamed aux.label.color to auxLabelColor.
  • Renamed aux.label.size to auxLabelSize.
  • Renamed aux.label.size.mode to auxLabelSizeMode.
  • Renamed aux.label.anchor to auxLabelAnchor.
  • Renamed aux.listening to auxListening.
  • Renamed aux.shape to auxShape.
  • Renamed aux.scale to auxScale.
  • Renamed aux.scale.x to auxScaleX.
  • Renamed aux.scale.y to auxScaleY.
  • Renamed aux.scale.z to auxScaleZ.
  • Renamed aux.image to auxImage.
  • Renamed aux.iframe to auxIframe.
  • Renamed aux.iframe.x to auxIframeX.
  • Renamed aux.iframe.y to auxIframeY.
  • Renamed aux.iframe.z to auxIframeZ.
  • Renamed aux.iframe.size.x to auxIframeSizeX.
  • Renamed aux.iframe.size.y to auxIframeSizeY.
  • Renamed aux.iframe.rotation.x to auxIframeRotationX.
  • Renamed aux.iframe.rotation.y to auxIframeRotationY.
  • Renamed aux.iframe.rotation.z to auxIframeRotationZ.
  • Renamed aux.iframe.element.width to auxIframeElementWidth.
  • Renamed aux.iframe.scale to auxIframeScale.
  • Renamed aux.progressBar to auxProgressBar.
  • Renamed aux.progressBar.color to auxProgressBarColor.
  • Renamed aux.progressBar.backgroundColor to auxProgressBarBackgroundColor.
  • Renamed aux.progressBar.anchor to auxProgressBarAnchor.
  • Renamed aux._selection to _auxSelection.
  • Renamed aux._user to _auxUser.
  • Renamed aux.user.active to auxUserActive.
  • Renamed aux.version to auxVersion.
  • Renamed aux._userChannel to _auxUserChannel.
  • Renamed aux._userContext to _auxUserContext.
  • Renamed aux._userInventoryContext to _auxUserInventoryContext.
  • Renamed aux._userMenuContext to _auxUserMenuContext.
  • Renamed aux._userSimulationsContext to _auxUserChannelsContext.
  • Renamed aux._editingBot to _auxEditingBot.
  • Renamed aux._selectionMode to _auxSelectionMode.
  • Renamed aux.runningTasks to auxRunningTasks.
  • Renamed aux.finishedTasks to auxFinishedTasks.
  • Renamed aux.task.output to auxTaskOutput.
  • Renamed aux.task.error to auxTaskError.
  • Renamed aux.task.time to auxTaskTime.
  • Renamed aux.task.shell to auxTaskShell.
  • Renamed aux.task.backup to auxTaskBackup.
  • Renamed aux.task.backup.type to auxTaskBackupType.
  • Renamed aux.task.backup.url to auxTaskBackupUrl.
  • Renamed aux.context to auxContext.
  • Renamed aux.context.color to auxContextColor.
  • Renamed aux.context.locked to auxContextLocked.
  • Renamed aux.context.grid.scale to auxContextGridScale.
  • Renamed aux.context.visualize to auxContextVisualize.
  • Renamed aux.context.x to auxContextX.
  • Renamed aux.context.y to auxContextY.
  • Renamed aux.context.z to auxContextZ.
  • Renamed aux.context.rotation.x to auxContextRotationX.
  • Renamed aux.context.rotation.y to auxContextRotationY.
  • Renamed aux.context.rotation.z to auxContextRotationZ.
  • Renamed aux.context.surface.scale to auxContextSurfaceScale.
  • Renamed aux.context.surface.size to auxContextSurfaceSize.
  • Renamed aux.context.surface.minimized to auxContextSurfaceMinimized.
  • Renamed aux.context.surface.defaultHeight to auxContextSurfaceDefaultHeight.
  • Renamed aux.context.surface.movable to auxContextSurfaceMovable.
  • Renamed aux.context.player.rotation.x to auxContextPlayerRotationX.
  • Renamed aux.context.player.rotation.y to auxContextPlayerRotationY.
  • Renamed aux.context.player.zoom to auxContextPlayerZoom.
  • Renamed aux.context.devices.visible to auxContextDevicesVisible.
  • Renamed aux.context.inventory.color to auxContextInventoryColor.
  • Renamed aux.context.inventory.height to auxContextInventoryHeight.
  • Renamed aux.context.inventory.pannable to auxContextInventoryPannable.
  • Renamed aux.context.inventory.resizable to auxContextInventoryResizable.
  • Renamed aux.context.inventory.rotatable to auxContextInventoryRotatable.
  • Renamed aux.context.inventory.zoomable to auxContextInventoryZoomable.
  • Renamed aux.context.inventory.visible to auxContextInventoryVisible.
  • Renamed aux.context.pannable to auxContextPannable.
  • Renamed aux.context.pannable.min.x to auxContextPannableMinX.
  • Renamed aux.context.pannable.max.x to auxContextPannableMaxX.
  • Renamed aux.context.pannable.min.y to auxContextPannableMinY.
  • Renamed aux.context.pannable.max.y to auxContextPannableMaxY.
  • Renamed aux.context.zoomable to auxContextZoomable.
  • Renamed aux.context.zoomable.min to auxContextZoomableMin.
  • Renamed aux.context.zoomable.max to auxContextZoomableMax.
  • Renamed aux.context.rotatable to auxContextRotatable.
  • Renamed stripe.publishableKey to stripePublishableKey.
  • Renamed stripe.secretKey to stripeSecretKey.
  • Renamed stripe.charges to stripeCharges.
  • Renamed stripe.successfulCharges to stripeSuccessfulCharges.
  • Renamed stripe.failedCharges to stripeFailedCharges.
  • Renamed stripe.charge to stripeCharge.
  • Renamed stripe.charge.receipt.url to stripeChargeReceiptUrl.
  • Renamed stripe.charge.receipt.number to stripeChargeReceiptNumber.
  • Renamed stripe.charge.description to stripeChargeDescription.
  • Renamed stripe.outcome.networkStatus to stripeOutcomeNetworkStatus.
  • Renamed stripe.outcome.reason to stripeOutcomeReason.
  • Renamed stripe.outcome.riskLevel to stripeOutcomeRiskLevel.
  • Renamed stripe.outcome.riskScore to stripeOutcomeRiskScore.
  • Renamed stripe.outcome.rule to stripeOutcomeRule.
  • Renamed stripe.outcome.sellerMessage to stripeOutcomeSellerMessage.
  • Renamed stripe.outcome.type to stripeOutcomeType.
  • Renamed stripe.errors to stripeErrors.
  • Renamed stripe.error to stripeError.
  • Renamed stripe.error.type to stripeErrorType.

• Added the renameTagsFromDotCaseToCamelCase() function to help with updating bots from the old tag style to the new tag style.
  • Use this function on bots that were using the old tag naming style but you want to use the new style.
  • Note that this only renames the tags already existing on the bot. It does not fix any code that might be stored in the bot.
  • Usage: renameTagsFromDotCaseToCamelCase(bot)
• Added the bot variable to all functions and formulas.
  • Replacement for this.
• Added the getMod() function to be able to get all the tags on a bot.
  • Returns a mod containing all the tag values on the bot.
  • The returned mod is always up to date with the bot's current values.
  • Calling mod.export() on the returned mod will save the tag code to JSON.
    • For example, if you have a formula =123, then mod.export(getMod(bot)) will return JSON containing tag: "=123" instead of tag: 123.
• Added the tags variable to all functions and formulas.
  • This is a quick shortcut for let tags = getMod(bot) at the beginning of a script/formula.
  • The tags variable has some caveats when used in formulas. Namely that the formulas won't be automatically updated when another tag referenced from the formula is updated. (Use getTag() for full support)
  • Supports autocomplete for all tags.

• Added a new system for managing causal trees.
  • This new system has improvements for performance and reliability.
  • It also adds support for revision history. (The controls will be coming in a future update)
  • Every new channel will use the new system while old channels will continue to use the old one.
  • Everything should function exactly the same as before.
• Changed the .aux file format.
  • The new format is based on the bots state and is easily human readable/writable.
  • This is different from the old format where a list of atoms was stored.
  • Downloading a channel will give you a .aux file with the new format.
  • Uploading a channel supports both the old format and the new format.

• Changed the functionality of the table view's filterying system to be inverted.
• Attempting to drag a bot onto a bot with aux.stackable set to false will now cause the dragged bot to pass through the other bot as if it was not there.

• Resolved issue of player inventory resizing showing a reset on each change.
• Tag values that are objects are displayed as JSON.Stringified text. ie { field: "myValue" }
  • Known Issue: Modifying these displayed strings will convert the tag value to a string
• When Moving the camera via player.MoveTo(), the pan distance is now set correctly so pan limits are absolute.

• Added the server.setupChannel(channel, botOrMod) function.
  • This sends a setup_channel action to the server which, if executed using action.perform(), will create a channel if it doesn't already exist and place a clone of the given bot or mod in it.
  • Takes 2 parameters:
    • channel - The channel that should be created.
    • botOrMod - (Optional) The bot or mod that should be cloned and placed inside the new channel. onCreate() is triggered after the bot or mod is created so you can use that to script custom setup logic.
  • As mentioned above, you have to receive the device action in onAnyAction() and do an action.perform(that.action.event) to allow channels to be setup via this function.

• Added the player.replaceDragBot(botOrMod) function.
  • When used inside of onBotDrag() or onAnyBotDrag(), it will set the bot/mod that the user is dragging.
  • Use this to implement clone or cloneAsMod style functionality.
• Added the ability to create temporary bots using the createTemp() function.
  • This function behaves exactly the same as create() but the created bot is temporary, which means it won't be shared and will be deleted upon refresh.

• Renamed aux.movable to aux.draggable.
  • aux.draggable now only woks with true and false values.
  • The pickup and drag options have been moved to a new tag aux.draggable.mode.
  • The clone and cloneMod options have been removed.
    • You will need to use the new player.replaceDragBot() API to replicate clone and cloneMod behavior.
• Removed the aux.mergeable tag.
  • It has been replaced with the aux.stackable tag.
• Removed the aux.mod and aux.mod.mergeTags tags.
• Renamed the local bot to the cookie bot.
  • This is supposed to help make it clear that the bot data is stored in the browser and will be cleared when the browser's data is cleared.
• Renamed the aux.users context to aux-users.
• Added the aux.inventory.height tag which controls the default height of the inventory on all contexts when set of the config bot.
  • The aux.context.inventory.height tag has been updated to only work on the context bot.
• Removed names from the other player frustums.
• Removed aux.whitelist, aux.blacklist, and aux.designers.

• Fixed an issue that would cause duplicate users to be created all the time.
• Fixed an issue that prevented other users from being rendered.
• Fixed an issue that caused all users to use channel designer colors.

• Improved the vendor JavaScript bundle size by removing unused code.
  • Refactored three-vrcontroller-module to use the three package instead of three-full so we don't duplicate Three.js.
  • Removed unused shims (PEP.js, webrtc-adapter).
  • Refactored lodash imports to directly import the modules that are used.
    • This helps with dead code eliminiation.
• Added the ability to save and load files.
  • New functions:
    • server.saveFile(filename, data, options)
      • filename is a string and should start with /drives/.
      • data is a string of the data to store.
      • options is an object with the following properties:
        • callbackShout A shout that should happen on the server when the file is done saving.
        • overwriteExistingFile A boolean that indicates if existing files should be overwritten. (defaults to false)
    • server.loadFile(filename, options)
      • filename is a string and should start with /drives/.
      • options is an object with the following properties:
        • callbackShout A shout that should happen on the server when the file is done loading.
  • Note that the save file and load file tasks must be enabled via the onAnyAction() listener.
    • You can enable it via using this code:

    if (that.action.type === 'device') {
        if (
            ['save_file', 'load_file'].indexOf(
                that.action.event.type
            ) >= 0
        ) {
            action.perform(that.action.event);
        }
    }
    

  • All files from USB drives are stored under the /drives directory and the USB drives themselves are numbered starting with 0.
    • To load a file from USB drive #1, use server.loadFile("/drives/0/myFile").
    • To save a file to USB drive #2, use server.saveFile("/drives/1/myFile", data).
• Removed several options from the side menu:
  • Removed the channel name from the top of the menu.
  • Removed the login status from the top of the menu.
  • Removed the login/logout options from the menu.
    • The "Logout" option will still be available if you are logged in as a non-guest.
    • Once you are logged out, then the option will dissapear.
  • Removed the "Add Channel" option from the menu in AUXPlayer.

• Fixed an issue that prevented the removeTags() function from working when given an array of bots.