[HowTo] Wie erstelle ich meinen EIGENEN Twitch Bot ( Updated )

const Owner    = 'HierDerChannelNameInDemGejointWerdenSoll'; // wir speichern unseren Channel namen in eine Konstante


const Bot      = 'HierDerBotChannelName'; // das selbe gilt für den bot
const BotOAuth = 'HierDerOAuthDesBots' // diesen erhaltet ihr auf https://twitchapps.com/tmi/


const Channels = [Owner]; // hier könnten noch mehr channel eingetragen werden wo der bot joinen soll aber es reicht ja unserer! deswegen braucht ihr hier nichts verändern


// *************************************************************
// **** NACH DIESER LINIE BRAUCHT IHR NICHS MEHR ÄNDERN ********
// *************************************************************


var tmi = require('tmi.js');


var options = {
	options: {
		debug: true
	},
	connection: {
		secure: true,
		reconnect: true
	},
	identity: {
		username: Bot,
		password: BotOAuth
	},
	channels: Channels
};


var client = new tmi.client(options);
client.connect();


// wenn der bot zum chat verbindet
client.on('connected', function(adress, port){
    console.log("Adresse: " + adress + " Port: " + port); // gibt eine nachricht in der konsole aus damit man sieht das der bot verbunden ist
    // ausgabe im chat das man erkennt das der Bot verbunden ist ( könnte auch weg gelassen werden ) *naaa wer versteht die anspielung :p* 
    client.say(Owner, "Arbeit Arbeit!"); // achtung hier wird angegeben in welchem chat geschrieben wird ... nicht wer schreibt ! ( da gab es einige missverständnisse im original post )
});

module.exports = {
    run: function(client, channel, user, message, _self) {


        // da eine nachricht mehr als nur das command entahlten kann splitten wir uns diese und suchen das command
        var   msg     = message.split(' '), // teilen der nachricht an leerzeichen und speichern diese in ein array ( eine variable weil wir dieses nochmal anpassen müssen )
              command = msg[0].toLowerCase(); // das command befindet sich im normalfall an 1 stelle ( also 0 weil array immer bei 0 beginnen ) wir speichern es un in kleinschreibung
        msg.shift();  // die restlichen teile sind die argumente ( wenn man z.b. !kill <name> angibt ist <name> ein argument) also entfernen wir den command und haben nur noch die argumente
        var args = msg, // nicht unbedingt nötig aber so machen wir uns das übersichtlicher und speichern die argumente und die args variable
            // hier kommen 3 variablen die später für commands praktisch sind wenn es für bestimmte user gruppen sein soll :D
             isMod   = user.mod, // ja wir können abfragen ob der user mod ist oder nicht ;)
             isSub   = user.subscriber, // jhuhuu er ist sub ... oder doch nicht ? die variable sagt es uns :D
             isTurbo = user.turbo, // hat der user Twitch turbo oder nicht ( keine ahnung wofür man das brauchen könnte aber hey nun haben wir es )
             userName = user.username; // hier ist der komplette name klein geschrieben


        // HIER starten jetzt die commands ! JUHUU ;D


    }
}

switch(command) { 
            // **************************************************** 
            // Der erste command
            // ****************************************************


            case '!test' :
                client.say(channel, "bestanden"); // ausgabe im chat ( channel reicht als variable da wir ja in verschiedenen channels sitzen können übergeben wir den in dem der command ausgeführt wurde )
            break;




            // **************************************************** 
            // Der zweite command
            // ****************************************************


            case '!test2' :
                client.say(channel, "auch bestanden"); // ausgabe im chat ( channel reicht als variable da wir ja in verschiedenen channels sitzen können übergeben wir den in dem der command ausgeführt wurde )
            break;




            // **************************************************** 
            // Der dritte und vierte command
            // ****************************************************


            // sollte man das break; weg lassen werden darunterliegende commands auch ausgeführt ( wofür auch immer man das benötigt aber es geht :D )


            case '!test3' :
                client.say(channel, "test 3 bestanden");
            case '!test4' :
                client.say(channel, "test 4 ? oder doch erst 3");
            break;


        }

// wir erstellen uns eine coldown variable auserhalb des moduls damit sie beim aufruf nicht immer resettet wird.
// und definieren die einzelnen cooldowns vor ( javascript hat sich etwas affig wenn wir etwas setzen wollen was nicht definiert ist )
var lastRun = []; 
    lastRun['global']   = 0;  // wann wurde irgendein command zuletzt ausgeführt ( hier 0 weil nie :D )
    lastRun['commands'] = []; // wann wurde ein bestimmter command zuletzt ausgeführt ( ein leeres array weil wir hier nich nicht wissen was genau drin stehen wird )
    lastRun['user']     = []; // wann wurde ein bestimmter command von einem bestimmten user zuletzt ausgeführt ( ein leeres array weil wir hier nich nicht wissen was genau drin stehen wird )


var globalCooldown   = 2, // globaler cooldown in sekunden ... wie lang ist die pause bis der bot im allgemeinen auf commands reagiert ( spam protection ) 
    commandCooldown  = 0, // command cooldown in sekunden ... wie lang ist die pause bis ein command wieder getrigert werden darf ( hier 0 weil wir diesen pro command anpassen )
    userCooldown     = 0; // user cooldown in sekunden ... wie lang ist die pause bis ein user den command wieder triggern darf ( hier 0 weil wir diesen pro command anpassen )

// HIER starten jetzt die commands ! JUHUU ;D


if (lastRun['global'] + globalCooldown <= curentTimestamp) { // prüft ob der globale cooldown schon abgelaufen ist
    switch(command) {
        // **************************************************** 
        // Der erste command
        // ****************************************************


        case '!test' :
            botMessage = 'bestanden'; // die nachricht die gesendet werden soll
        break;


    }
} else { // das else sollte man weg lasen und ist nur zu Demonstrationszwecken drin ( sonst hat die spam Protektion keinen sinn )
    botMessage = 'sry @' + userName +' Globaler cooldown'; // die nachricht die gesendet werden soll
}


if (botMessage !== false) { // prüft ob überhapt eine nachricht zu senden ist
    client.say(channel, botMessage); // ausgabe im chat ( channel reicht als variable da wir ja in verschiedenen channels sitzen können übergeben wir den in dem der command ausgeführt wurde )
    lastRun['global'] = curentTimestamp; // setzt den last run für den global cooldown
}

case '!test' : // mit cooldown für den command
     commandCooldown = 5; // in sekunden command cooldown ( gilt nur für diesen command )
     // vordefinieren der variable wenn sie noch nicht exisitert ... ( wie bereits erwähnt ist javascript da etwas pingelig :D )
     lastRun['commands'][command] = (lastRun['commands'][command] != undefined) ? lastRun['commands'][command] : 0;


     if (lastRun['commands'][command] + commandCooldown <= curentTimestamp) { // prüfen ob der command cooldown schon abgelaufen ist
         botMessage = 'bestanden'; // die nachricht die gesendet werden soll
         lastRun['commands'][command] = curentTimestamp; // speichern des aktuellen Timestamps im lastrun des commands
     } else { // wenn nicht sag dem user bescheid ( sollte man nur machen wenn es ein langer cooldown ist um spam zu vermeiden )
         botMessage = 'sry @' + userName + ' dieser command hat noch Cooldown'; // die nachricht die gesendet werden soll
     }
break;

case '!test' : // mit user cooldown
    userCooldown    = 120; // cooldown für einzelne user in sekunden ( gilt nur für diesen command )
    // und wieder müssen wir uns die variablen vor definieren da wir hier ein array im array haben das ganze zwei mal
    lastRun['user'][userName] = (lastRun['user'][userName] != undefined) ? lastRun['user'][userName] : [];
    lastRun['user'][userName][command] = (lastRun['user'][userName][command] != undefined) ? lastRun['user'][userName][command] : 0;
    if (lastRun['user'][userName][command] + userCooldown <= curentTimestamp) { // prüfen ob der user cooldown abgelaufen ist
        botMessage = 'bestanden'; // die nachricht die gesendet werden soll
        lastRun['user'][userName][command] = curentTimestamp;
    } else { // wenn nicht sag dem user bescheid ( sollte man nur machen wenn es ein lange cooldown ist um spam zu vermeiden )
        botMessage = 'sry @' + userName + ' dieser command hat für dich noch Cooldown'; // dier nachricht die gesendet werden soll
    }
break;

if (lastRun['user'][userName][command] + userCooldown <= curentTimestamp) { 
// mach was
}


// zu


if (lastRun['user'][userName][command] + userCooldown <= curentTimestamp || isMod) { 
// mach was
}

case '!random' : 
    var randomStrings = [ // hier speichern wir uns die antwortmöglichkeiten in ein array
        'antwort 1', 
        'antwort 2', 
        'antwort 3'
    ],


    randomString = randomStrings[Math.floor(Math.random()* randomStrings.length)]; // hier wählen wir zufällig einen eintrag aus dem zuvor erstellten array
    botMessage = randomString;
break;

case '!kill' : // z.b. !kill <name>
    var targetName = args[0], // da wir nur ein argument übergeben wissen wir es ist an position 0 ( hier kann theoretisch alles angegeben werden nicht unbedingt ein name )
    randomStrings = [ // hier speichern wir uns wieder random texte diese mal mit platzhaltern die wir ersetzen {{ATTACKER}} und {{TARGET}}
        '{{ATTACKER}} bewirft {{TARGET}} mit Wattebällchen bis er/sie blutet!', 
        '{{ATTACKER}} zieht sein Quitschehammer und rennt auf {{TARGET}} zu ... *QUITSCH* mist daneben!', 
        '{{ATTACKER}} bewirft {{TARGET}} mit gummiebärchenbomben.'
    ],
    randomString = randomStrings[Math.floor(Math.random()* randomStrings.length)]; // hier wird wieder der zufällige text gewählt
    randomString = randomString.replace('{{ATTACKER}}', userName); // mit replace ersetzen wir uns {{ATTACKER}} mit dem usernamen der den command ausführt
    randomString = randomString.replace('{{TARGET}}', targetName); // hier ersetzen wir uns {{TARGET}} mit dem argument0 in diesem fall der name der angegeben wurde
    botMessage = randomString;
break;

var commands   = require('./commands');
client.on('chat', function(channel, user, message, _self) { 
    if(_self) return;
    commands.run(client, channel, user, message, _self);
});




var subs = require('./subs'); // <--- hier die neue subs datei
client.on("subscription", (channel, user, method, message, userstate); { 
    subs.run(channel, user, method, message, userstate);
});