Download
(51 Kb)
Download
Updated: 02/06/17 08:01 AM
Pictures
File Info
Compatibility:
Homestead (2.7)
One Tamriel (2.6)
Shadows of the Hist (2.5)
Dark Brotherhood (2.4)
Thieves Guild (2.3)
Orsinium (2.2.4)
Updated:02/06/17 08:01 AM
Created:02/14/16 08:01 PM
Monthly downloads:56
Total downloads:7,011
Favorites:6
MD5:
Raffle Unlimited  Popular! (More than 5000 hits)
Version: 18.23.0
by: calia1120 [More]
Due to real life commitments, I am no longer able to support this addon.
If this addon is considered out of date please open RaffleUnlimited.txt, from the RaffleUnlimited install folder, in your text editor and update line 4's APIVersion number to the current number. (Please visit http://wiki.esoui.com to obtain the "Current API Version".)
As long as there are no changes to the API functions used for this addon, this method should work for some time to come.
------------------------------------------------------------------------------
Raffle Unlimited is a convenient method for handling raffles for items, gold and raffle tickets while in-game.

Invalid Start / End Date: If you receive a message about an invalid start and/or end date after an update to the API and/or game client, select a different date, choose your previously selected date and the addon will work as intended.

You can access Raffle Unlimited by going to Settings -> Addon Settings -> Raffle Unlimited
or type in your chat window: /raffleunlimited

------------------------------------------------------------------------------
How to manually install addons:
  1. Locate the "Elder Scrolls Online" folder in your Documents
    For Windows: C:\Users\<username>\Documents\Elder Scrolls Online\<version>\
    For Mac: ~/Documents/Elder Scrolls Online/<version>/
    (replace <version> with the client you're using - "live" or "liveeu")
  2. You should find an AddOns folder, if you don't, create one.
  3. Extract the addon from the downloaded zip file into the AddOns folder.
  4. Log into the game, and on the character creation/selection screen you'll find the Addons menu. Enable your addons from there.
------------------------------------------------------------------------------

The menu UI for Raffle Unlimited offers the following options:
  • Guild: The guild that you would like to use to draw the raffle.
  • Exclude Guild Rank(s) #: The guild rank(s) to exclude, in the order they appear in the guild pane, and above for any deposits made in increments of the "Entry Price". 1 = Guild Master
    For example: selecting #3 will exclude that rank as well as #1 and #2
  • Entry Price: The amount for each entry into the raffle.
  • Starting Amount $: This is the base amount being offered, without any raffle tickets even being purchased.
  • Starting Date: This is the date that entries started being deposited for the raffle.
  • Starting Time: This is the time that entries started being deposited.
  • Ending Date:This is the date that the entries finished being deposited for the raffle.
  • Ending Time: Any deposits made after this time, on the Ending Date, will be excluded from this raffle.
  • Prizes Per Username: The number of allowed prizes per username.
------------------------------------------------------------------------------

Slash Commands for Raffle Unlimited
/raffleunlimited - Opens the settings menu UI
/raffleu help - Displays the list of commands
/raffleu help set - Displays the command settings
/raffleu help list - Displays the commands for showing the current setting(s)
/raffleu help draw - Displays the commands for drawing the raffle
/raffleu help reset - Displays the commands for resetting the raffle
Raffle Settings
/raffleu set guild <GUILD_NAME> - Sets the "Guild" for the raffle (case sensitive)
/raffleu set rank <GUILD_RANK_NUMBER> - Sets the "Exclude Guild Rank(s)" for the raffle (numeric value)
/raffleu set entry price <AMOUNT> - Sets the "Entry Price"
/raffleu set start amount <AMOUNT> - Sets the "Starting Amount $" for the raffle
/raffleu set start date <M/D/YYYY> - Sets the "Starting Date" for the raffle
/raffleu set start time <H:MM> - Sets the "Starting Time" for the raffle (military format)
/raffleu set end date <M/D/YYYY> - Sets the "Ending Date" for the raffle
/raffleu set end time <H:MM> - Sets the "Ending Time" for the raffle (military format)
/raffleu set allow <One OR Multiple> - Sets the number of prizes a username can win per raffle
/raffleu set gold <UNLOCK_AMOUNT> <AMOUNT> - Adds the amount of gold as a raffle prize
/raffleu set item <UNLOCK_AMOUNT> <QUANTITY> <LINK_ITEM_IN_CHAT> - Adds the item to the list of prizes to draw from
/raffleu set item <UNLOCK_AMOUNT> <QUANTITY> tickets - Adds raffle tickets as an available prize, for the next raffle
/raffleu set bonus <AMOUNT> <QUANTITY> - Gives QUANTITY of free tickets when AMOUNT of tickets purchased, per deposit, not username
/raffleu set bonus multi <YES or NO> - Sets whether a deposit can receive multiple bonuses, default is "YES"
/raffleu set tickets <QUANTITY> <USERNAME> - Gives username (case sensitive) free tickets
List Raffle Settings
/raffleu list settings - Displays all of the basic raffle settings
/raffleu list guild - Displays the selected "Guild" for the raffle
/raffleu list rank - Displays the selected "Exclude Guild Rank(s)" for the raffle
/raffleu list entry price - Displays the "Entry Price" amount
/raffleu list start date - Displays the "Starting Date" for the raffle
/raffleu list start time - Displays the "Starting Time" for the raffle
/raffleu list end date - Displays the "Ending Date" for the raffle
/raffleu list end time - Displays the "Ending Time" for the raffle
/raffleu list allow - Displays the "Prizes Per Username" for the raffle
/raffleu list prize all - Displays all of the entered items for the raffle
/raffleu list prize <UNLOCK_AMOUNT> - Displays entered items at the designated unlock amount for the raffle
/raffleu list prize <UNLOCK_AMOUNT> <RAFFLE_ITEM_NUMBER> - Displays the designated item for the raffle
/raffleu list bonus - Displays all ticket purchase amounts and the number of free tickets for that amount
/raffleu list tickets - Displays all usernames that have free raffle tickets
Raffle Drawing
/raffleu draw - This will draw the raffle; In-progress displays information; Ended displays winners
/raffleu results - Results from the last raffle drawing; (A new draw will overwrite this information)
/raffleu entry <ENTRY_NUMBER> - Displays username, number of tickets, ticket numbers and amount deposited
/raffleu entry <USERNAME> - Displays all entries for the username, with a total deposited amount
/raffleu draw <DRAW_NUMBER> - This will draw only the "(DRAW_NUMBER)" from the draw results
Reset Raffle Settings
/raffleu reset all - Resets ALL of the stored information
/raffleu reset defaults - Resets only the default UI information
/raffleu reset other - Resets the all of the non-default information
/raffleu reset items all - Resets all of the items that have been added
/raffleu reset items <UNLOCK_AMOUNT> - Resets all items that are unlocked at the designated amount
/raffleu reset bonus - Resets all bonus ticket amounts
/raffleu reset tickets - Resets all free tickets issued to users
/raffleu remove <UNLOCK_AMOUNT> <RAFFLE_ITEM_NUMBER> - Removes the specified item
/raffleu remove bonus <AMOUNT> - Removes bonus tickets for the specified amount
/raffleu remove tickets <TICKET_ID> - Removes free tickets for this specific username
------------------------------------------------------------------------------

What is the <UNLOCK_AMOUNT> in the slash commands?
Raffle Unlimited allows you to set multiple items at multiple tiers. If you have various items that you offer for the raffle, no matter the number of participants, then this would be considered tier 1. If you have other items that are available when the total deposited towards the raffle reaches a specific amount, then this would be a new tier. The <UNLOCK_AMOUNT> is the total deposited amount that is required for the specific tier to become available as prizes in the raffle.
For example, if you have "Perfect Roe" that you would like to have available once the raffle reaches 100k, then the <UNLOCK_AMOUNT> would be "100000" or "100k".

What is the minimum <UNLOCK_AMOUNT> required?
Raffle Unlimited requires that you have at least one item available in the raffle for all participants, which that amount is 0 (zero).

How do I enter currency amounts into Raffle Unlimited?
Raffle Unlimited is programmed to allow a full, non-comma separated, number or an abbreviated number up to "M"illion(s).
For example: 1500000 or 1.5M work, but 1,500,000 will not.

What are the free tickets about?
If the guild you're in offers free raffle tickets for the next raffle, then these are the options that you would use to add the prior winner(s) and/or add free tickets to the current raffle as a prize.

Is there an option to set the gold at a percentage?
No. If you would like to raffle gold at a percentage, then you should check out the Raffle Gold addon.

How does Raffle Unlimited work?
Raffle Unlimited utilizes the game's built-in API calls to query and compile the guild bank transactions within the timeframe specified. This does not interact with anything in the guild bank, whether items or currency. Using this method ensures that there is a record available to all guild members of those that made a deposit.

Can I make a deposit into the guild bank without buying raffle tickets?
Yes. You will just need to make a deposit that is not in increments of the entry price.
For example: if the entry price is $1k, $3,001 or $2999 would not count towards the raffle.

Can I buy raffle tickets in bulk?
Yes. As long as the amount deposited can be divided by the entry amount it will be considered a raffle ticket purchase.
For example: if the entry price is $500, $9k and $16.5k would both be considered raffle ticket purchases.

How are the raffle ticket numbers assigned?
In the order purchased, oldest to newest deposits.
For example: entry amount = 1k
Guild Member #1 deposits 3k, they'd have ticket numbers 1, 2 and 3
Guild Member #2 deposits 1k, they'd have ticket number 4
Guild Member #3 deposits 5k, they'd have ticket numbers 5 - 9
Guild Member #1 deposits 2k, they'd also have ticket numbers 10 and 11

Why is there an option to draw again for a specific raffle item?
If you have any players that would like to donate to the raffle, but do not want to actually be selected during the drawing, you can use this feature to choose a different winner.

Will Raffle Unlimited interfere with other addons?
Raffle Unlimited will only scan your guild bank history when you draw and/or check the stats for the current raffle that is in-progress. It is a completely on-demand addon, and once it has compiled the information it will be dormant, until you run it again.

Limitations
  • Deposits that are made within the last minute might not appear when using the "Guild Raffle" to get the (current) results.
    Try waiting ~1 minute to use the "Guild Raffle" ability, which should include the deposit(s) in question.
  • The guild history on the server stores only 10 days worth of information, so it is important that this tool is used in a timely manner once a raffle has ended, to ensure that the information isn't lost.
  • Guilds that have plenty of guild bank transactions can take longer to build the information, but Raffle Unlimited will let you know in the chat window when it has finished and is ready for use.
  • There currently is no method for exporting in-game data to an external file, but any of the saved variables are stored in a file. IF you would like to access the information for the entrants when using the Guild Bank Raffle Drawing, the SavedVariables\RaffleUnlimited.lua contains the items and entrant's information, i.e. entry number, username, number of tickets, amount deposited and raffle ticket number(s).
    The only issue is you will need to parse this information, if you would like to post it anywhere in a readable format. A parsing tool for Raffle Unlimited can be found at http://www.juliabedriy.com/raffleunlimited.html, where you can upload the raw LUA data file, found in the SavedVariables folder, directly into it.
This addon uses the following libraries:
v.18.23.0
Updated version number to Homestead API build

v.17.23.0
Updated to LibAddonMenu version: 2.0 r23
Revised version number to reflect Current_ZOS_API_Build.LibAddonMenuRevision.AddonRevisionNumber

v.1.4.17
Updated version number to One Tamriel API build

v.1.4
Updated to LibAddonMenu v 2.0 r22

v.1.3.16
Updated version number to Shadows of the Hist API build
Updated to LibAddonMenu v 2.0 r21

v.1.3
Updated to LibAddonMenu v 2.0 r20

v.1.2.15
Updated version number to Dark Brotherhood API build

v.1.2.14
Updated version number to Thieves Guild API build

v1.2.2
Corrected an issue when displaying the free tickets.

v1.2.1
Corrected an issue with the bonus ticket tiers not sorting properly.

v1.2
Added bonus ticket option at multiple tiers.
Updated to LibAddonMenu v 2.0 r19

v1.1
Added a total deposited amount when using the slash command: /rg entry <USERNAME>
Optional Files (0)


Archived Files (8)
File Name
Version
Size
Uploader
Date
17.23.0
51kB
depeshmood
10/31/16 05:16 AM
1.4.17
48kB
depeshmood
10/05/16 05:10 AM
1.4
48kB
depeshmood
08/06/16 02:36 PM
1.3.16
46kB
depeshmood
08/01/16 05:05 AM
1.3
50kB
depeshmood
06/07/16 07:13 AM
1.2.15
45kB
depeshmood
05/30/16 10:25 AM
1.2.14
37kB
depeshmood
03/07/16 06:29 AM
1.2.2
45kB
depeshmood
02/27/16 10:50 PM


Post A Reply Comment Options
Unread 02/16/16, 03:30 PM  
babylon

Forum posts: 14
File comments: 363
Uploads: 0
Can you make the unlock settings into part of the user interface menu, rather than us typing slash commands?

It's too much faffing around.
Report comment to moderator  
Reply With Quote
Unread 02/14/16, 08:06 PM  
depeshmood
Guest

Join Date: Not Yet
Forum posts: 0
File comments: 0
Uploads: 0
Raffle Unlimited Parsing Tool Error

The "ERROR: No Entries Found!" message using the raffle parsing tool can happen for multiple reasons...
  • You have recently accessed the addon while playing ESO and are still in-game
  • You did not properly log out of and/or quit the game
  • Changes were made to the settings and drawing the raffle was triggered, which brought up empty results

There very well could be more, but that's all I can currently think of.

What causes the lua file to not have the information?
There is a SavedVariables cache that Elder Scrolls Online: Tamriel Edition uses. This information is stored in the cache until a user successfully logs out of their toon and/or game.
If a user does not properly log out of the character they are playing on and/or use the UI to quit the game then this can cause the cache to not be committed to their associated addon SavedVariables.
(While building this addon and the parsing tool, these were things that I noticed based on what I was doing)

The other thing that can cause the entries to no longer be there, even though you recently saw information, is updating the raffle settings for a new raffle. Changing these settings will not affect the entry information from the previous raffle, but using the Guild Raffle functionality, which displays the current stats and/or winners, will clear the entries.
I know that when I update the raffle(s) to a new week that I will begin checking the stats shortly thereafter. There are also times that I configure the raffle and run it just to see the information in the chat window.

How can I avoid losing the entry information?
  • Properly log out of your character(s) after using the addon
  • Properly quit the game after using the addon
  • Parse the LUA file prior to configuring the next raffle*
  • Check the Last Modified date on the LUA file, while in-game, and you can copy it to your root Documents folder, if the date/time is correct

* Raffle addons do not keep a running history of each raffle, as that could become too much information, and the information is generated on-demand.
Report comment to moderator  
Edit/Delete Message Reply With Quote
Post A Reply



Category Jump:

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.