Memperbarui Neromatic dan Pindah dari Versi Lama

Versi 1.9 membawa banyak perubahan, dan sebagian di antaranya mengubah cara script dijalankan. Kabar baiknya, data tokomu bisa dibawa pindah. Artikel ini menjelaskan apa yang berubah, cara memindahkannya dengan aman, dan hal-hal yang perlu dirapikan setelahnya.

Yang berubah dan perlu kamu ketahui

Library WhatsApp diganti. Versi lama memakai @ryuu-reinzz/haruka-lib, sedangkan versi 1.9 memakai @ryuu-reinzz/luna-lib. Akibatnya kamu wajib menjalankan npm install pada folder baru.

Format owner berubah. Di versi lama, owner ditulis sebagai global.owner di config.js. Sekarang namanya global.owners dan berupa daftar, ditambah global.ownername dan global.nomorbot. Kamu tidak perlu mengisinya manual. Wizard setup akan menanyakannya saat bot dijalankan pertama kali.

Prefix bawaan bertambah. Sekarang !, ,, ., dan prefix kosong. Artinya pembeli bisa mengetik perintah dan kode produk tanpa tanda apa pun. Kalau kamu tidak menginginkannya, hapus dengan .delprefix "".

Perintah berubah nama. Pengaturan buka-tutup toko yang dulu .mode buka dan .mode tutup sekarang menjadi .toko buka dan .toko tutup. Beritahu admin lain yang ikut mengelola tokomu.

Footer pesan dibuat otomatis dari nama toko, jadi tidak perlu diisi manual lagi.

Fitur baru yang aktif otomatis: antispam, ban, voucher, tema classic, dan kode produk. Antispam bisa dimatikan di global.appConfig.antispam kalau kamu belum siap.

Langkah pindah yang aman

Pindah ke folder baru, jangan menimpa folder lama. Dengan begitu kamu selalu punya jalan kembali.

1. Hentikan bot lama, lalu simpan cadangan seluruh foldernya. Pastikan salinan folder database ada di tempat aman.
2. Ekstrak script v1.9 ke folder baru, buka terminal di sana, dan jalankan npm install.
3. Salin data toko. Salin file database/db.json dari folder lama ke folder database di folder baru. Seluruh produk, stok, pesanan, dan data pengguna ikut terbawa. Bagian yang baru seperti voucher, ban, dan daftar notifikasi dibuat otomatis dengan isi kosong.
4. Jalankan npm start. Wizard menanyakan data owner dan toko, lalu menawarkan cara menautkan perangkat.
5. Tautkan perangkat. Kamu bisa mencoba menyalin folder session dari versi lama supaya tidak perlu menautkan ulang. Kalau bot gagal tersambung atau meminta login ulang, hapus folder session dan tautkan lagi lewat QR atau pairing code.
6. Pindahkan pengaturan toko. Jangan menimpa config.js baru dengan yang lama, karena strukturnya berbeda. Pindahkan hanya bagian yang kamu butuhkan, entah dengan mengetik perintahnya di chat (.addpayment, .addfaq, dan sejenisnya), atau dengan menyalin blok global.payment, global.faq, global.thumb, dan global.mess dari file lama ke file baru.

Merapikan produk lama

Produk buatan versi lama belum punya kode produk (slug), fitur yang baru ada di 1.9. Selama belum diatur, daftar produk dan kartu produknya tampil dengan kode yang kosong, dan pembeli tidak bisa mengaksesnya lewat kode. Aturlah satu per satu dengan .editproduk: pilih produk, pilih bagian Slug, lalu masukkan kode yang pendek dan mudah diingat. Bot menolak kode yang sudah dipakai produk atau perintah lain, jadi tidak akan ada bentrok.

Sambil menunggu, coba bukalah .produk dan periksa tiap produk. Ini juga saat yang tepat untuk membereskan kategori yang tidak konsisten dan melengkapi Form Tambahan pada tiap varian.

Setelah pindah, periksa ini

• Kirim .menu dari nomor owner dan pastikan bot merespons.
• Cek .payment untuk memastikan metode pembayaran sudah benar.
• Buka .produk dan lihat apakah semua produk tampil dengan kode yang benar.
• Cek stok produk dinamis lewat .delstok, yang menampilkan jumlah stok tiap varian.
• Lakukan satu pesanan uji sampai tahap invoice dari nomor lain.
• Jalankan .backup pertama dari instalasi baru sebagai titik awal cadangan.

Kalau kamu memodifikasi script

Plugin tambahan buatanmu sendiri perlu diuji sebelum dipakai. Handler utama sudah dipecah menjadi modul di folder lib/, dan konteks yang diterima plugin bisa berbeda dari versi lama. Uji dulu dengan mode .self supaya pembeli tidak ikut terdampak sementara kamu memeriksa.

Menjaga pembaruan ke depan

Biasakan alur yang sama setiap kali memperbarui: cadangkan dulu, ekstrak ke folder baru, jalankan npm install, salin database dan session, lalu uji sebelum membuka kembali untuk umum. Kebiasaan ini membuat setiap pembaruan terasa tenang, bukan menegangkan.