Was ist das Module API?
Das Module API ist ein System, mit dem man Minigames erstellen kann, das in Transformice eingebaut ist. Dadurch können Minigames erstellt werden, ohne dass Bots verwendet werden müssen, indem Scripts ausgeführt werden. Es wurde ursprünglich hier angekündigt: Topic-248549

Was ist ein Modul?
Modul ist der Name für ein Script, das in einem Raum ausgeführt wird. Offizielle Module wurden von dem Administratoren genehmigt und können in jedem Raum gespielt werden, der mit dem Modul-Namen beginnt und mit einer Zahl weitergehnt, z.B. #deathmatch1337 oder #bafflua0bloons.

Was sind die derzeitigen offiziellen Module?
Gib den Befehl /module im Spiel ein um eine Liste der offiziellen Module zu erhalten. Die Nummer nach dem Namen ist die Anzahl der Spieler in allen Räumen, die momentan das Modul verwenden. Es gibt auch eine detaillierte Liste der derzeitigen Minigames, von Icewolfbob zusammengestellt: Topic-52618


Kann ich in den Modul-Räumen Käse sammeln?
Keinerlei Statistiken werden in den Modul-Räumen gewertet, egal ob sie offiziell sind oder nicht. Allerdings kannst du dir ein Maximum von einem Shop-Käse je zwei Minuten verdienen.

Wer kann Module erstellen?
Nur eine ausgewählte Gruppe von Spielern, bekannt als das "Lua Team" kann das Module API verwenden ihndem sie ihre Scripts durch den /lua Befehl laufen lassen. Lua Mitglieder sind freiwillige Helfer und nicht von Atelier 801 angestellt. Moderatoren können auch keine Module laufen lassen.

Wie kann ich dem Lua Team beitreten?
Falls du dem Lua Team beitreten möchtest, musst du von einem Mitglied dem Team empfohlen werden. Du musst flüssig Englisch sprechen können um mit dem Rest des Teams kommunizieren zu können, ein geschätztes Mitglied der Community sein und bereits Wissen im Bereich Lua gesammelt haben.

Wird es je für alle möglich sein, es zu nutzen?
Es wird letztendlich möglich sein, die Scripts in den Stammeshäusern zu benutzen, indem man entweder bereits geschriebene Scripts verwendet oder eigene.

Gibt es irgendwelche Dokumentationen für das Module API?
Die offiziellen Dokumentationen sind im Moment privat, jedoch kann im folgenden Link eine unoffizielle, leicht veraltete Version betrachtet werden, außerdem zwei weitere nützliche Links:
Documentation
Enums - Beinhaltet eine Liste der Schaman Objekte, Bewegungen, Partikel und andere nützliche IDs.
Stylesheet Tags - Allgemein verwendete Farben in Chat Nachrichten.

Was kann man mit dem Module API alles machen?
Im Moment ist vieles möglich, obwohl das API noch in der Entwicklungsphase steckt. Die Beschreibungen können in dem Dokument, das oben verlinkt ist, nachgelesen werden um zu sehen, was möglich ist.

Was kann man mit dem Module API nicht machen?
Unglücklicherweise gibt es etliche Beschränkungen und Dinge können nicht gemacht werden, die einige Minigame Ideen am Fortschreiten hindern. Die größten sind hier aufgelistet:
-Nägel (einschließlich Baloons an Mäusen befestigen)
-Beschwören
-Statistiken speichern (technisch möglich, allerdings würde es sehr unregelmäßig und fehlerhaft arbeiten)
-aus-/einschalten von Schaman Skills
-festsetzen, wer Schaman ist (Schaman wird trotzdem ausgewählt je nachdem wer die meisten Punkte hat)
-Erhalten des Stammes eines Spielers

Kann jemand meine Scripts für mich ausprobieren?
Nur das Lua Team kann Scripts laufen lassen, aber generell machen sie dies nicht für andere Leute.

Was sind die zukünftigen Pläne für das Module API?
Auch wenn nur die Administratoren wissen, was in Zukunft mit den Modulen passiert, wurden schon einige Features bestätigt. Objekte mit Nägeln zu befestigen, eines Spielers Stamm zu bekommen und andere kleine Features werden möglich sein. Es wurde auch diskutiert, dass es eine Form der Integration mit der Community Platform geben soll.

Was ist der Unterschied hiervon zu Bots?
Während Bots durch einen Drittserver zum Spiel verbunden werden müssen und nicht immer garantiert werden kann, dass diese online sind, ist das Module API direkt in das Spiel eingebunden und alle offizielle Module sind immer abrufbar, auch direkt nach einem Server Neustart.
Bots (auch Modbots) haben weniger Rechte in einem Raum und können nur Aufgaben ausführen, die ein normaler Benutzer oder Mod ausführen kann und die nicht für Minigames bestimmt sind.

Welche Karten Perms werden für Module verwendet?
Wegen Problemen mit P0 (normal), P22 (Stammeshaus) und P44 (gelöscht) Karten, die auf dem Server das erste mal nach einem Server Neustart geladen werden, wurde ein neuer Perm Typ eingeführt (P41), der dieses Problem behebt und nun für Module verwendet wird. Karten werden nur zu diesen Perm Karten gemacht, wenn es notwendig ist, und nicht auf Anfrage. Sie zählen nicht als "höhere Perm" Karten.
Module verwenden außerdem Perm Typen, die nicht in der normalen Rotation auftauchen:
P21 - Vampire (Vampire werden zufällig ausgewählt, nicht wie beim normalen Vampir Survivor)
P32 - Dual Schaman
P41 - Minigame/Module Karten

Wo kann ich mir Hilfe holen zum schreiben von Minigame Scripts?
Du kannst in diesem Thread diskutieren und deine Fragen äußern, oder im #tmdevs IRC channel.



Was ist Lua?
Lua (portugiesisch für "Mond") ist eine leichte Programmiersprache, die als Script Sprache verwendet wird, mit erweiterbaren Semantics.

Warum Lua und nicht eine andere Programmiersprache?
Lua ist eine leichte Sprache mit schnell erlernbarem Syntx und wurde gemacht zur Benutzung von APIs wie diesem. Es ist weit bekannt und hat viele online Dokumentationen.

Wo kann ich Lua lernen?
Es gibt im Internet viele Stellen, wo Lua gut erklärt wird und es gibt auch viele Tutorials für Anfänger.
Official Lua Website
Lua Reference Manual
Lua Users Wiki
Lua Unofficial FAQ
Lua for Beginners Tutorial
Learning Lua Guide
Quick overview of Lua

Mit welchen Programmen kann ich Lua Codes schreiben?
Das eingebaute Textfeld im /lua Fenster ist nicht besonders gut zum Programmieren von mehr als ein paar Zeilen geeignet. Es gibt keine Zeilennummerierung, normale Tabs scheinen nicht zu funktionieren, es ist nicht groß genug um den Code komplett zu sehen, es hat keine Syntaxhervorhebung, um nur ein paar Punkte zu nennen. Du kannst mit jedem Text Editor arbeiten, es gibt aber auch einige externe Text Editoren oder integrierte Entwicklungsumfelder, mit denen es gut funktioniert:
Eclipse mit Lua Development Tools oder Lua Eclipse (IDE)
Lua Edit (IDE)
NotePad++
Sublime Text

Gemeinschaftliche Text Editors
Wenn du gerne mit jemand anderem in Echtzeit zusammen arbeiten und programmieren möchtest, gibt es online etliche Tools, mit denen du dies tun kannst.
Stypi - Echte Tabs (nicht einfach 4 Leerzeichen), Syntaxhervorhebung, viele Layouts und Features, Speichern und Privatmachen von Dokumenten, Echtzeitchat.
CodeShare - Hat Lua Syntaxhervorhebung.
Google Docs
EtherPad, QikPad - Gemeinschaftliche Textbearbeitungsseite, die mit der Open Source EtherPad software läuft.
CollabEdit
Sync.in
PiratePad

Lua Verkleinerer
Da es eine 32k Zeichen Beschränkung gibt, wenn man einen Code mit dem Module API laufen lassen will, müssen lange Scripts verkleinert werden. Verkleinerer machen den Code kürzer indem sie zB
Minification makes the code smaller through practises such as removing linebreaks, whitespace, renaming functions and local variables to shorter alternatives, and the such to help reduce the overall size.
Squish
Mothereffin Lua Minifier (web based)

Was für Lua Hilfsmittel gibt es noch?
Lua for Windows (Windows) - Lua Übersetzer.
Lua Shell (Chrome) - Lua Übersetzer.
CodePad (Web) - Lua Übersetzer.
Keycodes - Eine Liste von Tastenkombinationen und deren entsprechend zu benutzenden Zeichen in Lua.
ComputerCraft - Eine Modifiation für MineCraft, die Computer zum Spiel hinzufügt, auf denen du in Lua programmieren kannst.

Gibt es ein paar Beispiele für Scripts?
Es gibt viel mehr Möglichkeiten als man hier sehen kann, aber diese Beispiele geben einen kurzen Einblick, was man alles mit Lua programmieren kann und wie der Syntax strukturiert ist.

Ice players when they get cheese a dit :

function eventPlayerGetCheese(playerName)
tfm.exec.killPlayer(playerName)
tfm.exec.addShamanObject(tfm.enum.shamanObject.iceCube,tfm.get.room.playerList[playerName].x,tfm.get.room.playerList[playerName].y)
end

Spawn 2 balls at random places on the X axis every half a second a dit :

function eventLoop()
for 1,2,1 do tfm.exec.addShamanobject(6,math.random(1,799),100) end
end

Help command a dit :

function eventChatCommand(playerName,command)
if command=="help" then
tfm.exec.chatMessage("<J>Here's some help for you!",playerName)
end
end

Greet a new player when they join a dit :

function eventNewPlayer(playerName)
tfm.exec.chatMessage("<J>Welcome to this awesome minigame!",playerName)
end

Kill everyone with cheese a dit :

for playerName,player in pairs(tfm.get.room.playerList) do
if player.hasCheese then
tfm.exec.killPlayer(playerName)
end
end

Flying when tapping space a dit :

function eventNewGame()
for playerName in pairs(tfm.get.room.playerList) do
tfm.exec.bindKeyboard(playerName,32,true)
end
end
function eventKeyboard(playerName,keyCode)
if keyCode==32 then
tfm.exec.movePlayer(p,0,0,true,0,-50,true)
end
end

Credits to Shamousey for the original thread :) Topic-365251

-Plätzchenhalter-

Cir das hast du sehr sehr gut gemacht :)

waren hier mal *#transforcows? ich suche sie die ganze zeit D':

das gab es wirklich mal... ich suche auch immer nach diesen scheiß xD

*#transforcows, war ne Art Demo von einem Modul,
aber weil es für niemanden mehr verfügbar ist,
haben es die Macher des Modules oder die Admins wohl wieder entfernt.

PS: Solche Fragen könnt ihr besser im Fragen und Antworten-Thread stellen, da es mit diesen Thread
eigtl. nichts zu tun hat.
Topic-369340