vanilla-wow-addons – Blame information for rev 1

Subversion Repositories:
Rev:
Rev Author Line No. Line
1 office 1 Guild Event Manager (GEM)
2 by Kiki from European Cho'gall (Alliance)
3 Part of the GUI by Alexandre Flament
4 Home Page : http://christophe.calmejane.free.fr/wow/gem/
5 ----------------------------------------
6  
7 ---
8 ChangeLog :
9 ----------------
10 - 2.08 :
11 - March, 31th 2006 :
12 - Updated TOC for 1.10
13 - Fixed 'N' text in minimap icon flashing sometimes, while there is no new event
14 - Increased date column width, and added date in the tooltip
15 - Added a new color code in Admin list : Blue=Connected but not grouped, Green=Connected and grouped
16 - 2.07 :
17 - March, 16th 2006 :
18 - Fixed lua error in New event if you load a template created before Auto-members additionnal code
19 - Finally fixed channels init errors. Password protected channels should work too.
20 - March, 15th 2006 :
21 - Fixed lua error in Admin list popup if not leader
22 - You can now force yourself into replacement queue
23 - Fixed force titular button not working, if the player was not in replacement queue before
24 - March, 13th 2006 :
25 - Handling "Force titular" param in Sorting of members
26 - March, 10th 2006 :
27 - Added possibility to ignore a closed event (new button)
28 - Fixed bug in the ignore option (a previously ignored event might reappear)
29 - March, 9th 2006 :
30 - Added confirmation dialog for Delete Template (New event tab)
31 - Fixed wrong reset instance day, around midnight
32 - Added possibility to Auto-add members to an event (NOT FINISHED YET !! NO CHECKS !)
33 - Saving Auto-members to templates
34 - Added possibility to move a member back and forth Replacement queue
35 - Added possibility to force a member in titular list
36 - 2.06 :
37 - March, 7th 2006 :
38 - Fixed : some events not removed from the list, when changing channel
39 - Auto-purging players that didn't connect since 1 month
40 - Fixed players not sending any data when they first log in the channel
41 - Added Events Calendar view (not finished yet)
42 - Possibility to show instances reset from the calendar view
43 - March, 3rd 2006 :
44 - Increased EventsList size (2 more items), needed to incoming new EventView
45 - 2.05-2 :
46 - March, 2nd 2006 :
47 - Fixed lua error line 699... sorry
48 - 2.05 :
49 - March, 2nd 2006 :
50 - Fixed Channel initialization errors
51 - Fixed password protected channel errors. Now displaying if there is a join error
52 - Added possibility to choose channel to create a new event (from the GUI, in the NewEvent tab)
53 - Added possibility to force an hours offset from the server with "/gem offset <hours>" option (ADVANCED players !!!)
54 - February, 23th 2006 :
55 - Fixed lua error when sorting some events by class or level
56 - February, 20th 2006 :
57 - Added possibility to set a default value for password, alias and slashcommand (like it was possible for Channel), so guild can build an archive with all values set correctly.
58 - 2.04 :
59 - February, 17th 2006 :
60 - Fixed wrong event.date displayed when editing an event (if you have a timeoffset with the server)
61 - Calendar correctly pickup the date matching your options (UseTimeServer option), as well as the Events list
62 - Fixed issue with password in config (couldn't change a password with changing the channel name)
63 - February, 16th 2006 :
64 - Checking for expired events and commands before broadcasting
65 - Now even players with a PC clock not correctly set, will correctly purge passed events
66 - Removed TimeOffset config option, changed to UseServerTime CheckBox. When checked, the calendar will use ServerTime (instead of your local time) to create an event. Events in the list will be shown using ServerTime too.
67 - 2.03 :
68 - February, 16th 2006 :
69 - Temporary fix for "I'm the leader of..." warning message. More robust fix soon
70 - Fixed Crashed->Recover->Close-> Impossible to "unclose" (only "recover" possible)
71 - 2.02 :
72 - January, 6th 2006 :
73 - Hopefully fixed GEM messages sent to wrong channel, when using an AddOn that leave/rejoin GEM channels without notifying GEM.
74 - Improved GEM message flow (less messages sent in some situations)
75 - Fixed 'Deleted event reappearing' issue.
76 - Always uppercasing first char of External player name
77 - 2.01 :
78 - December, 23th 2005 :
79 - Added new commands to configure multiple channels feature (try /gem help)
80 - Added possibility to "Ignore" an event (non leader only) from a button in "subscribers" list
81 - Added possibility for a leader to completly remove a closed event that is not passed yet (and tell every player to remove it)
82 - December, 21th 2005 :
83 - Added UI buttons to 'Unclose' and 'Recover' (EXPERIMENTAL !) an event
84 - Fixed recover bugs :)
85 - December, 19th 2005 :
86 - Added 'bip your name' option, when someone calls you in a GEM channel
87 - Detecting Drunk status, and delaying GEM commands until you are sober
88 - Auto focus 'Name' field when opening AddExternal window
89 - Checking channel IDs when you change zone (to prevent sending GEM messages to a wrong channel, like Trade or General)
90 - Added possibility to promote subscribers as Assistants. Those promoted players are allowed to use the GroupAll button.
91 - Added possibility to ignore events (need GUI or /CMD)
92 - First step for 'partial recovering of a lost event'
93 - December, 15th 2005 :
94 - Added 'min' class limit value in the Subscribers plugin sorting function
95 - December, 14th 2005 :
96 - Changed the default enEN value for displayed dates, now it uses 12hours clock format with am/pm
97 - Changed the configuration tab a little bit
98 - December, 8th 2005 :
99 - You can now use the 'Tab' key to switch between EditBoxes
100 - Now sending your player's info (location/guild...) every 5min, if not sent during this period
101 - December, 7th 2005 :
102 - Fixed channel reinit bug, when changing alias in config (but not the channel name)
103 - Fixed ChatFrame handler, to support GuildAds messages
104 - December, 5th 2005 :
105 - Auto removing control characters from comment lines, to prevent WoW disconnection
106 - November, 23th 2005 :
107 - Now purging to-send messages, when leaving a GEM channel
108 - Fixed 'unknown' channel error in buffered send queue
109 - November, 21th 2005 :
110 - No longer closing your own events when you leave channel (fixes bug with alt char in another channel), but disabling admin
111 - November, 17th 2005 :
112 - If a leader receives an event is does not know, he auto-close it (if he crashed after creating new event, he'll loose it)
113 - Fixed few possible lua errors
114 - Improved change leader function (more robust)
115 - Added debug messages (CHANNEL msg) to track error during ChannelInit
116 - 2.00RC93 :
117 - November, 15th 2005 :
118 - Fixed GEM version not showing for other than me
119 - Changed the way closed events are handled (removed GEM_COM_CloseEvent message, replaced by a field in EventUpdate message).
120 - Few improvements in protocol, some code cleanup
121 - Command line option "/gem events" now display all events for all chans (shows eventIds needed for "purge" and "ev_chan" commands)
122 - Added new command line option, to *fix* lost events by changing channel : "/gem ev_chan <ev_id>" : This resets the eventId (must be leader) to the current joined GEM channel
123 - Added new command line option, to completly purge a closed event (must be closed before purge) : "/gem purge <ev_id>" : This removes closed eventId from the list (must be leader), even if event date not passed yet
124 - Added plugin API to send and receive messages (see GEM_comm.lua or readme file)
125 - Now displaying ChannelName (or Alias if set) instead of 'GuildEventManager' when someone joins or leaves the channel
126 - Changed tooltip back to how they were displayed (smaller font), but now auto-split long lines
127 - Finished Options tab help tooltip (need deDE localization, and a check for usUS one)
128 - 2.00RC92 :
129 - November, 14th 2005 :
130 - You can now choose the default sorting plugin you want to use, per character
131 - Added a 'comment' line (in options) you can set, per character (will be shown in members list)
132 - Improved members list with tooltips and infos
133 - Improved tooltips in Events list
134 - Added "/gem events" and "/gem unclose <ev_id>" commands, to list and unclose events (this is tempo, until a UI is made)
135 - November, 12th 2005 :
136 - Fixed possible receipt of a GEM message, before channels initialization
137 - Added new sorting plugin by Nerolabs from Shadowsong Server
138 - Added 3 new fields to player's informations (guild rank name/index, and a comment line)
139 - November, 10th 2005 :
140 - No longer automatically set channels (except default one) for rerolls
141 - Added support (OMG so many changes to be made) for multiple channels (but not possible to join multiple channels via GUI for the moment)
142 - Events are now locked to a channel
143 - Added new bugs to be fixed, thanks to your help ^^
144 - November, 9th 2005 :
145 - Fixed more lua errors :/
146 - Fixed Date showing in grey sometimes, in Events list
147 - 2.00RC91 :
148 - November, 8th 2005 :
149 - Fixed 2 lua errors
150 - 2.00RC9 :
151 - November, 8th 2005 :
152 - Now keeping closed events in the list. They are automatically removed when they expire
153 - Now converting short day name in french (possibly in DE, if added to localization file)
154 - Fixed few UI refresh issues
155 - Added a small blink on minimap icon, when there is a new event
156 - Implemented the 'Put in remplacement' button (event admin function)
157 - Added ingame help and informations (search for '[?]' buttons)
158 - November, 7th 2005 :
159 - Reduced cps sent to a very low limit, to see if it improve lag/disco issues
160 - Implemented _GEM_CMD_PurgeMultipleCommands function, which will greatly reduce obsolete cmd messages (and msg flow)
161 - Recompute my_bcast_offset at each log in
162 - Added speculative list of subscribers (tagged as 'NA')
163 - In Subscribers list, get Guild name from Members list, if available (instead of the "N/A" tag)
164 - Added a 'Invite' button in the popup menu in Subscribers list
165 - November, 5th 2005 :
166 - Fixed more lua errors
167 - 2.00RC8 :
168 - November, 4th 2005 :
169 - Fixed many lua errors, and init errors
170 - Completly removed debug flow, when debug is set to 0
171 - Fixed possible lag issue (not sending multiple CloseEvent, when receiving cmd for unknown event I owned)
172 - Added a low level flow control to sent messages, to prevent lag and disconnections. If you experience lag or disconnections, please tune the values _GEM_COM_MaxSendPerSchedule and _GEM_COM_ScheduledTaskInterval in GEM_comm.lua.
173 - Increased personnal bcast offset range, from 1-30 to 1-90 sec (should reduce even more duplicated messages, at the price of more time to see new events or subscriptions when you log in)
174 - Added confirmation dialog when closing an event
175 - Removed Kick/Ban buttons in Subscribers tab (need room for new buttons soon), but added a contextual menu
176 - Added to contextual menu, the new ChangeLeader function
177 - 2.00RC7 :
178 - November, 3rd 2005 :
179 - Fixed lua error when an event is closed while you inspect list of subscribers
180 - Added a new option in config, to show or not members login/logout
181 - Added a new option in config, to specify an hour offset, for displayed hours
182 - Added a new option in config, to filter events not in your selected character's level range
183 - Now saving members, per realm, and per channel
184 - November, 2nd 2005 :
185 - Fixed localization errors
186 - Fixed small channel flood occuring in some rare occasions
187 - Added colors in Members list, to show officers and guild leaders
188 - Fixed Unban button, showing for non-leader
189 - Automatically remove "/" if set in SlashCmd Editbox
190 - October, 30th 2005 :
191 - Fixed possible error at init
192 - Added Member's count, and possibility to see offlines
193 - 2.00RC6 :
194 - October, 28th 2005 :
195 - Correctly duplicating Alias/SlashCmd for rerolls
196 - Improved members list populating by saving know players to Savedfile. Will take some time the first few days to populate, but will be instant after. This method will really decrease channel flood.
197 - Added debug messages, to track down Alias/Slash issue
198 - Added a new UI windows, to see current banned players from an event (and un-ban them)
199 - Added print message in config window
200 - 2.00RC5 :
201 - October, 27th 2005 :
202 - Fixed lua error when using GEM2 in same channel than GEM1
203 - Renamed GEMv2 to GuildEventManager2
204 - If you were added to an event by the leader (Add External player), you will notice it, and set you as having subscribed (you can now unsubscribe)
205 - October, 26th 2005 :
206 - Added possibility to talk to the GEM channel (only filter GEM commands)
207 - Added Channel Alias, slash command, sticky channel.
208 - Added a new TAB : Connected members
209 - Fixed lua errors when clicking on headers of listviews
210 - Added new key bindings to directly open "Create Event", "Event List", "Members" or "Config"
211 - 2.00RC4 :
212 - October, 21th 2005 :
213 - Fixed few bugs
214 - Finished LeaderChange function
215 - Added a warning message, if receiving GEM commands, but on a different channel than config.
216 - October, 20th 2005 :
217 - Fixed lua error when changing channel
218 - Possibility to configure (via options) the displayed date format
219 - Fixed your commands not being sent when you log in
220 - Implemented LeaderChange forward protocol (needs more testing)
221 - 2.00RC3 :
222 - October, 19th 2005 :
223 - Now displaying minimap cursor's current position in config
224 - Now saving channel config per character
225 - Preliminary code to handle change of leader
226 - Fixed few GUI bugs
227 - Now correctly checking player's level during subscription and event modification
228 - Added new color codes
229 - 2.00RC2 :
230 - October, 18th 2005 :
231 - Fixed 'Minor update' bug, and events not showing (because of this)
232 - Created plugin system, for subscribers sorting
233 - Created default 'By Subscription Date' plugin
234 - Now displaying SortingMode, in the Details tab of an Event
235 - Increased Event Comment string to 200 chars
236 - Fixed issue with Date being changed when editing an event
237 - 2.00RC1 :
238 - October, 17th 2005 :
239 - Added possibility to subscribe to a 'replacement' queue ('Take me, if you don't find someone else')
240 - Finished recoding of low level protocol and ACK system for all commands
241 - Added new cool debug frame (only in debug mode) with colors for easier debugging (obiously)
242 - Fixed wrong level being used when selecting a reroll in the dropdown list
243 - Re-enabled AddExternal command, with new 2.0 parameters
244 - Added GUI possibility to send the 'Comment' string when subscribing
245 - October, 12th 2005 :
246 - Added comment string to subscribe/unsubscribe in the protocol.
247 - Subscribe/unsubscribe is now working with v2.0
248 - October, 7th 2005 :
249 - v2.0 Events are now working. Everybody can see the list of subscribers (name, level and position, but not the guild it takes too much place).
250 - Increased 'Place' and 'Comment' fields to 40 and 100 characters.
251 - October, 6th 2005 :
252 - Changed the protocol. Now splitting long messages into pieces. Allow to support long event comments, list of subscribers, and much more to come.
253 - September, 28th 2005 :
254 - Start of massive rewrite of the code. Files splitted into many other files. More modular.
255 - 1.07 :
256 - September, 20th 2005 :
257 - Fixed player's level using an ALT not always being initialized to the correct value (once again, issue related to 1.7 changes)
258 - Fixed issues with player names using special chars
259 - Added many warning message to help track the possible class limit overflow (please inform me, if you get a warning)
260 - Fixed auto gem users listing at startup
261 - Fixed a bug : if you are titular, but leader comes offline, and you unsub, then re-subscribe, you would be considered unsubscribed for ever :p
262 - 1.06 :
263 - September, 19th 2005 :
264 - Fixed my_names init error (again, thanks to blizz for undocumented changes in vars init in 1.7)
265 - Changed auto-delete from 24 to 1 hour (10 hours for the leader only)
266 - Fixed a big bug I added when I put the auto-delete function in place : no subscribe/unsubscribe was sent to the leader when he logs in
267 - Now retrieve GEM channel list when logging in : Leader should see connected subscribers when logging.
268 - 1.05 :
269 - September, 14th 2005 :
270 - Removed RegisterForSave call. Variables are now correctly saved in the new SavedVariables folder
271 - Updated toc (#1700)
272 - Fixed vars init when disconnect/reconnect and /reloadui (thanks blizz for the undocumented new behaviour changes)
273 - Fixed ugly Frame background
274 - 1.04 :
275 - September, 13th 2005 :
276 - Added ButtonHole support
277 - Optimized CPU usage when GEM is not visible
278 - Added an overlay 'N' letter over minimap icon, when there is new event(s) available
279 - September, 12th 2005 :
280 - Fixed guild names with spaces
281 - Fixed Expired events check for events I don't own
282 - Fixed lua error when receiving an expired update for event I'm the leader of
283 - 1.03 :
284 - September, 9th 2005 :
285 - Added minimap icon
286 - Localized all remaning texts
287 - Fixed auto-purge of old events
288 - Added new color code for Admin list of players (green=player connected)
289 - September, 6th 2005 :
290 - Fixed a bug in join channel retry
291 - 1.02 :
292 - September, 2nd 2005 :
293 - Now correctly switch players to/from titular/substitute queues, after editing an event
294 - Optimized channel flow when leader logs in
295 - Added 'Group all titulars' option in Admin tab
296 - September, 1st 2005 :
297 - Fixed issue (lua errors) due to old format data, still in file after 1.01 upgrade.
298 - 1.01 :
299 - September, 1st 2005 (1.01):
300 - Added possibility to choose one of your reroll, to create/subscribe events
301 - Added "/gem toggle", to toggle the GUI from command line
302 - Added Load/Save templates, in NewEvent tab
303 - Enabled "Edit Event" feature (in EventsList, Admin tab)
304 - Default channel is now "GEMChannel<YourGuild>"
305 - Many fixes
306 - 0.10 :
307 - August, 31th 2005 (0.10-2):
308 - Added possibility for the leader to add an *external player* (player who does not have GEM installed)
309 - Fixed Guild not showing in Admin tab
310 - Added automatic purge of old events
311 - Fixed a bug in calendar, if opening it on the 31th day of a month
312 - Added GEM new version detection (major version only - protocol changes)
313 - Changed protocol - Not compatible with previous versions
314 - August, 30th 2005 (0.10-1):
315 - Fixed calendar localization
316 - Removed Chronos/Sea dependency
317 - Fixed GUI refreshment, and improvments : now using colors instead of '*' (red=banned, yellow='*', blue='**', green='***'), and added colored Leader in events list (green = logged)
318 - 0.9 :
319 - August, 29th 2005 (0.9-1):
320 - Added 'Day of week' in Events date
321 - Added '*' in the 'Subscribers' column. One '*' means you have sent subscription for the event. Two '*' means you have subscribed (received by leader), but you are in Substitute queue. Three '*' means you have subscribed, and you are in Titular queue.
322 - Fixed bugs in 'kick/ban' protocol
323 - Fixed substitute count not showing in Limits tab
324 - You can only subscribe to an event not yet subscribe (same for unsubscribe)
325 - Other few fixes (all your datas will be reset, sorry about that, but I had to change few structs)
326 - 0.8 :
327 - August, 26th 2005 (0.8-9):
328 - Everybody can see current titulars/substitutes for each class
329 - August, 25th 2005 (0.8-8):
330 - Finished admin/global GUI tabs.
331 - August, 22th 2005 (0.8-7):
332 - Many fixes. Added pretty much all the GUI.
333 - August, 4th 2005 (0.8-6):
334 - Fixed channel init
335 - GUI CB function called when creating/updating/closing locally
336 - July, 28th 2005 (0.8-5):
337 - Finished calendar, with time/date
338 - July, 27th 2005 (0.8-4):
339 - Now encoding Date/Hour as unique integer (#sec since 1970)
340 - July, 27th 2005 (0.8-3):
341 - Added calendar to choose event date
342 - Realm initialization fix
343 - July, 26th 2005 (0.8-2):
344 - Added per-realm events
345 - Added players Guild
346 - Added Callback function for GUI
347 - July, 20th 2005 (0.8-1):
348 - Added a special tag (<GEMversion>) to messages sent in GEMChannel
349 - Sending broadcast messages as blocs (every seconde)
350 - July, 19th 2005 :
351 - Added support for kick/ban players from an event
352 - July, 15th 2005 :
353 - Added a list of all my rerolls (needed or ACKs might never go to State2).
354 - Added current_count to events (so everybody can see current subscriber count).
355 - Added GEM_AddExternalSubscriber and GEM_RemoveExternalSubscriber functions (leader only).
356 - 0.7 : July, 11th 2005 : Few fixes
357 - 0.6 : July, 9th 2005 : Fixed bugs :p
358 - 0.5 : July, 7th 2005 : Added substitute list sorting.
359 - 0.4 : July, 6th 2005 : Added titular and substitute list. Fixed bugs :p
360 - 0.3 : July, 1st 2005 : Added unsubscribe command. Fixed bugs :p
361 - 0.1 : June, 28th 2005 : Module created.
362  
363  
364 ---
365 Description :
366 ----------------
367 This AddOn allows you to create/schedule/manage future raid instance directly in-game. Players can register (join) and reserve a room for your instance, or cancel subscription.
368 You can setup a maximum players for your event, as well as the min/max per class.
369 When a player wants to join and there is no room left for his class, he is put in a *substitute* queue, waiting for someone to cancel his subscription.
370  
371 The leader of an event does not have to be logged in for a player to subscribe.
372  
373 This addon has been designed to help guilds to schedule events, and its member to say *I'll be there*, and count the number of players that are ok for an instance.
374 It does work for multiple guilds (kind of Alliance of guilds), if you want, or even with your friend list.
375  
376 All dates are stored in universal time, and displayed in local time, so if someone creates an event in a different timezone than yours, you will see the correct time on your side.
377  
378  
379 ---
380 Installation :
381 ---------------
382  
383 1. Extract .zip file to WorldOfWarcraft\Interface\AddOns\
384 2. load up WoW check the Addon is enabled ("/gem help" should print infos)
385 3. Bind a key to GuildEventManager or type "/gem toggle"
386 4. in the options TAB set the channel to whichever you are going to use
387  
388  
389 ---
390 Notes :
391 --------
392  
393 COLOR CODE :
394 - Events List in Events Tab, Where column :
395 - White = Old event (already displayed)
396 - Green = New event (never seen)
397 - Events List in Events Tab, Leader column :
398 - White = Leader not connected
399 - Green = Leader connected
400 - Events List in Events Tab, Subscribers column :
401 - White = Not subscribed
402 - Purple = Level of your selected character does not match event's level range
403 - DarkGrey = Subscription sent, but not ACKed yet
404 - Bleu = Subscription ACKed but you are in Substitute queue
405 - Green = Subscription ACKed and you are in Titular list
406 - Yellow = Subscription ACKed and you are in Replacement list
407 - DarkRed = You have been kicked from event (and thus unsubscribed). You can re-subscribe
408 - LightRed = You have been banned from event (and thus unsubscribed). You cannot re-subscribe until you are unbanned
409 - Admin List in Events Tab, Name column :
410 - White = Player not connected (or external)
411 - Blue = Player connected but not grouped
412 - Green = Player connected and grouped
413 - Members list, Guild column :
414 - Green = Guild leader
415 - Blue = Guild officer
416 - White = Guild member
417  
418  
419 ---
420 FAQ :
421 --------
422 Q : I don't see events of other people, and others don't see mine
423 A : Are you sure you are on the same channel (check GEM options) ? Are you sure you don't have joined more than 9 channels (there is a limit of 9 or 10 channels you can join) ? Are you sure your PC's clock is correctly set ?
424 If you still don't see events, try "/gem debug 1", it will show a new TAB, look at the debug log (screenshot it) for warnings or event related messages, then contact me.
425  
426 Q : I see garbage on my channels, like "<GEM-1>01..."
427 A : Check if the channel you see garbage is the same than the one in your GEM config. Maybe you have changed the channel with a character, and changed reroll. Leave the garbaged one with a /leave ChanNum. In v2.0, channel will be saved per char, so you will not have this problem anymore.
428  
429 Q : I just subscribed to an event, but I don't appear in the list, nor the titulars count has changed.
430 A : If the leader of the event is not logged, all commands (subscribe, unsubscribe, ...) are stored and broadcasted to every person in the channel (and each time someone logs in). In order to see your subscription in the list (and titulars count increased/decreased), you must wait until the leader logs. When he does, all commands are flushed and he processes them, in the order they were submitted.
431 Look at the color codes above, they help you know in which state you are.
432  
433 Q : All thoses stored commands don't flood the channel when someone (or the leader) logs in ?
434 A : No, there is an algorithm that makes people to sent commands at different time when someone joins, and if a known command has just been sent, the sent from your side is canceled. There is also a maximum of commands that can be sent per second, so you are not (less) flooded.
435  
436 Q : I don't like the subscribers sorting modes available. I want something else, custom.
437 A : Well, that's where the Sorting plugin system comes in ! Look at the "GEM_sort_stamp.lua" file, there is all you need to make your own plugin (there is no need for the plugin to be installed on each player's computer, only on the leader's one). Simply make a new addon with a .toc file, that depends on GuildEventManager, and you're done. The plugin will be loaded by GEM, and you'll be able to choose your custom sorting in GEM's "Create new Event" tab.
438  
439 Q : I have a lua error, but I cannot tell you the file/line it occured
440 A : Please install (even temporarily) ImprovedErrorFrame (http://www.curse-gaming.com/mod.php?addid=170), and you'll be able to see the full error text
441  
442 Q : When I link an item to the GEM channel, it displays the name only.
443 A : For links to be sent, you must use the SlashCmd specified in GEM config. If you speak using /# (# being GEM's channel number), it will not work.
444  
445 Q : I don't see anybody in the Members list, and the list populates very slowly. Also, I always see "N/A" for people's location.
446 A : This is to greatly reduce traffic in the channel. Each player sends his personal informations ONLY when he changes of zone, NOT when someone logs in (otherwise every single player will have to send his current info upon each login, which causes too much traffic).
447 Because of this, the first time you come to a channel, we don't see anybody, you must wait for each player to move to another zone. When this happens, the player is saved and stored in your variables, so the next time, only it's current location will show as 'N/A' until he moves.
448  
449 Q : I'm using SlashCmd and alias, and when I try to send a message, I don't see anything in my chatframe, nor I see messages from others.
450 A : Some addons are not hooking chatframe like they should.
451 - If you have GuildAds : Get the latest version, it has been fixed
452 - If you have flagRSP : Get the latest version, it has been fixed
453 - If you have Guilded : Why do you need this one anymore ? oO
454  
455 Q : I don't like the way Dates are displayed. How can I change that ?
456 A : Change the option "Displayed dates format" ingame, in the GEM Configuration tab with the value you want.
457 You can find help on the parameters here : http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html
458  
459 Q : I don't understand the 'time offset' option
460 A : When someone creates an event, the time/date for the event is (by default, if you don't change the offset in GEM config) relative to it's computer's clock (which uses international time).
461 Example :
462 My computer's clock is set at GMT+1, I play on a server where time is set to GMT.
463 I create an event for tonight 8pm, GEM will flag (create) the event for 8pm GMT+1 (and store it using universal time value), not 8pm GMT (so not the server time).
464 BUT the date will be displayed for eveybody, using their local time. For someone playing on a computer with clock set at GMT+2, the event will show for him at 9pm.
465 The offset value in GEM config, is for people who want events to be shown using server time (or any other time offset), not local time.
466 They can set an offset from local time to match server time. If you don't set anything, it will display/create events based on your computer time (local).
467  
468 Q : When are events removed from the list ?
469 A : Events are auto removed (not closed, removed completly from GEM) 1 hour after event's date for non-leader players, and 10 hours after event's date for leader.
470 Using the previous example, the event will disapear for eveybody at 9pm GMT+1 (so for the guy playing at GMT+2 time, it will disapear when his computer's clock will reachs 10pm).
471  
472  
473  
474 --------------- Plugin API ---------------
475  
476  
477 function GEM_COM_API_AddDispatchFunction :
478 Adds a command dispatch callback function
479 opcode : String -- Unique Opcode you want to use (must represent an Int)
480 func : Function -- Function to be called when you receive this Opcode
481  
482 Prototype for command related to an event = function CallbackFunc(channel,from,stamp,ev_id,params) :
483 - channel = Channel event is linked to
484 - from = Sender of the message
485 - stamp = Stamp the command was issued by the author of the cmd (not necessary same person than 'from')
486 - ev_id = EventId the command is related to
487 - Common Cmd 'params' =
488 Params[1] = leader (STRING) -- Leader of the event
489 Params[2] = ev_date (INT) -- Date of the event
490 Params[3] = ack (STRING) -- 1 or 0, if the packet is an ack to the command or not
491 Params[4] = pl_dest (STRING) -- Name of player the command is destinated to
492 Params[5] = pl_src (STRING) -- Name of player the command is originating from
493 Followed by specific Cmd 'params' you pass to the Send function
494  
495 Prototype for global command = function CallbackFunc(channel,from,stamp,ev_id,params) :
496 - Same as previously, but ev_id = GEM_GLOBAL_CMD, and no 'common params', only 'specific params'
497  
498 Global commands are volatile (not stored nor forwarded by other players), while event related commands are stored and broadcasted when a new player arrives.
499  
500 Returns true on success, false if opcode is already in use
501  
502 function GEM_COM_API_AddDispatchFunction(opcode,func);
503  
504 function GEM_COM_API_SendVolatileCommand :
505 Sends a volatile command (not stored nor forwarded by other players)
506 channel : String -- Channel to send message to
507 opcode : String -- Unique Opcode you want to use (must represent an Int)
508 params : Table -- Array of your params (must be Int index based, use table.insert())
509 Returns true on success.
510  
511 function GEM_COM_API_SendVolatileCommand(channel,opcode,params);
512  
513  
514 function GEM_COM_API_SendCommand :
515 Sends an event related command (stored and broadcasted when a new player arrives)
516 channel : String -- Channel to send message to
517 opcode : String -- Unique Opcode you want to use (must represent an Int)
518 ev_id : String -- EventId command is related to
519 pl_dest : String -- Recipient player the message is addressed to
520 pl_src : String -- Originator player (often the event.leader)
521 params : Table -- Array of your params (must be Int index based, use table.insert())
522 Returns true on success, false if event is unknown.
523  
524 function GEM_COM_API_SendCommand(channel,opcode,ev_id,pl_dest,pl_src,params);