Plugins + Scripts MultiMenu

MultiMenu Manual​

MultiMenu is a lightweight UI plugin for VaM.
It lets creators build multiple custom menus, overlays, settings panels, and trigger-based controls inside a single plugin instance.

The main idea is simple: one atom can hold many menus. Switch them, or use them as transparent actions for imgs in background.
Each menu can have its own layout, position, colors, title, buttons, sliders, checkboxes, switchers, text items, spacers, and actions.

MultiMenu is especially useful for larger scenes where many UI controls are needed, but using many separate UI plugins would add unnecessary clutter and performance cost. This is solution.

​

Recommended Workflow​

For the best visual result, I recommend using MultiMenu as an interactive overlay.
Create your menu graphics as regular image atoms, then place MultiMenu items over the visual buttons, labels, or sliders.
This allows you to design beautiful UI panels in Photoshop, GIMP, Affinity, or any other image editor, while MultiMenu handles only the lightweight interactive layer.
With this workflow you can create polished, custom-looking menus with very little performance cost.

---

​

What MultiMenu Can Do​

• Create multiple menus inside one plugin
• Build many UI layers from a single atom
• Show, hide, toggle, or reset menus through VaM triggers
• Position each menu independently in 3D space
• Rotate each menu independently
• Style each menu separately
• Add buttons, sliders, checkboxes, switchers, text items, spacers, and submenus
• Copy and paste menu styles
• Copy and paste menu positions
• Set default states for interactive items
• Reset menus back to their default states
• Use transparent items as clickable overlays above custom images
• Reduce the need for many separate UI/action plugins
• 
  

---

​

Menu Features

Each menu can have its own settings:

• Menu name
• Menu ID
• Active state (For hiding them)
• Accept External Actions toggle
• Hide Menu Title option
• Background color
• Background alpha
• Menu title color
• Menu title size
• Menu title alignment
• Wrapper width
• Menu padding
• Item alignment
• Position X / Y / Z
• Rotation X / Y / Z
• 
  
• 
  

This makes it possible to stack multiple menus over each other, swap them during gameplay, or use them as separate UI pages.

Item Types​

Button​

A simple clickable button.
Use it for normal actions such as opening a menu, triggering scene logic, changing settings, or starting any VaM trigger action.

---

Submenu​

A cycling button with multiple internal trigger states.

Each click moves to the next trigger state and runs that state’s actions.
This is useful for compact settings where one button should cycle through several modes.

Example use case:

• Quality Low / Quality Medium / Quality High

---

​

Slider​

A value slider with trigger output and a default value.
Use it for settings that need smooth numeric control.

Example use cases:

• Light Intensity
• Alpha
• Scale
• Speed
• Volume
• Custom plugin values

---

​

Checkbox​

A classic checkbox item with ON and OFF actions.
Use it for simple enabled / disabled settings.

Example use case:

• Activate Music?: Toggle On/Off

---

​

Switcher​

A two-state button with separate ON and OFF labels and actions.
Unlike Checkbox, Switcher behaves more like a visual toggle button.
Visible Label is actualy triggered button

Example use cases:

• Music: On / Music: Off
• TV visibility: Show / TV visibility: Hide
• Skybox: Day / Skybox: Night

---

​

Spacer​

Empty layout space.
Use it to create gaps, align elements, or improve menu layout.

---

​

Text​

A visual text item.
Use it for labels, section names, short descriptions, or custom menu headings.
You can hide Item background

---

​

External Actions​

MultiMenu can be controlled from other VaM triggers.

Available external actions:

• Hide All Menus
• Hide Menu Name
• Hide Menu ID
• Show All Menus
• Show Menu Name
• Show Menu ID
• Toggle Menu Name
• Toggle Menu ID
• Reset Menu Name
• Reset Menu ID

Reset Behavior​

Reset actions restore supported items in a menu back to their configured default states.
This can affect:

• Sliders
• Checkboxes
• Switchers
• Submenus

This is useful when you want a settings menu to return to a known default state after a scene event, mode change, or reset button.

---

​

Accept External Actions​

Each menu has an Accept External Actions option.

When enabled, the menu can respond to external trigger actions such as show, hide, toggle, and reset.

When disabled, external actions will ignore that menu.
The menu items themselves can still be clicked manually if the menu is visible and active.
So its good way how to hide all other Menus with just one action, and show only ID or named specific Menu

---

​

Overlay Use​

MultiMenu is designed to work very well as an overlay system.
A common workflow is:

1. Create a UI design as an image.
2. Add the image into VaM.
3. Add MultiMenu to an atom.
4. Place buttons, sliders, or toggles over the image.
5. Make the item backgrounds transparent if needed.
6. Connect the items to your scene actions.

This gives you the look of a fully custom interface while keeping the interactive layer simple and lightweight.

---

​

Credits​

MultiMenu is freely inspired by the general idea of Hazmhox’s VAMStory plugin.

It is not a copy or a modified version of VAMStory.
MultiMenu was built from the ground up as a separate, lightweight menu system focused on optimized UI overlays, scene settings, and trigger-based control panels.

The goal is to provide a simpler and more performance-friendly tool for creators who want to build complex custom menus from a small number of plugin instances.