Ruffle - Emulator Adobe Flash Player

Ruffle adalah emulator Adobe Flash Player yang penting untuk menjalankan konten Flash lawas (game, animasi, aplikasi, dan banner SWF). Ia beroperasi sebagai aplikasi mandiri di semua sistem operasi (termasuk Windows, macOS, dan Linux) dan terintegrasi ke dalam peramban melalui WebAssembly.

Ruffle menyediakan build terpisah untuk Windows, macOS, dan Linux yang berfungsi seperti program biasa: cukup jalankan file eksekusi dan buka file SWF yang diinginkan di dalamnya.

Ruffle memanfaatkan keamanan memori dari bahasa Rust dan sandbox dari peramban modern. Ini memungkinkan konten lawas yang berpotensi berisiko untuk berjalan tanpa risiko infeksi sistem atau kebocoran data.

Emulator ini menggabungkan dukungan untuk AVM1 yang lebih lama (ActionScript 1 dan 2, digunakan hingga 2006) dan AVM2 (ActionScript 3) yang lebih kompleks. Ini diperlukan untuk pengoperasian yang benar dari hampir semua konten Flash, mulai dari animasi awal tahun 2000-an hingga game dan aplikasi kompleks yang dirilis sesaat sebelum teknologi ini dihentikan.

Tautan unduhan:

Windows (64-bit) macOS Linux (x86_64) Linux (ARM64) Flatpak

Semua tautan mengarah ke sumber resmi: build untuk Windows (x86_64), macOS (universal untuk Intel dan Apple Silicon), Linux (x86_64 dan ARM64 untuk Raspberry Pi dan perangkat ARM) didistribusikan melalui repositori GitHub proyek Ruffle, sementara versi Linux dalam format Flatpak tersedia melalui katalog Flathub resmi dengan tanda tangan digital dan isolasi aplikasi.

Daftar Isi:

Fitur Utama Ruffle

Integrasi melalui WebAssembly. Untuk pengoperasian peramban, Ruffle dikompilasi ke WebAssembly (Wasm) — bytecode tingkat rendah yang dijalankan dalam sandbox terisolasi peramban dengan kinerja mendekati native. Ini memungkinkan emulator untuk memuat dan memproses grafik dan logika Flash yang kompleks tanpa perlu menginstal plugin NPAPI/PPAPI yang sudah usang dan tidak aman.

Deteksi Otomatis dan Polyfilling Konten Flash. Versi web Ruffle menyertakan detektor JavaScript yang memindai struktur DOM halaman untuk elemen object, embed, dan applet, serta file dengan ekstensi .swf. Setelah mendeteksi konten tersebut, Ruffle secara otomatis menggantinya dengan pemutar sendiri, secara transparan memperbaiki halaman untuk pengguna dan memulihkan fungsionalitas elemen Flash.

Mode Operasi Ganda (Aplikasi Desktop dan Ekstensi Web). Ruffle menawarkan fleksibilitas kepada pengguna: dapat digunakan sebagai aplikasi desktop mandiri untuk pemutaran SWF lokal (cukup kaitkan file dengan eksekusi Ruffle) atau sebagai ekstensi peramban yang terintegrasi ke dalam lingkungan penjelajahan web, menyediakan dukungan Flash di situs mana pun.

Dukungan untuk ActionScript 1.0 dan 2.0 (AVM1). Ruffle mengimplementasikan mesin virtual AVM1, memastikan kompatibilitas dengan sejumlah besar konten yang dibuat sebelum 2006 dan hingga 2013. Tingkat kompatibilitas saat ini untuk konstruksi bahasa AVM1 mencapai 99%, dan untuk API — 81%, menjamin pengoperasian yang benar dari sebagian besar game dan animasi Flash awal.

Dukungan untuk ActionScript 3.0 (AVM2). Untuk konten yang dibuat setelah 2006, Ruffle menyertakan implementasi AVM2. Meskipun pekerjaan pada kompatibilitas sedang berlangsung secara aktif, emulator sudah menyediakan tingkat dukungan yang cukup untuk menjalankan banyak game dan aplikasi kompleks yang ditulis dalam ActionScript 3, terus memperluas cakupan API dan kemampuan bahasa.

Keamanan pada Tingkat Bahasa Rust. Salah satu keunggulan arsitektur utama Ruffle adalah penggunaan bahasa Rust. Rust menjamin keamanan memori pada waktu kompilasi, sepenuhnya menghilangkan seluruh kelas kerentanan yang menghantui Adobe Flash Player asli, seperti buffer overflow, double free, dan kesalahan use-after-free.

Isolasi dalam Sandbox Peramban. Saat beroperasi di lingkungan web, Ruffle (melalui WebAssembly) sepenuhnya mematuhi kebijakan keamanan peramban. Ini menambahkan lapisan isolasi ekstra: emulator tidak memiliki akses langsung ke sistem file pengguna atau proses sistem lainnya, membuat eksploitasinya sangat sulit dibandingkan dengan plugin Flash klasik.

Manajemen Memori yang Efisien. Tidak seperti Flash Player asli yang menggunakan pengumpulan sampah dengan jeda non-deterministik, Ruffle mewarisi model kepemilikan ketat Rust. Ini memungkinkan penggunaan memori yang lebih dapat diprediksi, mengurangi fragmentasi, dan menghilangkan kebocoran memori yang sering menyebabkan perilaku peramban yang tidak stabil.

Dukungan Baris Perintah. Versi desktop Ruffle menawarkan antarmuka baris perintah yang berfungsi penuh. Pengguna dapat menjalankan emulator dengan parameter, misalnya: ruffle filename.swf untuk file lokal, atau ruffle https://example.com/filename.swf untuk memutar SWF dari URL. Perintah ruffle --help menampilkan daftar lengkap semua argumen dan pengaturan yang tersedia.

Kode Sumber Terbuka dan Transparansi Pengembangan. Ruffle didistribusikan di bawah lisensi Apache 2.0 dan MIT. Keterbukaan penuh kode sumber berarti pengembang mana pun dapat mengaudit keamanan emulator, menyumbangkan perbaikan, dan berpartisipasi dalam pengembangannya, menghilangkan kemungkinan fitur tersembunyi atau kerentanan yang mungkin diperkenalkan oleh pengembang perusahaan.

Kompatibilitas dengan Beragam Peramban. Berkat teknologi WebAssembly, Ruffle didukung oleh semua peramban modern, termasuk Google Chrome, Mozilla Firefox, Microsoft Edge, Safari, Opera, Brave, dan Vivaldi. Ini memastikan pengalaman yang konsisten dengan konten Flash terlepas dari preferensi pengguna terhadap mesin peramban (Chromium, Gecko, atau WebKit).

Dukungan untuk Peramban Seluler (iOS dan Android). Tidak seperti Adobe Flash Player asli yang tidak pernah didukung secara resmi di iOS dan memiliki dukungan terbatas di Android, Ruffle berfungsi di platform seluler. Ini memungkinkan game dan animasi Flash berjalan di ponsel pintar dan tablet langsung melalui peramban seluler, membuka akses ke konten arsip bagi audiens seluler.

Tidak Perlu Konfigurasi. Ruffle dirancang dengan prinsip "pasang dan lupakan". Setelah memasang ekstensi atau meluncurkan aplikasi desktop, emulator tidak memerlukan konfigurasi yang rumit. Ia secara otomatis mendeteksi parameter pemutaran seperti ukuran panggung, kecepatan bingkai, dan jenis interaksi, menerapkan pengaturan optimal tanpa campur tangan pengguna.

Perlindungan Terhadap Kerentanan Zero-Day. Karena Ruffle bukanlah plugin, tidak menggunakan API usang, dan kodenya ditulis dalam Rust dengan fokus pada keamanan, ia kebal terhadap serangan yang menjadi ciri khas Adobe Flash Player. Ini menjadikannya solusi ideal bagi organisasi yang harus mempertahankan akses ke konten lawas tetapi tidak dapat mengambil risiko kompromi sistem.

Kompatibilitas dengan Berbagai Metode Instalasi. Ruffle menawarkan beberapa metode penerapan. Pengembang web dapat menginstalnya sebagai ekstensi statis di peramban berbasis Chromium (melalui mode pengembang) atau sebagai add-on sementara di Firefox (melalui about:debugging). Integrasi melalui penyisipan kode JavaScript sederhana di sisi server juga tersedia.

Pemutaran Konten Online dan Offline. Versi desktop Ruffle memungkinkan membuka dan memutar file SWF yang disimpan secara lokal di komputer. Ini menjadikan emulator alat yang sangat diperlukan bagi kolektor, pengarsip, dan peneliti yang bekerja dengan arsip lokal game dan animasi Flash.

Kinerja Rendering Tinggi. Ruffle menggunakan API grafis modern (seperti OpenGL, Vulkan, DirectX, atau WebGL) melalui pustaka lintas platform. Ini menyediakan akselerasi perangkat keras untuk rendering grafik vektor dan raster, memungkinkan pemutaran yang mulus bahkan pada perangkat yang lebih lemah di mana Flash Player asli mungkin mengalami kelambatan.

Pengembangan Aktif dan Pembaruan Sering. Proyek ini sedang dalam pengembangan aktif. Rilis keluar secara teratur dan mencakup perbaikan bug kritis serta dukungan API ActionScript yang diperluas. Sebagai contoh, versi terbaru telah memperbaiki kasus tepi dalam metode String.indexOf dan lastIndexOf, dan menangani indeks negatif dengan benar di Array.indexOf.

Integrasi dengan Arsip dan Platform Utama. Ruffle telah dipilih sebagai pemutar resmi untuk pemutaran konten Flash oleh raksasa seperti Internet Archive, Newgrounds, Coolmath Games, dan Armor Games. Ini menegaskan tingkat keandalan dan kompatibilitas emulator yang tinggi, serta kemampuannya untuk beroperasi di bawah beban tinggi dalam kondisi dunia nyata.

Dukungan untuk Penyimpanan Game dan Status. Seperti Flash Player asli, Ruffle mendukung Local Shared Objects (LSO), yang digunakan banyak game untuk menyimpan kemajuan. Emulator dengan benar meniru mekanisme membaca dan menulis data ke penyimpanan ini, memastikan integritas penyimpanan dalam lingkungan runtime aplikasi.

Emulasi Waktu dan Kecepatan Bingkai yang Akurat. Ruffle secara akurat meniru timer internal Flash Player, yang sangat penting untuk logika game dan animasi. Ini memastikan sinkronisasi peristiwa, suara, dan pergerakan objek yang tepat, mencegah situasi di mana game berjalan lebih lambat atau lebih cepat dari aslinya.

Dukungan untuk Interaksi DOM dan JavaScript (ExternalInterface). Untuk aplikasi web kompleks yang menggunakan API ExternalInterface untuk bertukar data antara ActionScript dan JavaScript, Ruffle mengimplementasikan jembatan yang kompatibel. Ini memungkinkan emulator menangani panggilan fungsi dan transfer data dengan benar, menjaga interaktivitas konten dengan halaman web di sekitarnya.

Penskalaan Otomatis dan Adaptasi Resolusi. Saat memutar konten Flash yang dibuat untuk resolusi tertentu (misalnya, 800x600), Ruffle secara otomatis menerapkan algoritme penskalaan untuk beradaptasi dengan ukuran jendela peramban atau aplikasi desktop saat ini. Ia mempertahankan proporsi dan kualitas gambar, dan menangani area interaksi tetikus dengan benar.

Dukungan untuk Beragam Format Media. Emulator mendukung decoding berbagai format media yang mungkin disematkan dalam file SWF, termasuk MP3 untuk audio dan kompresi video yang digunakan dalam versi Flash selanjutnya. Decoding dilakukan melalui pustaka berkinerja tinggi yang ditulis dalam Rust, mengurangi beban sistem.

Debugging dan Pencatatan Log Tingkat Lanjut. Untuk pengembang dan pengguna tingkat lanjut, Ruffle menyediakan kemampuan untuk mengaktifkan log terperinci tentang operasi mesin virtual AVM1/AVM2. Ini memungkinkan mendiagnosis masalah kompatibilitas, melacak kesalahan dalam kode ActionScript, dan memahami proses internal emulasi untuk penyesuaian yang lebih presisi.

Emulasi Kursor dan Elemen Interaktif. Ruffle dengan benar menangani perubahan gaya kursor yang ditentukan oleh konten Flash. Misalnya, untuk elemen interaktif seperti LoaderDisplay, emulator secara otomatis mengubah kursor standar menjadi penunjuk, meniru perilaku pemutar Flash asli dan memberikan navigasi yang familiar bagi pengguna.

Dukungan untuk Nightly Builds untuk Akses Dini. Selain rilis stabil, tim Ruffle menyediakan akses ke build eksperimental harian Nightly. Build ini berisi perbaikan dan inovasi terbaru yang belum termasuk dalam versi stabil.

Melestarikan Warisan Budaya Digital. Ini bukan hanya fungsi teknis, tetapi tujuan fundamental dari proyek ini. Ruffle dibuat sebagai alat untuk melestarikan konten internet bersejarah. Berkat kemampuannya untuk bekerja di peramban modern tanpa mengorbankan keamanan, jutaan game Flash, animasi, dan aplikasi yang akan hilang selamanya setelah Adobe Flash Player dihentikan tetap dapat diakses oleh generasi mendatang.

12 Kemampuan Teknis Ruffle yang Kurang Dikenal

  1. Menggunakan WGPU sebagai Backend Rendering Utama. Tidak seperti banyak emulator yang mengandalkan OpenGL lawas, Ruffle menggunakan pustaka WGPU — API grafis modern, aman, dan lintas platform. Di desktop, WGPU secara otomatis memilih backend tingkat rendah yang paling optimal: Vulkan, DirectX 12, atau Metal. Di peramban, ia dapat bekerja melalui WebGPU (jika tersedia) atau mengemulasi operasi melalui WebGL dengan kehilangan kinerja minimal.

  2. Dukungan WebGPU di Peramban untuk Kinerja Maksimal. Untuk pengguna peramban modern (misalnya, versi terbaru Chrome dan Edge), Ruffle dapat menggunakan API mutakhir WebGPU. Ini memberikan pengurangan waktu kompilasi shader yang signifikan dan overhead yang lebih rendah dibandingkan dengan backend WebGL standar, yang sangat penting untuk grafik 3D kompleks dan aplikasi Stage3D.

  3. Penyesuaian Backend Rendering yang Mendetail (canvas, webgl, wgpu-webgl). Hanya sedikit yang tahu bahwa perilaku rendering dapat dikontrol secara manual. Selain wgpu-webgl standar, ada opsi untuk mengaktifkan secara paksa:

    • webgl — backend klasik yang melakukan inisialisasi lebih cepat dan mungkin berguna untuk konten sederhana yang tidak memerlukan efek bitmap kompleks.

    • canvas — backend paling lambat, tetapi paling akurat. Ini adalah satu-satunya yang menskalakan goresan garis tipis dalam grafik vektor dengan benar, yang mungkin tampak terlalu tebal saat menggunakan akselerasi perangkat keras.

  4. Emulasi Stage3D dan Kompilasi AGAL ke WGSL. Ruffle tidak hanya mendukung grafis 2D tetapi juga akselerasi 3D melalui API Stage3D (Context3D). Shader yang ditulis dalam AGAL (Adobe Graphics Assembly Language) dikompilasi "saat itu juga" ke WGSL (WebGPU Shading Language) atau GLSL modern. Ini memungkinkan menjalankan game dan aplikasi 3D kompleks yang dibuat untuk Flash Player 11 dan yang lebih baru, memanfaatkan pipeline penuh shader yang dapat diprogram.

  5. Dukungan untuk fscommand untuk Kompatibilitas Mundur. Ruffle telah mempertahankan dukungan untuk mekanisme fscommand lawas namun penting. Ini memungkinkan film Flash lama (dibuat sebelum ExternalInterface) untuk berinteraksi dengan JavaScript di halaman, mengirim perintah dan argumen arbitrer. Dalam implementasi modern Ruffle, perintah ini diproses melalui onFSCommand, memungkinkan fungsionalitas bahkan untuk konten web yang sangat lama.

  6. Double Buffering untuk Context3D. Saat bekerja dengan konten 3D, Ruffle menggunakan mekanisme double buffering yang canggih (back buffer / front buffer). Ini adalah teknik kinerja standar namun sangat penting, memungkinkan bingkai berikutnya dirender di buffer latar belakang sementara bingkai saat ini ditampilkan di layar, menghilangkan artefak visual (robeknya bingkai) dalam game yang dinamis.

  7. Alat Benchmarking: ruffle_scanner dan exporter. Di dalam repositori Ruffle, terdapat alat utilitas yang tidak termasuk dalam build standar tetapi tersedia untuk pengembang:

    • ruffle_scanner — memungkinkan pengujian kompatibilitas emulator dengan seluruh folder file SWF, menghasilkan laporan CSV tentang keberhasilan penguraian.

    • exporter — alat untuk menghasilkan batch tangkapan layar PNG dari file SWF, yang dapat berjalan dalam mode headless (tanpa GUI), berguna untuk pengujian otomatis dan membuat pratinjau.

  8. Isolasi Lengkap melalui Sandbox Flatpak. Untuk pengguna Linux, ada build Ruffle resmi dalam format Flatpak. Ini bukan hanya metode instalasi, tetapi lapisan keamanan tambahan: aplikasi berjalan di lingkungan terisolasi di mana semua penyimpanan, konfigurasi, dan log disimpan secara ketat di dalam direktori home Flatpak (~/.var/app/rs.ruffle.Ruffle/), tanpa akses ke seluruh sistem.

  9. Dukungan Integrasi melalui Homebrew dan Scoop. Untuk pengguna berpengalaman, Ruffle menawarkan metode instalasi tingkat lanjut di luar unduhan manual. Di macOS, dapat diinstal melalui Homebrew (brew install --HEAD ruffle-rs/ruffle/ruffle), memungkinkan pembaruan otomatis ke nightly build terbaru. Di Windows, manajer paket Scoop melayani fungsi serupa.

  10. Sistem Penyimpanan Data Transparan (SharedObjects). Ruffle secara akurat meniru sistem penyimpanan lokal Flash (LSO — Local Shared Objects). Namun, tidak seperti pemutar berpemilik, lokasi file-file ini terstandarisasi dan transparan bagi pengguna. Di Windows, mereka terletak di %AppData%\Local\Ruffle\SharedObjects\, di Linux — di ~/.local/share/ruffle/SharedObjects/. Ini memungkinkan pencadangan manual dari penyimpanan game lama.

  11. Konfigurasi melalui JavaScript API dan Pengaturan Global. Untuk pengembang web, Ruffle menyediakan JavaScript API yang kuat, memungkinkan tidak hanya menyematkan pemutar tetapi juga mengontrol statusnya. Metode tersedia untuk memuat SWF secara terprogram (load), mengontrol volume (volume), menjeda (suspend/resume), dan mencegat keluaran trace() dari ActionScript untuk debugging melalui traceObserver.

  12. Penandatanganan dan Notarisasi Otomatis Build macOS. Dalam proses CI/CD, semua build malam Ruffle untuk macOS menjalani penandatanganan kode dan notarisasi oleh Apple. Ini berarti bahwa bahkan versi emulator yang tidak stabil tidak akan diblokir oleh Gatekeeper sebagai perangkat lunak yang tidak aman, memastikan pengoperasian bebas masalah pada versi terbaru macOS di mana persyaratan keamanan ketat.

Menginstal Versi Desktop Ruffle

Versi desktop Ruffle adalah aplikasi native yang memungkinkan Anda membuka dan memutar file SWF langsung di komputer, tanpa memerlukan peramban. Ini adalah pilihan ideal untuk melihat arsip lokal game dan animasi Flash.

Windows (10, 11)

Metode 1: Antarmuka Grafis (direkomendasikan)

  1. Unduh file bernama ruffle-windows-x86_64.zip (untuk sistem 64-bit) atau ruffle-windows-x86.zip (untuk sistem 32-bit).

  2. Ekstrak konten arsip ke folder mana pun yang nyaman (misalnya, C:\Program Files\Ruffle atau C:\Users\[Nama_Pengguna_Anda]\Documents\Ruffle).

  3. Untuk menjalankannya, klik dua kali file eksekusi ruffle.exe. Antarmuka grafis aplikasi akan terbuka.

  4. Untuk membuka file SWF, klik tombol Open File di antarmuka atau cukup seret dan lepas file SWF ke dalam jendela aplikasi.

  5. Metode alternatif: Atur asosiasi file. Klik kanan file .swf, pilih Open with → Choose another app, cari ruffle.exe dan centang opsi Always use this app to open .swf files.

Metode 2: Baris Perintah

Untuk pengguna berpengalaman, antarmuka baris perintah tersedia:

  1. Buka Command Prompt (CMD) atau PowerShell.

  2. Navigasikan ke folder yang berisi ruffle.exe, atau tambahkan folder tersebut ke variabel lingkungan PATH Anda.

  3. Untuk menjalankan file lokal, jalankan perintah:

    ruffle.exe C:\path\to\your\file.swf

  4. Untuk menjalankan file SWF dari URL:

    ruffle.exe https://example.com/animation.swf

  5. Untuk melihat semua parameter baris perintah yang tersedia:

    ruffle.exe --help

Metode 3: Instalasi melalui Manajer Paket Scoop

Bagi mereka yang lebih menyukai instalasi otomatis:

scoop bucket add extras
scoop install ruffle

macOS

Metode 1: Antarmuka Grafis (direkomendasikan)

  1. Unduh file ruffle-macos-x86_64.dmg atau ruffle-macos-aarch64.dmg (untuk Apple Silicon M1/M2/M3) dari halaman rilis.

  2. Buka file .dmg yang diunduh.

  3. Seret ikon Ruffle ke dalam folder Applications.

  4. Jalankan Ruffle dari folder Applications. Pada peluncuran pertama, sistem mungkin meminta konfirmasi — klik Open.

  5. Setelah aplikasi diluncurkan, gunakan tombol Open File atau seret dan lepas file SWF ke dalam jendela.

Metode 2: Instalasi melalui Homebrew

Untuk pengguna tingkat lanjut:

# Instal versi stabil terbaru (jika tersedia)
brew install ruffle

# Atau instal nightly build terbaru dari sumber
brew install --HEAD ruffle-rs/ruffle/ruffle

Metode 3: Baris Perintah

Setelah instalasi melalui Homebrew atau menempatkan ruffle secara manual di /usr/local/bin:

ruffle ~/Downloads/game.swf
ruffle https://example.com/game.swf

Linux

Metode 1: Instalasi melalui Flatpak (direkomendasikan untuk isolasi)

Flatpak memberikan keamanan maksimum dengan menjalankan Ruffle dalam sandbox yang terisolasi:

# Tambahkan repositori Flathub
flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo

# Instal Ruffle
flatpak install flathub rs.ruffle.Ruffle

# Jalankan
flatpak run rs.ruffle.Ruffle

Metode 2: Instalasi melalui AppImage (tidak perlu instalasi)

  1. Unduh file ruffle-x86_64.AppImage dari halaman rilis.

  2. Buat file tersebut dapat dieksekusi:

    chmod +x ruffle-x86_64.AppImage

  3. Jalankan dengan klik dua kali atau melalui terminal:

    ./ruffle-x86_64.AppImage

Metode 3: Instalasi Manual (untuk distribusi berbasis Debian/Ubuntu)

  1. Unduh ruffle-linux-x86_64.tar.gz (atau ruffle-linux-armv7.tar.gz untuk perangkat ARM seperti Raspberry Pi).

  2. Ekstrak arsip:

    tar -xzf ruffle-linux-x86_64.tar.gz

  3. Salin file eksekusi ke direktori sistem:

    sudo cp ruffle /usr/local/bin/

  4. Jalankan dari terminal:

    ruffle

Menginstal Ruffle sebagai Ekstensi Peramban

Ekstensi Ruffle secara otomatis mendeteksi konten Flash di halaman web mana pun dan menggantinya dengan emulator.

Catatan Penting

Saat ini, ekstensi tidak dihosting di toko ekstensi resmi (Chrome Web Store, Firefox Add-ons) dan sedang dalam pengembangan aktif. Instalasi dilakukan secara manual, melalui mode pengembang peramban.

Instalasi di Google Chrome dan Peramban Berbasis Chromium

Peramban yang didukung: Google Chrome, Microsoft Edge, Brave, Opera, Vivaldi, Arc dan lainnya yang berbasis Chromium.

Petunjuk langkah demi langkah:

  1. Buka halaman rilis Ruffle di GitHub.

  2. Unduh arsip bernama ruffle-chromium.zip (atau serupa yang mengandung chromium).

  3. Ekstrak arsip ke folder permanen di komputer Anda. Penting: Jangan hapus folder ini setelah instalasi, karena peramban akan mengaksesnya agar ekstensi berfungsi. Lokasi yang direkomendasikan:

    • Windows: C:\Users\[Nama_Pengguna_Anda]\AppData\Local\Ruffle\

    • macOS: ~/Library/Application Support/Ruffle/

    • Linux: ~/.local/share/ruffle/

  4. Buka peramban Anda dan masukkan yang berikut di bilah alamat:

    chrome://extensions/

  5. Di sudut kanan atas halaman, aktifkan Developer mode.

  6. Klik tombol Load unpacked.

  7. Dalam dialog yang terbuka, pilih folder tempat Anda mengekstrak arsip ruffle-chromium.zip, dan klik Select Folder.

  8. Ekstensi telah terinstal. Sekarang, saat mengunjungi situs dengan konten Flash, Ruffle akan aktif secara otomatis.

Untuk Microsoft Edge (Chromium): Prosesnya identik dengan Chrome. Gunakan edge://extensions/ sebagai pengganti chrome://extensions/ dan aktifkan mode pengembang.

Instalasi di Mozilla Firefox

Penting: Di Firefox, ekstensi terinstal hanya untuk sementara dan akan dihapus setelah peramban dimulai ulang. Ini adalah batasan Firefox untuk ekstensi yang tidak ditandatangani. Untuk penggunaan permanen, disarankan menggunakan versi desktop atau menunggu publikasi di toko resmi.

Petunjuk langkah demi langkah:

  1. Buka halaman rilis Ruffle di GitHub.

  2. Unduh file bernama ruffle-firefox.xpi. Saat mengunduh, pilih Save File.

  3. Di Firefox, masukkan yang berikut di bilah alamat:

    about:debugging

  4. Di bilah sisi kiri, pilih This Firefox.

  5. Klik tombol Load Temporary Add-on….

  6. Dalam dialog file, pilih file ruffle-firefox.xpi yang diunduh dan klik Open.

  7. Ekstensi akan dimuat dan diaktifkan. Ekstensi akan berfungsi hingga Anda menutup peramban.

Tips: Jika Anda menggunakan Firefox Nightly atau Developer Edition, Anda dapat menonaktifkan verifikasi tanda tangan ekstensi melalui about:config, yang memungkinkan instalasi permanen, tetapi ini tidak disarankan untuk penggunaan sehari-hari karena alasan keamanan.

Instalasi di Safari (macOS)

Menginstal ekstensi Ruffle di Safari memerlukan langkah tambahan karena kebijakan keamanan Apple.

  1. Unduh file ruffle-safari.zip dari halaman rilis.

  2. Ekstrak arsip.

  3. Jalankan file Ruffle.app dari folder yang diekstrak. Ini akan menginstal ekstensi di sistem Anda.

  4. Buka Safari, buka Safari → Settings → tab Extensions.

  5. Pastikan sakelar di samping Ruffle disetel ke On.

  6. Ekstensi diaktifkan dan akan bekerja dengan konten Flash di halaman web.

Menginstal Ruffle di Situs Web (untuk Pengelola Web)

Jika Anda memiliki situs web yang menghosting konten Flash, Anda dapat mengintegrasikan Ruffle langsung ke dalam kode halaman Anda. Ini akan memungkinkan pengunjung situs Anda memutar konten Flash secara otomatis tanpa memasang ekstensi apa pun.

Metode Paling Sederhana: Menggunakan Pemutar JavaScript

  1. Unduh file ruffle.js dan folder sumber daya ruffle dari halaman rilis.

  2. Unggah file-file ini ke server Anda (misalnya, ke folder seperti /js/ruffle/).

  3. Tambahkan kode berikut ke bagian <head> setiap halaman tempat konten Flash berada:

<script src="/js/ruffle/ruffle.js"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        // Pengaturan pemutar
        autoplay: "auto", // "on", "off" atau "auto"
        splashScreen: false, // Nonaktifkan layar splash
    };
</script>

  1. Ruffle akan secara otomatis mendeteksi semua elemen object, embed, dan applet di halaman dan menggantinya dengan pemutarnya sendiri.

Pengaturan Lanjutan melalui CDN (tanpa mengunduh file)

Untuk pengujian cepat, Anda dapat menggunakan CDN:

<script src="https://unpkg.com/@ruffle-rs/ruffle"></script>
<script>
    window.RufflePlayer = window.RufflePlayer || {};
    window.RufflePlayer.config = {
        autoplay: "on",
    };
</script>

Inisialisasi Manual untuk Konten yang Dimuat Secara Dinamis:

Jika file SWF ditambahkan ke halaman secara dinamis (melalui JavaScript), Anda dapat menginisialisasi pemutar secara manual:

const ruffle = window.RufflePlayer.newest();
const player = ruffle.createPlayer();
player.style.width = "800px";
player.style.height = "600px";
player.load("path/to/your/file.swf");
document.body.appendChild(player);

Memverifikasi Fungsionalitas

Setelah menginstal Ruffle menggunakan metode apa pun, Anda dapat memeriksa cara kerjanya:

  1. Versi desktop: Cukup buka file SWF apa pun.

  2. Ekstensi peramban: Kunjungi koleksi game Flash Internet Archive atau situs mana pun dengan konten Flash yang diketahui. Jika elemen Flash ditampilkan dan diputar, Ruffle berfungsi dengan benar.

  3. Diagnostik: Di peramban Anda, tekan F12 untuk membuka alat pengembang. Di konsol, Anda akan melihat pesan dari Ruffle yang mengonfirmasi aktivasi.

Pemecahan Masalah Umum

Masalah Kemungkinan Solusi
Ekstensi tidak aktif di situs Pastikan situs tidak diblokir dalam pengaturan ekstensi. Verifikasi bahwa mode pengembang diaktifkan di chrome://extensions/.
File SWF tidak diputar atau menampilkan layar putih Versi Ruffle saat ini mungkin tidak mendukung file SWF khusus ini. Periksa apakah kontennya adalah AVM2 (ActionScript 3), yang dukungannya masih disempurnakan.
Tidak dapat membuka file di versi desktop Pastikan file tidak rusak. Coba buka dari baris perintah dengan flag --verbose untuk mendapatkan log kesalahan yang mendetail.
Ekstensi menghilang setelah memulai ulang Firefox Ini adalah perilaku normal untuk ekstensi sementara. Gunakan versi desktop atau tunggu publikasi resmi di toko add-on.
Kinerja rendah di peramban Coba ganti backend rendering di pengaturan ekstensi. Untuk peramban Chromium, periksa juga apakah akselerasi perangkat keras diaktifkan di pengaturan peramban.