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
Versi
0.3.1
Unduhan
6,6 MB · zip
Lisensi
MIT, gratis untuk kanal yang dimonetisasi
Kebutuhan
Unreal Engine 5.8 (gratis), kepala FaceNinja, dan agen coding yang bisa memakai MCP
Berjalan di
Windows 10 atau 11, macOS 14 atau lebih baru
Satu foto, lalu kepala yang bisa bicara.
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.
Buat kepala dari foto Anda di FaceNinja, lalu unduh MetaHuman ZIP.
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.
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
Apa
Disarankan
Minimum
Komputer
Windows 11 dengan NVIDIA RTX 3070 atau lebih baik, atau Mac dengan M2 Max atau lebih baru dan memori 32 GB
PC dengan kartu RTX dan RAM 16 GB, atau Mac dengan M1 atau lebih baru dan 16 GB (frame rate lebih rendah)
Disk
150 GB kosong
100 GB kosong
Perangkat lunak
Unreal Engine 5.8, OBS, kabel audio virtual (VB-CABLE atau BlackHole), dan agen coding. Prompt 1 memeriksa dan memasangnya bersama Anda.
Akun
FaceNinja, dan akun Epic Games gratis untuk rig MetaHuman Creator
Opsional
iPhone 12 atau lebih baru dengan aplikasi Live Link Face yang gratis
Webcam
Gratis secara default.
Gratis
Kit-nya (lisensi MIT)
Unreal Engine 5.8, MetaHuman Creator, dan Live Link Face
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
Suara
Berjalan di
Bunyi pertama
Biaya
Catatan
Kokoro (default)
Komputer Anda
Sekitar 0,08 s di RTX 5080, 0,09 s di Mac M5 Max
Gratis (Apache-2.0)
54 suara preset dalam 8 bahasa
Suara Anda sendiri (Chatterbox)
Komputer Anda
Sekitar 0,7–1,1 s di RTX 5080 atau Mac M5 Max
Gratis (MIT)
Dari rekaman suara Anda sendiri sepanjang 10–20 detik. Setiap klip membawa watermark yang tidak terdengar, yang menandainya sebagai sintetis.
Suara cloud (ElevenLabs)
Cloud
Tergantung koneksi Anda; tidak kami ukur
Ditagih ElevenLabs, per karakter, sesuai paket Anda
Kalimat 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.
Wajah Anda, suara Anda.
Pakai wajah dan suara Anda sendiri, karakter orisinal, atau orang yang setuju secara tertulis. Jangan membuat tiruan wajah selebritas, streamer, atau siapa pun, dan jangan membuat kloning suara orang lain. Itu adalah peniruan identitas: bisa melanggar hukum (hak kepribadian dan hak publisitas), dan melanggar aturan YouTube, Twitch, dan Epic.
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 UnrealEN.
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.