Você sabe o que são modules?

Modules são minigames dentro do Transformice. Existem diversos tipos desses minigames e seus criadores tem controle completo sobre ele. Os Modules são escritos na linguagem Lua e podem ser oficiais, semi-oficiais ou não-oficiais.

• Modules oficiais são minigames ou utilitários que foram aprovados pela administração do jogo. Eles podem ser encontrados na lista de salas, dentro do sub-menu "Module". Nestas salas, você pode ganhar um queijo a cada 2 minutos. Estes Modules também podem ser rodados no cafofo da sua tribo. Contudo, a manutenção dos minigames deve ser feita pela equipe Lua.
• Modules semi-oficiais são minigames que podem ser jogados no cafofo da tribo ou em salas com o nome do módulo (/sala #NomeDoMódulo). Estes módulos, contudo, não aparecem no comando /module nem nas salas oficiais. Eles também requerem a aprovação de um administrador para existirem.
• Modules não-oficiais são quaisquer outros minigames ou utilitários não aprovados por um administrador. É importante reforçar que algumas funções estão disponíveis apenas para membros da equipe Lua. Para que modules não-oficiais tenham acesso a elas, portanto, é necessária a participação de pelo menos um membro da equipe Lua no projeto. Modules não-oficiais só podem ser rodados por membros da equipe Lua, por membros da FunCorp ou no cafofo da tribo, caso algum membro com direitos suficientes tenha acesso ao script.

Lista dos modules oficiais e semi-oficiais

Abaixo, disponibilizamos uma lista dos modules oficiais e semi-oficiais atualmente implementados no Transformice, com o tópico oficial dele, caso exista. Você pode acessar a lista dos modules oficiais digitando "/module" ou acessando o sub-menu da lista de salas.



Quais as diferenças entre salas modules e salas normais?

Além dos modules terem sua própria jogabilidade e recursos exclusivos, existem também outras entre estas salas, como:

• Em modules oficiais, você pode ganhar no máximo um queijo a cada dois minutos ao entrar na toca (isto não vale para modules semi-oficiais)
• Em modules não-oficiais, o aviso "Sua última mensagem é igual" não aparece.
• Os stats (first, queijos, saves, etc) não contam no perfil. Isto vale tanto para modules oficiais quanto não-oficiais

Como posso jogar num minigame?

É bem simples. Para jogar em qualquer module oficial basta ir na sala do module desejado, digitando o nome da sala, assim: "/sala #NomeDoMinigame". Também é possível acessar modules pela lista de salas. Finalmente, caso você tenha permissão para mudar mapas no cafofo da tribo, também é possível jogar estes modules lá. É só digitar o comando "/module #NomeDoMinigame".

Como posso executar um script?

Para executar algum script, alguns requisitos devem ser respeitados:

I.		Você precisa estar no cafofo da sua tribo
II.		Você precisa ter a permissão de mudar mapas
III.		Você precisa ter mais de 1000 queijos coletados em seu perfil
IV.		Você não pode ter nenhum ban por hack em sua conta

Após conferidos todos estes requisitos, você poderá usar o comando "/lua". Quando usado, uma janela se abre com uma área para digitar ou colar algo. Basta pressionar o botão "Enviar" para que o script seja carregado em sua sala.



Onde posso sugerir algo ou reportar um bug?

Se você tem uma ideia para algum minigame, você poderá postá-la no no tópico de sugestões para minigames Lua. Sua sugestão será analisada pelos membros da equipe Lua.

Como faço para criar um minigame?

Basicamente, minigames consistem em um script escrito em Lua que permite comandar certas funções do servidor. Para desenvolver um script você irá precisar de conhecimentos sobre: lógica de programação, a API do Transformice e a linguagem de programação Lua.

A aba de documentação Lua traz as funções disponíveis para uso no desenvolvimento de um minigame.

Desenvolvi um minigame, como posso torná-lo oficial?

Somente membros da equipe lua pode gerenciar um minigame oficial. Uma opção é enviar um formulário para a equipe por conta própria (clique na aba "Equipe" para maiores informações).

Para que um minigame se torne oficial é preciso que ele seja aprovado por um administrador do jogo e além disso, esses jogos devem seguir algumas normas obrigatórias, dentre as quais são: jogabilidade divertida/interessante, "replay value" (o jogo deve ser interessante o bastante para que os jogadores tenham vontade de jogar ele mais vezes), regras e informações úteis e de fácil compreensão, tradução para os idiomas mais falados no jogo e codificação eficiente, que não use tantos recursos do servidor.

Eu executei um script e uma pequena janela de bate-papo chamada #lua abriu. O que é isso?

A janela #lua é usada para reunir todas as informações sobre o script que está sendo executado no momento. Quaisquer strings impressas irão aparecer nesse chat, assim como avisos em relação as falhas no script, avisos sobre tempo de execução muito alto, etc.



Onde posso conseguir ajuda para desenvolver um minigame?

Existem vários lugares onde você pode pedir ajuda para desenvolver algo. Se você está tendo dificuldades para solucionar um erro em seu script, você pode visitar o tópico de erros frequentes para tentar conseguir ajuda sobre como corrigí-lo ou, se preferir, pedir ajuda no próprio Module FAQ.

Mas, se você precisa falar com algum membro da equipe de forma rápida, clique na aba "Equipe" para ver a lista de membros da equipe lua. Você sempre pode entrar em contato com eles quando necessário. Além disso, existem um chat in-game que pode ser acessado digitando "/chat Lua".

O que mais devo saber ao desenvolver um minigame?

Algumas informações podem ser úteis para você que está tentando desenvolver um novo minigame. Tenha em mente que:

•		O Flash suporta algumas tags em HTML que podem ser usadas no chat do jogo, em pop-ups, textareas e outros lugares onde são exibidas strings. Você pode ler mais sobre quais as tags em HTML que podem ser usadas clicando aqui.
•		A função tfm.exec.newGame() não pode ser executada duas vezes seguidas. Um mínimo de 3 segundos de intervalo é exigido.
•		Os caracteres "<" e ">" não podem ser exibidos em strings. No entanto, usando HTML, esses caracteres poderão ser exibidos como uma string.
•		Algumas variáveis das funções tfm.get.room.playerList e tfm.get.room.objectList dependem do sync da sala para se manterem atualizadas. Isso significa que algumas informações, tais como as coordenadas do jogador e do objeto, direção do jogador, entre outros, podem estar incorretas. Tenha em mente que essas variáveis são atualizadas aproximadamente uma vez a cada 2 segundos.
•		Todas as funções da Documentação Lua usam camelCase, ou seja, a primeira palavra começa começa com um caractere em minúsculo e todas as subsequentes começam com caracteres em maíusculo. Um bom exemplo disso é a função tfm.exec.eventDisableAllShamanSkills ()

SpoilerReferências Onde posso aprender lua? Existem vários tutoriais em toda a internet, exemplificando bem como funciona e o que é lua. Site oficial do Lua Manual de Referência de Lua Wikipedia do Lua (em inglês) FAQ não-oficial do Lua (em inglês) Aprenda Lua em 15 minutos (em inglês) Lua para programadores (em inglês) Tutorial Lua (em inglês) Quais programas eu posso usar para codificar em Lua? A área de texto do /lua não é exatamente o melhor lugar para se codificar, servindo para codificar nada mais do que algumas linhas. As guias não parecem estar corretas por conta da área de texto não ser larga o suficiente para mostrar o código por inteiro, além de não ter realce de sintaxe. Mas por outro lado, existem alguns editores de texto e ambientes de desenvolvimento integrado (IDE) para a linguagem de progração Lua que podem te ajudar. Atom e seu plugin em Lua (IDE, em inglês) NotePad++ (em inglês) Sublime Text (em inglês) ZeroBrane Studio (IDE, em inglês) Visual Studio Code e seu package para a module api. Editores de texto colaborativos Existem várias ferramentas de colaboração/compartilhamento de código em tempo real. Entre eles, destacamos (todos em inglês, com exceção do Google Docs): http://codeshare.io/ - Com Lua syntax highlight Google Docs EtherPad, QikPad e Makinit's Pad - Sites colaborativos de edição de texto que podem ser abertos quando o EtherPad estiver em execução. CollabEdit Sync.in PiratePad Lua Minifiers (minificação/encurtador de código) A minificação faz com que o código se torne menor através de práticas como a remoção de quebras de linha, espaços em branco, renomeação de funções e variáveis locais para alternativas mais curtas, ajudando a reduzir o tamanho total do código. Squish Mothereffin Lua Minifier (web app) Variados Todos em inglês. Lua para Windows (Windows) - Interpretador Lua. Lua Shell (Chrome) - Interpretador Lua. CodePad (Web app) - Interpretador Lua. ComputerCraft - Um programa para MineCraft que adiciona computadores ao jogo onde você pode progamar coisas em Lua.

Créditos:
Kirbyfleur pelo banner ♥
Equipe Lua BR pela ajuda com a elaboração do tópico e da Documentação ♥

Este post contêm uma variedade de informações que lhes pode ser útil ao desenvolver um module.