valor.js
v12.8.0
Published
Türk Discord bot geliştiricileri için komut yükleyici ve müzik sistemi olan NPM kütüphanesi.
Downloads
53
Maintainers
Readme
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ımMüzik komutlarını ve açıklamalarını gösterir.
!sıraSıradaki şarkıları gösterir.
!oynatSıraya şarkı ekler. Kullanım: !oynat <şarkı-adı-veya-link>
!oynatma-listesiSıraya oynatma listesi ekler.
!sıradan-çıkarSıradaki bir şarkıyı sıradan çıkarır.
!atlaMevcut çalınan şarkıyı atlar!
!durdurŞarkıyı durdurur ve sırayı temizler.
!sesMüziğin ses seviyesini değiştirir. Kullanım: !ses <0 ile 100 arasında bir sayı>