Adventure v2.5.1

This release includes a hotfix for a high-priority bug identified in v2.5.0:

• Adds a limit to the number of distance recalculations performed for midpoint nodes. Certain large or esoteric Adventure qsets would cause this calculation to run an infinite number of times.

Adventure v2.5.0

Adventure v2.5.0 includes several major additions to the previously released inventory system, plus a handful of long-requested feature additions. Let's take a look!

Custom Score Screen

With the addition of inventory items, reviewing your trip through the widget has become more important than ever. The new custom score screen provides a timeline of your journey, including item deltas and conditional question text.

Conditional Question Text

A new addition to the node editor allows you to override question text with variations based on certain requirements: visit count and/or item possession. Multiple variations can be added, and the widget will select a variation based on a variety of factors, primarily recency and item count.

Short Answer Partial String Matching

A new addition to short answer response nodes allows partial matches: if a response contains a match, the matched answer set will be selected. Notably, exact matches still take precedence - and multiple matches are evaluated based on specificity (the length of the matching string).

Other Additions

Hide required items for specific responses

Multiple choice nodes can hide the items required to select them, regardless of whether the requirements are met. Note that the required items will still be listed if the answer is selected and the item requirements are not met.

Improved in-between node UI

Did you know you could add nodes in between existing nodes, by mousing over the midpoint of a link between two nodes? We don't blame you if you didn't, it wasn't obvious at all. We revamped node links to include a small mouseover dot at their midpoints, which will expand when hovered over. In addition, midpoints will intelligently shift along their path if located too close to an adjacent node, making them easier to identify and select when multiple links are cluttered close together. However, unlike the previous implementation, in-between nodes are not allowed if either end of a link is a blank node.

Bug Fixes

While working on this update, we resolved a number of minor bugs throughout the widget.

Full Changelog: v2.4.1...v2.5.0

Adventure v2.4.1

This update incorporates hotfixes for the following issues:

• Under certain circumstances, player answer choices are pushed off the page due to the height of question content.
• Fixed an error associated with an invalid missingItems reference during the required items check upon answer selection in the player.

Adventure v2.4.0

Adventure v2.4.0 introduces the much-anticipated Inventory System, adding considerable depth to the existing suite of tools available to creators. In addition, we've integrated a number of quality-of-life features, and upgraded the MWDK dependency to 3.X.

The Inventory System

The Adventure widget you know and love is already a potent decision tree engine that enables flexible, dynamic experiences based on making choices and exploring their consequences. What if those decisions could be augmented further? What if a user could be granted items based on the nodes they visit or as the result of certain interactions, and future choices gated or modified by those items? The inventory system facilitates all of this and more:

Define Items

Create any number of items that can be given and taken from users over the course of their journey. Items can represent physical goods or status effects, like emotional state, currency, reputation, and more. Items can also be marked silent to make them invisible to the user, but able to facilitate game state under the hood.

Give and Take

Any time a user visits a node, items can be given to them or removed from their inventory. Advanced conditional settings can be applied to control the quantity of items taken or received, or to only apply them on the first visit.

Choices and Conditions

Gate certain choices behind item requirements. Require none, any, or a certain range of items. Answers can additionally be hidden if item requirements are not met.

A Bird's Eye View

Enhancements to the decision tree visualization let you easily assess inventory system transactions and requirements.

An Entirely Optional Layer

The inventory system is entirely opt-in. Existing Adventure widgets will continue to function as they have all along. New features are only enabled when you create your first item.

Additional Enhancements

Improved Node Authoring UI

We've made changes to node authoring windows in several places to take better advantage of larger screen sizes.

Fuzzy String Detection for Short Answers

By default, short answer response matching is less strict, ignoring characters like white space and symbols, as well as capitalization. You can opt-in to strict matching if desired for individual answers.

Custom Labels for Nodes

Have a lot of nodes and lose track of things? You can apply custom labels to them to better navigate the tree at a glance. These labels are entirely for the creator's benefit and have no effect on the player experience.

More to Come

We'll be back in the new year with some additional updates, including contextual question content and a new score screen!

What's Changed

• Feature/inventory system by @cayb0rg in #69

Full Changelog: v2.3.2...v2.4.0

Special Thanks

A special shout-out to @cayb0rg for their incredible work on this feature, going above and beyond the original requirements to deliver a massive update to a massively complicated codebase, and to @SimonRothUCF for his work creating the suite of icons for the inventory system.

Adventure v2.3.2

Adds accessibility metadata to the widget's install.yaml and updates the yarn lockfile to address deprecation.

What's Changed

• Accessibility metadata & ZipArchive fix by @clpetersonucf in #75

Full Changelog: v2.3.1...v2.3.2

Adventure v2.3.1

This update provides numerous accessibility improvements to the widget player, improved image and video support, and many dependency updates to address node package vulnerabilities.

** Change Log:**

• Improved player accessibility
• Added alt text support for images in all node types, including hotspot
• Added an "expand" option to embedded images and video in the player, improving image and video visibility.
• Many dependabot updates

Contributors:

• Cay Henning @cayb0rg
• Michael Ferrara @michaelferrara
• Corey Peterson @clpetersonucf

Adventure 2.3.0

2.3.0 adds support for embedding external video! The "Add Media" button, when selected for Multiple Choice, Short Answer, Narrative, or End Point nodes, will now prompt you to choose between uploading a video from YouTube or Vimeo, or adding an image using the Materia image uploader. This was a commonly requested feature and we're very happy to finally have it supported in Adventure.

Adventure Hotfix v2.2.2

• Resolves an edge-case bug where a user creates a Narrative node, changes the answer destination to "An Existing Destination", and then uses the "Convert" option to change the node to an End Point.
• Added additional checks during the startup tree validation to ensure the internal node properties associated with the bug are removed if no longer required.

Adventure v2.2.1

Demo asset file size reduction

As one of the default widgets for Materia, reducing the size of the assets in this widget's demo contributes to lightening up traffic for a lot of users. This is especially useful for the tiny free Heroku demo installs as database storage is very limited.

Adventure v2.2.0

• Updated dependencies with critical security vulnerabilities
• Added player and creator guides