Mix and match of AlcScript

[Grogyan]

Just been reading Nadnerbs code for switching on and off stuff, and it was bothering me some.
viewtopic.php?f=9&t=1137&start=20

Can we mix up the scripts, or are we stuck with the linear, "this script only for doing this"?

Cause at times, when I get down to conditional objects, lights, textures, there is thoughts that I i'd like to switch sound on/off, turn light on/off then wait some period of time and then a oneshotmod for example.

[D'Lanor]

Considering that we can combine Alcscript with Python script anything is possible. The oneshotmod for example is by default activated in the Python script. That means you can throw in a timer for it.

In my age Prad a whole lot of stuff is happening at the push of a single button.

[Nadnerb]

The reason we have alcscript at all is so that it can be mixed and matched. Otherwise, it would be easier to just give out fixed functionality responders. The idea is that you can attach any number of actions (sound messages, footstep messages, python scripts, sdl changes, animations, etc) to any detector/logic trigger (objectinvolume, clicking, facing, enter, exit, multistate) For instance, I have an alcscript that detects when the avatar enters a region, calls a python script, which warps the avatar to another named point, and forces a camera cut. (this was made in response to andy's questions about gahreesen style doors, but I never actually published this) Edit: here it is.

So yeah, mix and match as much as you like, that's what it's there for. (just don't expect it to work the first time. )

[D'Lanor]

Thanks Nadnerb. That is what we need, examples. I am sure Alcscript is very versatile but unfortunately most of its features are still undocumented. Even though it has been out for... what is it? Two months maybe?

I am pretty fluid in Python but Alcscript remains a mystery to me. And I don't have time to reverse engineer it if I need to know something.

We really need an alcscript showcase section in these forums. If not a fully documented wiki.

[Paradox]

I have a file that lists every possible option and flag that can be set on an object via AlcScript (and some that only exist in my WC and will be committed soon). Note that some flags are specific to certain classes (you can't set circle flags on a fixed camera). Also, some options are mutually exclusive.

Show Spoiler

Code: Select all

[object name]:
    type: { object, lamp, collider, soundemit, softvolume, camera, region, oneshotmod, spawnpoint }

    visual:
        visregions:
          - <reference>
        sprite:
            flags:
              - pivotface
              - pivotfavory
              - pivoty
              - pivottumble
              - scale
              - facecam
              - facelist
              - faceplay
              - faceobj
              - offset
              - offsetlocal
              - maxbounds

    lamp:
        softvolume: <reference>
        flags:
          - disable
          - obsolete
          - castshadows
          - movable
          - hasincludes
          - includeschars
          - overall
          - hasspecular
          - shadowonly
          - shadowlightgroup
          - forceproj
   
    physical:
        friction: <float>
        elasticity: <float>
        campassthrough: { true, false }
        owner: <reference>
        physlogic: { none, storepos, resetpos, detect }
   
    camera:
        brain:
            type: { fixed, circle, avatar, firstperson, simple }
            poa: <float>,<float>,<float>
            accel: <float>
            decel: <float>
            velocity: <float>
            poaaccel: <float>
            poadecel: <float>
            poavelocity: <float>
            xpanlimit: <float>
            zpanlimit: <float>
            zoomrate: <float>
            zoommin: <float>
            zoommax: <float>
            subjectkey: <reference>
            rail: <reference>
            offset: <float>,<float>,<float>
            flags:
              - cutpos
              - cutposonce
              - cutpoa
              - cutpoaonce
              - animatefov
              - followlocalavatar
              - panicvelocity
              - railcomponent
              - subject
              - circletarget
              - maintainlos
              - zoomenabled
              - istransitioncamera
              - worldspacepoa
              - worldspacepos
              - cutposwhilepan
              - cutpoawhilepan
              - nonphys
              - neveranimatefov
              - ignoresubworldmovement
              - falling
              - running
              - verticalwhenfalling
              - speedupwhenrunning
              - fallingstopped
              - beginfalling
            circleflags:
              - lagged
              - absolutelag
              - farthest
              - targetted
              - hascenterobject
              - poaobject
              - circlelocalavatar
            transitions:
              - accel: <float>
                decel: <float>
                velocity: <float>
                poaaccel: <float>
                poadecel: <float>
                poavelocity: <float>
                cutpos: {true, false }
                cutpoa: {true, false }
                ignore: {true, false }
                to: <reference>
   
    oneshot:
        animation: <anim name>
        seektime: <float>
        reversable: { true, false }
        smartseek: { true, false }
        drivable: { true, false }
        noseek: { true, false }

    sound:
        flags:
          - is3dsound
          - disablelod
          - looping
          - autostart
          - localonly
          - loadonlyoncall
          - fullydisabled
          - dontfade
          - incidental
        file: <blender sound object>
        type: { soundfx, ambience, backgroundmusic, guisound, npcvoices }
        volume: <float>
        softvolume: <reference>
        occluder: <reference>
        channel: { left, right }
        maxdist: <float>
        mindist: <float>
        buffer: { static, stream }
        fadein:
            length: <float>
            start: <float>
            end: <float>
            type: { linear, logarithmic, exponential }
            stop: { true, false }
        fadeout:
            length: <float>
            start: <float>
            end: <float>
            type: { linear, logarithmic, exponential }
            stop: { true, false }
   
    softvolume:
        type: { convex, inverse, union, intersect }
        softdist: <float>
        instrength: <float>
        outstrength: <float>
        volumes:
          - <reference>
        flags:
          - none
          - check
          - posset
          - dirty
          - registered
   
    logic:
        modifiers:
          - tag: <string>
            name: <string>
            flags:
              - localelement
              - reset
              - triggered
              - oneshot
              - requestingtrigger
              - typeactivator
              - multitrigger
            cursor: { nochange, up, left, right, down, poised, clicked, unclicked, hidden, open, grab, arrow }
            activators:
              - type: { objectinvolume, objectinvolumeandfacing, pickingdetector }
                remote: <reference>
                triggers: { enter, exit, any, unenter, unexit, bump }
                facingtolerance: <float>
                needwalkfwd: { true, false }
            conditions:
              - type: { volumesensor, facing, activator, objectinbox }
                satisfied: { true, false }
                direction: { enter, exit }
                isfirst: { true, false }
                trignum: <int>
                directional: { true, false }
                tolerance: <float>
            actions:
              - type: { pythonfile, responder }
                ref: <reference>
        actions:
          - type: responder
            tag: <string>
            name: <string>
            responder:
                states:
                  - cmds:
                        -type: <message>
                        params:
                            <list of params varies per message>
                        waiton: <int>
                    nextstate: <int>
                    waittocmd: <int>
                curstate: <int>
          - type: pythonfile
            tag: <string>
            name: <string>
            pythonfile:
                file: <reference>
                parameters:
                  - type: { string, bool, . . . }
                    value: <data of type>

[D'Lanor]

Thanks, but I am missing the quickscript options in your list. For example the method to make conditional objects.

[Paradox]

Quickscripts are fairly strightforward, they should definitely have their own page on the wiki.

Essentially a quickscript just takes a condensed bit of code and expands it into full AlcScript. In my mind, I don't see any reason not to type the full AlcScript anyways so that one has more control over the params and the objects.

Quickscripts are:

Footstep Show Spoiler

Code: Select all

[object]:
    type: object
    region:
        type: footstep
        surfaces:
          - grass
          - dirt
          - etc.

Sound Region Show Spoiler

Code: Select all

[object]:
    type: object
    region:
        type: soundregion
        soundemitter: <reference>

Animation Region Show Spoiler

Code: Select all

[object]:
    type: object
    region:
        type: logic
        selfanimation:
            animation: <string>

SDL Visibility Show Spoiler

Code: Select all

[object]:
    type: object
    quickscript:
        sdl:
            type: boolshowhide

Clickable Show Spoiler

Code: Select all

[object]:
    type: object
    quickscript:
        simpleclick:
            pythonfile: <reference>
            region: <reference>
            animation: <string>
            animtarget: <reference>

[D'Lanor]

Sorry to keep nagging but now we still don't know what it all means. I think I can guess the purpose of a few flags, but what we really need is "alcscript for dummies".

[Paradox]

What makes you think that we understand that flags?

[Grogyan]

For me its like well my Age/shell is the way I want it, but Plasma can't organise itself with lots of overlapping regions, and so some control like while climbiing switch camera and play footstep sound.

In my case for shell 119 that is what is happening, the regions are there, the region for footstep dirt has been extended to overlap the floor of the pyramid as well, but you can't hear the sound there. Biggest problem is the ladder, there are 4 overlapping regions, but as soon as the avatar passes through the end of one it changes the sound of rope to dirt, at the top it switches to metal even though you are still on the ladder, so I was thinking AlcScript could fix this