farmbuyer@1
|
1
|
farmbuyer@1
|
2 local todo = [[
|
farmbuyer@1
|
3 - broadcasted entries triggering auto-shard don't have "shard" text
|
farmbuyer@1
|
4
|
farmbuyer@1
|
5 - [DONE,TEST,comm] releasing before DBM signals wipe results in outdoor location
|
farmbuyer@1
|
6
|
farmbuyer@1
|
7 - implement ack, then fallback to recording if not ack'd
|
farmbuyer@1
|
8
|
farmbuyer@1
|
9 - special treatment for recipes / BoE items? default to guild vault?
|
farmbuyer@1
|
10
|
farmbuyer@1
|
11 - rebroadcasting entire boss sections, entire days. maybe only whisper
|
farmbuyer@1
|
12 to specific people rather than broadcast.
|
farmbuyer@1
|
13
|
farmbuyer@1
|
14 - signpost a potential boss kill, pipeline loot until the cache clears
|
farmbuyer@1
|
15
|
farmbuyer@1
|
16 - Being able to drag rows up and down the main loot grid would be awesome. Coding
|
farmbuyer@1
|
17 that would be likely to drive me batshiat insane.
|
farmbuyer@1
|
18 ]]
|
farmbuyer@1
|
19
|
farmbuyer@1
|
20 local addon = select(2,...)
|
farmbuyer@1
|
21
|
farmbuyer@1
|
22 addon.helptree = {
|
farmbuyer@1
|
23 {
|
farmbuyer@1
|
24 value = "about",
|
farmbuyer@1
|
25 text = "About",
|
farmbuyer@1
|
26 },
|
farmbuyer@1
|
27 {
|
farmbuyer@1
|
28 value = "basic",
|
farmbuyer@1
|
29 text = "Basics",
|
farmbuyer@1
|
30 children = {
|
farmbuyer@1
|
31 {
|
farmbuyer@1
|
32 value = "loot",
|
farmbuyer@1
|
33 text = "Loot Entries",
|
farmbuyer@1
|
34 },
|
farmbuyer@1
|
35 {
|
farmbuyer@1
|
36 value = "boss",
|
farmbuyer@1
|
37 text = "Boss Entries",
|
farmbuyer@1
|
38 },
|
farmbuyer@1
|
39 },
|
farmbuyer@1
|
40 },
|
farmbuyer@1
|
41 {
|
farmbuyer@1
|
42 value = "tracking",
|
farmbuyer@1
|
43 text = "Tracking Loot",
|
farmbuyer@1
|
44 children = {
|
farmbuyer@1
|
45 {
|
farmbuyer@1
|
46 value = "enabled",
|
farmbuyer@1
|
47 text = "Full Tracking",
|
farmbuyer@1
|
48 },
|
farmbuyer@1
|
49 {
|
farmbuyer@1
|
50 value = "bcast",
|
farmbuyer@1
|
51 text = "Rebroadcasting",
|
farmbuyer@1
|
52 },
|
farmbuyer@1
|
53 },
|
farmbuyer@1
|
54 },
|
farmbuyer@1
|
55 {
|
farmbuyer@1
|
56 value = "texts",
|
farmbuyer@1
|
57 text = "Generated Texts",
|
farmbuyer@1
|
58 children = {
|
farmbuyer@1
|
59 {
|
farmbuyer@1
|
60 value = "forum",
|
farmbuyer@1
|
61 text = "Forum Markup",
|
farmbuyer@1
|
62 },
|
farmbuyer@1
|
63 {
|
farmbuyer@1
|
64 value = "other",
|
farmbuyer@1
|
65 text = "Other Texts",
|
farmbuyer@1
|
66 },
|
farmbuyer@1
|
67 {
|
farmbuyer@1
|
68 value = "saved",
|
farmbuyer@1
|
69 text = "Saved Texts",
|
farmbuyer@1
|
70 },
|
farmbuyer@1
|
71 },
|
farmbuyer@1
|
72 },
|
farmbuyer@1
|
73 {
|
farmbuyer@1
|
74 value = "tips",
|
farmbuyer@1
|
75 text = "Handy Tips",
|
farmbuyer@1
|
76 children = {
|
farmbuyer@1
|
77 {
|
farmbuyer@1
|
78 value = "slashies",
|
farmbuyer@1
|
79 text = "Slash Commands",
|
farmbuyer@1
|
80 },
|
farmbuyer@1
|
81 },
|
farmbuyer@1
|
82 },
|
farmbuyer@1
|
83 {
|
farmbuyer@1
|
84 value = "todo",
|
farmbuyer@1
|
85 text = "TODOs, Bugs, etc",
|
farmbuyer@1
|
86 children = {
|
farmbuyer@1
|
87 {
|
farmbuyer@1
|
88 value = "gotchas",
|
farmbuyer@1
|
89 text = "Gotchas",
|
farmbuyer@1
|
90 },
|
farmbuyer@1
|
91 {
|
farmbuyer@1
|
92 value = "todolist",
|
farmbuyer@1
|
93 text = "TODO/knownbugs",
|
farmbuyer@1
|
94 },
|
farmbuyer@1
|
95 },
|
farmbuyer@1
|
96 },
|
farmbuyer@1
|
97 }
|
farmbuyer@1
|
98
|
farmbuyer@1
|
99 -- Help text. Formatting doesn't matter, but use a blank line to split
|
farmbuyer@1
|
100 -- paragraphs. This file needs to be edited with a text editor that doesn't
|
farmbuyer@1
|
101 -- do anything stupid by placing extra spaces at the end of lines.
|
farmbuyer@1
|
102 do
|
farmbuyer@1
|
103 local replacement_colors = { ["+"]="|cff30adff", ["<"]="|cff00ff00", [">"]="|r" }
|
farmbuyer@1
|
104 local T={}
|
farmbuyer@1
|
105 T.about = [[
|
farmbuyer@1
|
106 Ouro Loot is the fault of Farmbuyer of Ouroboros on US-Kilrogg. Bug reports,
|
farmbuyer@1
|
107 comments, and suggestions are welcome at the project page at curse.com or send
|
farmbuyer@1
|
108 them to <farmbuyer@gmail.com>.
|
farmbuyer@1
|
109 ]]
|
farmbuyer@1
|
110
|
farmbuyer@1
|
111 T.basic = [[
|
farmbuyer@1
|
112 The </ouroloot> (and </loot> by default) command opens this display. The buttons
|
farmbuyer@1
|
113 on the right side control operation and are mostly self-explanatory. Hovering over
|
farmbuyer@1
|
114 things will usually display some additional text in the gray line at the bottom.
|
farmbuyer@1
|
115
|
farmbuyer@1
|
116 Each tab on the left side can additionally create extra contols in the lower-right
|
farmbuyer@1
|
117 section of the display.
|
farmbuyer@1
|
118
|
farmbuyer@1
|
119 The first tab on the left side, <Loot>, is where everything goes to and comes
|
farmbuyer@1
|
120 from. Looting events and Deadly Boss Mods notifications go to the <Loot> tab; the
|
farmbuyer@1
|
121 other tabs are all generated from the information in the <Loot> tab.
|
farmbuyer@1
|
122 ]]
|
farmbuyer@1
|
123
|
farmbuyer@1
|
124 T.basic_loot = [[
|
farmbuyer@1
|
125 A "loot row" in the first tab has three columns: the item, the recipient, and any
|
farmbuyer@1
|
126 extra notes. The recipient's class icon is displayed by their names, if class
|
farmbuyer@1
|
127 information is available at the time.
|
farmbuyer@1
|
128
|
farmbuyer@1
|
129 <Mouse Hover>
|
farmbuyer@1
|
130
|
farmbuyer@1
|
131 Hovering the mouse over the first column will display the item in a tooltip.
|
farmbuyer@1
|
132
|
farmbuyer@1
|
133 Hovering over the second column will display a tooltip with the loot that person
|
farmbuyer@1
|
134 has received. If they've won more than 10 items, the list is cut off with '...'
|
farmbuyer@1
|
135 at the end; to see the full list, use the right-click +Show only this player> option
|
farmbuyer@1
|
136 instead.
|
farmbuyer@1
|
137
|
farmbuyer@1
|
138 <Right-Click>
|
farmbuyer@1
|
139
|
farmbuyer@1
|
140 Right-clicking a loot row shows a dropdown menu.
|
farmbuyer@1
|
141
|
farmbuyer@1
|
142 Right-clicking in the first or third columns will display options for special
|
farmbuyer@1
|
143 treatment of that loot entry (marking as offspec, etcetera). Using any of those
|
farmbuyer@1
|
144 options will change the text in the third column (which will then affect the text
|
farmbuyer@1
|
145 in the generated tabs, such as forum markup).
|
farmbuyer@1
|
146
|
farmbuyer@1
|
147 Right-clicking in the second column allows you to temporarily remove all other
|
farmbuyer@1
|
148 players from the loot display. Use the reset button in the lower-right corner to
|
farmbuyer@1
|
149 restore the display to normal. The menu also allows you to +reassign> loot from
|
farmbuyer@1
|
150 one player to another; if the new recipient is not in the raid group at the time,
|
farmbuyer@1
|
151 use the +Enter name...> option at the bottom of the list of names to type the
|
farmbuyer@1
|
152 name into a text box. If your raid takes advantage of the new ability to trade
|
farmbuyer@1
|
153 soulbound items, you will need to reassign the item here for the generated text
|
farmbuyer@1
|
154 to be factually correct.
|
farmbuyer@1
|
155
|
farmbuyer@1
|
156 See the help screen on "Boss Entries" for the +Insert new boss kill event> option.
|
farmbuyer@1
|
157
|
farmbuyer@1
|
158 <Double-Click>
|
farmbuyer@1
|
159
|
farmbuyer@1
|
160 Double-clicking a loot row in the third ("Notes") column allows you to edit that
|
farmbuyer@1
|
161 field directly. The color of the text will still depend on any +Mark as ___>
|
farmbuyer@1
|
162 actions done to that loot row, whether automatically or by hand.
|
farmbuyer@1
|
163 ]]
|
farmbuyer@1
|
164
|
farmbuyer@1
|
165 T.basic_boss = [[
|
farmbuyer@1
|
166 Boss wipe/kill entries are entirely dependant on Deadly Boss Mods being enabled and
|
farmbuyer@1
|
167 up-to-date. The typical sequence of events for our usual raids goes like this:
|
farmbuyer@1
|
168
|
farmbuyer@1
|
169 We make four or five attempts on Baron Steamroller. As DBM registers that combat
|
farmbuyer@1
|
170 ends, a <wipe> event is entered on the loot display along with the duration of the
|
farmbuyer@1
|
171 fight. If the loot display is opened, the wipes will be visible with a light gray
|
farmbuyer@1
|
172 background.
|
farmbuyer@1
|
173
|
farmbuyer@1
|
174 After reminding the dps classes to watch the threat meters, we manage to kill
|
farmbuyer@1
|
175 Steamroller. When DBM registers the win, a <kill> event is entered on the display
|
farmbuyer@1
|
176 with a dark gray background.
|
farmbuyer@1
|
177 All previous <wipe>s are removed and collapsed into the <kill> event. The final
|
farmbuyer@1
|
178 <kill> event shows the duration of the successful fight and the number of attempts
|
farmbuyer@1
|
179 needed (or "one-shot" if we manage to be competent).
|
farmbuyer@1
|
180
|
farmbuyer@1
|
181 Sometimes this goes wrong, when DBM misses its own triggers. If DBM does not catch
|
farmbuyer@1
|
182 the start of the boss fight, it can't register the end, so nothing at all is
|
farmbuyer@1
|
183 recorded. If the fight was a win but DBM does not catch the victory conditions,
|
farmbuyer@1
|
184 then DBM will (after several seconds) decide that it was a wipe instead. And
|
farmbuyer@1
|
185 sometimes useful loot will drop from trash mobs, which DBM knows nothing about.
|
farmbuyer@1
|
186
|
farmbuyer@1
|
187 For all those reasons, right-clicking on a "boss row" will display options for
|
farmbuyer@1
|
188 +Insert new boss kill event>, and for toggling a <wipe> into a <kill>. We often
|
farmbuyer@1
|
189 insert bosses named "trash" to break up the display and correct the forum markup
|
farmbuyer@1
|
190 listing.
|
farmbuyer@1
|
191 ]]
|
farmbuyer@1
|
192
|
farmbuyer@1
|
193 T.tracking = [[
|
farmbuyer@1
|
194 The first button underneath +Main> in the right-hand column displays the current
|
farmbuyer@1
|
195 status of the addon. If it is disabled, then no recording, rebroadcasting, or
|
farmbuyer@1
|
196 listening for rebroadcasts is performed. Any loot already recorded will be restored
|
farmbuyer@1
|
197 across login sessions no matter the status.
|
farmbuyer@1
|
198
|
farmbuyer@1
|
199 You can turn on tracking/broadcasting before joining a raid. If you join a raid
|
farmbuyer@1
|
200 and the addon has not been turned on, then (by default) a popup dialog will ask for
|
farmbuyer@1
|
201 instructions. (This can be turned off in the advanced <Options>.)
|
farmbuyer@1
|
202
|
farmbuyer@1
|
203 The addon tries to be smart about logging on during a raid (due to a disconnect or
|
farmbuyer@1
|
204 relog). If you log in, are already in a raid group, and loot has already been
|
farmbuyer@1
|
205 stored from tracking, it will re-enable itself automatically. It will not (as of
|
farmbuyer@1
|
206 this writing) restore ancillary settings such as the tracking threshold.
|
farmbuyer@1
|
207
|
farmbuyer@1
|
208 The intent of the addon design is that, after the end of a raid, all the generated
|
farmbuyer@1
|
209 markup text is done, optionally saved (see "Generated Texts - Saved Texts"), and
|
farmbuyer@1
|
210 then cleared from
|
farmbuyer@1
|
211 storage altogether. As a result, if you login with restored loot information but
|
farmbuyer@1
|
212 are not in a raid, the addon will do nothing on its own -- but will assume that
|
farmbuyer@1
|
213 you've forgotten to finish those steps and will yammer about it in the chat window
|
farmbuyer@1
|
214 as a reminder.
|
farmbuyer@1
|
215
|
farmbuyer@1
|
216 The +Threshold> drop-down has no connection at all with any current loot threshold
|
farmbuyer@1
|
217 set by you or a master looter.
|
farmbuyer@1
|
218 ]]
|
farmbuyer@1
|
219
|
farmbuyer@1
|
220 T.tracking_enabled = [[
|
farmbuyer@1
|
221 Full tracking records all loot events that fulfill these criteria:
|
farmbuyer@1
|
222
|
farmbuyer@1
|
223 1) The loot quality is equal to or better than what you have selected in the
|
farmbuyer@1
|
224 +Threshold> drop-down.
|
farmbuyer@1
|
225
|
farmbuyer@1
|
226 2) The loot is not one of the few items hardcoded to not be tracked (badges,
|
farmbuyer@1
|
227 emblems, Stone Keeper Shards, etc).
|
farmbuyer@1
|
228
|
farmbuyer@1
|
229 3) <You can see the loot event.> More precisely, you need to be close enough
|
farmbuyer@1
|
230 to the recipient of the loot to be able to see "So-And-So receives loot: [Stuff]"
|
farmbuyer@1
|
231 in your chat window, even if you have those actual loot messages turned off.
|
farmbuyer@1
|
232
|
farmbuyer@1
|
233 It is (3) that causes complications. A master looter can assign loot to anybody
|
farmbuyer@1
|
234 anywhere in a raid instance, but the range on detecting loot events is much
|
farmbuyer@1
|
235 smaller. If your raid does not use master looting then you merely need to be
|
farmbuyer@1
|
236 close enough to the boss corpse, presuming that the winners will need to walk
|
farmbuyer@1
|
237 over to get their phat epix.
|
farmbuyer@1
|
238
|
farmbuyer@1
|
239 If you do use master looter, then you have two options: first, you can
|
farmbuyer@1
|
240 require players
|
farmbuyer@1
|
241 who might get loot to stay near the boss. You would then also need to stay near
|
farmbuyer@1
|
242 the boss to detect the loot event. (This can be less hassle if you are also
|
farmbuyer@1
|
243 the loot master.) The downside is that other players moving on to fight to the
|
farmbuyer@1
|
244 next boss are doing so without the help of their teammates.
|
farmbuyer@1
|
245
|
farmbuyer@1
|
246 The other option is to ask other players to also install Ouro Loot, and for
|
farmbuyer@1
|
247 them to turn on the "Rebroadcasting" feature. Any loot events which they can
|
farmbuyer@1
|
248 see will be communicated to you. Then it only becomes necessary for at least
|
farmbuyer@1
|
249 one person to be close enough to the loot recipient to see the item awarded,
|
farmbuyer@1
|
250 and you will record it no matter how far away you are -- even back in Dalaran.
|
farmbuyer@1
|
251
|
farmbuyer@1
|
252 If you have Full Tracking enabled, then you are also automatically rebroadcasting.
|
farmbuyer@1
|
253 Having more than one player with Full Tracking turned on is probably a good
|
farmbuyer@1
|
254 idea, in case one of the trackers experiences a game crash or is suddenly kidnapped
|
farmbuyer@1
|
255 by robot ninja monkeys.
|
farmbuyer@1
|
256 ]]
|
farmbuyer@1
|
257
|
farmbuyer@1
|
258 T.tracking_bcast = [[
|
farmbuyer@1
|
259 The simplest method of operation is only rebroadcasting the loot events that you
|
farmbuyer@1
|
260 see, as you see them. Nothing is recorded in your local copy of the addon.
|
farmbuyer@1
|
261
|
farmbuyer@1
|
262 If you logout for any reason, the addon will not reactivate when you log back in.
|
farmbuyer@1
|
263
|
farmbuyer@1
|
264 You can use </loot bcast> or </loot broadcast> to turn on rebroadcasting without
|
farmbuyer@1
|
265 opening the GUI.
|
farmbuyer@1
|
266 ]]
|
farmbuyer@1
|
267
|
farmbuyer@1
|
268 T.texts = [[
|
farmbuyer@1
|
269 The middle tabs are just large editboxes. Their text is initially generated from
|
farmbuyer@1
|
270 the information stored on the main <Loot> tab, at the time you click on the tab.
|
farmbuyer@1
|
271 Not every bit of information that
|
farmbuyer@1
|
272 we want in the generated text is always available, or depends on things that the
|
farmbuyer@1
|
273 game itself can't know. So you can edit the text in the tabs and your edits will
|
farmbuyer@1
|
274 be preserved.
|
farmbuyer@1
|
275
|
farmbuyer@1
|
276 Each time you click one of the text tabs, every new entry on the <Loot> tab
|
farmbuyer@1
|
277 since the last time this tab was shown will be turned into text.
|
farmbuyer@1
|
278
|
farmbuyer@1
|
279 Clicking the +Regenerate> button will throw away all the text on that tab, including
|
farmbuyer@1
|
280 any edits you've made, and recreate all of it from scratch. If you've accidentally
|
farmbuyer@1
|
281 deleted the text from the editbox, or you've made manual changes to the <Loot> tab,
|
farmbuyer@1
|
282 you can use this button to start over.
|
farmbuyer@1
|
283
|
farmbuyer@1
|
284 You can click in an editbox and use Control-A to select all text, then Control-C
|
farmbuyer@1
|
285 to copy it to the system clipboard for subsequent pasting into a web browser or
|
farmbuyer@1
|
286 whatever. If you're on a Mac, you probably already know the equivalent keys.
|
farmbuyer@1
|
287 ]]
|
farmbuyer@1
|
288
|
farmbuyer@1
|
289 T.texts_forum = [[
|
farmbuyer@1
|
290 The <Forum Markup> tab creates text as used by the guild forums for Ouroboros
|
farmbuyer@1
|
291 of Kilrogg. By default this is fairly standard BBcode. The format of the
|
farmbuyer@1
|
292 individual loot items can be adjusted via the dropdown menu on the lower right
|
farmbuyer@1
|
293 of the tab.
|
farmbuyer@1
|
294
|
farmbuyer@1
|
295 The [url] choice defaults to using Wowhead. If you have the [item] extension
|
farmbuyer@1
|
296 for your BBcode installed, you can use either of those choices too. The "by ID"
|
farmbuyer@1
|
297 variant is good for heroic ToC/ICC items that share names with nonheroic items,
|
farmbuyer@1
|
298 but is harder to read in the text tab.
|
farmbuyer@1
|
299
|
farmbuyer@1
|
300 You can also specify a custom string. Formatting is done with these replacements:
|
farmbuyer@1
|
301
|
farmbuyer@1
|
302 +$N>: item name|r
|
farmbuyer@1
|
303
|
farmbuyer@1
|
304 +$I>: (capital "eye", not "ell") numeric item ID|r
|
farmbuyer@1
|
305
|
farmbuyer@1
|
306 +$T>: loot recipient and any additional notes|r
|
farmbuyer@1
|
307
|
farmbuyer@1
|
308 +$X>: if more than one of the item was looted, this is the "x2", "x3", etc
|
farmbuyer@1
|
309
|
farmbuyer@1
|
310
|
farmbuyer@1
|
311 Pro tip #1: if something has happened on the main <Loot> tab which cannot be
|
farmbuyer@1
|
312 changed directly but would generate incorrect text, you can click this tab to
|
farmbuyer@1
|
313 generate the text right away. Then edit/move the text as needed. When you
|
farmbuyer@1
|
314 close the display or click back on the <Loot> tab, your edited text will be
|
farmbuyer@1
|
315 preserved for later.
|
farmbuyer@1
|
316
|
farmbuyer@1
|
317 Pro tip #2: Barring things like pro tip #1, the author typically does not
|
farmbuyer@1
|
318 generate any text until the end of the raid.
|
farmbuyer@1
|
319 ]]
|
farmbuyer@1
|
320
|
farmbuyer@1
|
321 T.texts_other = [[
|
farmbuyer@1
|
322 So far the only other generated text is the <Attendance> tab, an alphabetized list
|
farmbuyer@1
|
323 on a per-boss basis.
|
farmbuyer@1
|
324
|
farmbuyer@1
|
325 Other addons can register their own text tabs and corresponding generation
|
farmbuyer@1
|
326 functions. If you want to be able to feed text into an offline program (for
|
farmbuyer@1
|
327 example, a spreadsheet or DKP tracker), then this may be of use to you.
|
farmbuyer@1
|
328
|
farmbuyer@1
|
329 Ideas for more tabs? Tell me!
|
farmbuyer@1
|
330 ]]
|
farmbuyer@1
|
331
|
farmbuyer@1
|
332 T.texts_saved = [[
|
farmbuyer@1
|
333 The contents of the <Forum Markup> and <Attendance> tabs can be saved, so that they
|
farmbuyer@1
|
334 will not be lost when you use the +Clear> button.
|
farmbuyer@1
|
335
|
farmbuyer@1
|
336 Do any edits you want to the generated text tabs, then click the +Save Current As...>
|
farmbuyer@1
|
337 button on the right-hand side. Enter a short descriptive reminder (for example,
|
farmbuyer@1
|
338 "thursday hardmodes") in the popup dialog. The texts will remain in their tabs,
|
farmbuyer@1
|
339 but clearing loot information will not lose them now.
|
farmbuyer@1
|
340
|
farmbuyer@1
|
341 All saved texts are listed on the right-hand side. There is no technical limit to
|
farmbuyer@1
|
342 the number of saved texts, but the graphical display will begin to overflow after
|
farmbuyer@1
|
343 about half a dozen saved sets. (And I don't care.)
|
farmbuyer@1
|
344
|
farmbuyer@1
|
345 Clicking a saved text name lets you +Load> or +Delete> that saved set. The primary
|
farmbuyer@1
|
346 <Loot> tab is not saved and restored by this process, only the generated texts.
|
farmbuyer@1
|
347 This also means you cannot +Regenerate> the texts.
|
farmbuyer@1
|
348 ]]
|
farmbuyer@1
|
349
|
farmbuyer@1
|
350 T.tips = [[
|
farmbuyer@1
|
351 Shift-clicking an item in the <Loot> display will paste it into an open chat editbox.
|
farmbuyer@1
|
352
|
farmbuyer@1
|
353 The |cffff8000[Ouro Loot]|r "legendary item" link displayed at the start of all
|
farmbuyer@1
|
354 chat messages is a clickable link. Clicking opens the main display. An option
|
farmbuyer@1
|
355 on the <Options> tab will cause a message to be printed after a boss kill,
|
farmbuyer@1
|
356 mostly for lazy loot trackers who don't like typing slash commands to open windows.
|
farmbuyer@1
|
357
|
farmbuyer@1
|
358 If you are broadcasting to somebody else who is tracking, you should probably be
|
farmbuyer@1
|
359 using the same threshold. If yours is lower, then some of the loot you broadcast
|
farmbuyer@1
|
360 to him will be ignored. If yours is higher, then you will not be sending information
|
farmbuyer@1
|
361 that he would have recorded. The "correct" setting depends on what your guild wants
|
farmbuyer@1
|
362 to track.
|
farmbuyer@1
|
363
|
farmbuyer@1
|
364 Ticking the "notraid" box in advanced debugging <Options>, before enabling tracking,
|
farmbuyer@1
|
365 will make the tracking work outside of a raid group. Communication functions
|
farmbuyer@1
|
366 will behave a little strangely when doing this. Be sure to check the threshold!
|
farmbuyer@1
|
367 You can also use <"/ouroloot debug notraid"> instead.
|
farmbuyer@1
|
368
|
farmbuyer@1
|
369 Using the "Saved Texts" feature plus the +Clear> button is a great way of putting
|
farmbuyer@1
|
370 off pasting loot into your guild's website until a more convenient time.
|
farmbuyer@1
|
371 ]]
|
farmbuyer@1
|
372
|
farmbuyer@1
|
373 T.tips_slashies = [[
|
farmbuyer@1
|
374 The </ouroloot> command can take arguments to do things without going through
|
farmbuyer@1
|
375 the UI. Parts given in *(angle brackets)* are required, parts in [square brackets]
|
farmbuyer@1
|
376 are optional:
|
farmbuyer@1
|
377
|
farmbuyer@1
|
378 +broadcast>/+bcast>: turns on rebroadcasting|r
|
farmbuyer@1
|
379
|
farmbuyer@1
|
380 +on [T]>: turns on full tracking, optionally setting threshold to T|r
|
farmbuyer@1
|
381
|
farmbuyer@1
|
382 +off>: turns off everything|r
|
farmbuyer@1
|
383
|
farmbuyer@1
|
384 +thre[shold] T>: sets tracking threshold to T|r
|
farmbuyer@1
|
385
|
farmbuyer@1
|
386 +list>: prints saved text names and numbers|r
|
farmbuyer@1
|
387
|
farmbuyer@1
|
388 +save *(your set name)*>: saves texts as "your set name"|r
|
farmbuyer@1
|
389
|
farmbuyer@1
|
390 +restore *(N)*>: restores set number N|r
|
farmbuyer@1
|
391
|
farmbuyer@1
|
392 +delete *(N)*>: deletes set number N|r
|
farmbuyer@1
|
393
|
farmbuyer@1
|
394 +help>: opens the UI to the help tab|r
|
farmbuyer@1
|
395
|
farmbuyer@1
|
396 +toggle>: opens or closes the UI (used mostly in automated wrappers)|r
|
farmbuyer@1
|
397
|
farmbuyer@1
|
398
|
farmbuyer@1
|
399 If you use the slash commands to enable tracking or set loot thresholds, you can
|
farmbuyer@1
|
400 give numbers or common names for the threshold. For example, "0", "poor", "trash",
|
farmbuyer@1
|
401 "gray"/"grey" are all the same, "4", "epic", "purple" are the same, and so on.
|
farmbuyer@1
|
402
|
farmbuyer@1
|
403 If you give an unrecognized argument to the </ouroloot> slash command, it will
|
farmbuyer@1
|
404 search the tab titles left to right for a title beginning with the same letters as
|
farmbuyer@1
|
405 the argument, and open the display to that tab. For example, <"/loot a"> would
|
farmbuyer@1
|
406 open the <Attendance> tab, and <"/loot ad"> would open the <Advanced> tab. If
|
farmbuyer@1
|
407 you had added a theoretical <EQDKP> tab, then <"/loot eq"> would be the fastest
|
farmbuyer@1
|
408 way to see it.
|
farmbuyer@1
|
409 ]]
|
farmbuyer@1
|
410
|
farmbuyer@1
|
411 T.todo = [[
|
farmbuyer@1
|
412 If you have ideas or complaints or bug reports, first check the Bugs subcategories
|
farmbuyer@1
|
413 to see if they're already being worked on. Bug reports are especially helpful
|
farmbuyer@1
|
414 if you can include a screenshot (in whatever image format you find convenient).
|
farmbuyer@1
|
415
|
farmbuyer@1
|
416 Click the "About" line on the left for contact information.
|
farmbuyer@1
|
417 ]]
|
farmbuyer@1
|
418
|
farmbuyer@1
|
419 T.todo_gotchas = [[
|
farmbuyer@1
|
420 <Things Which Might Surprise You> (and things I'm not sure I like in the
|
farmbuyer@1
|
421 current design):
|
farmbuyer@1
|
422
|
farmbuyer@1
|
423 If you relog (or get disconnected) while in a raid group, behavior when you log
|
farmbuyer@1
|
424 back in can be surprising. If you have already recorded loot (and therefore
|
farmbuyer@1
|
425 the loot list is restored), then OL assumes it's from the current raid and should
|
farmbuyer@1
|
426 reactivate automatically in full tracking mode. If you were tracking but no
|
farmbuyer@1
|
427 loot had dropped yet (and therefore there was nothing *to* restore), then OL
|
farmbuyer@1
|
428 will pop up its reminder and ask again. Either way, if you were only broadcasting
|
farmbuyer@1
|
429 then OL will *not* go back to only broadcasting. This is probably a bug.
|
farmbuyer@1
|
430
|
farmbuyer@1
|
431 The saved texts feature does exactly that: only saves the generated texts, not
|
farmbuyer@1
|
432 the full loot list. Restoring will get you a blank first tab and whatever you
|
farmbuyer@1
|
433 previously had in the various generated text tabs.
|
farmbuyer@1
|
434
|
farmbuyer@1
|
435 Using the right-click menu to change an item's treatment (shard, offspec, etc)
|
farmbuyer@1
|
436 does not broadcast that change to anyone else who is also tracking. Changing
|
farmbuyer@1
|
437 the item and then selecting "rebroadcast this item" *does* include that extra
|
farmbuyer@1
|
438 info. Doing that on the initial "mark as xxx" action is... tricky.
|
farmbuyer@1
|
439
|
farmbuyer@1
|
440 The generated text tries to only list the name of the instance if it has not
|
farmbuyer@1
|
441 already been listed, or if it is different than the instance of the previous
|
farmbuyer@1
|
442 boss. If you relog, the "last printed instance name" will be forgotten, and
|
farmbuyer@1
|
443 you'll see redundant raid instance names appearing in the text.
|
farmbuyer@1
|
444
|
farmbuyer@1
|
445 After a boss wipe, multiple broadcasting players releasing spirit more than
|
farmbuyer@1
|
446 several seconds apart can cause spurious "wipe" entries (of zero duration) on
|
farmbuyer@1
|
447 the loot grid. The surefire way to avoid this is to not release spirit until
|
farmbuyer@1
|
448 DBM announces the wipe, but the problem isn't serious enough to really worry
|
farmbuyer@1
|
449 about. (Right-click the spurious entries and delete them.)
|
farmbuyer@1
|
450 ]]
|
farmbuyer@1
|
451
|
farmbuyer@1
|
452 T.todo_todolist = todo
|
farmbuyer@1
|
453
|
farmbuyer@1
|
454
|
farmbuyer@1
|
455 -- Fill out the table that will actually be used. Join adjacent lines here so
|
farmbuyer@1
|
456 -- that they'll wrap properly.
|
farmbuyer@1
|
457 addon.helptext = {}
|
farmbuyer@1
|
458 for k,text in pairs(T) do
|
farmbuyer@1
|
459 local funkykey = k:gsub('_','\001') -- this is how TreeGroup makes unique keys
|
farmbuyer@1
|
460 local wrapped = text
|
farmbuyer@1
|
461 wrapped = wrapped:gsub ("[%+<>]", replacement_colors)
|
farmbuyer@1
|
462 wrapped = wrapped:gsub ("([^\n])\n([^\n])", "%1 %2")
|
farmbuyer@1
|
463 wrapped = wrapped:gsub ("|r\n\n", "|r\n")
|
farmbuyer@1
|
464 wrapped = wrapped:gsub ("Ouroboros", "|cffa335ee<Ouroboros>|r")
|
farmbuyer@1
|
465 wrapped = wrapped:gsub ("%*%(", "<") :gsub("%)%*", ">")
|
farmbuyer@1
|
466 addon.helptext[funkykey] = wrapped
|
farmbuyer@1
|
467 end
|
farmbuyer@1
|
468 end -- do scope
|
farmbuyer@1
|
469 todo = nil
|
farmbuyer@1
|
470
|
farmbuyer@1
|
471
|
farmbuyer@1
|
472 -- Don't bother recording any of this loot:
|
farmbuyer@1
|
473 addon.default_itemfilter = {
|
farmbuyer@1
|
474 [29434] = true, -- Badge of Justice
|
farmbuyer@1
|
475 [40752] = true, -- Emblem of Heroism
|
farmbuyer@1
|
476 [40753] = true, -- Emblem of Valor
|
farmbuyer@1
|
477 [45624] = true, -- Emblem of Conquest
|
farmbuyer@1
|
478 -- could probably remove the above now
|
farmbuyer@1
|
479 [43228] = true, -- Stone Keeper's Shard
|
farmbuyer@1
|
480 [47241] = true, -- Emblem of Triumph
|
farmbuyer@1
|
481 [49426] = true, -- Emblem of Frost
|
farmbuyer@1
|
482 }
|
farmbuyer@1
|
483
|
farmbuyer@1
|
484 -- vim:noet
|