fivem-natives git:20260814.8f3a5c0A

Immutable. This exact content is served forever at /api/v1/blob/835b01c07ecd5b17.

---
name: fivem-natives
description: FiveM/GTA V native doğrulama ve arama veritabanı (7191 native, çevrimdışı). Bir FiveM Lua/JS kodu yazarken, düzenlerken veya incelerken native adı, imzası, parametre sırası ya da client/server tarafı söz konusu olduğunda MUTLAKA kullan — kullanıcı istemese bile. Native adını hafızadan yazma; önce doğrula. Tetikleyiciler - FiveM, Cfx, GTA V native, QBCore, QBX, ESX, ox_lib, client.lua/server.lua, fxmanifest, "bu native var mı", "hangi native", "server tarafında çalışır mı", "imzası ne", resmon/performans incelemesi, Lua lint.
---

# FiveM Native Veritabanı

FiveM nativelerini hafızadan yazmak en sık yapılan hatadır: var olmayan bir isim
(`GetPlayerMoney`), yanlış taraf (`DrawMarker` sunucuda) veya yanlış parametre
sırası üretilir ve script sessizce patlar. Bu skill bunu ölçülebilir hale getirir.

**Kural: Bir native adını ezberden yazma. Emin olmadığın her native için önce
`check` çalıştır.**

## Veri

`data/` içinde çevrimdışı, birleştirilmiş indeks:

| küme | adet |
|---|---|
| toplam native | 7191 |
| client-only | 6830 |
| shared (client + server) | 232 |
| server-only | 129 |

Kaynaklar: `runtime.fivem.net/doc/natives.json` (GTA V) +
`natives_cfx.json` (Cfx) + `citizenfx/fivem` kaynağındaki sunucu handler kayıtları.
Sağlama ve tarih için `python scripts/nativedb.py stats`.

> GTA V native listesi upstream'de `apiset` taşımaz — docs.fivem.net onları
> client varsayar. Sunucu erişilebilirliği Cfx bildirim setinden ve
> `ServerGameState_Scripting.cpp` içindeki `RegisterNativeHandler` kayıtlarından
> türetilir; iki taraf da destekliyorsa `shared` olarak işaretlenir.

## Komutlar

Plugin kökü `${CLAUDE_PLUGIN_ROOT}` (kurulu değilse `~/.claude/muto-atlas`).

```bash
# Var mı? Hangi tarafta? — kod yazmadan ÖNCE
python "$P/scripts/nativedb.py" check GetEntityCoords DrawMarker GetPlayerMoney

# Tam imza, parametre açıklamaları, docs linki, Lua örneği
python "$P/scripts/nativedb.py" show GetVehicleNumberPlateText

# Doğru nativei bul (ad hatırlanmıyorsa)
python "$P/scripts/nativedb.py" search vehicle fuel --apiset server

# Bir namespace'te sunucudan çağrılabilenler
python "$P/scripts/nativedb.py" ns VEHICLE --apiset server

# Yazdığın Lua'yı denetle
python "$P/scripts/lint_lua.py" resources/muto-lumber
```

`check` var olmayan native bulursa **exit 1** döner ve yakın isimleri önerir.

## Zorunlu akış

1. **Kod yazmadan önce** — kullanacağın nativeleri tek `check` çağrısında doğrula.
   Çıktıdaki `[client] / [server] / [shared]` etiketi hangi dosyaya yazacağını belirler.
2. **İmzayı `show`'dan al**, hafızadan değil. Parametre sırası ve tipleri oradadır.
3. **Kod yazdıktan/düzenledikten sonra** — dokunduğun kaynağa `lint_lua.py` çalıştır.
   E00x hatası kalmadan işi bitmiş sayma.
4. **Kullanıcıya native önerirken** docs linkini (`show` çıktısındaki `docs` satırı)
   birlikte ver.

`check` bir nativei bulamıyor ve yakın öneri de yoksa: **o native yoktur.** Uydurma.
Muhtemelen aradığın şey bir framework fonksiyonudur (QBCore/ox_lib exports) —
native değil. Bunu kullanıcıya açıkça söyle.

## Taraf disiplini

| dosya | çağırabileceği |
|---|---|
| `client.lua` | `client` + `shared` |
| `server.lua` | `server` + `shared` |
| `shared.lua` / config | yalnız `shared` |

Sunucuda **çalışmayan** yaygın yanlışlar: `DrawMarker`, `DrawText3D`,
`GetClockHours`, `RequestModel`, `TaskGoToCoord`, `PlaySoundFrontend`,
`SetNuiFocus`, tüm `HUD`/`GRAPHICS`/`CAM`/`STREAMING` namespace'i.

Sunucuda entity işi yapman gerekiyorsa `--apiset server` ile ara: `shared` işaretli
entity nativeleri (`GetEntityCoords`, `SetEntityCoords`, `DeleteEntity`,
`CreateVehicle`, `GetPlayerPed`) sunucu tarafında da geçerlidir.

`Wait`, `CreateThread`, `RegisterNetEvent`, `TriggerClientEvent`,
`PerformHttpRequest`, `GetPlayers` native değildir — Citizen runtime fonksiyonlarıdır,
veritabanında aranmazlar ve iki tarafta da vardır.

## Lint kuralları

| kural | anlamı |
|---|---|
| `E001` | native yok (yazım hatası veya uydurma) |
| `E002` | yanlış taraf — client-only native sunucu dosyasında |
| `E003` | fazla argüman — imzadan çok parametre verilmiş |
| `W101` | `RequestModel`/`RequestAnimDict` her karede çağrılıyor |
| `W102` | `GetGamePool`/`GetActivePlayers` `Wait(0)` döngüsünde |
| `W103` | mesafe hesabı her karede, sonuç önbelleklenmiyor |
| `W104` | eksik argüman — yasal ama kasıtlı olduğunu doğrula |

E00x hatadır, düzelt. W1xx uyarıdır; `GetEntityCoords(ped)` gibi yaygın deyimler
W104 üretir ve genelde sorun değildir — bakıp geç.

Linter `Bridge.HasItem()` gibi tablo/metot çağrılarını ve taranan dosyalarda
tanımlı yerel fonksiyonları native saymaz. Yine de bir yanlış pozitif görürsen
tanımın lint kapsamındaki dosyalarda olduğundan emin ol.

## Performans ve derinlik

Per-frame maliyet, entity önbellekleme ve resmon hedefleri için
`references/performance.md`. Sık karıştırılan native çiftleri ve doğru karşılıkları
için `references/pitfalls.md`.

## Güncelleme

Cfx yeni native eklediğinde:

```bash
python "$P/scripts/build_index.py" --fetch
```

Upstream'i yeniden indirir ve indeksi yeniden üretir.