Skip to content

Casting a New Overlay

The "Cast New Overlay" option allows you to create a blank overlay from scratch. This is ideal for advanced users who want full control over layout, style, and behavior.

How to Cast a New Overlay

  1. Go to The Forge
  2. Click the Cast New Overlay button (green)

  3. Fill in the form:

  4. Overlay Name
    Must include only letters, numbers, dashes -, underscores _, or spaces.

  5. Create Overlay For
    A dropdown that lists users you have administrative rights over (see Roles). You can cast overlays for yourself or others.

  6. Click Cast Overlay

You’ll be redirected to the view page for the newly created overlay.

What You Get

A newly cast overlay includes:

  • A blank HTML template (starter index.html)
  • A placeholder CSS file (style.css)
  • A JavaScript file for interactivity (script.js)
  • An empty JSON file for setting up a GUI (meta.json)
  • A working OBS-compatible link

This allows you to define your own GUI configuration interface from scratch using the Blueprint Editor, tailored to your overlay's needs.

Use Cases

Casting from scratch is best when:

  • You’re creating a new template or system
  • You want to use the full Smithy editor
  • You don’t want to start from a pre-configured blueprint

🔐 The "Create Overlay For" dropdown only shows users you have permission to manage. Overlay ownership is permanent once cast.