Efek Gabungan for YMM4 — Panduan Pengguna

Versi: 2.2.0 / OS yang Didukung: Windows 10 / 11 (64bit) / Runtime: .NET 10.0

1. Ikhtisar

«Efek Gabungan» adalah plugin efek video untuk YukkuriMovieMaker4 (YMM4). Plugin ini memungkinkan Anda menyimpan beberapa efek video dalam satu item «Efek Gabungan» dan mengelolanya melalui pengelompokan, penyimpanan prasetel, dan pemanggilan kembali.

Fitur utama:

Menerapkan beberapa efek secara berurutan dalam satu item
Menyimpan, memanggil, dan berbagi prasetel dengan nama
Kelola beberapa konfigurasi efek dengan tab dan beralih seketika (mendukung tambah, hapus, dan ganti nama)
Mengatur prasetel dengan tiga jenis grup virtual: Semua, Terbaru, dan Favorit
Riwayat cuplikan dan manajemen cabang bergaya Git
Penulisan atomik dengan verifikasi CRC32 dan persistensi multi-redundan SHA-256
Ekspor dan impor file paket prasetel (.ceprstpkg)
Salin, potong, dan tempel berbasis clipboard
Pencarian multi-sumbu dengan dukungan ekspresi reguler
Antarmuka dalam 8 bahasa (Jepang, Inggris, Tionghoa Sederhana, Tionghoa Tradisional, Korea, Spanyol, Arab, Indonesia)
Antarmuka responsif yang otomatis beralih ke tata letak mobile di bawah lebar 400px

Label linimasa menampilkan jumlah efek saat ini dan nama prasetel yang diterapkan, misalnya «Efek Gabungan Aktif: 3 [NamaPrasetel]», sehingga memudahkan identifikasi konten sekilas.

Output AviUtl (.exo) tidak didukung.

2. Persyaratan Sistem

Item	Persyaratan
OS	Windows 10 / 11 (64bit)
YukkuriMovieMaker4	Versi terbaru direkomendasikan
Runtime	.NET 10.0
GPU	GPU kompatibel Direct2D

3. Instalasi

Unduh file .ymme terbaru dari halaman Releases di GitHub.
Pastikan YMM4 tidak sedang berjalan.
Klik dua kali file .ymme yang diunduh untuk menginstalnya.
Jalankan YMM4 dan pilih item di linimasa.
Pilih «Efek Gabungan» dari menu Tambah Efek Video.

Setelah instalasi, panel manajemen prasetel dan daftar efek akan muncul di panel properti.

4. Memulai

Pilih item video atau gambar di linimasa.
Tambahkan «Efek Gabungan» dari menu Tambah Efek Video.
Tambahkan dan konfigurasikan efek di bagian «Efek Aktif» di bagian bawah panel properti.
Klik tombol «+ (Tambah)» di panel manajemen prasetel, masukkan nama, dan simpan prasetel.
Untuk menerapkan konfigurasi yang sama pada item lain, pilih prasetel dan klik tombol «✓ (Terapkan)».

5. Tata Letak Antarmuka

Panel properti menampilkan bagian-bagian berikut dari atas ke bawah.

5-1. Panel Manajemen Prasetel (PresetManagerControl)

Ini adalah area utama untuk mengelola prasetel, dibagi menjadi dua kolom.

Area	Keterangan
Kolom kiri (daftar grup)	Menampilkan grup yang ditentukan pengguna dan grup virtual (Semua, Terbaru, Favorit). Klik untuk memilih, klik dua kali untuk mengganti nama, seret dan lepas untuk mengurutkan ulang (grup virtual tidak dapat dipindah). Gunakan tombol + untuk menambah grup dan tombol - untuk menghapusnya.
Atas kolom kanan (bilah pencarian)	Memfilter prasetel berdasarkan kata kunci. Klik ikon di kanan untuk mengubah target pencarian.
Tengah kolom kanan (daftar prasetel)	Mencantumkan prasetel di grup yang dipilih. Setiap baris menampilkan bintang (toggle favorit), nama, jumlah efek, dan ikon info (tooltip menampilkan daftar efek). Pemilihan berganda (Ctrl+klik, Shift+klik) didukung.
Bawah kolom kanan (tombol aksi)	Dari kiri: Tambah (+), Hapus (-), Perbarui (↺), Terapkan (✓). Tombol memperluas labelnya saat hover.
Gagang ubah ukuran bawah	Seret untuk mengubah tinggi panel.

5-2. Pembagi Kisi

Seret batas antara dua kolom untuk menyesuaikan lebar kolom grup. Nilai dipulihkan saat startup berikutnya.

5-3. Tata Letak Mobile (di bawah 400px lebar)

Saat lebar kontrol turun di bawah 400px, daftar grup disembunyikan dan tombol menu hamburger (≡) muncul. Mengkliknya membuka daftar grup sebagai popup.

5-4. Manajemen Tab Efek (EffectTabManagerControl)

Bilah tab ditampilkan di atas «Efek Aktif». Setiap tab menyimpan konfigurasi efek yang terpisah, dan saat tab diganti, isi tab terpilih langsung diterapkan.

Tombol + di kanan: «Tambah Tab»
Tombol × pada tiap tab: «Hapus Tab» (tab pertama «Baru» tidak bisa dihapus)
Klik dua kali nama tab: ganti nama (Enter atau pindah fokus untuk konfirmasi, Esc untuk batal)
Nama tab default: pertama «Baru», lalu «Tab 2», «Tab 3», ...

5-5. Efek Aktif (VideoEffectSelector)

Pemilih efek video standar YMM4 menampilkan efek dari tab yang sedang dipilih. Operasi tambah, hapus, urut ulang, aktif/nonaktif di sini disimpan ke tab tersebut.

6. Manajemen Grup

Prasetel dapat diorganisir ke dalam grup. Ada «grup nyata» dan «grup virtual».

6-1. Menambahkan Grup

Klik tombol «+» di bagian bawah daftar grup.
Masukkan nama grup di kotak dialog dan klik «OK».
Grup baru ditambahkan ke daftar dan dipilih secara otomatis.

6-2. Menghapus Grup

Pilih grup yang ingin dihapus dari daftar grup.
Klik tombol «-» di bagian bawah daftar grup.
Klik «OK» di kotak konfirmasi untuk menghapus grup beserta semua prasetelnya.

Catatan: Grup «Bawaan» dan grup virtual (Semua, Terbaru, Favorit) tidak dapat dihapus.

6-3. Mengganti Nama Grup

Gunakan salah satu metode berikut:

Klik dua kali pada grup untuk membuka kotak dialog dan masukkan nama baru.
Klik kanan pada grup dan pilih «Ganti Nama» dari menu konteks.

Catatan: Grup virtual tidak dapat diganti namanya.

6-4. Mengurutkan Ulang Grup

Seret dan lepas grup nyata untuk mengubah urutannya. Grup virtual selalu berada di bagian atas daftar dan tidak dapat dipindah.

7. Manajemen Prasetel

7-1. Menambahkan Prasetel (Menyimpan)

Atur efek yang ingin disimpan di «Efek Aktif».
Pilih grup tujuan di daftar grup (jika grup virtual dipilih, akan disimpan ke grup nyata pertama).
Klik tombol «+ (Tambah)» di bagian bawah kolom kanan.
Masukkan nama prasetel di kotak dialog dan klik «OK».
Konfigurasi efek saat ini disimpan sebagai prasetel dan ditambahkan ke daftar.

7-2. Menghapus Prasetel

Pilih prasetel yang akan dihapus (Ctrl+klik atau Shift+klik untuk multi-pilih).
Klik tombol «- (Hapus)» atau klik kanan dan pilih «Hapus».
Klik «OK» di kotak konfirmasi untuk menghapus.

Memilih beberapa prasetel dan menghapusnya akan menghapus semua prasetel yang dipilih sekaligus.

7-3. Mengganti Nama Prasetel

Klik dua kali pada prasetel untuk membuka kotak dialog dan masukkan nama baru.
Klik kanan dan pilih «Ganti Nama».

7-4. Mengosongkan Prasetel (Mengosongkan Isi)

Menghapus semua efek yang tersimpan dalam prasetel, membiarkan prasetel kosong. Prasetel itu sendiri tetap ada.

Klik kanan pada prasetel yang dituju.
Pilih «Kosongkan Prasetel» dari menu konteks.
Klik «OK» di kotak konfirmasi.

7-5. Mengurutkan Ulang Prasetel

Seret dan lepas prasetel dalam daftar untuk mengubah urutannya. Pengurutan ulang tidak tersedia saat menampilkan grup virtual (Semua, Favorit, Terbaru).

8. Grup Virtual

Grup virtual adalah grup khusus yang selalu muncul di bagian atas daftar grup. Grup ini tidak dapat dihapus, diganti namanya, atau diurutkan ulang.

Nama Grup	Isi	Urutan
Semua	Menampilkan semua prasetel dari semua grup nyata.	Abjad (menaik)
Terbaru	Menampilkan 10 prasetel yang baru-baru ini diterapkan.	Terbaru diterapkan lebih dulu
Favorit	Menampilkan semua prasetel yang ditandai bintang.	Abjad (menaik)

Saat grup virtual dipilih dan Anda menambahkan atau menempel prasetel, prasetel tersebut disimpan ke grup nyata pertama.

9. Menerapkan Prasetel

9-1. Menerapkan Satu Prasetel

Pilih prasetel yang ingin diterapkan dari daftar.
Klik tombol «✓ (Terapkan)» atau klik kanan dan pilih «Terapkan».
Konfigurasi efek prasetel dimuat ke item di linimasa.

Menerapkan prasetel yang sama lagi: Jika Anda mencoba menerapkan prasetel yang isinya identik dengan efek saat ini, kotak konfirmasi akan muncul. Klik «OK» untuk menambahkan (menumpuk) efek di atas yang sudah ada. Klik «Batal» untuk membatalkan.

9-2. Menerapkan Beberapa Prasetel Sekaligus

Pilih beberapa prasetel menggunakan Ctrl+klik atau Shift+klik.
Klik tombol «✓ (Terapkan)».
Efek dari semua prasetel yang dipilih digabungkan secara berurutan dan diterapkan.

Tidak ada kotak konfirmasi duplikat yang ditampilkan untuk multi-pilih. Juga, saat 2 atau lebih prasetel dipilih, daftar «Terbaru» dan JSON prasetel tidak diperbarui.

9-3. Pembaruan Label Setelah Penerapan

Setelah menerapkan satu prasetel, label linimasa diperbarui untuk menampilkan «Efek Gabungan Aktif: 3 [NamaPrasetel]». Nama prasetel tetap ditampilkan meskipun efek diubah secara manual sesudahnya.

10. Memperbarui Prasetel

Menimpa prasetel yang dipilih dengan konfigurasi efek saat ini.

Pilih prasetel yang ingin diperbarui dari daftar.
Ubah efek di «Efek Aktif».
Konfirmasi bahwa tombol «↺ (Perbarui)» aktif (hanya diaktifkan saat ada perubahan).
Klik «↺ (Perbarui)» atau klik kanan dan pilih «Perbarui».

Kapan tombol Perbarui menjadi aktif: Tombol hanya aktif saat prasetel yang dipilih sama dengan prasetel yang terakhir diterapkan dan konfigurasi efek saat ini berbeda dari yang tersimpan di prasetel. Jika parameter efek diubah, status tombol dievaluasi otomatis setelah debounce 50ms.

11. Pencarian Prasetel

Masukkan kata kunci di kotak pencarian untuk memfilter prasetel secara real time.

11-1. Beralih Mode Pencarian

Klik ikon filter di ujung kanan kotak pencarian untuk membuka menu dan mengubah target pencarian.

Mode Pencarian	Target
Nama Prasetel (default)	Nama prasetel
Nama Efek	Label semua efek yang terkandung dalam prasetel (daftar dipisahkan baris baru)
Jumlah Efek	Jumlah efek dalam prasetel. Input numerik memprioritaskan pencocokan tepat; kembali ke pencocokan parsial jika tidak ada pencocokan tepat.
Data Mentah (JSON)	JSON mentah dari konfigurasi efek yang diserialisasi. Cari berdasarkan nama tipe efek atau nilai parameter.
Semua	Menampilkan prasetel yang cocok dengan nama, nama efek, atau JSON mentah

11-2. Pencarian dengan Ekspresi Reguler

Ekspresi reguler (tidak peka huruf besar-kecil) dapat digunakan di semua mode pencarian.

Contoh: ^blur → Mencari prasetel yang namanya dimulai dengan «blur»
Contoh: color|shadow → Mencari prasetel yang namanya mengandung «color» atau «shadow»
Contoh: [0-9]+ → Mencari prasetel yang namanya mengandung angka

Jika pola ekspresi reguler yang tidak valid dimasukkan, pencarian kembali ke pencocokan parsial string yang tidak peka huruf besar-kecil.

12. Favorit

Tandai prasetel yang sering digunakan sebagai favorit untuk mengaksesnya dengan cepat dari grup virtual «Favorit».

12-1. Menandai / Membatalkan Tanda Favorit

Klik tombol bintang di awal setiap baris di daftar prasetel.

Bintang kuning (emas) menunjukkan prasetel ditandai sebagai favorit.
Bintang abu-abu menunjukkan bukan favorit.

Perubahan disimpan ke file prasetel segera.

12-2. Melihat Grup Favorit

Pilih «Favorit» di daftar grup untuk menampilkan semua prasetel berbintang dalam urutan abjad. Jika Anda membatalkan tanda favorit prasetel saat melihat grup Favorit, prasetel tersebut langsung hilang dari daftar.

13. Salin, Potong & Tempel

Gunakan clipboard untuk menyalin, memotong, dan menempel prasetel. Data ditulis ke clipboard dalam format JSON yang sama dengan paket prasetel, sehingga Anda juga dapat memeriksanya dan mengeditnya di editor teks.

13-1. Salin

Pilih prasetel yang akan disalin (multi-pilih didukung).
Klik kanan dan pilih «Salin».

Prasetel asli tidak berubah.

13-2. Potong

Pilih prasetel yang akan dipindahkan (multi-pilih didukung).
Klik kanan dan pilih «Potong».

Prasetel disalin ke clipboard dan aslinya dihapus secara bersamaan. Tidak ada kotak konfirmasi yang ditampilkan.

13-3. Tempel

Pilih grup tujuan di daftar grup.
Klik kanan pada area kosong di daftar prasetel atau prasetel mana pun dan pilih «Tempel».

Hanya tersedia saat clipboard mengandung JSON paket prasetel yang valid. Prasetel yang ditempel diberi GUID baru (berbeda dari ID asli). Jika grup virtual dipilih, prasetel ditambahkan ke grup nyata pertama.

13-4. Format Data Clipboard

Data yang ditulis ke clipboard menggunakan format JSON berikut:

{
  "FormatId": "CombinedEffect.PresetExchange",
  "Version": 1,
  "ExportedAtUtc": "2025-01-01T00:00:00+00:00",
  "Presets": [
    {
      "Id": "...",
      "Name": "Nama Prasetel",
      "IsFavorite": false,
      "SerializedTabs": "...",
      "SerializedEffects": "..."
    }
  ]
}

14. Ekspor & Impor Prasetel

Prasetel dapat diekspor dan diimpor sebagai file paket (ekstensi .ceprstpkg), memungkinkan berbagi antar lingkungan dan pengguna.

14-1. Ekspor

Pilih prasetel yang akan diekspor (Ctrl+klik atau Shift+klik untuk multi-pilih).
Klik kanan dan pilih «Ekspor».
Kotak dialog simpan file terbuka. Tentukan tujuan dan nama file, lalu simpan.

Prasetel tunggal: Nama prasetel digunakan sebagai nama file default (karakter yang tidak diizinkan dalam nama file diganti dengan _).
Beberapa prasetel: Nama paket default «CombinedEffect_Prasetel» digunakan.

14-2. Impor

Pilih grup yang ingin ditambahi prasetel yang diimpor.
Klik kanan pada area kosong di daftar prasetel dan pilih «Impor».
Kotak dialog pemilihan file terbuka. Pilih file .ceprstpkg (beberapa file dapat dipilih sekaligus).
Prasetel yang diimpor ditambahkan ke grup saat ini.

Prasetel yang diimpor diberi GUID baru sehingga tidak akan konflik dengan prasetel yang sudah ada.

14-3. Kompatibilitas Versi

File paket menyertakan nomor versi format. Versi saat ini adalah 1. Pesan kesalahan ditampilkan jika Anda mencoba mengimpor paket dengan versi lebih tinggi dari yang didukung.

15. Riwayat Cuplikan & Manajemen Cabang

Setiap prasetel memiliki jendela manajemen riwayat bergaya Git. Anda dapat menyimpan perubahan konfigurasi efek sebagai cuplikan dan mengelolanya dengan cabang.

15-1. Membuka Jendela Riwayat

Klik kanan pada prasetel yang ingin dikelola.
Pilih «Manajemen Riwayat» dari menu konteks.
Jendela manajemen riwayat terbuka (satu jendela per prasetel).

15-2. Tata Letak Jendela Riwayat

Panel	Keterangan
Kiri (daftar cabang)	Mencantumkan semua cabang untuk prasetel. Klik untuk memilih cabang; riwayat cuplikannya ditampilkan di tengah. Masukkan nama cabang di kotak teks di bawahnya dan klik «Buat Cabang Baru» untuk menambahkan cabang baru.
Tengah (daftar cuplikan)	Mencantumkan cuplikan dari HEAD cabang yang dipilih ke belakang. Setiap baris menampilkan ikon commit (diisi untuk HEAD saat ini), tag, pesan, tanggal/waktu, ringkasan diff, dan ID. Klik kanan untuk menu konteks. Masukkan pesan di bawahnya dan klik «Simpan Cuplikan Baru» untuk menyimpan konfigurasi saat ini. Gunakan tombol «Kembali ke Ini» di bawahnya untuk kembali ke cuplikan yang dipilih.
Kanan (tampilan diff)	Menampilkan perbedaan antara cuplikan yang dipilih dan konfigurasi efek saat ini. Penambahan ditandai hijau, penghapusan merah, dan modifikasi kuning. Perubahan jumlah efek dan nilai properti sebelum/sesudah ditampilkan dalam font Consolas.

15-3. Membuat Cuplikan

Buka jendela manajemen riwayat.
Masukkan pesan yang mendeskripsikan perubahan di kotak teks di bagian bawah panel tengah.
Klik «Simpan Cuplikan Baru».
Konfigurasi efek prasetel saat ini disimpan sebagai cuplikan dan HEAD cabang yang dipilih diperbarui.

15-4. Kembali ke Cuplikan (Revert)

Pilih cuplikan yang ingin dikembalikan.
Klik tombol «Kembali ke Ini».
Prasetel dan item Efek Gabungan di linimasa dikembalikan ke keadaan cuplikan yang dipilih.

15-5. Membuat Cabang

Masukkan nama cabang baru di kotak teks di bagian bawah panel kiri.
Klik «Buat Cabang Baru».
Cabang baru dibuat mulai dari cuplikan yang saat ini dipilih (atau HEAD cabang saat ini).

15-6. Operasi Menu Konteks

Mengklik kanan cuplikan membuka menu konteks.

Operasi	Keterangan
Gabungkan ke Saat Ini	Menambahkan efek cuplikan yang dipilih ke akhir efek saat ini.
Pertahankan Perubahan (Soft)	Memindahkan HEAD cabang yang dipilih ke cuplikan yang dipilih tanpa mengubah efek linimasa.
Buang Perubahan (Hard)	Melakukan Pertahankan Perubahan (Soft) dan Revert secara bersamaan.
Kelola Tag	Membuka jendela manajemen tag untuk cuplikan.

15-7. Membaca Ringkasan Diff

Ringkasan diff ditampilkan di kolom «Perubahan» di daftar cuplikan.

«Ditambahkan (+N)»: Cuplikan memiliki N efek lebih banyak dari keadaan saat ini
«Dihapus (N)»: Cuplikan memiliki N efek lebih sedikit dari keadaan saat ini
«Dimodifikasi»: Jumlah efek sama, tetapi parameter telah berubah
(kosong): Identik dengan konfigurasi efek saat ini

15-8. Lokasi Penyimpanan Data Riwayat

Data riwayat disimpan di folder History/ di bawah direktori plugin. Subfolder dibuat per prasetel; info cabang disimpan sebagai branches.json dan setiap cuplikan sebagai {ID}.json.

16. Manajemen Tag

Anda dapat melampirkan beberapa tag ke cuplikan untuk pengorganisasian. Tag ditampilkan dalam warna hijau di daftar cuplikan.

16-1. Menambahkan Tag

Klik kanan pada cuplikan yang ingin diberi tag.
Pilih «Kelola Tag» dari menu konteks.
Jendela manajemen tag terbuka.
Masukkan nama tag di kotak teks di bagian atas dan klik «Tambah».

Nama tag duplikat tidak diizinkan.

16-2. Menghapus Tag

Buka jendela manajemen tag.
Klik tombol «Hapus» di sebelah tag yang ingin dihapus.

17. Hapus Efek Sekaligus

Anda dapat menghapus semua efek yang dinonaktifkan (tidak dicentang) dari item Efek Gabungan sekaligus.

Klik kanan pada area kosong di daftar prasetel.
Pilih «Bersihkan» → «Hapus Efek yang Tidak Dipilih» dari menu konteks.
Klik «OK» di kotak konfirmasi.
Semua efek yang saat ini dinonaktifkan dihapus.

Efek yang diaktifkan tidak terpengaruh. Jika tidak ada efek yang dinonaktifkan, tidak ada yang terjadi.

18. Antarmuka Responsif & Tata Letak

18-1. Menyesuaikan Tinggi Panel

Seret gagang ubah ukuran (garis ganda) di bagian bawah panel manajemen prasetel untuk mengubah tingginya. Tinggi minimum adalah 200px. Pengaturan disimpan saat Anda melepas seret dan dipulihkan saat startup berikutnya.

18-2. Menyesuaikan Lebar Kolom Grup

Seret pembagi kisi (batas antara daftar grup dan daftar prasetel) ke kiri atau kanan untuk menyesuaikan lebar kolom grup. Lebar minimum adalah 120px dan maksimum 400px. Pengaturan disimpan saat seret selesai.

18-3. Tata Letak Mobile

Saat lebar kontrol turun di bawah 400px, perubahan berikut terjadi:

Panel daftar grup disembunyikan.
Pembagi kisi disembunyikan.
Tombol menu hamburger (≡) muncul di sebelah kiri bilah pencarian.
Mengkliknya membuka daftar grup sebagai popup. Memilih grup menutup popup.

Saat lebar kontrol kembali ke 400px atau lebih, tata letak otomatis beralih kembali ke mode desktop.

19. Penyimpanan Data & Persistensi Aman

Semua data prasetel, konfigurasi grup, dan data riwayat disimpan sebagai file JSON. Mekanisme redundansi dan verifikasi integritas berikut mencegah kehilangan data akibat satu kegagalan.

19-1. Penulisan Atomik

Penulisan file mengikuti langkah-langkah berikut:

Menulis ke file sementara (.tmp).
Menggunakan File.Replace untuk menukar file sementara dengan file utama, dan memindahkan file lama ke cadangan (.bak).
Bahkan jika aplikasi crash saat penulisan, file utama atau cadangan selalu dalam keadaan valid.

19-2. Verifikasi CRC32

Checksum CRC32 dihitung dan ditambahkan ke file saat penulisan. Saat pembacaan, checksum diverifikasi; jika tidak cocok, file cadangan digunakan untuk pemulihan.

19-3. Penyimpanan Multi-Redundan SHA-256

Data prasetel dan registri grup disimpan di dua lokasi:

Penyimpanan utama: Folder presets/ di bawah direktori plugin
Penyimpanan cadangan: Folder user/backup/CombinedEffect/

Saat startup, kedua lokasi dibandingkan dengan hash SHA-256 dan timestamp yang tersimpan di CombinedEffectSettings. Jika inkonsistensi terdeteksi, data yang benar digunakan untuk memperbaiki (menyembuhkan) yang lain secara otomatis.

19-4. Penulisan dengan Debounce

Operasi perubahan berturut-turut di-debounce selama 300ms (100ms untuk penghapusan) dan ditulis bersama, mengurangi beban I/O.

19-5. Logging

Log operasi dan log kesalahan disimpan di user/log/CombinedEffect/.

File log baru dibuat saat file saat ini melebihi 512 KB.
File log yang lebih dari 31 hari dihapus otomatis (diperiksa setiap jam).

20. Migrasi dari Versi Lama

Jika file data versi lama ada di jalur berikut, migrasi otomatis dilakukan saat startup pertama.

%AppData%\YukkuriMovieMaker4\user\plugins\CombinedEffect\presets.json

Setelah migrasi, file lama diubah namanya menjadi presets.json.migrated. File lama tidak dihapus jika migrasi gagal.

Migrasi mencakup:

Daftar grup dalam format lama (grup yang setara dengan virtual «Semua» dan «Favorit» dikecualikan)
Prasetel yang termasuk dalam setiap grup (nama, status favorit, konfigurasi efek)

21. Struktur File & Folder

Jalur (relatif terhadap direktori plugin)	Isi
`presets/`	Folder penyimpanan data prasetel utama
`presets/groups.json`	Konfigurasi grup (nama grup dan daftar ID prasetel)
`presets/{GUID}.json`	Data setiap prasetel (nama, favorit, JSON konfigurasi efek)
`presets/recent_ids.json`	Daftar ID prasetel yang baru-baru ini digunakan (maks 10)
`presets/UISettings.json`	Pengaturan antarmuka (tinggi panel, lebar kolom grup)
`History/`	Folder penyimpanan data riwayat cuplikan
`History/{GUID Prasetel}/branches.json`	Daftar cabang untuk prasetel tersebut
`History/{GUID Prasetel}/{GUID Cuplikan}.json`	Data setiap cuplikan
`user/backup/CombinedEffect/`	Penyimpanan cadangan (relatif terhadap direktori instalasi YMM4)
`user/log/CombinedEffect/`	Folder penyimpanan file log (relatif terhadap direktori instalasi YMM4)

Data prasetel disimpan di penyimpanan utama maupun cadangan. Jika satu hilang, yang lain dapat digunakan untuk pemulihan. Jika keduanya dihapus, prasetel tidak dapat dipulihkan.

22. Dukungan Multibahasa

Seluruh antarmuka beralih secara otomatis berdasarkan pengaturan bahasa YMM4. Tidak ada konfigurasi tambahan yang diperlukan.

Kode Bahasa	Bahasa
ja-jp	Jepang
en-us	Inggris
zh-cn	Tionghoa Sederhana
zh-tw	Tionghoa Tradisional
ko-kr	Korea
es-es	Spanyol
ar-sa	Arab
id-id	Indonesia

23. Referensi Parameter

Parameter	Tipe	Default	Dapat Dianimasikan	Keterangan
Efek Aktif (Effects)	ImmutableList<IVideoEffect>	(kosong)	Tidak	Daftar efek video yang akan dikelola. Gunakan pemilih efek standar YMM4 untuk menambah, menghapus, mengurutkan ulang, dan mengaktifkan/menonaktifkan efek. Diproses sebagai pipeline dari atas ke bawah. Efek yang dinonaktifkan dilewati.
EffectTabsJson	String (JSON)	(string kosong)	Tidak	Properti internal yang menyimpan status tab efek (ID tab terpilih, nama tab, dan JSON efek per tab). Diperbarui otomatis saat tab ditambah, dihapus, diganti nama, atau dipindah.
SelectedPresetJson	String (JSON)	(string kosong)	Tidak	Properti internal yang menyimpan informasi tentang prasetel yang saat ini diterapkan. Diatur otomatis saat prasetel diterapkan. Pengeditan langsung tidak direkomendasikan. Digunakan untuk menampilkan nama prasetel di label linimasa.
PresetManagerVisible	bool	true	Tidak	Flag internal yang mengontrol visibilitas panel manajemen prasetel. Dikecualikan dari serialisasi JSON ([JsonIgnore]).

Format Tampilan Label

Keadaan	Format	Contoh
Tanpa prasetel diterapkan	{Nama Efek} Aktif: {N}	Efek Gabungan Aktif: 3
Prasetel diterapkan	{Nama Efek} Aktif: {N} [{Nama Prasetel}]	Efek Gabungan Aktif: 3 [Set Efek A]

24. Referensi Cepat

Operasi Tab

Operasi	Metode	Catatan
Tambah Tab	Tombol «+» di kanan bilah tab	Membuat tab baru dengan konfigurasi efek kosong
Hapus Tab	Tombol «×» pada tab	Tab pertama «Baru» tidak bisa dihapus
Ganti nama tab	Klik dua kali tab untuk mengedit	Enter/pindah fokus untuk konfirmasi, Esc untuk batal
Pindah tab	Klik tab	Efek tab terpilih ditampilkan di «Efek Aktif»

Operasi Grup

Operasi	Metode	Batasan
Tambah grup	Tombol «+» di bagian bawah daftar grup	Tidak ada
Hapus grup	Tombol «-» di bagian bawah daftar grup	Grup bawaan dan virtual tidak dapat dihapus
Ganti nama grup	Klik dua kali, atau klik kanan → «Ganti Nama»	Grup virtual tidak dapat diganti namanya
Urutkan ulang grup	Seret dan lepas	Grup virtual tidak dapat dipindah

Operasi Prasetel

Operasi	Metode	Catatan
Tambah prasetel	Tombol «+ (Tambah)»	Disimpan ke grup nyata pertama saat grup virtual dipilih
Hapus prasetel	Tombol «- (Hapus)», atau klik kanan → «Hapus»	Kotak konfirmasi ditampilkan. Multi-pilih didukung.
Ganti nama prasetel	Klik dua kali, atau klik kanan → «Ganti Nama»	Tidak ada
Urutkan ulang prasetel	Seret dan lepas	Tidak tersedia saat melihat grup virtual
Terapkan prasetel	Tombol «✓ (Terapkan)», atau klik kanan → «Terapkan»	Kotak konfirmasi untuk konten identik
Perbarui prasetel	Tombol «↺ (Perbarui)», atau klik kanan → «Perbarui»	Hanya aktif saat efek berubah
Kosongkan prasetel	Klik kanan → «Kosongkan Prasetel»	Kotak konfirmasi ditampilkan. Hanya tersedia saat prasetel memiliki 1+ efek.
Toggle favorit	Klik tombol bintang	Tidak ada
Salin	Klik kanan → «Salin»	Multi-pilih didukung
Potong	Klik kanan → «Potong»	Tanpa kotak konfirmasi. Multi-pilih didukung.
Tempel	Klik kanan → «Tempel»	Membutuhkan JSON valid di clipboard
Ekspor	Klik kanan → «Ekspor»	Multi-pilih. Format .ceprstpkg.
Impor	Klik kanan area kosong → «Impor»	Beberapa file dapat dipilih
Hapus efek yang tidak dipilih	Klik kanan area kosong → «Bersihkan» → «Hapus Efek yang Tidak Dipilih»	Kotak konfirmasi ditampilkan
Buka riwayat	Klik kanan → «Manajemen Riwayat»	Satu jendela per prasetel

Operasi Riwayat

Operasi	Metode	Keterangan
Simpan cuplikan	Masukkan pesan → Tombol «Simpan Cuplikan Baru»	Dinonaktifkan jika pesan kosong
Kembali ke cuplikan	Pilih cuplikan → Tombol «Kembali ke Ini»	Diterapkan ke prasetel dan linimasa
Buat cabang	Masukkan nama cabang → Tombol «Buat Cabang Baru»	Dinonaktifkan jika nama cabang kosong
Gabungkan	Klik kanan cuplikan → «Gabungkan ke Saat Ini»	Menambahkan efek ke akhir saat ini
Pertahankan Perubahan (Soft Reset)	Klik kanan cuplikan → «Pertahankan Perubahan (Soft)»	Hanya memindahkan HEAD, tanpa perubahan efek
Buang Perubahan (Hard Reset)	Klik kanan cuplikan → «Buang Perubahan (Hard)»	Soft Reset + Revert secara bersamaan
Kelola tag	Klik kanan cuplikan → «Kelola Tag»	Membuka jendela manajemen tag

25. Catatan & Peringatan

Output format AviUtl (.exo) tidak didukung.
Menyarangkan «Efek Gabungan» di dalam «Efek Gabungan» lain tidak direkomendasikan.
Grup virtual «Semua», «Favorit», dan «Terbaru» tidak dapat dihapus, diganti namanya, atau diurutkan ulang.
Grup «Bawaan» tidak dapat dihapus.
Menambahkan atau menempel prasetel saat grup virtual dipilih menyimpannya ke grup nyata pertama.
Mengimpor file paket memberikan ID baru yang berbeda dari GUID asli. Oleh karena itu, prasetel yang diimpor tidak mewarisi riwayat cuplikan.
Operasi Potong menghapus prasetel tanpa kotak konfirmasi. Tindakan ini tidak dapat langsung dibatalkan, jadi gunakan dengan hati-hati.
Menerapkan satu prasetel akan memulihkan struktur tab yang tersimpan (termasuk tab yang dipilih). Saat menerapkan beberapa prasetel sekaligus, atau menerapkan ulang prasetel yang sama dalam mode tumpuk, hanya efek dari tab terpilih yang digabungkan dan tab dibangun ulang menjadi satu tab «Baru».
Data prasetel disimpan di penyimpanan utama dan cadangan. Menghapus satu folder mungkin masih memungkinkan pemulihan, tetapi menghapus keduanya akan mengakibatkan kehilangan data permanen.
Data riwayat disimpan di folder History/. Menghapus folder ini akan menghapus semua riwayat.
Riwayat cuplikan bertumbuh tanpa batas. Jika ada terlalu banyak cuplikan yang tidak diperlukan, Anda dapat menghapus file .json yang tidak diinginkan secara manual di folder History/{GUID Prasetel}/ (jangan hapus branches.json).
Hanya efek yang didukung oleh sistem plugin YMM4 yang disimpan sebagai bagian dari konfigurasi efek prasetel. Efek yang tidak didukung mungkin dilewati saat pemuatan.
Karena penulisan dengan debounce, ada penundaan hingga 300ms antara operasi perubahan dan penulisan file yang sebenarnya. Jika YMM4 segera dihentikan paksa, operasi terakhir mungkin tidak tersimpan.

26. Penafian & Lisensi

Plugin ini dirilis di bawah Lisensi MIT.

PERANGKAT LUNAK INI DISEDIAKAN «APA ADANYA», TANPA GARANSI DALAM BENTUK APA PUN, TERSURAT MAUPUN TERSIRAT, TERMASUK NAMUN TIDAK TERBATAS PADA GARANSI KELAYAKAN JUAL, KESESUAIAN UNTUK TUJUAN TERTENTU, DAN NON-PELANGGARAN.

Penulis tidak bertanggung jawab atas kerusakan apa pun yang timbul dari penggunaan atau ketidakmampuan menggunakan plugin ini. Gunakan dengan risiko Anda sendiri.

Penulis: routersys / Lisensi: MIT License / Repositori: https://github.com/routersys/YMM4-CombinedEffect

Akhir dokumen.