comparison LFGFilter.txt @ 8:9129e71852b0 v3

v3 docs update + toc
author ovolkov
date Sat, 24 Jan 2015 06:43:15 +0300
parents 041bc456db50
children 28bee190a79f
comparison
equal deleted inserted replaced
7:1c43d75054e7 8:9129e71852b0
1 LFG Filter for Premade Groups, v2 1 LFG Filter for Premade Groups, v3
2 2
3 It's great to have built-in Premade Group finder (aka LFG internally) except all the groups are mixed together and you need to carefully scan list to find that one raid or difficulty you've interested in or use TEXT based filter and risk missing groups you'd want. 3 It's great to have built-in Premade Group finder (aka LFG internally) except all the groups are mixed together and you need to carefully scan list to find that one raid or difficulty you've interested in or use TEXT based filter and risk missing groups you'd want.
4 4
5 == Features == 5 == Features ==
6 * Sorts all groups by raid/difficulty, so, say, all you heroic groups for some specific raid are together. 6 * Sorts all groups by raid/difficulty, so, say, all you heroic groups for some specific raid are together.
22 22
23 Number values: 23 Number values:
24 * ilvl - minimum ilevel required by group. 24 * ilvl - minimum ilevel required by group.
25 * defeated - amount of bosses defeated. 25 * defeated - amount of bosses defeated.
26 * members - people already in group. 26 * members - people already in group.
27 * tanks - amount of tanks. 27 * tanks/healers/damagers - amount of players in tank/healer/damager role.
28 * healers - amount of healers. 28 * warriors/deathknights/paladins/monks/priests/shamans/druids/rogues/mages/warlocks/hunters - amount of players of respective class.
29 * damagers - amount of damagers. 29
30 For each variable that have plural name there's also a copy with singular name for convenience. So both "mages" and "mage" or "tanks" and "tank" will work, for example.
30 31
31 === Short summary of Lua syntax === 32 === Short summary of Lua syntax ===
32 * and, or, not - logical operators. "highmaul and normal" will find Highmaul normal raids, "highmaul and (normal or heroic)" will find Highmaul normal and heroic and will hide mythic. 33 * and, or, not - logical operators. "highmaul and normal" will find Highmaul normal raids, "highmaul and (normal or heroic)" will find Highmaul normal and heroic and will hide mythic.
33 * == - equal, ~= - not equal, comparison for everything. 34 * == - equal, ~= - not equal, comparison for everything.
34 * < > <= >= - comparison for numbers. 35 * < > <= >= - comparison for numbers.
35 * :find - a string function, true if requested substring is present. 36 * :find - a string function, true if requested substring is present.
36 * :match - a string function, can be used for more complex searches with regular expressions. Look it up in Lua manual. 37 * :match - a string function, can be used for more complex searches with regular expressions. Look it up in Lua manual.
37 * () can be used to group and define precedence. 38 * () can be used to group and define precedence.
38 39
39 === Examples === 40 === Examples ===
40 * =highmaul and heroic and defeated == 0 41 * =highmaul and heroic and defeated == 0
41 ** Fresh Highmaul Heroic. 42 ** Fresh Highmaul Heroic.
42 43
43 * =highmaul and ((normal and (name:find("imp") or defeated == 6)) or (heroic and defeated == 1)) 44 * =highmaul and ((normal and (name:find("imp") or defeated == 6)) or (heroic and defeated == 1))
48 49
49 * =members > 3 50 * =members > 3
50 ** Find groups with at least 3 members. It will skip some groups that's just starting, but will also reliably hide recruit ads and other spam. 51 ** Find groups with at least 3 members. It will skip some groups that's just starting, but will also reliably hide recruit ads and other spam.
51 52
52 == Change log == 53 == Change log ==
54 2014-01-24 v3
55 * Support both plural and singular names for variables that hold amount of something.
56 * Add variables for number of players of specific class.
57
53 2014-01-21 v2 58 2014-01-21 v2
54 * Complete filtering rework: now works with expressions entered directly into group search filter field. 59 * Complete filtering rework: now works with expressions entered directly into group search filter field.
55 60
56 2014-11-12 v1 61 2014-11-12 v1
57 * Initial implementation: sort + activity ID search. 62 * Initial implementation: sort + activity ID search.