Valor.JS

Türk Discord bot geliştiricileri için komut yükleyici ve müzik sistemi olan Discord framework'ü.

Kurulum

npm install valor.js

Kullanım

Komut Yükleyici

1 - Komut yükleyiciyi kullanmak için aşağıdaki gibi yeni bir KomutYukleyici oluşturun ve ayarları tanımlayın.

const valorJS = require("valor.js"); // Valor.JS'yi 'valorJS' olarak tanımlar.

const komutYukleyici = new valorJS.KomutYukleyici({ // Yeni bir 'KomutYukleyici' oluşturur.
    klasor: __dirname + '/komutlar/', // Komutların bulunduğu klasörü ayarlar.
    prefix: ['!', '?'] // Komutların prefix(ler)'ini ayarlar.
});

2 - Sonrasında message event'inin içine basit bir komut tanımlaması yapın.

bot.on("message", (mesaj) => {

    if (mesaj.channel.type === 'dm') return; // Bu komutların DM'den kullanılmasını engeller. Böyle olmasını istemiyorsanız bu satırı silebilirsiniz.
    if (mesaj.channel.type === 'bot') return; // Bu komutların botlar tarafından kullanılmasını engeller. Bu kod botun güvenliği ve düzeni için çok önemlidir! 
    let args = mesaj.content.split(" "); // Bu argümanları tanımlar. Örnek: !yazdır <1. argüman>
    let komut = args[0]; // Komutun ilk argüman olduğunu tanımlar. Örnek: !yazdır <yazdırılacak-şey> - !yazdır komutu 0. argümandır, <yazdırılacak-şey> ise 1. argümandır.
    let cmd = komutYukleyici.getCommand(komut); // komut değişkenini komut yükleyiciye bir komut olarak tanımlar.
    if (!cmd) return; // Eğer mesaj bir komut değilse botun hiçbir şey yapmamasını sağlar. Fakat sizin ayarladığınız oto mesajlar vb. çalışacaktır.

    try {
        cmd.run(bot, mesaj, args)
    } catch(hata) {
        console.log(hata) // Eğer komut yükleyicide bir hata var ise konsole log olarak yazdırır.
    }
});

Komut Oluşturma

1 - Komutlar klasörü olarak tanımladığınız klasöre test.js isimli bir JavaScript dosyası oluşturun. Sonra test.js'nin içine aşağıdaki kodu yazarak test.js'yi bir komut olarak tanımlayın.

module.exports = class test { // test adlı bir sınıf oluşturun ve onu module.exports ile diğer dosyaların kullanımına açın.
    constructor(){
            this.isim = 'test', // Komutun ismini girin. (Komutun kullanımıdır)
            this.alternatif = ['t', 'test-komutu'], // Komutu başka komut ismi kullanarak kullanmanıza sağlar. Eğer alternatif eklemek istemiyorsanız: this.alternatif = [],
            this.usage = '?test' // Komutun kullanımını girin. (Sadece komutun kullanımını normal bir cümleymiş gibi tanımlar ve komutun kullanımını etkilemez. Genel olarak yardım komutu için kullanılır.)
    }
 
    async run(bot, message, args) {
        await message.delete(); // Komut kullanıldıktan sonra komutu tetikleyen mesajı sil.
        message.reply(this.isim + " çalıştı!") // Eğer komut başarılı bir şekilde çalıştıysa 'test çalıştı!' mesajı göndermesi lazım.
    }
}

Müzik Sistemi

Valor.JS size çok kolay ve hızlı bir şekilde gelişmiş ve performanslı bir müzik botu kurmanıza olanak sağlar.

const muzikBotu = new valorJS.MuzikBotu({ // Yeni bir `MuzikBotu` oluşturur
    googleKey: 'google anahtarınız', // Google API Anahtarınızı tanımlar. https://console.developers.google.com/apis/credentials?hl=TR sayfasından anahtar alabilirsiniz.
    discordToken: 'tokeniniz', // Bot tokeninizi tanımlar. Eğer müzik botunuzu ayrı bir bot olarak kullanıyorsanız ayrı olarak kullandığınız müzik botunuzun tokenini girebilirsiniz.
    prefix: '!' // Prefixi tanımlar. Default değer olarak prefix '!!'dir.
});

muzikBotu.start(); // Müzik botunu başlatır.

Müzik Sistemi Komutları

!şarkı
Mevcut çalınan şarkıyı gösterir.
!yardım
Müzik komutlarını ve açıklamalarını gösterir.
!sıra
Sıradaki şarkıları gösterir.
!oynat
Sıraya şarkı ekler. Kullanım: !oynat <şarkı-adı-veya-link>
!oynatma-listesi
Sıraya oynatma listesi ekler.
!sıradan-çıkar
Sıradaki bir şarkıyı sıradan çıkarır.
!atla
Mevcut çalınan şarkıyı atlar!
!durdur
Şarkıyı durdurur ve sırayı temizler.
!ses
Müziğin ses seviyesini değiştirir. Kullanım: !ses <0 ile 100 arasında bir sayı>

Valor.JS, Valor#2370 tarafından bulunmuş, yapılmış ve geliştirilmektedir. Yardım için Discord kullanıcı adım: Valor#2370