UNIT-Inviter

UNIT-Inviter Frame

Usage

Type "/uinvite" to open invite frame.

Type "/uinviteml" to open masterlooter frame or rightclick on launcher button.

You should see a button on your FuBar, minimap, whatever, if a LibDataBroker addon like Broker2FuBar or something like that is installed.

Most functions are provided with tooltips. So no further description here.

The addon is configurable via the standard interface options (ESC > Interface > Addons > UNITInviterConfig)

Description

The addon is designed for UNIT Raidleaders (http://www.wow-unit.net). Though, it's possible to import non-UNIT raid data (see description below). UNIT is an open raid community platform and will be opened for all german realms soon. Have a look at http://v3.wow-unit.net/index.html to get an impression.

Features:


  • See planned raids, exportet from UNIT page (or any other source)
  • Automatically invide participants (single invite or repetitive invite)
  • Group will turn into raid, if necessary
  • Loot Master is set automatically for the forgetful ones among you ;) (can be turned off)
  • Create WoW Calendar Event from exported raids*
  • Create custom invite list by selecting players from exportet player database or exported raids or by adding players manually
  • Filter player list by character name or main-character name (exported player data needs to give info on mainchars of course)
  • Highlight players in list which joined your community's chat channel to get a hint on who is online (IMO a /who on each player would't be the best idea)

  • Master Looter Frame: see all raid members/roll results, loot rating and available loot in one frame. Assign loot to players.
  • Loot rating modules can be plugged-in to calculate loot-system-specific ratings after each assigned loot (a module for the UNIT loot system is included)
  • Participants are not automatically transfered from raids to events. Blizzards API seems to restrict this.

Importing Raid/Player Data

You need to get a 'UnitInviter.lua' file and store it inside your global saved variables folder ("\...\World of Warcraft\WTF\Account\[AccountName]\SavedVariables\UnitInviter.lua"). It should be easy for Web-Admins to provide appropriate files containing the information needed (see below).

The file needs to be present before you start WoW! The addon will work though, but without showing any raid or player data. The attached 'UnitRaidExport.exe' may or may not be usefull. It's just a simple command-line programm which copies a file from a given URL into your global vars folder. Usage: UnitRaidExport.exe [AccountName] [FILEURL]. Where [AccountName] here is the same as [AccountName] obove.

Exporting Raid/Player Data

Felder/fields:

"Raids"    : Tabelle aller aktuellen Raids
             Table of current raids
"playerDB" : Tabelle aller aktiven Charaktere der Community
             Table of all active chars
"name"     : Titel des Events, beliebig wählbar (z.B. "UNIT-Raid")
             The event's title (arbitrary)
"players"  : Tabelle der Angemeldeten Charakter
             Table of participating chars
"backup"   : Tabelle der Angemeldeten Ersatz-Charakter
             Table of chars assigned to the subs bench
"type"     : ID des Event-Typs (Zuordnung unten)
             ID of the event type (see below)
"texture"  : ID des Dungeon (Zuordnung unten)
             ID of the dungeon
"detail"   : beliebiger Text, z.B. Name des Dungeon
             arbitrary text, e.g. name of the dungeon
"hour"     : volle Stunde des Event-Beginns (z.B.: 19)
             hour of the day, the event begins
"minute"   : Minute des Event-Beginns (z.B.: 45)
             minute of the hour, the event begins
"year"     : das Jahr (z.B.: 2008)
             the year
"month"    : der Monat (z.B.: 11)
             month of the year
"day"      : der Tag (z.B.: 28)
             day of the month

"raidId"   : Eindeutige Identifizierung des Raid. I.d.R. der Index des Raid
             in der Datenbank der Community-Website.
             Unique ID of the Raid. Usually the index of the raid inside
             the website's database.
"lootId"   : Die Kategorie, für die die Loot-Berechtigung berechnet wird.
             z.B. 1=10er Raids, 2=25er Raids. Oder für jede Instanz eine 
             eigene ID. Das hängt vom verwendeten Loot-System ab.
             The category, the loot rating is calculated for. E.g., 1 stands
             for 10 men raids, 2 for 25 men raids. Or each instance may have
             its own ID.

Beispiel-Datei mit 2 Raids:
Example file showing 2 raids:

Speicherort/location: "\...\World of Warcraft\WTF\Account\[MYACCOUNT]\SavedVariables\UnitInviter.lua"

Wichtig: die Textdatei muss in UTF-8 kodiert sein!
Important: the file must be UTF-8 encoded! (regarding german umlauts in particular)

UnitInviterUnitRaidsDB = {
    ["global"] = {
        ["Raids"] = {
            {
                ["players"] = {
                    "Player1",
                    "Player2",
                    "Player3",
                    "Player4",
                    "Player5",
                    "Player6",
                    "Player7",
                    "Player8",
                },
                ["backup"] = {
                    "PlayerX", -- [1]
                    "PlayerX", -- [2]
                    "PlayerX", -- [3]
                    "PlayerX", -- [4]
                    "PlayerX", -- [5]
                },
                ["raidId"] = 12,
                ["lootId"] = 1,
                ["type"] = 1,
                ["hour"] = "20",
                ["detail"] = "Das Auge der Ewigkeit",
                ["name"] = "Unit-Raid",
                ["month"] = "11",
                ["minute"] = "0",
                ["year"] = "2008",
                ["day"] = "5",
                ["texture"] = 3,
            },
            {
                ["players"] = {
                    "Player1",
                    "Player2",
                },
                ["raidId"] = 13,
                ["lootId"] = 1,
                ["type"] = 1,
                ["hour"] = "20",
                ["detail"] = "Hyjal der Vergangenheit",
                ["name"] = "Unit-Raid",
                ["month"] = "12",
                ["minute"] = "15",
                ["year"] = "2008",
                ["day"] = "5",
                ["texture"] = 15,
            },
        },
        
        ["playerDB"] = {
			{
				["role"] = "1",
				["class"] = "1",
				["name"] = "Mychar",
				["main"] = "Mymainchar",
			}, -- [1]
			{
				["role"] = "2",
				["class"] = "1",
				["name"] = "Mychar2",
				["main"] = "Mymainchar2",
			}
	},
        --following sub-table is specific to the rating-module
        ["unitModuleLootData"] = {
		--first sub-table is lootId 1
                {
			["MyChar1"] = {
				["numRaids"] = 10,
				["numLoot"] = 3,
			},
			["MyChar1"] = {
				["numRaids"] = 6,
				["numLoot"] = 2,
			},
	        },
                --second sub-table is lootId 2...
                {
			["MyChar1"] = {
				["numRaids"] = 2,
				["numLoot"] = 0,
			},
			["MyChar1"] = {
				["numRaids"] = 5,
				["numLoot"] = 1,
			},
	        },
	},
    },
}

PlayerDB field "class":

Krieger/Warrior      = 1
Magier/Mage          = 2
Druide/Druid         = 3
Paladin              = 4
Schurke/Rogue        = 5
Schamane/Shaman      = 6
Hexenmeister/Warlock = 7
Priester/Priest      = 8
Jäger/Hunter         = 9
Todesritter/DK       = 10

PlayerDB field "role":

Tank   = 1
DD     = 2
Healer = 3

Event type ID (field "type"):

RAID    = 1
DUNGEON = 2
PVP     = 3
MEETING = 4
OTHER   = 5

Dungeon IDs (field "texture"):

1 - Archavons Kammer/Chamber
2 - Archavons Kammer/Chamber (Hero)
3 - Das Auge der Ewigkeit
4 - Das Auge der Ewigkeit (Hero)
5 - Das Obsidiansanktum
6 - Das Obsidiansanktum (Hero)
7 - Naxxramas
8 - Naxxramas (Hero)
9 - Ulduar < was removed from calendar

9 - Der Schwarze Tempel/BT
10 - Der Sonnenbrunnen/Sunwell
11 - Festung der Stürme/TK
12 - Gruuls Unterschlupf/Lair
13 - Höhle des Schlangenschreins/Serpentshrine Cavern
14 - Hyjal der Vergangenheit/COT 3
15 - Karazhan
16 - Magtheridons Kammer/Chamber
17 - Zul'Aman

18 - Geschmolzener Kern/MC
19 - Obere Schwarzfelsspitze/UBRS
20 - Onyxias Hort/Lair
21 - Pechschwingenhort/BWL
22 - Ruinen von Ahn'Qiraj/AQ20
23 - Tempel von Ahn'Qiraj/AQ40
24 - Zul'Gurub

Facts

Date created
01 Nov 2008
Categories
Last update
28 Dec 2008
Development stage
Release
Language
  • deDE
  • enUS
License
All Rights Reserved
Curse link
UNIT-Inviter
Recent files

Authors