ShikimoriBotz

Warning

Script ini tidak untuk di jual! Harap hargai developers karena tujuan pembuatan script ini adalah agar semua orang bisa pakai dengan gratis!

Fitur

• Ringan dan Cepat
• Button Response
• Simple
• Support Case
• Support Plugin
• Support CommonJS
• Support ESM

Dokumentasi

Semua perintah bot ada pada file case.js, Dan juga untuk menu, Disini saya membuat agar lebih praktis dan tidak perlu lagi menambahkan menu secara manual, Disini ada yang namanya dekorasi @Category, dekorasi ini bisa memasukan setiap perintah ke dalam kategori menu.

Berikut adalah cara pemakaian @Category:

Type Case

/** @Category ("yourCategory", "your alias of commands", "your_command", "Description of Command heres") */
case "your_command": {
  // Rest of your code...
}
break;

Untuk contoh lebih lengkap, Silahkan lihat pada file case.js

Tidak ada @Category untuk tipe plugin. Sebagai gantinya kamu bisa memakai format seperti berikut:

Type Plugin CJS ( plugin.cjs atau plugin.js )

module.exports = (handler) => {

  handler.add({
    cmd: ["ping"], // Perintah
    cats: "Testing", // Kategori
    alias: "Ping untuk Testing", // Alias
    desc: "Testing", // Deskripsi
    
    run: async ({ m }) => { // Kode yang akan dijalankan
      m.reply("Pong");
    }
  })

}

Type Plugin ESM ( plugin.mjs )

export default (handler) => {

  handler.add({
    cmd: ["ping"], // Perintah
    cats: "Testing", // Kategori
    alias: "Ping untuk Testing", // Alias
    desc: "Testing", // Deskripsi
    
    run: async ({ m }) => { // Kode yang akan dijalankan
      m.reply("Pong");
    }
  })

}

Untuk contoh lebih lengkap, Silahkan lihat pada file exPlugin.js atau ping.js

Tip

Khusus untuk plugin, Folder yang memiliki awalan tanda __ contoh __example tidak akan ditampilkan pada menu, atau plugin dalam keadaan nonaktif. Ini juga bekerja untuk file maupun folder, __folder __file.js

Dokumentasi @Category untuk tipe Case

Struktur @Category untuk Case

/** @Category ("Kategori", "Alias Perintah", "Perintah", "Deskripsi Perintah") */

Validasi dan Persyaratan

Warning

Perhatikan struktur dan urutan parameter dengan ketat!

• Parameter 1 (Kategori):

  • Wajib diisi
  • Gunakan huruf kapital di awal
  • Contoh: "Downloader", "Tools", "Utility"

• Parameter 2 (Alias):

  • Nama yang akan ditampilkan di menu
  • Bisa menggunakan spasi
  • Contoh: "Downloader YouTube", "Downloader TikTok"

• Parameter 3 (Perintah):

  • Perintah yang sebenarnya untuk eksekusi
  • Gunakan huruf kecil
  • Hindari spasi
  • Contoh: "ytmp3", "tiktok"

• Parameter 4 (Deskripsi):

  • Jelaskan fungsi perintah
  • Maksimal 50-60 karakter
  • Gunakan bahasa yang jelas

Important

• Selalu gunakan tanda kutip ""
• Urutan parameter tidak boleh berubah
• Pisahkan parameter dengan koma

Contoh yang Benar ✅

/** @Category ("Downloader", "Download YouTube Audio", "ytmp3", "Unduh audio dari YouTube dengan mudah") */
case "ytmp3": {
  // Implementasi perintah
}
break;

Contoh yang Salah ❌

/** @Category ("ytmp3", "Downloader", "Download YouTube", "Unduh audio") */ // Salah urutan!

Kesalahan Umum

• Lupa menambahkan salah satu parameter
• Menukar urutan parameter
• Menggunakan tipe data selain string
• Menggunakan karakter khusus yang tidak perlu

Tip

Selalu periksa kembali dekorator @Category Anda sebelum commit!

Debugging

Jika @Category tidak terdeteksi:

1. Periksa struktur dekorator
2. Pastikan tidak ada kesalahan pengetikan
3. Cek urutan parameter
4. Gunakan console.log untuk memverifikasi

Konfigurasi Plugin

Jika pluginmu punya banyak cmd seperti ini, dan males ngasih alias untuk masing masing cmdnya, silahkan pakai format berikut

handler.add({
    cmd: [
      'glitchtext',
      'writetext',
      'advancedglow',
      'typographytext'
    ],
    cats: "Tools", // Kategori

    // cmd yang diterima akan berurutan sesuai pada cmd di atas, contoh:
    // iterasi pertama - glitchtext
    // iterasi kedua   - writetext
    // iterasi ketiga  - advancedglow
    // Semua properti
    // cmd - cmd saat ini sesuai urutan command diatas
    // fcmd - semua cmd ( berbentuk array )
    // cats - kategori saat ini
    alias: ({ cmd }) => toUpper(cmd), // cmd disini mengacu pada command di atas ^ jadi kita ambil lagi value cmdnya dan memproses datanya untuk dijadikan alias
    desc: "Membuat foto text",

    run: async ({ m, cmd, text, ditz }) => {
      if (!text) return m.reply("Mana teksnya?");

      const model = getModel(cmd);
      const image = await ephoto(model, text);

      await ditz.sendImage(m.chat, image, "Ini fotonya", m.fq);
    }
  })

Untuk contoh lebih lengkap, Silahkan lihat pada file ephoto.js

Note

untuk versi case, jika kamu memiliki permasalahan serupa seperti ini, coba tumpuk case nya manual case "c1" : case "c2": case "c3": {}

Properti lain untuk plugin

interface IParams {
  m: any; // Seriaze
  cmd: string; // Input command dari user
  text: string; // Query setelah command
  ditz: any; // Socket
}

type IProperti = {
  cats: string[];
  alias: string;
  desc: string;
  owner: boolean; // Hanya izinkan owner
  premium: boolean; // Hanya user premium

  run: (params: IParams) => void;
};

Kontribusi

Jika Anda ingin berkontribusi mulai dari menambahkan fitur, Memperbaiki Bugs, dan lain lain, PR Selalu terbuka!

Donasi

Donasikan sedikit uang Anda agar saya lebih semangat membuat project menakjubkan Lainnya! Donasikan lewat Saweria

Script ini akan terus diUpdate setiap harinya ( Munkin:v ). Kalau ada error atau bug segera laporkan ke atmin.