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:
- 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")
- You should find an AddOns folder, if you don't, create one.
- Extract the addon from the downloaded zip file into the AddOns folder.
- 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: