Skip to main content

Button Configuration

Learn how to configure individual buttons on your HUD to perform specific actions on objects in Second Life.

[Suggested Image: HUD configuration page showing the button list and configuration interface]

Accessing Button Configuration​

To configure buttons on your HUD:

  1. Open Your HUD: Click on a HUD from your dashboard
  2. View Button List: See all available buttons detected from your HUD
  3. Configure Actions: Click on any button to set its action

[Suggested Image: Navigation from dashboard to HUD configuration page]

Understanding HUD Buttons​

Button Detection​

When your HUD connects to the dashboard, the system automatically detects:

  • Available Links: All numbered links in your HUD object
  • Button Names: Default names like "Button 1", "Button 2", etc.
  • Link Numbers: Corresponding link numbers from Second Life

📝 Note: Each link in your HUD object becomes a configurable button in the web interface.

[Suggested Image: Button detection showing the mapping between Second Life links and web interface buttons]

Button Status​

Buttons have different status indicators:

🟢 Configured​

  • Green border: Button has been configured with an action
  • Action visible: Shows the current action (e.g., "Set Texture")
  • Ready to use: Can be triggered from Second Life

⚪ Unconfigured​

  • Gray border: No action assigned yet
  • Needs setup: Click to configure
  • Won't respond: Button clicks in Second Life have no effect

[Suggested Image: Side-by-side comparison of configured vs unconfigured buttons]

Button Configuration Interface​

Opening the Configuration Modal​

  1. Click any button in the button list
  2. Configuration modal opens with all available options
  3. Choose action type from the dropdown menu

[Suggested Image: Button configuration modal opening from clicking a button]

Configuration Options​

Action Selection​

  • Dropdown menu: Choose from 20+ available actions
  • Categories: Actions organized by type (Basic Materials, PBR, Effects, etc.)
  • Real-time preview: See parameter options as you select

Parameter Configuration​

Based on the selected action, you'll see different parameters:

  • Target Selection: Choose which object links to affect
  • Face Selection: Select specific faces or all faces
  • Action-specific options: Texture UUIDs, colors, values, etc.

[Suggested Image: Configuration modal showing action dropdown and parameter options]

Action Categories​

🎨 Basic Materials​

Perfect for simple material changes:

  • Set Texture: Apply a texture to object faces
  • Clear Texture: Remove textures and return to default
  • Set Color: Change the color/tint of objects
  • Clear Color: Reset to white/default color
  • Set Transparency: Make objects see-through
  • Clear Transparency: Return to fully opaque

[Suggested Image: Basic materials configuration showing texture UUID input and color picker]

✨ Basic Effects​

Add visual effects to your objects:

  • Set Glow: Make objects emit light
  • Clear Glow: Remove glow effect
  • Set Fullbright: Make objects ignore lighting
  • Clear Fullbright: Return to normal lighting
  • Set Shininess: Add reflective properties
  • Clear Shininess: Remove reflections

[Suggested Image: Effects configuration showing glow level slider and shininess options]

💎 PBR Materials (Advanced)​

Modern, realistic material rendering:

  • PBR Complete: Apply complete PBR material assets
  • PBR Base Color: Set albedo/diffuse color and texture
  • PBR Normal: Apply normal maps for surface detail
  • PBR Metallic: Configure metallic and roughness properties
  • PBR Emissive: Add emissive (glowing) textures

[Suggested Image: PBR configuration interface showing texture inputs and material property sliders]

📏 Object Transform​

Change object size and rotation:

  • Increase Size: Make objects larger by specified amounts
  • Decrease Size: Make objects smaller
  • Set Rotation: Rotate objects to specific angles
  • Advanced Rotation: Continuous rotation effects

[Suggested Image: Transform configuration showing scale inputs and rotation controls]

💡 Lighting System​

Control lighting effects:

  • Set Point Light: Create light sources
  • Clear Point Light: Remove lighting effects
  • Configure properties: Color, intensity, radius, and falloff

[Suggested Image: Lighting configuration with color picker and intensity/radius sliders]

🔗 Actions​

Trigger external actions:

  • Open URL: Launch web pages or external links
  • Group Actions: Execute multiple actions simultaneously

[Suggested Image: URL action configuration and group actions setup]

Target Selection​

Choose which parts of objects to affect:

  • Affects entire object: All linked parts receive the action
  • Most common choice: Good for overall appearance changes
  • Efficient: Single command affects everything
  • Target individual parts: Only selected links are affected
  • Precise control: Perfect for complex objects
  • Link information: Shows link names when available

[Suggested Image: Link selection dropdown showing "All Links" and individual link options with names]

Face Targeting​

Control which faces of objects are affected:

All Faces​

  • Affects all sides: The entire surface of selected links
  • Default choice: Most common selection
  • Complete coverage: Ensures no faces are missed

Specific Faces​

  • Individual face control: Target specific faces (0-7)
  • Advanced usage: For complex texturing schemes
  • Face numbers: Based on Second Life face numbering

[Suggested Image: Face selection interface showing "All Faces" and numbered face options]

Advanced Configuration​

Parameter Details​

Different actions require different parameters:

Texture Actions​

  • Texture UUID: 36-character Second Life texture identifier
  • Repeats: How many times the texture tiles (X, Y)
  • Offsets: Position adjustment (X, Y coordinates)
  • Rotation: Texture rotation in degrees

Color Actions​

  • RGB Values: Red, Green, Blue components (0.0 to 1.0)
  • Color Picker: Visual color selection interface
  • Tint Mode: How color combines with existing textures

Scaling Actions​

  • Scale Factors: Multiplier for size changes (X, Y, Z)
  • Uniform Scaling: Apply same scale to all dimensions
  • Incremental: Add/subtract from current size

[Suggested Image: Advanced parameter configuration showing texture settings with repeats, offsets, and rotation]

Group Actions​

Combine multiple actions into one button:

  1. Select "Group Actions" from the action dropdown
  2. Add individual actions to the group
  3. Configure each action with its own parameters
  4. Set execution order for the actions

💡 Use Case: Change texture, color, and glow all with one button click.

[Suggested Image: Group actions configuration showing multiple actions stacked in a list]

Saving and Testing​

Configuration Workflow​

  1. Select Action: Choose the desired action type
  2. Set Parameters: Configure all required options
  3. Choose Targets: Select links and faces
  4. Save Configuration: Click "Save" to apply settings
  5. Test in Second Life: Click the button in-world to verify

Real-time Sync​

  • Immediate Effect: Changes apply instantly to your HUD
  • No Restart Required: Button works immediately after saving
  • Live Updates: Other users see changes right away

[Suggested Image: Save button and confirmation message, plus testing in Second Life]

Common Configuration Patterns​

Material Switcher​

Set up buttons to switch between different materials:

  • Button 1: "Wood Texture" - applies wood texture and brown tint
  • Button 2: "Metal Texture" - applies metal texture and gray color
  • Button 3: "Glass Mode" - sets transparency and removes textures

Lighting Controller​

Create dynamic lighting effects:

  • Button 1: "Warm Light" - yellow light, medium intensity
  • Button 2: "Cool Light" - blue light, high intensity
  • Button 3: "Turn Off" - removes all lighting

Size Controller​

Provide size adjustment options:

  • Button 1: "Increase Size" - grows object by 10%
  • Button 2: "Decrease Size" - shrinks object by 10%
  • Button 3: "Reset Size" - returns to original size

[Suggested Image: Examples of common button configurations with their settings]

Best Practices​

🎯 Naming Convention​

  • Use descriptive names: "Red Texture" instead of "Button 1"
  • Group related functions: "Light On", "Light Off", "Light Dim"
  • Keep names short: They display in limited space

⚡ Performance Tips​

  • Avoid redundant actions: Don't set the same texture twice
  • Use "All Links" when possible: More efficient than individual links
  • Group related changes: Combine texture + color into one action

🔄 User Experience​

  • Logical grouping: Put related functions near each other
  • Clear feedback: Use contrasting settings so users see changes
  • Test thoroughly: Verify each button works as expected

[Suggested Image: Well-organized button layout showing logical grouping and clear naming]

Troubleshooting Button Configuration​

Common Issues​

"No Effect" When Clicking​

  • Check configuration: Ensure button is properly configured
  • Verify targets: Make sure link/face selections are correct
  • Test parameters: Confirm UUIDs and values are valid

"Invalid Texture UUID"​

  • Check format: UUIDs must be 36 characters with hyphens
  • Verify texture: Ensure texture exists and is accessible
  • Copy carefully: Avoid extra spaces or characters

"Button Not Responding"​

  • Reconnect HUD: Reset the HUD scripts in Second Life
  • Check session: Verify session ID is correct
  • Reload dashboard: Refresh the web interface

[Suggested Image: Troubleshooting guide showing common error messages and solutions]

Next Steps​

Continue configuring your HUD with these guides:

  1. Action Types - Detailed guide to all available actions
  2. Receptor Objects - Understanding target objects
  3. Advanced Techniques - Complex configurations
  4. Interface Design - Customize your HUD's appearance

Need help? Visit our FAQ or Contact Support.