Parking Sensor

# ? Dokumentasi Script CLEO: Parking Sensor (v5.2.4)

Script ini adalah modifikasi **Parking Sensor (Sensor Parkir)** asli untuk game *GTA San Andreas* (dikhususkan untuk platform **SAMP / GTA SA-MP**). Mod ini berfungsi memberikan bantuan berkendara berupa indikator visual (HUD) dan peringatan suara (Bip) saat kendaraan mendekati objek di sekitarnya.

> ⚠️ **Catatan Lisensi Penting:** Mod ini memiliki status hak cipta **Strictly No Remake / No Modification**. Kode sumber ini hanya disajikan sebagai referensi pembelajaran dokumentasi dan dilarang keras untuk dimodifikasi, diubah strukturnya, ataupun didistribusikan ulang dalam bentuk modifikasi.

---

## ? Informasi Sistem

* **Format File:** CLEO Script (`.cs`)

* **Kompatibilitas:** GTA SA 1.0 US, CLEO 4.3, SAMPFUNCS 5.4.1

* **Arsip Aset:** Membutuhkan file database tekstur asli di `models\txd\PARKHUD.txd`

---

## ✨ Fitur & Logika Kerja Sistem

### 1. Sistem Deteksi Selimut 8 Arah (*Raycasting System*)

Sistem internal memindai rintangan di sekeliling kendaraan secara real-time melalui 8 zona deteksi:

* **4 Arah Utama:** Depan (*Front*), Belakang (*Rear*), Kiri (*Left*), dan Kanan (*Right*).

* **4 Arah Diagonal:** Depan-Kiri (*FL*), Depan-Kanan (*FR*), Belakang-Kiri (*RL*), dan Belakang-Kanan (*RR*).

* **Proteksi False Positive (v5.2.4):** Titik awal deteksi dirancang berada tepat di luar batas bumper kendaraan untuk mencegah sensor mendeteksi bodi kendaraan itu sendiri.

* **Sensor Elevasi Rendah:** Memiliki pemindai tambahan setinggi **0.63 meter** dari permukaan jalan yang mengikuti kontur tanah untuk mendeteksi pembatas jalan (*trotoar*) atau objek rendah.

### 2. Status Indikator Visual (HUD)

Visual indikator pada layar menggunakan skema warna adaptif berdasarkan jarak objek yang terdeteksi:

* ? **Hijau:** Area aman / bebas dari rintangan.

* ? **Kuning:** Peringatan waspada (objek mulai mendekat dalam jarak jangkauan sensor).

* ? **Merah:** Peringatan bahaya (objek sudah sangat dekat dengan bodi kendaraan).

### 3. Penyimpanan Konfigurasi (.INI Persistence)

Modifikasi ini dilengkapi dengan pembaca status otomatis yang terhubung ke file konfigurasi `CLEO\ParkingSensor.ini`. Sistem akan memuat pengaturan terakhir pengguna (seperti status audio aktif/mati dan mode tampilan) setiap kali game dimulai.

---

## ? Perintah Konsol / Chatbox (Client Commands)

Fitur bawaan mod ini dapat dioperasikan secara penuh di dalam game SAMP menggunakan perintah berikut:

| Perintah | Fungsi Utama |

| :--- | :--- |

| `/parkingsensor` | Mengaktifkan atau menonaktifkan seluruh fungsi sistem sensor parkir. |

| `/parkingsensoredit` | Mengaktifkan mode penyetelan posisi visual HUD di layar menggunakan tombol arah. |

| `/parkingsensorreset` | Mengembalikan posisi visual HUD di layar ke koordinat bawaan asli. |

| `/parkinghud` | Mengubah mode visual: **Obstacle Only** (muncul saat ada objek) atau **Always** (selalu tampil). |

| `/parkingsensorsound`| Mematikan/menghidupkan suara bip (visual HUD tetap bekerja mendeteksi). |

---

## ? Mekanisme Audio Peringatan

* **Urgensi Bip:** Frekuensi suara bip akan semakin cepat ketika status indikator berubah dari warna Kuning (`event 1057`) ke warna Merah (`event 1056`).

* **Batas Kecepatan Aman:** Sensor otomatis berhenti memindai dan menonaktifkan suara jika kendaraan melaju di atas kecepatan **15.0 unit** untuk kenyamanan pengendara saat melaju kencang.