Panduan Instalasi dan Penggunaan Auto Translate SAMP RP (Windows)

Terima kasih telah membeli Auto Translate Mod SAMP RP dari Solusi Roleplay. Panduan ini menjelaskan langkah instalasi dan konfigurasi mod pada sistem operasi Windows.

Persyaratan Sistem

Pastikan perangkat Anda memenuhi persyaratan berikut sebelum memulai:

1. GTA San Andreas dan SA-MP versi PC.
2. Moonloader 026 (atau versi terbaru yang kompatibel) sudah terpasang di folder GTA San Andreas.
3. Python 3.10 atau lebih baru sudah terpasang di Windows.

waspada

Saat menginstal Python, pastikan opsi Add Python to PATH dicentang.

Langkah 1: Ekstraksi Berkas Mod

1. Unduh berkas ZIP mod yang Anda terima setelah pembelian.

2. Ekstrak seluruh isi berkas ZIP langsung ke folder moonloader pada direktori GTA San Andreas Anda.

   Contoh lokasi default:

   C:\Program Files (x86)\GTA San Andreas\moonloader\

3. Pastikan folder moonloader memuat berkas berikut:

Berkas	Fungsi
AutoTranslate.lua	Skrip utama SA-MP
tr_server.py	Server latar belakang dan pengawas lisensi
translator.py	Mesin terjemahan
translate_config.json	Berkas konfigurasi

Langkah 2: Konfigurasi Lisensi dan Gemini API Key

1. Buka berkas translate_config.json di folder moonloader menggunakan Notepad atau editor teks lain, seperti VS Code atau Notepad++.

2. Isi default berkas konfigurasi adalah sebagai berikut:

   translate_config.json

   {
       "license_key": "MASUKKAN_LICENSE_KEY_DISINI",
       "product_code": "tr-id",
       "gemini_api_key": "MASUKKAN_GEMINI_API_KEY_DISINI",
       "model": "gemini-3.6-flash"
   }

3. Ubah nilai sesuai data Anda:

Kolom	Keterangan
license_key	License Key resmi yang Anda dapatkan saat pembelian dari Solusi Roleplay.
gemini_api_key	Opsional untuk Mode Slang. Isi dengan API Key Google Gemini untuk menggunakan fitur terjemahan bahasa gaul Amerika yang natural. Jika dikosongkan, mod tetap dapat digunakan dengan mode terjemahan Formal.

4. Simpan berkas dengan Ctrl + S, lalu tutup editor teks.

Langkah 3: Menjalankan Server Latar Belakang

Server latar belakang (tr_server.py) harus dijalankan sebelum Anda masuk ke game agar proses otentikasi lisensi dan terjemahan aktif.

1. Buka folder moonloader.

2. Jalankan tr_server.py dengan salah satu cara berikut:

   • Klik ganda berkas tr_server.py.

   • Atau buka Command Prompt (CMD) pada folder tersebut, lalu jalankan:

     python tr_server.py

3. Server akan memverifikasi lisensi ke server Solusi Roleplay. Jika lisensi valid, terminal menampilkan pesan berikut:

   [Solusi Roleplay] Memeriksa Lisensi Produk...
   [INFO] Menghubungkan ke server lisensi...
   
   [SUKSES] Lisensi Berhasil Diaktifkan/Valid! (valid)
   [INFO] Device ID terikat: xxxxxxxxxxxxxxxx
   [Solusi Roleplay] Translator Background Server Running...

peringatan

Jangan menutup jendela CMD atau terminal selama Anda bermain. Biarkan tetap terbuka di latar belakang.

Langkah 4: Pengujian dan Penggunaan di Dalam Game

1. Jalankan GTA SA-MP dan masuk ke server Roleplay yang diinginkan.
2. Jika tr_server.py berjalan dengan baik, mod akan memproses terjemahan secara otomatis.

Menerjemahkan Pesan Keluar (Outbound)

Ketik pesan seperti biasa menggunakan perintah RP standar.

• Terjemahan Formal: Mod secara otomatis mengonversi perintah seperti /me, /do, /s, atau percakapan biasa ke dalam bahasa Inggris formal.
• Terjemahan Slang: Jika Gemini API Key sudah dikonfigurasi, pesan Anda dikonversi ke bahasa slang sehari-hari yang natural.

Menerjemahkan Pesan Masuk (Inbound)

Pesan berbahasa Inggris dari pemain lain akan otomatis diterjemahkan ke bahasa Indonesia pada obrolan Anda.

Pemecahan Masalah

Error license_mismatch atau device_mismatch

• Penyebab: Lisensi sudah terikat ke komputer atau perangkat lain.
• Solusi: Hubungi dukungan pelanggan Solusi Roleplay atau admin Discord jika Anda ingin memindahkan lisensi ke perangkat baru.

Error Command python timed out

• Penyebab: Koneksi internet terganggu atau Google API mengalami keterlambatan respons.
• Solusi: Pastikan koneksi internet stabil. Mod akan mengulang pengiriman secara otomatis tanpa mengganggu permainan.

Mod Lua Tidak Merespons

• Pastikan tr_server.py sudah berjalan sebelum Anda menguji di dalam game.

Dukungan Teknis

Jika Anda mengalami kendala teknis atau memerlukan bantuan terkait lisensi, hubungi kami melalui:

• Discord Support: @elianvancuy
• Situs Resmi: docs.solusiroleplay.web.id