by *Chobbs* » Mon Feb 22, 2010 8:33 am
Mornin' folks,
More fiddling with the ingame auction thing.
[quote:2ezm3yjc]v0.5d
- added the Appraise function. see below for details. Format is still ugly, the information presented isn't final either.
- consigning fee reworked. The fee to consign an item is now much lower than before, and is now capped. Upon a successful sale, a final value fee is applied, also capped. This is done to discourage frivolous auctions. Fee values are not final.
[/quote:2ezm3yjc]
It dawned upon me (after two weeks...) that it would be helpful to post the commands and what they do. So in lieu of ingame help files, I give you this monstrous post.
[quote:2ezm3yjc]CONSIGN
<itemname> <minbid> <optional time, 1-3 days>
<itemname> <minbid> <buyout> <optional time, 1-3 days>
- consigns an item for auction
- confirmation is necessary, or else the auction will not be posted
- if no buyout argument is present, the auction will run its full time unless canceled
LOTS
[no argument]
<all>
<query>
- used to show current auctions
- if no argument is present or 'all', will show you ALL of the current auctions. Be forwarned, this list is getting large and ignores the lines setting (can't figure out how to get it to respect this. not yet anyway)
- you can also use lots to search for item by name, type, worn location, &c. i.e. 'lots head' will show all items up for auction that can be worn on head. 'lots weapon' will show you all weapons.
Note: lots searches by an item's keywords, not short description. i.e. if you're looking for "a pair of leather sleeves", searching for "pair" will yield incorrect results
BID
<itemname> <minbid>
- places a bid on an item. If there is more than one instance of an item, use the unique id to guarantee accuracy. "Bid 2.token" and the like does NOT work.
- bids CANNOT be canceled (no plans to change this in the future)
- money is drawn immediately from your bank to cover your bid. you MUST have sufficient funds, else no bid will be placed, so if you cannot place a bid, go deposit your money
- if you are overbid, go back to the auctioneer and he'll return the bid amount
- confirmation required
BUYOUT
<itemname>
- immediately buys an item at the listed buyout price. If there is no buyout, you cannot buyout the item. Again, if multiple items are present, use the unique id, for the same reason.
- money is drawn from what you have on your persons, NOT from the bank
- confirmation required
BIDLIST
- shows you all of your bids, as well as all your posted auctions. Will probably improve upon this later
CANCEL
[no argument]
<all>
<item>
- if no argument present or 'all', shows all the auctions you can cancel
- cancels an auction you have consigned and have no bids
- if you have waited over an hour to cancel, your bid fee will NOT be returned. cancellations within the hour will be returned
- confirmation required
RECLAIM
[no argument]
<all>
<item>
- reclaim is defined as an auction that did not sell or have any bids, and whose timers have expired
- you have 5 days to reclaim your item after the auction expires before the item is moved to a shopkeep somewhere
- if no argument present or 'all', shows all items you can reclaim
COLLECT
[no argument]
<all>
<item>
- collect is defined as collecting a bid that you have won, or an auction that has sold.
- If you are the bidder, the item will be given to you at this time.
- If you are the seller, the sell fee will be applied here and you will receive the winning bid amount minus the fee.
- if no argument present or 'all', shows all items that you can collect
APPRAISE
<itemname>
- appraise is defined as learning collected data regarding the item to help people get an idea on an appropriate value
- will show you the raw value of the item; shopkeepers buy and sell the item at a % of this value
- will show you how many times this item has been sold either via buyout or bids
- will NOT show you how many times it has been consigned. data collected in this manner would largely be useless
- will show the min/max/avg bids and buyouts for the item
- item must be inventory to appraise
- data at this point is largely incomplete, since the system is still in its infancy and has not collected much data yet
- no fee to appraise, but there will probably be one in the distant future
QUERY
[same as normal query]
- see ingame help query. fee of 2000 still applies
[/quote:2ezm3yjc]
auclist, not auc list, at the kobolds also shows most commands. Will write help files soon.
Thanks to those who continue to give suggestions and help me debug this thing.
Chobbs!