LSL sound loop script for ambient sound

Sound brings a place to life: waves on a beach, birds in a garden, a crackling fireplace. This sound loop script plays a sound on repeat from any object, with a volume setting and touch to switch it on or off.

lsl-sound-loop-script.lsl · 52 lines Check this script

// Ambient Sound Loop - free LSL script from WhatSL (https://whatsl.com/scripts/lsl-sound-loop-script)
// Free to use, change and put in your own creations, also ones you sell.
//
// Plays a sound on repeat: birds, waves, a fire, rain, a shop jingle.
// Put a sound in the object's Contents (or paste a sound UUID into SOUND_NAME). Touch to turn it on and off.

string  SOUND_NAME   = "";    // "" = the first sound in Contents; or a sound name or UUID
float   SOUND_VOLUME = 0.6;   // 0.0 to 1.0; keep ambient sounds soft
integer START_ON     = TRUE;
integer OWNER_ONLY   = FALSE; // TRUE = only the owner can turn it on and off

integer gOn = FALSE;

string soundToPlay()
{
    if (SOUND_NAME != "") return SOUND_NAME;
    return llGetInventoryName(INVENTORY_SOUND, 0);
}

setSound(integer on)
{
    llStopSound();
    gOn = FALSE;
    if (!on) return;
    string snd = soundToPlay();
    if (snd == "")
    {
        llOwnerSay("Put a sound in my Contents, or set SOUND_NAME.");
        return;
    }
    llLoopSound(snd, SOUND_VOLUME);
    gOn = TRUE;
}

default
{
    state_entry()
    {
        setSound(START_ON);
    }

    touch_start(integer total)
    {
        if (OWNER_ONLY && llDetectedKey(0) != llGetOwner()) return;
        setSound(!gOn);
    }

    changed(integer change)
    {
        if (change & CHANGED_INVENTORY) setSound(gOn);
    }
}

Free to use, change and put in your own creations, also ones you sell.

How to set it up

Put a sound into the object's Contents (or copy a sound's UUID).
Add the script and save. The sound starts playing.
Touch the object to stop it and touch again to start it.

Settings

SOUND_NAME: empty plays the first sound in the Contents. You can also type a sound name or paste a sound UUID.
SOUND_VOLUME: 0.0 to 1.0. Ambient sounds sound best soft, around 0.3 to 0.6.
START_ON: whether the sound plays as soon as the script starts.
OWNER_ONLY: TRUE stops visitors from switching it off.

Tips

Use sounds that are made to loop, without a gap or click at the end.
Visitors hear the sound near the object. Place several quiet sources around a big area rather than one loud one.
For music for a whole parcel, use the parcel's music stream instead of a sound loop.

Frequently asked questions

Why can't I hear anything?

Check that sound effects are turned up in your viewer's volume controls, that the object has a sound in its Contents, and that you are close enough to the object.

Can I play several sounds in a row?

This script loops one sound. Playing a list of sounds needs llPlaySound with a timer for each clip.

Does a sound loop cause lag?

Very little. The region tells viewers to loop the sound once; the viewer does the rest.

float OPEN_ANGLE = 90.0; // degrees to swing; use -90.0 to open the other way float AUTO_CLOSE = 10.0; // seconds before it closes by itself; 0.0 = stay open integer HINGE_SIDE = 1; // 1 = hinge on the +X edge, -1 = hinge on the -X edge string OPEN_SOUND = ""; // optional: a sound name in the door's Contents, or a sound UUID string CLOSE_SOUND = ""; integer gOpen = FALSE; vector gClosedPos; rotation gClosedRot; openDoor()

vector SIT_POS = <0.0, 0.0, 0.5>; // metres from the centre of the object (never use <0,0,0>) vector SIT_ROT = <0.0, 0.0, 0.0>; // degrees, for example <0.0, 0.0, 90.0> to turn the avatar string SIT_TEXT = "Sit"; // the word on the right-click menu integer HIDE_WHEN_USED = FALSE; // TRUE = the object turns invisible while someone sits (pose ball) key gSitter = NULL_KEY; string poseAnim() { return llGetInventoryName(INVENTORY_ANIMATION, 0); }

string THANK_YOU = "Thank you for the tip, %name%!"; // %name% becomes the tipper's name integer PUBLIC_THANKS = TRUE; // TRUE = say thanks in local chat, FALSE = only the tipper sees it integer DEFAULT_AMOUNT = 100; // the amount in the Pay window's box list QUICK_AMOUNTS = [50, 100, 250, 500]; // exactly four quick buttons, in L$ integer CLICK_TO_PAY = TRUE; // TRUE = a left click opens the Pay window vector TEXT_COLOR = <1.0, 0.85, 0.3>; integer gTotal = 0; string gLast = ""; string gOwnerName = "";