FaceNinja

Creator Kit · untuk VTuber · gratis

Wajah Anda. Streaming Anda.

Ubah kepala FaceNinja Anda menjadi MetaHuman yang berbicara dan bergerak bersama Anda, di panggung kecil dalam Unreal Engine 5.8. Agen coding Anda membangunnya dari tujuh prompt. Anda mengetik, ia berbicara; Anda tersenyum, ia tersenyum. Lalu Anda menangkapnya di OBS.

Versi 0.3.1 · 6,6 MB · lisensi MIT · Windows dan Mac

Ukuran dan SHA-256 untuk skrip dan agen: version.json

Tentang kit
Versi0.3.1
Unduhan6,6 MB · zip
LisensiMIT, gratis untuk kanal yang dimonetisasi
KebutuhanUnreal Engine 5.8 (gratis), kepala FaceNinja, dan agen coding yang bisa memakai MCP
Berjalan diWindows 10 atau 11, macOS 14 atau lebih baru

Satu foto, lalu kepala yang bisa bicara.

Video demo Creator Kit
Satu foto buatan AI, lalu kepala FaceNinja yang dibuat darinya, lalu kepala itu berbicara di ruangan milik kit, dirender di Unreal 5.8. Kalimat pertama: suara Kokoro gratis dengan lip sync dari audio gratis milik Epic. Kalimat kedua: suara ElevenLabs dengan plugin berbayar Runtime MetaHuman Lip Sync. Kepala yang berbicara adalah kepala ARKit FaceNinja (52 blendshape) pada body dan rambut dari MetaHuman Creator, dirender secara offline.

Semua orang dalam video ini sintetis. Pakai wajah dan suara Anda sendiri, atau karakter orisinal.

Unduh video (MP4, 7,3 MB)

Tiga bagian, satu malam.

  1. Kepala Anda

    Buat kepala dari foto Anda di FaceNinja, lalu unduh MetaHuman ZIP.

  2. Agen Anda membangun panggungnya

    Ekstrak kit, buka agen coding Anda di folder itu, lalu tempel tujuh prompt satu per satu. Agen mengendalikan Unreal lewat server MCP milik Unreal sendiri dan tool bawaan kit.

  3. Anda streaming

    iPhone atau webcam Anda menggerakkan wajahnya. Ketik satu kalimat dan avatar Anda mengucapkannya. OBS menangkap jendelanya.

Tidak ada kode yang perlu ditulis. Setiap prompt berakhir dengan sesuatu yang bisa Anda periksa.

Unduhan kecil, semuanya sudah terhubung.

Ruang streaming

Ruangan kecil yang hangat dengan sofa, rak buku, tanaman, dan lampu lembut, tiga kamera (close-up, setengah badan, lebar), dan green screen yang bisa dinyalakan.

MetaHuman Anda

Satu tool mengimpor MetaHuman ZIP Anda, mencocokkan wajah MetaHuman Creator dengannya secara tepat, dan memilih rambut, alis, serta bulu mata yang paling mirip.

Face tracking

Live Link Face di iPhone, atau face tracking webcam dari Epic.

Ketik untuk bicara

Panel kecil dan server suara di komputer Anda. Suara Kokoro yang gratis mulai berbicara dalam sekitar 0,1 s pada kartu grafis terbaru.

Siap untuk OBS

Putar di jendela 1920×1080 untuk window capture OBS, dengan green screen saat Anda ingin latar sendiri. NDI di Mac dan Spout di Windows tersedia sebagai opsi.

Kepala GLB dan FBX juga

Kit ini juga memasukkan GLB atau FBX kepala Anda beserta 52 blendshape ARKit-nya, dalam ukuran asli dan dengan pengaturan material yang dibutuhkan Unreal untuk menampilkannya.

Ditambah catatan agen (AGENTS.md) dan pengaturan MCP untuk Claude Code, Codex, Cursor, VS Code, dan Gemini CLI.

Yang Anda perlukan.

Komputer, perangkat lunak, dan akun
ApaDisarankanMinimum
KomputerWindows 11 dengan NVIDIA RTX 3070 atau lebih baik, atau Mac dengan M2 Max atau lebih baru dan memori 32 GBPC dengan kartu RTX dan RAM 16 GB, atau Mac dengan M1 atau lebih baru dan 16 GB (frame rate lebih rendah)
Disk150 GB kosong100 GB kosong
Perangkat lunakUnreal Engine 5.8, OBS, kabel audio virtual (VB-CABLE atau BlackHole), dan agen coding. Prompt 1 memeriksa dan memasangnya bersama Anda.
AkunFaceNinja, dan akun Epic Games gratis untuk rig MetaHuman Creator
OpsionaliPhone 12 atau lebih baru dengan aplikasi Live Link Face yang gratisWebcam

Gratis secara default.

Gratis

  • Kit-nya (lisensi MIT)
  • Unreal Engine 5.8, MetaHuman Creator, dan Live Link Face
  • Lip sync dari audio milik Epic
  • OBS, BlackHole, dan VB-CABLE (donasi diterima)
  • Suara Kokoro dan Chatterbox, di komputer Anda

Berbayar, hanya jika dipilih

  • Kepala FaceNinja Anda, dalam kredit (harga)
  • Suara ElevenLabs, di akun ElevenLabs Anda sendiri dan ditagih ElevenLabs per karakter
  • Plugin Runtime MetaHuman Lip Sync di Fab: sekitar US$280 per seat untuk kreator dengan pendapatan di bawah US$100.000 setahun, US$840 di atasnya

Unreal tidak memungut royalti atas video yang di-stream atau direkam. Harga produk perusahaan lain per Oktober 2026; periksa situs mereka.

Salin, tempel, periksa.

Tempel secara berurutan, satu per satu, dan tunggu sampai agen Anda selesai. Masing-masing berakhir dengan apa yang seharusnya Anda lihat.

Prompt tetap berbahasa Inggris di setiap versi bahasa, karena agen Anda memerlukan nama tool dan file persis seperti aslinya. Anda tetap bisa berbicara dengan agen Anda dalam bahasa Anda sendiri.

01 · Pasang yang Anda perlukan

Waktu: 20–90 menit, sebagian besar mengunduh

Prompt · Inggris
I am setting up the FaceNinja Creator Kit in this folder. I do not write code, so explain each step in one short
sentence and ask me before anything that needs my password, installs a driver, or changes system settings.

1. Tell me my operating system, CPU, RAM, graphics card and free disk space, and compare them with the
   "What you need" table in GUIDE.md. Warn me if something is below the minimum.
2. Check what is installed and tell me what is missing:
   - Unreal Engine 5.8 (Windows: C:\Program Files\Epic Games\UE_5.8; Mac: /Users/Shared/Epic Games/UE_5.8).
     If it is missing, do not install it yourself: tell me to install Unreal Engine 5.8 from the Epic Games
     Launcher's Library tab (default options), and wait until I say it is done.
   - OBS Studio. Offer to install it (Windows: winget install OBSProject.OBSStudio; Mac: brew install --cask obs).
   - A virtual audio cable. Windows: VB-CABLE from https://vb-audio.com/Cable/ (I run its installer as
     administrator and restart). Mac: brew install --cask blackhole-2ch (it asks for my password).
     Only from these places.
   - uv (https://docs.astral.sh/uv/getting-started/installation/).
3. In tts/, make the voice environment: uv venv -p 3.11, then uv pip install -r requirements-kokoro.txt
   (on a PC with an NVIDIA card add --extra-index-url https://download.pytorch.org/whl/cu128).
4. Run uv run python server.py --list-devices in tts/ and show me the output devices.

End with a checklist: Unreal 5.8, OBS, virtual cable, voice environment, each with a tick or a cross.

Yang seharusnya Anda lihat: empat tanda centang: Unreal 5.8, OBS, kabel, dan suara.

02 · Hubungkan agen Anda ke Unreal

Waktu: 10–20 menit

Prompt · Inggris
Open the kit's Unreal project and connect to Unreal's own MCP server.

1. Open FaceNinjaCreatorKit/FaceNinjaCreatorKit.uproject with Unreal Engine 5.8 (Mac: open -a with
   "/Users/Shared/Epic Games/UE_5.8/Engine/Binaries/Mac/UnrealEditor.app" and the project path; Windows:
   "C:\Program Files\Epic Games\UE_5.8\Engine\Binaries\Win64\UnrealEditor.exe" with the project path).
   Tell me the first start takes several minutes while it compiles shaders.
2. The project starts Unreal's MCP server at http://127.0.0.1:8000/mcp. This folder already has the MCP
   settings for you (.mcp.json, .cursor, .vscode, .gemini, .codex). If you cannot see an "unreal-mcp" server,
   tell me how to reload your MCP settings, or add that URL yourself.
3. Wait until the server answers, then list the toolsets. You should find FaceNinjaKitTools. Describe it and
   tell me in one sentence per tool what you can now do for me.

Yang seharusnya Anda lihat: agen Anda menampilkan daftar tool FaceNinja.

03 · Bangun panggung Anda

Waktu: 2–5 menit

Prompt · Inggris
Using FaceNinjaKitTools in Unreal, build my streaming stage.

1. Call build_stage. It makes a small room with a sofa, a bookshelf, a plant, lights and three cameras.
2. Take a still from each camera with stage_screenshot (closeup, bust, wide) and show them to me.
3. Ask me which camera I want for streaming and call set_camera with it.

Yang seharusnya Anda lihat: tiga gambar diam dari ruangan.

04 · Masukkan kepala FaceNinja Anda

Waktu: 15–30 menit

Prompt · Inggris
Using FaceNinjaKitTools in Unreal, turn my FaceNinja head into a MetaHuman and put it on my stage.
My head ZIP is: <drag the ZIP file here>

1. Call import_head_zip with that path. Tell me which hair, brows and lashes it picked.
2. Tell me that the next step sends my head's shape (not my photos) to Epic's free MetaHuman service, and that
   a browser window may ask me to sign in to my Epic account. Wait for my OK.
3. Call preview_avatar so I can see my head in the room, and show me a stage_screenshot (bust camera).
4. Call rig_head, then download_head_textures. Tell me: "A browser opens Epic's sign-in page. Unreal stops
   answering until you sign in and approve it there; that is normal." Wait until I say I approved it, then
   check head_status every 30 seconds until rigged and high_res_textures are both true.
5. Once rigged: call build_metahuman, then place_avatar.
6. Take a stage_screenshot with the bust camera and show it to me.

Yang seharusnya Anda lihat: MetaHuman Anda di dalam ruangan.

05 · Hubungkan iPhone atau webcam

Waktu: 10 menit

Prompt · Inggris
Using FaceNinjaKitTools in Unreal, connect my iPhone's Live Link Face app to my avatar.

1. Call my_ip_address. Tell me where to type it in the app (Settings > Live Link > Add Target, port 14785).
2. Ask me for the phone's IP address (Live Link Face shows it in its settings), then call connect_iphone.
3. Call connect_face with FN_iPhone, then play_in_window.
4. Ask me to smile, blink and turn my head, and whether the avatar follows. Ask before changing any firewall
   setting.

Yang seharusnya Anda lihat: avatar menirukan wajah Anda.

06 · Ketik untuk bicara

Waktu: 10 menit

Prompt · Inggris
Start the kit's voice server and connect it to my avatar.

1. Ask me which voice I want:
   a. a free preset voice that runs on my computer (Kokoro, default),
   b. my own voice (Chatterbox): ask me to record 10-20 seconds of myself reading any text in a quiet room as
      tts/my_voice.wav, then set it up with requirements-chatterbox.txt,
   c. a studio voice from ElevenLabs: it needs my own ElevenLabs account, costs money per line and sends my text to ElevenLabs.
      Ask me to put my own ElevenLabs API key in the ELEVENLABS_API_KEY environment variable myself; never write it to a file.
2. In tts/ start the server in the background with my cable as --device ("BlackHole" on a Mac, "CABLE Input" on
   Windows):
   a. uv run python server.py --engine kokoro --preset af_heart --device "<cable>"
   b. uv run python server.py --engine chatterbox-turbo --voice my_voice.wav --device "<cable>"
   c. uv run python server.py --engine elevenlabs --voice Rachel --device "<cable>"
3. In Unreal, using FaceNinjaKitTools: voice_status, then connect_voice (it listens on the cable), then
   connect_face with FN_Voice, then play_in_window, then open_talk_panel.
4. Call say with "Hi everyone, welcome back to the stream!" and ask me if the lips moved with the voice.

Yang seharusnya Anda lihat: avatar mengucapkan kalimat Anda dengan bibir yang bergerak.

07 · Siaran langsung dengan OBS

Waktu: 10 menit

Prompt · Inggris
Help me show my avatar in OBS Studio.

1. In Unreal, using FaceNinjaKitTools: play_in_window (1920x1080). If I want my own background instead of the
   room, call set_green_screen with true first.
2. In OBS add a "Window Capture" (Windows) or "macOS Screen Capture" set to that Unreal window. Tell me the
   clicks; you cannot click in OBS for me.
3. Only with the green screen: add a "Chroma Key" filter (key colour green) and show me where "Similarity" is.
4. Add an "Audio Input Capture" of "CABLE Output" (Windows) or "BlackHole 2ch" (Mac), and set its
   "Audio Monitoring" to "Monitor and Output" so I hear the voice too.

Yang seharusnya Anda lihat: avatar Anda di OBS, lengkap dengan suaranya.

Setiap langkah, beserta apa yang harus dilakukan saat ada yang tidak berfungsi, ada di GUIDE.md di dalam zip.

Tiga jenis suara.

Suara untuk fitur ketik untuk bicara
SuaraBerjalan diBunyi pertamaBiayaCatatan
Kokoro (default)Komputer AndaSekitar 0,08 s di RTX 5080, 0,09 s di Mac M5 MaxGratis (Apache-2.0)54 suara preset dalam 8 bahasa
Suara Anda sendiri (Chatterbox)Komputer AndaSekitar 0,7–1,1 s di RTX 5080 atau Mac M5 MaxGratis (MIT)Dari rekaman suara Anda sendiri sepanjang 10–20 detik. Setiap klip membawa watermark yang tidak terdengar, yang menandainya sebagai sintetis.
Suara cloud (ElevenLabs)CloudTergantung koneksi Anda; tidak kami ukurDitagih ElevenLabs, per karakter, sesuai paket AndaKalimat yang Anda ketik dikirim ke ElevenLabs. Anda membawa akun dan kunci API ElevenLabs sendiri.

Bunyi pertama: waktu dari mengirim satu kalimat sampai audio pertama, diukur lewat server suara kit pada Oktober 2026.

Pertanyaan tentang kit.

01Apakah saya perlu menulis kode?
Tidak. Anda menempel prompt; agen Anda menjalankan tool dan menunjukkan gambar hasilnya.
02Apakah bisa dipakai di Mac?
Bisa, di Mac dengan M1 atau lebih baru dan Unreal 5.8. Tool wajah real-time dari Epic berjalan di Mac mulai Unreal 5.8.
03Apa yang keluar dari komputer saya?
Bentuk kepala Anda dikirim ke Epic saat MetaHuman Creator membangun rig. Kalau Anda memilih suara cloud, kalimat yang Anda ketik dikirim ke ElevenLabs. Hanya itu: tidak ada foto, tidak ada rekaman.
04Bolehkah saya menjual video yang dibuat dengannya?
Boleh. Kit-nya berlisensi MIT, Unreal tidak memungut royalti atas video, dan Kokoro serta Chatterbox mengizinkan penggunaan komersial. Periksa ketentuan ElevenLabs dan Fab untuk bagian milik mereka.
05Apakah plugin lip sync berbayarnya termasuk?
Tidak. Plugin itu dijual per seat di Fab. Jalur gratis memakai lip sync dari audio milik Epic.
06Bisakah avatar saya dibagikan sebagai aplikasi?
Tidak dengan lip sync gratis: sumber audio Epic bekerja di editor (Play), yaitu cara siaran VTuber berjalan. Aplikasi yang dipaketkan memerlukan plugin berbayar.
07Saya hanya punya GLB atau FBX. Bisakah dipakai?
Bisa, untuk gambar diam dan animasi. File-nya berukuran meter, sehingga kepala masuk dalam ukuran asli, dan kit menyalakan Used with Morph Targets pada materialnya agar blendshape tidak dirender hitam. Wajah dan suara langsung menggerakkan MetaHuman, jadi pakai MetaHuman ZIP untuk streaming. Selengkapnya di catatan Unreal EN.

Lisensi.

Kit-nya berlisensi MIT (LICENSE di dalam zip). Seni ruangannya CC0 dari Poly Haven. Semua yang lain (Unreal, MetaHuman, OBS, kabel, suara, plugin opsional) Anda pasang sendiri, di bawah lisensinya masing-masing; THIRD_PARTY.md di dalam zip mencantumkan masing-masing beserta tautannya.

Siap? Buat kepala Anda, lalu unduh kitnya.