Neocortex Logo

Cara Membuat NPC AI di Godot | Panduan 2026

Cara membuat NPC AI di Godot pada 2026: HTTPRequest dan API model, Neocortex Godot SDK, model lokal dengan NobodyWho, dan plugin Player2.

Sercan AltundasFounder of Neocortex

· 9 menit baca

Cara membuat NPC AI di Godot pada 2026: HTTPRequest dan API model, Neocortex Godot SDK, model lokal dengan NobodyWho, dan plugin Player2.

Anda membuat NPC AI di Godot dengan mengirim apa yang diucapkan pemain ke model bahasa dan menampilkan atau mengucapkan balasannya: melalui node HTTPRequest bawaan Godot dan API model, melalui SDK karakter, atau melalui add-on yang menjalankan model di mesin pemain. Godot tidak memiliki fitur karakter AI sendiri, jadi setiap jalur menambahkan GDScript atau add-on.

Panduan ini ditujukan untuk developer Godot 4 yang menginginkan karakter yang menjawab dengan kata-kata mereka sendiri, bukan dari pohon dialog. Panduan ini membahas empat cara: HTTPRequest dengan API model, Neocortex Godot SDK, model lokal dengan NobodyWho, dan plugin NPC AI Player2. Setiap cara disertai langkah-langkahnya, apa yang dibutuhkan dan biayanya, diikuti tabel perbandingan, tips untuk metode apa pun, dan pertanyaan yang sering diajukan.

4 cara membuat NPC AI di Godot

Keempatnya dimulai dengan sebuah node di scene Anda yang mewakili karakter dan sebuah input untuk pemain, berupa LineEdit atau mikrofon. Perbedaannya ada pada di mana model berjalan, siapa yang membayarnya, dan seberapa banyak GDScript yang Anda tulis.

Metode 1: HTTPRequest dan API model

Jalur ini hanya memakai apa yang sudah disertakan Godot. Node HTTPRequest adalah "node dengan kemampuan mengirim permintaan HTTP", sehingga sebuah skrip dapat mengirim kalimat pemain ke penyedia model dan membaca jawabannya. Kami memakai OpenAI Responses API sebagai contoh.

Yang dibutuhkan: API key dari penyedia model dan sedikit GDScript.

  1. Buat API key. Untuk OpenAI, buat di platform.openai.com/api-keys.
  2. Tambahkan node HTTPRequest. Jadikan node anak dari scene NPC Anda dan hubungkan sinyal request_completed-nya ke sebuah fungsi di skrip NPC.
  3. Tulis karakternya. Simpan string instruksi sistem berisi nama, peran, nada, dan batasan karakter.
  4. Kirim kalimatnya. Susun body JSON berisi model, instruksi, dan pesan pemain, lalu panggil request() dengan https://api.openai.com/v1/responses, header Authorization: Bearer <key> dan Content-Type: application/json, metode POST, dan body-nya.
  5. Baca balasannya. Di handler request_completed, parse body sebagai JSON dan letakkan teksnya di Label atau RichTextLabel di atas NPC.
  6. Simpan riwayat. Simpan giliran terbaru dalam Array dan kirimkan bersama setiap permintaan; model melupakan semuanya di antara panggilan.
  7. Bangun tambahannya. Suara, lip sync, dan aksi adalah pekerjaan Anda sendiri: lebih banyak panggilan API untuk ucapan, dan aturan Anda sendiri untuk mengubah balasan menjadi gameplay.
  8. Jaga keamanan key. Dokumentasi Godot menganjurkan TLS dan memperingatkan agar tidak mengirim informasi sensitif. Key di dalam game yang diekspor dapat dibaca, jadi letakkan server Anda sendiri di depan penyedia sebelum rilis.

Biaya: Godot gratis. Anda membayar tarif per token dari penyedia.

Kekurangannya: memori, suara, aksi, keamanan, dan server key semuanya harus Anda bangun dan pelihara sendiri.

Metode 2: Neocortex Godot SDK

Neocortex adalah produk kami, jadi bacalah bagian ini dengan itu dalam pikiran. Anda merancang karakter di editor visual di browser, lalu menggunakannya di Godot melalui add-on open-source (Apache 2.0). Kepribadian, pengetahuan, emosi, suara, dan aksi adalah node di editor; di Godot, Anda menambahkan node yang sudah jadi. Halaman NPC AI Godot memuat daftar lengkapnya.

Yang dibutuhkan: Godot 4.7 atau lebih baru dan akun Neocortex dengan API key.

  1. Buat karakter. Di dasbor, buka Characters, klik Create New Character, masukkan nama, dan klik Create. Bangun karakter itu di node editor.
  2. Uji di browser. Klik Play di kanan atas editor.
  3. Buat API key. Buka API Keys di dasbor.
  4. Pasang add-on. Unduh rilis terbaru dari https://github.com/neocortex-link/neocortex-godot-sdk/releases/latest dan salin addons/neocortex-godot-sdk ke folder addons proyek Anda.
  5. Aktifkan. Buka Project > Project Settings > Plugins dan aktifkan Neocortex. Tempelkan API key Anda di dock Neocortex.
  6. Tambahkan chat dalam satu langkah. Pilih Project > Tools > Neocortex > Complete Text Chat atau Complete Voice Chat. Ini menambahkan chat yang berfungsi ke scene; pilih karakter dari dropdown Inspector.
  7. Hubungkan ke game Anda. Gunakan node NeocortexSmartAgent untuk karakter, NeocortexAudioReceiver untuk mikrofon, NeocortexFaceAnimator untuk lip sync pada blend shape gaya ARKit, NeocortexInteractable untuk objek yang harus diketahui karakter, dan NeocortexEventLogger untuk hal-hal yang terjadi. Node Action di editor mengirim nama aksi yang dapat ditindaklanjuti oleh GDScript Anda.
  8. Buka contohnya. Tujuh scene contoh dan launcher-nya terbuka dari dock Neocortex: Text Chat, Audio Chat, Actions, Interactables, Group Chat, Usage Gating, dan Quiz Show.

Batasan yang perlu diketahui: rekaman berhenti pada 29 detik, suara yang lebih pendek dari 0,15 detik tidak dikirim, dan permintaan chat habis waktu setelah 30 detik.

Biaya: Starter €9, Pro €29, dan Team €99 per bulan dengan penagihan tahunan, atau €11, €35, dan €119 dengan penagihan bulanan. Penggunaan komersial membutuhkan Pro atau Team. Lihat harga.

Kekurangannya: karakter berjalan di cloud kami, sehingga game membutuhkan koneksi. Game yang diekspor membawa API key-nya, jadi atur batas penggunaan untuknya. Group chat membutuhkan Pro atau Team, kuis membutuhkan Team, dan dokumentasi kami tidak mencantumkan setiap target ekspor.

Mulai sekarang

Metode 3: Model lokal dengan NobodyWho

NobodyWho adalah mesin inferensi open-source yang menjalankan model bahasa di mesin pemain, dengan add-on Godot. Readme-nya menyatakan bahwa ia tidak memerlukan "API key" dan tidak memiliki biaya tersembunyi.

Yang dibutuhkan: Godot 4.6 atau yang lebih baru (sesuai dokumentasi Godot-nya), dan model dalam format GGUF.

  1. Pasang. Di Godot, buka tab AssetLib, cari NobodyWho, unduh, dan impor dengan centang Ignore asset root. Atau salin addons/nobodywho dari sebuah rilis ke proyek Anda. Mulai ulang atau muat ulang editor.
  2. Pilih model. Model GGUF apa pun bisa dipakai. Readme menyarankan Qwen3 0.6B untuk memulai; model remote diunduh dan disimpan dalam cache saat pertama kali dipakai.
  3. Buat chat. Dalam skrip, panggil await NobodyWhoChat.create(<model path>, {}).
  4. Ajukan pertanyaan. Panggil chat.ask(<player text>) dan await hasilnya completed(). Dokumentasi menyarankan untuk selalu await nilai yang dikembalikan segera.
  5. Tulis perannya. Beri chat instruksi karakter, dengan mengikuti bagian Chat di dokumentasi NobodyWho.
  6. Periksa target Anda. NobodyWho mendukung ekspor desktop dan Android Godot. Tidak ada ekspor iOS atau web.

Biaya: Gratis untuk penggunaan komersial di bawah EUPL-1.2. Jika Anda mengubah kode NobodyWho sendiri, perubahan itu harus dibuka sebagai open source.

Kekurangannya: kecepatan dan kualitas balasan bergantung pada perangkat keras pemain dan ukuran model, dan model menambah ukuran unduhan. Fitur suara tercantum untuk engine-nya; periksa apakah binding Godot memilikinya sebelum Anda merencanakannya.

Metode 4: Plugin NPC AI Player2

Player2 adalah aplikasi desktop dengan API lokal untuk game dan mod. Plugin Godot-nya "menggunakan API AI gratis dari aplikasi Player2" dan terhubung saat aplikasi sedang terbuka.

Yang dibutuhkan: Godot 4.5 (sesuai daftar di Asset Library), client ID developer Player2, dan aplikasi Player2.

  1. Pasang plugin. Ambil dari Godot Asset Library atau GitHub, dan seret folder addons ke proyek Anda.
  2. Tambahkan client ID Anda. Buat di player2.game/profile/developer dan masukkan di Project Settings > Player2 > Game Key.
  3. Tambahkan node NPC. Tambahkan node Player2 AI NPC ke scene dan edit deskripsi agen.
  4. Hubungkan chat. Panggil fungsi chat pada node dengan teks pemain dan hubungkan sinyal chat_received-nya untuk menampilkan balasan. Panggil notify untuk memberi tahu agen tentang peristiwa di dunia.
  5. Tambahkan suara. Atur Voice ID di Character Config atau tambahkan node Player2TTS; untuk input suara, tambahkan Player2STT dan aktifkan audio input di Project Settings > Audio.
  6. Jalankan Player2. Buka aplikasi Player2; plugin terhubung secara otomatis.

Biaya: Gratis untuk kreator, menurut halaman Player2. Plugin ini berlisensi GPLv3.

Kekurangannya: situs Player2 menyatakan API lokalnya bekerja saat aplikasi terbuka, jadi rencanakan untuk pemain yang tidak memiliki aplikasi. Periksa lisensi GPLv3 terhadap proyek Anda.

Perbandingan keempat metode

FaktorHTTPRequest dan APINeocortex SDKNobodyWhoPlugin Player2
Tempat karakter didefinisikanString di GDScriptEditor node visual di browserGDScript AndaDeskripsi node di Godot
Tempat model berjalanCloud penyediaCloud NeocortexPerangkat pemainMelalui aplikasi Player2
Versi Godot4.x dengan HTTPRequest4.7 atau lebih baru4.6 atau lebih baru4.5 tercantum
SuaraBangun sendiriDisertakan, dengan lip syncTercantum untuk engineNode TTS dan STT
Lisensi add-onTidak diperlukanApache 2.0EUPL-1.2GPLv3
Biaya awalTarif token penyediaMulai €9 per bulanGratisGratis untuk kreator
Keterampilan yang dibutuhkanGDScript, HTTP, serverMenyalin add-on, menambahkan nodeGDScript, memilih modelMenambahkan node

HTTPRequest memberi kendali penuh dengan kode paling banyak. NobodyWho adalah jalur offline, terikat pada perangkat keras pemain. Neocortex menyimpan karakter di editor yang di-host, dengan suara, lip sync, dan sampel. Player2 adalah node tercepat untuk ditambahkan dan bergantung pada aplikasinya.

Tips untuk hasil Godot yang lebih baik

Kebiasaan ini membantu untuk setiap metode.

  1. Jauhkan key dari ekspor. Apa pun di dalam proyek yang diekspor dapat dibaca. Simpan file pengaturan berisi key di luar version control, dan gunakan server atau batas penggunaan per pemain dan per karakter.
  2. Tunjukkan bahwa NPC mendengar pemain. Beralih ke animasi "berpikir" atau beri label pada saat permintaan dimulai, agar masa tunggu balasan tidak pernah terlihat seperti game yang membeku.
  3. Beri tahu karakter tentang scene. Kirim objek terdekat dan peristiwa terbaru bersama setiap pesan, agar NPC berbicara tentang ruangan tempat ia berdiri.
  4. Biarkan GDScript membuat keputusan akhir tentang aksi. Simpan daftar pendek aksi yang boleh diminta karakter, dan periksa setiap aksi dalam kode sebelum dijalankan.
  5. Gunakan pohon dialog untuk alur cerita. Simpan baris yang menggerakkan cerita dalam add-on dialog terskrip dan gunakan karakter AI untuk segala hal di sekitarnya. Postingan plugin Godot kami mencantumkan add-on untuk bagian terskrip.

Memilih metode yang tepat untuk Godot

HTTPRequest dan API model cocok jika Anda tidak menginginkan add-on, menginginkan kendali penuh atas setiap permintaan, dan dapat menjalankan server kecil untuk key-nya.

Neocortex SDK cocok jika Anda ingin merancang karakter secara visual, mengujinya di browser, dan mendapatkan suara, lip sync, aksi, dan sampel di Godot 4.7, dengan karakter yang sama dapat dipakai di Unity dan Unreal Engine.

NobodyWho cocok jika game harus berjalan offline tanpa biaya berjalan, di desktop atau Android.

Plugin Player2 cocok jika pemain Anda sudah memakai aplikasi Player2, atau Anda sedang membuat prototipe dan menginginkan langkah paling sedikit.

Untuk pilihan lain, lihat alat NPC AI terbaik untuk Godot, dan jika Anda masih memilih engine, Godot vs Unity.

Pertanyaan yang sering diajukan

Bisakah saya membuat NPC AI di Godot secara gratis?

Bisa. NobodyWho gratis dan menjalankan model secara lokal, Player2 gratis untuk kreator. API model yang Anda panggil sendiri mengenakan biaya per token.

Apakah Godot punya NPC AI bawaan?

Tidak. Godot memberi Anda node HTTPRequest untuk panggilan web, tetapi tidak ada model bahasa atau sistem karakter. Postingan Godot AI kami membahas apa yang ada di sekitar engine.

Versi Godot apa yang saya butuhkan?

Neocortex membutuhkan Godot 4.7 atau lebih baru, NobodyWho 4.6 atau lebih baru, dan plugin Player2 mencantumkan 4.5. HTTPRequest adalah bagian dari Godot 4.

Bisakah NPC AI Godot berjalan offline?

Bisa, dengan model lokal seperti NobodyWho di desktop atau Android. Rute cloud, termasuk Neocortex, membutuhkan koneksi.

Apakah Neocortex Godot SDK open source?

Ya. Lisensinya Apache 2.0, dan sumbernya ada di GitHub di neocortex-link/neocortex-godot-sdk. Laporan bug dan ide sangat diterima di sana.

Apakah NPC AI Godot berfungsi di ekspor web?

Bergantung pada rutenya. NobodyWho tidak memiliki ekspor web. Untuk game browser di luar Godot, Neocortex juga memiliki Web SDK.

Artikel serupa

Baca juga