// SPDX-License-Identifier: MIT
// Copyright (c) 2026 Incoprea
// Short keyframed shuttle
// Not compiled or tested in-world
// Setup: Use a spare nonphysical unattached root with keyframed-motion-compatible prim accounting, commonly an appropriate Convex Hull shape configured manually. Owner-touch starts.
// Stop / restore: Owner-touch clears keyframed motion at the current position. It does not return Home; reposition manually if needed.
// Notes: Do not change link topology, attachment state or physics while running. Selection can pause simulator motion. One-shot examples keep their armed flag until the next owner touch clears it, even after the path finishes; they do not infer completion from wall-clock timers. KFM affects actual collision geometry and can push physical objects. Use a clear test area. It ignores nonphysical collision obstacles; this script never changes physics shape or physical status. OpenSim support must be checked.
// License: see LICENSE in this distribution.
// Original Incoprea. MIT. Not compiled or tested in-world.
integer active;
default
{
    touch_start(integer n)
    {
        if(llDetectedKey(0)!=llGetOwner()||llGetLinkNumber()>1||llGetAttached()||llGetStatus(STATUS_PHYSICS))return;
        active=!active;
        if(active)llSetKeyframedMotion([<0.5,0.0,0.0>,4.0],[KFM_DATA,KFM_TRANSLATION,KFM_MODE,KFM_PING_PONG]);
        else llSetKeyframedMotion([],[]);
    }
    changed(integer change)
    {
        if(change&CHANGED_LINK)
        {
            llSetKeyframedMotion([],[]);
            active=FALSE;
        }
    }
}