[IMPLEMENTED] Item related JS functions

[Grimson]

The following JS functions would be nice:

getItems( x, y, world, range)
To get a list of items that are within "range" (using a circle) of the given coordinates.

getItem( x, y, z, world)
To get the Item at the given coordinates.

findItem( x, y, z, world, itemType)
To find the item of "itemType" closest to the given coordinates.

[Maarc]

There's a function that doesn't specifically do that, but you can use to do it.

Code: Select all

AreaItemFunction( functionName, srcObject, radius )
AreaCharacterFunction( functionName, srcObject, radius )

Basically, you call that (granted, I realise it's not a specific x/y/z/world), and it'll execute the function you specify on all the items in that radius.

eg

Code: Select all

function myTalker( srcObject, trgObject, mSocket )
{
   if( trgObject.type == 1 ) // a container
   {
            trgObject.TextMessage( "I'm a container!" );
            return true;
   }
   return false;
}

function onUse( cUser, iUsed )
{
    var itemsSpoken = AreaItemFunction( "myTalker", iUsed, 5 );
    cUser.TextMessage( "Wow, " + itemsSpoken + " containers talked to me!" );
}

This is written off the top of my head and a quick look at the code, but it looks right. Basically, if you double click on an item, it'll make all containers within 5 paces of it say something

There's no way (yet) to break out of the radial loop. I guess that should be an option to include, if people want to be able to break early. But it should let you get a few things done.

Hope that helps.

[Grimson]

Is someone working on this, if not I'll give it a try myself.

[Grimson]

getItem( x, y, z, world)
To get the Item at the given coordinates.

findItem( x, y, z, world, itemType)
To find the item of "itemType" closest to the given coordinates.

Those two are now on the CVS. As for the list of items, I simply don't know how to send such a list in a usable form to the JS engine.

[Xuri]

What happens if there is more than one item at a given location?

[Grimson]

What happens if there is more than one item at a given location?

There shouldn't be more than one at the exact same location, but if it happens the first item at the given coordinates will be sent.

[Xuri]

How do you tell what's the "first" item if there's a dynamic wooden floor tile as well as a piece of wall?

[Grimson]

How do you tell what's the "first" item if there's a dynamic wooden floor tile as well as a piece of wall?

It's the the item that comes first in the item list, that's stored in the map region, it is in.

[Xuri]

Alrighty. Just trying to poke some holes =)

Btw, Maarc added some JS events a few versions ago similar to this, for static items, though I'm not sure if I ever got them working =P

Added JS StaticAt function - takes 4 parameters - x, y, world, [tileID] (tileID is optional - if not specified, ANY static at that location will match)

Added JS StaticInRange function - takes 5 parameters - x, y, world, radius, tileID

[Grimson]

Btw, Maarc added some JS events a few versions ago similar to this, for static items, though I'm not sure if I ever got them working =P

Added JS StaticAt function - takes 4 parameters - x, y, world, [tileID] (tileID is optional - if not specified, ANY static at that location will match)

Added JS StaticInRange function - takes 5 parameters - x, y, world, radius, tileID

They are not similar, they check if something is there an then return eighter true or false. While mine return an item or (hopefully) a list of items in range.

Well, I'm going to sleep now. It has been enough coding for today .

[giwo]

Grimson, just so you know, we reverse-iterate our DataLists, thus when you call First(), it technically gives you the last entry in the list.

[Xuri]

Well, I'm going to sleep now. It has been enough coding for today .

Whaat? But it's only 7 am! ;P hehe

[Grimson]

The following JS functions would be nice:

getItems( x, y, z, world, range)
To get a list of items that are within "range" of the given coordinates.

This is now on CVS.