Bright finder

Finds objects by owner or name anywhere on your parcel - any number, any range!

DESCRIPTION

If you have lost an object on a parcel...
...Bright Finder will find it.

If visitors to your parcel have lost objects...
...Bright Finder will find them.

If you aren't sure why you are using so many prims in your parcel or rental...
...Bright Finder will list them all with a total object & prim count.

In short, the Bright Finder will search and report on all the objects on a parcel of land. You can search by owner, or using a object-name search string. You don't even have to own the parcel - you can find items in your rental, your favourite sandbox, wherever you happen to be - all you need to be able to do is rez the one prim search ball.

To search, just rez the ball. If you want to search for your "Personal Jet", say "/4 jet" to find any object with "...JET..." in its name. If you'd like to restrict the search by owner, click the ball and click "Pick owner". If you own the parcel of land, you'll be offered a menu of all the avatars who have objects there. If not, you can still choose to search for all objects, or only those objects owned by you.

Then click the ball and click "SEARCH!". It will turn invisible, and disturb no one as it flies round searching. It will report progress as it goes, and send a message every time it finds an item, giving the items name, owner, prim count, and an SLURL link which will teleport you straight to the object. While it is searching, you don't have to wait - just get on with your day: you don't even have to stay in the same region, the messages will keep coming if you leave.

Most searches are completed within a few minutes: and at the end of the search, the ball will report the number of objects found, the total prim count, and then delete itself. But as the ball is copyable, you can rez another from your inventory whenever you need it.

There are a lot of search devices on Second Life, but most have a range of only 96m, and can find 16 items at most - because the scripting language can only see 96m and report 16 object names in one command. The Bright Finder is a real search utility, and will search an entire parcel, from 0m to 4096m up in the sky - the entire space you can build in.

Simple, fast, flexible, and comprehensive. Use it to find your objects and manage your own or your visitors prim counts: the Bright Finder is *the* serious search tool.

INSTRUCTIONS

To unpack, drag the "Bright Finder boxed" object from your inventory onto the ground to rez it. Right-click it, click "Open" from the pop-up menu to open a contents window, and click the "Copy To Inventory" button at the moment. This will create a folder called "Bright Finder boxed" in your inventory.

To use your finder, drag the object "Bright Finder" from this folder onto the ground to rez it.

It is a small, black ball. You will see the following text floating over it:

---
Will search parcel 'XXX'
for objects owned by me
with any name ('/4 hat' to search for HAT).
CLICK for menu
---

If you want to search for objects with a particular string in their name - for instance, "jet" to find your crashed personal jet - say "/4 jet". The floating text will change to reflect your criteria:

---
Will search parcel 'XXX'
for objects owned by me
with names like ...JET... ('/4' to clear).
CLICK for menu
---

To search by owner, click the search ball. You will see the following pop-up menu:

---
Will search parcel 'XXX'
for objects owned by me
with any name ('/4 hat' to search for HAT).
[Pick owner] [SEARCH!]
---

Click [Pick owner]. You will then see a menu like this:

---
[1] Jane Doe [2] Joe Bloggs [3] June Lune
[1] [2] [3]
[<] [Anyone's] [>]
---

If you own the parcel, this list of names will include everyone who has rezzed objects there. If there are more than will fit on the menu, click [<] and [>] to scroll through them. Then click a numbered button for a particular owner, or [Anyone's] to find objects regardless of who owns them.

If you don't own the parcel, the ball will not have permission to access the list of names before searching: your choice will be [Me], to find your own objects, or [Anyone's].

Once you have selected an owner, the floating text will look like this:

---
Will search parcel 'XXX'
for objects owned by Jane Doe
with names like ...JET... ('/4' to clear).
CLICK for menu
---

To start your search, simply click the ball, and click [SEARCH!].

The ball will turn invisible, and start searching. You will see the following message:

---
*** YOUR SEARCH IS RUNNING!
It may take a few minutes,
more if the parcel is large, irregular, laggy or primmy.
SO FEEL FREE TO GET ON WITH YOUR DAY!
You'll get progress reports every 60 seconds,
and search results as they come in.
The finder will delete itself when it is finished.

Searching parcel 'Anne's land'
for objects owned by Jane Doe
with names like ...JET...
---

The search will take a few minutes - possibly more, if the parcel is large, is oddly shaped (as there are more corners to look in), has a lot of prims, or is laggy.

As the message explains, you are now free to get on with your day. You don't even need to stay in the region: you'll receive messages as the search goes on. It will normally take a few minutes.

The search is done in two phases. The first phase and "maps" the parcel, dividing it into search areas. You will see progress messages like this as it runs:

Phase 1 of 2: started mapping 2048m2.

The second phase searches each of these areas from 0m to 4096m altitude. As it runs, you will receive progress messages like this:

Phase 2 of 2: started scanning 8388608m3.

Note that this huge number is the *volume* of the space to search, in cubic metres or m3. In this case, it is 2048m2 of land multiplied by an altitude of 4096m.

As each object is found, you'll receive a "FOUND" message like this:

FOUND 'Viper Jet Fighter' (f9d94961-596d-0c39-060c-d3a6afeb795c)
owned by Jane Doe: [link to Jane Doe's profile]
with 30 prim(s) at Eden (24.7,30.4,1201.2) [SLURL teleport link]

You can click the profile link to find out about the owner, or the teleport link to be taken straight to your object (it's probably best to be flying when you teleport, otherwise if the object is in mid-air, you'll fall when you get there).

At the end of the search, you'll receive a summary report like this:

*** SEARCH COMPLETE
Searched parcel 'Anne's land'
for objects owned by Jane Doe
with names like ...JET...
Found 1 object(s) and 30 prim(s) in 2 minutes 10 seconds.

The search ball will then delete itself - but of course, being copyable, you'll still have a copy in your inventory, ready for the next time you need to run a search.

TIPS

* The results from your search will appear in your "chat window", and if you have chat logging turned on, will also be saved in the chat text log on your PC. If you need to keep a record of the items, you can select and press "Control+C" to copy the report from either the chat window or your text log, and then paste it into a notecard or a PC text file.

* Second Life allows objects to send messages to avatars in two ways, called "OwnerSay" and "InstantMessage". Both the names are a bit misleading - you "hear" them both in your "chat" window in the same way. OwnerSay is a little faster, but only works while you are in the same region. InstantMessage is slower, but works even between regions. The Bright Finder will automatically use OwnerSay if you are in the same region, and switch to InstantMessage if you aren't. You won't notice much difference, but as OwnerSay is a little faster, you'll receive your results *slightly* faster if you stay in the region during the search.

* There are a few rather unusual and very rare situations in which the Bright Finder may not find every object. If there are is a huge collection of tiny prims all at nearly exactly the same coordinates, the Finder will send a message to explain that it found a cluster too tightly packed to search. Regions also sometimes contain "ghosted" objects which you can stand on but don't appear in the prim count, or which *do* appear in the prim count but don't actually appear in world. Prim ghosts are generally cleared by a sim restart.

* Every now and then, do a search for all your own objects on your parcel of land or in your rented home, and look through the list. It is very easy to accidentally rez things which are too small to see, or in places where they are hidden, where they take up prim space and cause lag from then on, without you even realising they are there. Look through your search results, and if you see anything which shouldn't be there, you have a chance to teleport to it and delete it - a spring clean!

FOR MORE INFORMATION CONTACT...

Shan Bright
Chief Executive Officer