Skip to content

Workshop

KiwifruitDev edited this page Jul 22, 2023 · 12 revisions

This page illustrates how to submit custom video/audio effects to the Steam Workshop.

Prerequisites

Creating an Effect

Effects can easily be created using a template from within the software.

To do so, open Nonsensical Video Generator and head to the Effects tab.

Then, click on the Workshop Effect Management button to start the process.

Workshop Effect Management Button Workshop Effect Management Subpage

Interactables

The following interactable controls are available:

  • Effect Name Text Entry
    • The name of the effect. This will be used as the title of the effect in the Steam Workshop and will be suffixed by "Effect".
    • Default: My Effect
  • Effect File Name Text Entry
    • The internal name of the effect. This will be used as the name of the effect's folder and file under a .lua extension.
    • Default: myeffect
  • Minimal Template Toggle Switch (Off)
    • Toggles whether to use the minimal template or not.
    • Default: Off
  • Back Button
    • Returns to the Effects tab.
  • Reload All Button
    • Removes all effect libraries, updates Steam Workshop subscriptions, and re-queries Lua scripts.
    • This should be pressed after updating the effect script as they are only run once otherwise.
  • Create Button
    • Creates the effect using the specified parameters and returns to the Effects tab.

Editing the Effect

Once created, the effect can be edited by clicking on its name in the effect list.

This will open code on your computer, which is the application name for Visual Studio Code.

See Prerequisites for more information.

Your Visual Studio Code window should look like this:

The built-in documentation of the non-minimal template should be enough to get you started.

The effect created by the template will perform a speed up or slow down with either an increase in contrast or inverted colors.

Effect Settings and Libraries

The effect template uses the following settings:

  • Chance Roll Text Entry
    • Out of 100, chance for which effect to apply.
    • This is what determines whether to slow down or speed up the video.
    • Default: 50

No libraries are used by default, but if you are using any, you should add them to the libraries table in the Query function.

See the built-in documentation for more information.

Testing the Effect

To test the effect, head back to Nonsensical Video Generator, head to the Effects tab, click on the Workshop Effect Management button, and then finally click Reload All Button to update the effect libraries.

This page will be kept open when you visit a different tab, such as the Generate tab.

To test the effect, make sure it's the only effect enabled and then visit the Generate tab.

You might want to increase the Effect Chance Text Entry to make it more likely to appear.

Once ready, click on Start Rendering Button to start the rendering process.

Debugging the Effect

To view debugging and other useful information, press F5 to open the console.

Console

Selecting Workshop Tags

Once you're happy with the effect, you can publish it to the Steam Workshop.

To do so, head to the Effects tab, click on your effect's Settings button, and then click on Publish Button.

You will be prompted to select a few tags with toggle switches Toggle Switch (Off) next to them.

Workshop Tags Subpage

By default, the effect template would use the following tags:

  • Video Toggle Switch (On)
    • This effect applies contrast and color changes to the video.
    • Therefore, it is a video effect.
  • Audio Toggle Switch (On)
    • This effect primarily slows down or speeds up the video and audio.
    • Because the audio is affected, this is an audio effect.

No libraries are used by default, but if you are using any, you should select the appropriate tags.

Publishing the Effect

After selecting tags, click on Submit Button to choose a thumbnail and publish the effect.

By default, the effect template would use the following thumbnail:

Thumbnail

You can change this by selecting a different image otherwise.

The recommended thumbnail size is 256x256 or a larger square image.

Updating the Effect

To update the effect at any time, head to the Effects tab, click on your effect's Settings button, and then click on Publish Button again.

If you see View Workshop Button, then the effect can be updated without creating a listing.

Clone this wiki locally