Killer Monkeys – Attendance: Esse addon começou com um problema em janeiro, que era criar raids com o mês (zero), pelo o que percebi ele ficou meio doido na virada do ano, o função que deveria calcular que se o mês anterior fosse dezembro, voltasse um ano, não estava funcionando,  com isso ele deixava Janeiro com 1 e Dezembro com 0.
A solução foi remover esse código e usar uma função do jogo que pega o mês exato de acordo com o Offset que está sendo utilizado.

Ambos Addons se encontram hospedados na Curse Gaming, e podem ser atualizados pelo Curse Client ou baixados diretamente.
KM Recipe Tree http://my.curse.com/downloads/wow-addons/details/killer-monkeys-recipe-tree.aspx
KM Attendance  http://my.curse.com/downloads/wow-addons/details/km_att.aspx

Eu sou um fã de carteirinha do portal wowwiki.com, nesse site está concentrado muita informação sobre warcraft, assim como a Lore, Gameplay e também sobre a API do World of Warcraft.

Quando eu tive a idéia de criar o KM_RecipeTree, eu já tinha noção que no wowwiki eu poderia encontrar informações de como inciar o projeto. Como sempre eu achei o velho exemplo de qualquer inicio em linguagem de programação que é o "Hello World".

Vou mostrar aqui neste artigo como criar um simples Addon "Hello World" e como interagir com a API do jogo mostrando a quantidade de "gold" que seu personagem tem. Avisando que esses dois Addon de exemplo já existem no kit de desenvolvimento oficial da Blizzard, eu só vou explicar passo a passo da criação de cada um.

1. Estrutura de um Addon

Um addon deve possuir em sua pasta três arquivos.
.toc -> Onde fica as informações principais do addon; nome, versão, variáveis, dependências e etc.
.lua -> Onde fica toda a programação do addon.
.xml -> Onde fica o código da estrutura da interface do addon.

1.1 Arquivo .toc

A estrutura do .toc é mais ou menos assim:

Esse ai é o .toc do meu addon KM_Att se você reparar ele apenas informa para o jogo as informações básicas do addon.
Os campos mais importante são, o Interface (onde diz qual versão do jogo o addon é compatível, 30000 = WOTLK), Title (o nome do addon) e a ultima linha são os arquivos que vamos carregar.

A estrutura do nosso addon OlaMundo será assim

- Crie uma pasta chamada Olamundo dentro da pasta dos addon do WOW (Pasta do WOW\Interface\AddOns\Olamundo).
- Crie um arquivo chamado Olamundo.toc e coloque os dados acima.
1.2 Arquivo .lua

Agora vamos para a parte de programação, a API do world of warcraft trabalha com uma linguagem de programação chamada Lua, eu não vou entrar muito a fundo de Lua porém tem que saber dela para programar no jogo, ela é simples e para saber mais informações veja o wikipedia sobre lua.

Nessa etapa deve se criar um arquivo chamado Olamundo.lua na pasta do jogo, e abrir esse arquivo para colocar nossas primeiras linhas de código.

PLAIN TEXT
CODE:




function Olamundo()


  message("Olá Mundo de Azeroth!");


end 

Salve o arquivo, com isso você criou uma função que chama uma outra função global chamada message. Essa função message vai mostrar uma janela com o texto escolhido e um botão de "OK", é uma função da API.
1.3 Arquivo .xml

Esse arquivo é o que vai interagir diretamente com a API, sendo carregado pelo .toc e se comunicando com o .lua.
Crie um arquivo chamado Olamundo.xml e nele bote o código abaixo.

PLAIN TEXT
CODE:




<ui xmlns="http://www.blizzard.com/wow/ui/"


 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"


 xsi:schemaLocation="http://www.blizzard.com/wow/ui/


 ..\..\FrameXML\UI.xsd">


  <script file="Olamundo.lua"/>


  <frame name="HelloWorldFrame">


   <scripts>


    <onload>


     Olamundo();


    </onload>


   </scripts>


  </frame>


</ui> 

Se você já entende um pouco com XML vai se familirializar com a formatação XML. Se você sabe absolutamente nada de XML, dá uma "googlada" sobre o assunto pois voando em XML não vai pra frente com addons no wow.
A tag inicial do código XML para a API do wow sempre vai ser <UI>, e nesse mesmo formato ai com esses mesmo valores xmls e bla bla bla. A parte que fica entre as tags <UI></UI> é o que importa mais.
<Script /> essa tag vai chamar o Olamundo.lua, pode se colocar varios .lua ai bastanto adicionar outra <Script file="nomedoarquivo.lua" />
* Importante: XML tem uma formatação certa, se abrir uma TAG deve fechar <TAG> </TAG> se quiser uma Tag de uma linha só coloque <TAG /> com a barra "/" no final.

<Frame> </Frame> essa e a parte que criamos um frame, na verdade não vai ter nenhum Frame na tela do jogo, pois nossa função somente aqui é escrever o "Olá Mundo" na tela. Mas o frame é quem dispara eventos então mesmo sem nada gráfico precisa de um frame para fazer o addon funcionar.
<Scripts> </Scripts> Aqui controlamos os eventos do frame, lembra um pouco os eventos de um campo HTML (onload, onmouseover, onclick, etc).
<Onload></Onload> Aqui vamos informar a API do jogo que quando carregar esse frame (quando carrega o jogo e a cada ReloadUI) execute os comandos dentro das TAG, que no caso é o Olamundo() que esta dentro de Olamundo.lua.

2 Testando

- Salve tudo e abra o Jogo, na tela de Login clique em Addons para ver se o addon Olamundo está sendo listado e esta habilitado.
- Escolha um personagem e entre no jogo.
- Se a tela "Olá Mundo de Azeroth" aparecer com o botão de OK para fechar, você teve sucesso e criou seu primeiro Addon.

3 Mais só isso?

Vou depois criar uma proxima etapa indo mais a fundo com a interface e com os eventos do jogo, e claro monstrando algo mais concreto, mas só com isso já da para ter ideia de como funciona e começar a criar seus próprios addons.

Meu primeiro addon foi um que eu fiz com a saida da BC, era o KM_RecipeTree (Killer Monkeys - Recipe Tree) esse addon eu fiz porque eu tinha um lock tailor e era muuuito chato ficar calculando os mats que precisava para fazer os itens, tipo o cara me perguntava QUAIS OS MATS DA BAG? se eu falar é tantos bold of cloth ai cara e os MATS DO BOLT? puts, ai eu fiz um addon que calcula tudo isso e manda no chat
Mais info aqui: http://my.curse.com/downloads/wow-addons/d...ecipe-tree.aspx (não ta funcionando na WOTLK mas vou atualizar em breve)

bom voltando ao mais novo
Site do Addon no Curse.com
http://my.curse.com/downloads/wow-addons/details/km_att.aspx
O Killer Monkeys - Attendance é um addon que tem como função gerar o numero de attendance dos membros da guild, usando como base de dados o sistema de calendário do jogo. De inicio a minha guild (Killer Monkeys) costumava usar o phpRaid, onde os eventos eram marcados e de acordo com o apply de cada membro uma pontuação era dada e no final de cada mês era gerado a porcentagem de presença desse player (attendance) e com isso ele subia ou descia de rank na guild.

O phpRaid é uma boa ferramenta porem ele tem um problema que era ter que atualizar manualmente cada dia de raid de acordo com o setup da mesma, tendo que marcar os faltosos e o grupo que foi formado, as vezes isso gerava dados imprecisos e sem falar do saco que é o (Alt-Tab) para atualizar.

O phpRaid tinha flags para o player de acordo com o apply da raid: Avaliable, Not Avaliable e Confirmed, onde se dava 1 ponto para Confirmed, 0.5 para Avaliable e 0 (zero) para Not Avaliable. No final contava os pontos com uma formula e o phpRaid gerava o att (ele não faz isso nativamente foi uma modificação que fiz).

Com o calendário e um sistema de attendance in-game tudo é feito usando a interface do jogo, sem alt-tab, officers podem setar as raids e as flags e players podem conferir seu attendance ontime.

No calendário do jogo existem 6 flags onde a pontuação pode ser mais diversificada, para a nossa guild usamos:
Confirmed = 1 (usado para quem deu accepted e apareceu no dia do evento).
Standby = 0.5 (usado para quem deu accepted, apareceu mas saiu no meio, ou ficou de replace e saiu logo em seguida quando precisou).
Declined = 0.25 (não pode vir mas avisou com antecedência).
Out = -1 (ponto negativo para quem da accepted e não aparece, e para quem não responde ao evento também).
Invited = ~ (não conta pontos mas e a flag de todos que foram invitados, se o cara não responder delcined ou accepted o addon muda a flag dele para Out no dia do evento).
Accepted = 0 (essa flag quase nunca vai ser usada como pontuação final, mas e bom ter como coringa para dar ZERO a alguem em algum caso especial).

A formula para gerar o attendance é:
factor_confirmed = 1
factor_standby = 0.5
factor_declined = 0.25
factor_out = -1
FLAGS_DOPLAYER = (confirmed * factor_confirmed) + (standby * factor_standby) + (declined * factor_declined) + (out * factor_out)
attendance = (FLAGS_DOPLAYER * 100) / NUMBER_OF_EVENTS

* Mas claro cada guild pode mudar os valores das flags de acordo com suas regras.

=== FEATURES ===
- Atualiza as flags do evento de acordo com a raid montada (Aba 2, Raid Setup)
- Calcula o attendance de acordo com as flags marcadas no calendário
- Mostra detalhes do attendace do jogador (confirmed, declined, out e etc)
- Menu de configurações onde pode se escolhe:
-- Dias da semana que a guild raida (Segunda, terça e etc) os outros dias da semana não serão contados no ATT (Minha guild raida oficialmente de Segunda a Quinta, porem agente marca raid todo dia os outros dias não contam att)
-- Ignorar algumas raids mesmo no dia da semana da raid, apagar dados da raid no cache
-- Fatores da formula para cada flag, cada guild pode ter os fatores que desejar.

=== TODO ===
- Filtro para os tipos de raid que valem attendance (Blacktemple, Nax25man e etc).
- Relatório da raid em texto (c/ ou sem formato BBCODE) para ser usado nos forums.
- Relatório do player em texto (c/ ou sem formato BBCODE).
- Purge raids (esse butão não funciona bem ainda)
- Completar dados da raid pelo addon e não pelo calendário (depende da blizz liberar a função no próximo patch)

=== KNOW ISSUES ===
- Assim que instalado o addon não atualiza os dados do cache dos eventos sozinho, precisa abrir o calendário para que ele consiga carregar a lista de eventos, isso é um bloqueio da blizz ainda não consegui disparar o evento sem ser abrindo o calendário.
- O addon pega todas as raids mas sem os dados dos players, para evitar tráfego de dados a blizz so manda dados dos players do evento escolhido pelo calendário, e tem um bloqueio de 2 segundos para puxar denovo os dados, então para atualizar os dados so players daquele evento deve se clicar nele no calendário. O botão completar dados da raid não funciona também só da pra completar usando o calendário.
- Ontem a noite depois do crash do server o addon deu um erro na parte de atualizar a raid mas do nada parou, não sei o que foi mas vou tentar identificar.

## Author: ReiserFS
## Interface: 30000
## Notes: Control Attendance using Built-in WOW calendar.
## Title: KM_Attendance
## Version: 1.0
## eMail: reiserfs@killermonkeys.net
## URL: http://thiago.killermonkeys.net
## DefaultState: Enabled
## LoadOnDemand: 0
## SavedVariables: KMATT_SAVED_VAR_CONFIG, KMATT_SAVED_VAR_ATT

O itemstats constava em mostrar as informações dos itens do world of warcraft na página. Sendo preciso apenas colocar o nome do item, e o sistema iria buscar em portais especializados (thottbot, allakhazam e etc) as informações e armazenava em um banco de dados.

Para simplificar o funcionamento, um usuário do fórum por exemplo poderia usar o BBcode [wow]Nome do Item[/wow] em seu tópico que o sistema iria buscar o "Nome do Item" e gravar no banco de dados se caso encontrasse. Assim quando postado o tópico o "Nome do Item" seria um link, e que quando passado o mouse em cima desse link, um "tooltip" iria aparecer mostrando as informações desse item.

Apesar de ter usado o sistema, na nova versão do PHPBB3 eu não queria mais ter que usa-lo pois apesar de ser uma boa idéia o sistema tinha alguns problemas que eram:

- Implementar o sistema implicaria uma modificação nos arquivos originais do phpbb3, coisa que eu estou evitando fazer.
- O sistema de armazenamento no banco fazendo um cache dos itens, não acompanhava a atualização dos dados.
- Buscar informações dos itens nos sites de terceiros não gerava dados confiáveis e deixava o sistema pesado por baixar um site toda vez que um item era postado.
- Postar mais de 4 novos items deixava a função de enviar a mensagem no fórum muito lenta, pois o servidor tinha que baixar o site 4 vezes e gravar no banco.
- Itens atualizados no jogo, não eram atualizados no cache.

Para evitar estes problemas eu tive a idéia inicial de usar o Armory. O Armory é um portal da blizzard que contem informações sobre os personagens, guilds e itens do jogo. Com isso já se tinha uma base com dados confiáveis e atualizados.
Usar o armory também implicaria em menos tráfego de informação pois o armory é um site todo em XML, então o tráfego seria mínimo.
Outra coisa que eu não queria era uma base de dados de cache, mas também não queria que o fórum ficasse lento. Para isso eu encontrei no portal Dhtmlgoodies.com um script em AJAX que tem a função de mostrar um Tooltip externo, e que esse era carregado apenas quando se passar o mouse por cima do link.

Com as idéias prontas e as ferramentas na mão eu comecei a programar, para facilitar mais o trabalho eu usei uma classe em PHP pronta chamada phparmory criada por Michael Cotterell. Onde evitou economizou tempo, re-inventar a roda está fora de moda.

O único problema que encontrei com a classe, era que a classe buscava os itens pelo ItemID e não pelo nome do item. Como o objetivo do MOD era buscar os itens pelo nome eu fiz uma modificação na classe adicionando um novo método que busca o item pelo nome.

Bom o projeto final ficou pronto, tendo problemas apenas com o IE7, mas quem que usa Internet Explorer? eu não conheço ninguém.

Link do projeto no site do phpbb3
http://www.phpbb.com/community/viewtopic.php?f=70&t=576155&p=3174276#p3174276

PhpArmory
http://phparmory.sourceforge.net/
DHTMLGOODIES
http://www.dhtmlgoodies.com/scripts/ajax-tooltip/ajax-tooltip.html

Ele consiste em calcular o total de reagentes que são requeridos para se criar um item através de uma profissão do jogo.
Clique em Read More abaixo para ver porque criei esse addon, e como ele funciona.

- Bom com a saída da expansão do World of Warcraft, (The Burning Crusade) foram adicionados mais "recipes" para as profissões existentes.

Com isso alguns novos itens possuem uma lista muito grande de reagentes para criação, e alguns desses reagentes precisam de outros reagentes formando uma cascata.
Quando alguem me perguntava quais os materiais que precisavam para criar um item, era meio confuso responder pois eu tinha que passar apenas para ele a lista de matéria prima então precisava fazer varios calculos para isso, por exemplo:

Para criar uma bolsa que cabem 18 itens, eu precisava de:
4: "Rolo de pano magico"
2: "Teias de aranha"
1: "Essencia plana".

Porem o outro jogador não tinha como conseguir o "Rolo de pano magico" pois era com a minha profissão que era feito esse reagente. Então para fazer ficava assim:

4: "Rolo de pano magico"
-3: "Rolo de pano normal"
--6: "Pedaços de pano"
-2: "Poeira magica"
2: "Teias de aranha"
1: "Essencia plana".

No final das contas eu tinha que passar para o outro jogador somente os materiais que ele consegue no jogo matando monstros o pegando no chão (Herbalista, Minerador e etc).

O resultado final era:
72: "Pedaços de pano"
8: "Poeira magica"
2: "Teias de aranha"
1: "Essencia plana".

Bom o addon foi feito para automatizar essas contas e facilitando o uso do jogo.
Download: http://www.curse.com/downloads/wow-addons/details/killer-monkeys-recipe-tree.aspx