TrailMyx's Subroutine collection foro OEUO - Includes FINDITEM!

[TrailMyx]

Code: [Select]

---------------------------------------------------------------
-- Script Name: TrailMyx's Subroutine Collection
-- Author: TrailMyx
-- Version: v8
-- Shard OSI / FS: unk
-- Revision Date: 9/29/2010
-- Purpose: Collection of routines to help the scripter automate UO
--
--          TM_SecondTimer
--            local timer = TM_SecondTimer:New{duration = 5} -- creates a 5 SECOND non-blocking countdown timer (automatically starts)
--            timer:Start(10) -- restarts existing timer with new time
--            timer:Check() -- returns true if time has expired, false otherwise
--
--          TM_msTimer
--            local timer = TM_msTimer:New{duration = 50} -- creates a 50 MILLISECOND non-blocking countdown timer (automatically starts)
--            timer:Start(500) -- restarts existing timer with new time
--            timer:Check() -- returns true if time has expired, false otherwise

--          TM_IDtoEUO(id) -- converts an OEUO numerical ID value to the classic EUO base-26 text value
--          TM_EUOtoID(str_in) -- converts the classic EUO base-26 item id into an OEUO-compatible numerical ID value
--
--          TM_ItemInfo -- includes all necessary item information as returned by UO.GetItem
--            TM_FindItemsByID(id) -- locates items by ID (either EUO or OEUO format)  Returns count and table of items
--            TM_FindItem(ids, locations, containers, dist, ignore) -- locates multiple IDS/TYPES on either ground or container, and at specific distances
--                                                                     return count(sum of items), stacks(sum of stacks), matches(table of all matching items)
--                                                                     ignore - table of items previously ignored
--
--          TM_GumpWait(c1, c2) -- waits for either gump c1 or gump c2 to pop up within 7 seconds.  Returns true on success
--          TM_GumpWaitAndSize(c1, x, y) -- waits for gump c1 that is size (x,y) within 7 seconds.  Returns true on success
--
--          TM_IgnoreItem(ignore, findid) -- maintains an "ignore" list.  This table can be passed to TM_ItemInfo
--
--          TM_OpenPaperdoll(x,y)
--          TM_OpenStatusBar(x,y)
--          TM_OpenBackPack(x,y)
---------------------------------------------------------------

This is going to be my main subs distribution file for those functions that don't have a specific location.  I will implement a version number query subroutine so that you can make sure you are using the expected version of this file.  Didn't do that yet.

[TrailMyx]

I forgot to add in the color matching for this.  It would be nice for this sub to find all your frostwood, and sum up all the stacks.  

Really, it's pretty easy to do that by hand, so I might as well leave that be.  I can put up the sample code if you'd like.

[TrailMyx]

I decided this was stable enough to put out into the public.  Enjoy

[TrailMyx]

Playing with OEUO is much easier with these routines, especially if you need to use the finditem function.  With the property information also embedded within each item, you have a very powerful toolset.

[TrailMyx]

Another nice feature of these functions is the non-blocking timers.

Code: [Select]

local timer = TM_SecondTimer:New{duration = 5} -- creates a 5 SECOND non-blocking countdown timer (automatically starts)
 while timer:Check() == false do
   -- do something else until timer fires.
 end

 if timer:Check() == true then
   print("your timer expired for some reason")
 end


[TrailMyx]

Version 7:
Added IGNOREITEM feature into TM_FindItem.

[Endless Night]

Version 7:
Added IGNOREITEM feature into TM_FindItem.

Twinkle McNugget is just getting spoiled rotten these days..

[TrailMyx]

Twinkle McNugget is just getting spoiled rotten these days..

Lol, yeh.  It's time to start put'in out!

Also included in these subs:

TM_OpenPaperdoll(x,y)
TM_OpenStatusBar(x,y)
TM_OpenBackPack(x,y)

The names are explanatory.

[TrailMyx]

BTW, upgraded to V8.  I released without testing...  Oops.  Works now for TM_IgnoreItem

[Scrripty]

Version 7:
Added IGNOREITEM feature into TM_FindItem.

Twinkle McNugget is just getting spoiled rotten these days..

My cancer treatment comes before UO.  Sorry.   The last 2 days I've been at the docs for 8+ hours each.  I have to go Saturday too, then I should be free for 5 days or so.  We'll see.  Yesterday was a benedryl filled day where I slept with the laptop on my lap most of the day. heh

[NObama]

Ok, I don't understand.

If I want to use this to, say, find and count all powder of fort in containers near my character...I think this is the syntax:

Code: [Select]

count = TMFindItem (4102)
if count > 0 then
  print("Found:"..count)
end 

What I don't understand is how to call the subroutine library...plus, I'm not entirely sure I've got the syntax right above...

*head hurts, time for bed*

 

[TrailMyx]

Please take a look at the sample code that's included in the comments.  But you're looking for something like this:

Code: [Select]

dofile("tm_subs_collection8.lua")

temp = {} -- will contain all found items as objects (see tm_subs_collection8.lua for a description of all information stored in the object)
count = 0 -- this is the count.
count, temp = TM_FindItemsByID(4102) -- you can also have a string here representing the EUO-style value like "POF"
if count > 0 then
  print(string.format("Found = %d",count))
  for x,v in ipairs(temp) do
    print(string.format("Finditem is %d",v.findid))
  end
end


This is untested code since I'm traveling I can't test, but it should be close to working.

BE SURE TO SAVE THIS SNIPPET TO A FILE FIRST!! OTHERWISE OEUO WILL NOT WORK

Similar sample code is in the file to use the full-blown finditem.  Please take the time to go over and see what's inside tm_subs_collection8.lua

[NObama]

Thanks, TM.  Believe it or not, I did read your comments...I am just completely lost.  EUO syntax made sense to me, this still does not.  I am not sure UO will be around long enough for me to become literate in Lua.

I told myself I was going to successfully code a snippet that would do something simple, like find the Ant Queen.  Then, I discovered how hard that is in OEUO and I died a little inside.

[Scrripty]

 Its far from all that hard, most people are just overcomplicating it for themselves.  Try to write your own finditem routine so you understand how it works a bit better in oeuo before you try to use tms tools.  They are always a bit more complicated than the new user should start with imo.

[TrailMyx]

Well not in this case. If you know EUO syntax, then these just work.  Everything I've put out so far has the old EUO scripter in mind.