vscode-ty-levels
A Visual Studio Code extension for editing Avara levels.
Commands
Hit Cmd-Shift-P and begin typing any of the commands below. Hit Enter to execute.
Physically transform geometry and actors en masse by selecting the elements you want to transform and executing any of the following commands. The entire document will be affected if no selection is made.
Translation
You will be prompted to enter a translation expression. Your expression can be a simple constant (e.g. "-2"), or more complex (e.g. "3 * mainRampWidth").
Translate Along X Axis
Add to cx/x/xx attributes.
Translate Along Z Axis
Add to cz/z/zz attributes.
Translate Along Y Axis
Add to y/yy attributes.
Reflection
You will be prompted to enter a coordinate. Elements will be reflected across the axis at the given coordinate.
⚠️ Mirroring commands do not support expressions in angle attributes. Non-numeric angle attributes will trigger an error.
Mirror Across X Axis
Reflect cz/z/zz and angle attributes across the X axis.
Mirror Across Z Axis
Reflect cx/x/xx and angle attributes across the Z axis.
Mirror Across Y Axis
Reflect y/yy and ramp angle attributes across the Y plane. The angle attribute for elements other than ramps is unaffected.
Rotation
You will be prompted to enter a center of rotation (x,z). Elements will be rotated around the specified point. This affects the following attributes: cx, x, xx, cz, z, zz, w, d, angle.
⚠️ Rotation commands do not support expressions in angle attributes. Non-numeric angle attributes will trigger an error.
Rotate 90 Degrees Clockwise
Rotate elements by +90 degrees.
Rotate 90 Degrees Counterclockwise
Rotate elements by -90 degrees.
More commands
Set Param
Change a specific param/attribute to a given value. You will be prompted to enter arguments matching this format: {<param>,<value>,<element (optional)>}. Examples:
w,5
Change all `w` params/attributes to `5`.
shape,bspGrenade,Goody
Change `shape` params/attributes to `bspGrenade` on all `Goody` elements.
Set Param on Element with Etag
This command is triggered by Avara's /set TUI command. It is like Set Param, but targets an element with a given etag.
Tagging
Toggle Auto Tag
Enable or disable automatic etag creation on save. This adds an "autotag" comment to the top of your file when enabled.
By default, only Avara's built-in solids are affected (Wall, Ramp, WallDoor, etc.). This behavior can be configured.
Paste from clipboard, adding etags where they didn't exist before and regenerating existing etags in the pasted clip. There is no need to invoke this command manually. It happens automatically when Auto Tag is enabled and you paste using Cmd-V.
Manual tagging
Add etags to selection. Existing etags are unchanged. The entire document is affected if nothing is selected.
Remove etags from selection or entire document.
Regenerate existing etags across selection or entire document.
External commands
These commands are triggered externally. They cannot be manually invoked.
Find Etag
This command is triggered by Avara's /find TUI command. It selects and reveals the targeted etag in your open document.
Configuration
This extension looks for an optional configuration file tylconfig.json in your workspace's root folder. The structure of the file is as follows:
autotag [Array]
- List additional elements that should be auto-tagged here. They can be other Avara built-ins, or your own macros, for instance.
You can find an example configuration file here.
