ai-jobs
Bir depoda başlayan iş rotaları (taksi, otobüs, tır, çöp, haber, çekici, geri dönüşüm, bağ, dalış) ve sosisli büfesi.
ai-jobs oyunculara bir depoda başlatabilecekleri basit işler verir: bir rotada araç sür ve durak başına para al, arızalı araçları çek ya da yürüyerek eşya topla. Rotaların yanında bir sosisli büfesi de yürütür: bir araba kirala, etrafta it, pişir ve gelip geçenlere sat. Her rota ve her durak admin panelinde ayarlanır, bu yüzden kod yazmadan yeni meslekler ekleyebilirsin.
Oyunda ne yapar
- Mesaiye başlamak. Her rotanın harita blip’i olan bir deposu vardır. Depoya yürü ve noktayı kullan (Start working, işe başla). Sürüş rotaları rotanın doğuş noktasına bir iş aracı koyar ve sana anahtarlarını verir. Mesaiyi bitirmek için depoyu tekrar kullan (Stop working, işi bırak).
- Duraklar. Server bir sonraki durağını seçer ve haritada gösterir. Durakta noktayı kullan (Work here, burada çalış): rotanın durak başına süresi boyunca bir ilerleme çubuğu çalışır, sonra paranı alırsın (toplama rotasında eşya alırsın) ve sıradaki durak çıkar.
- Rota türleri.
- Random stops (rastgele duraklar): sıradaki durak rotanın başka herhangi bir durağıdır (taksi, tır, haber, çöp).
- Stops in order (sıralı duraklar): duraklar id’lerine göre birbirini izler ve ilkinden tekrar başlar (otobüs).
- Gathering on foot (yürüyerek toplama): araç yok; her durak bir eşyadan rastgele sayıda verir (geri dönüşüm, bağ, dalış). Su altındaki duraklar dalış animasyonu oynatır.
- Towing (çekme): durakta kilitli, arızalı bir araç bekler. Onu çekicinin kasasına yükle, sonra depo sıradaki durak olur. Paran depoda ödenir, sadece çekilen araç hâlâ kasanın 15 m içindeyse.
- Mesai sonu. Mesai, mesai başına durak sayısı bitince (0 kendiliğinden hiç bitmez demektir), depoda bitirdiğinde, server’dan çıktığında ya da resource durduğunda biter. O anda iş aracı ve çekilen araç silinir. Veritabanına hiçbir şey kaydedilmez.
- Ödeme. Sürüş ve çekici rotaları, rotanın durak başına ücretini rotanın ödeme hesabına (varsayılan bank) yatırır.
Sosisli büfesi
- Gişede bir büfe kirala. Depozito, depozito hesabından alınır. Büfe gişenin yanındaki doğuş noktasında belirir.
- Menüsünü açmak için büfeyi kullan: Push the stand (büfeyi it), Prepare hot dogs (sosisli hazırla), Start selling / Stop selling (satışa başla / satışı bırak).
- İterken bırakmak için G tuşuna bas. Düştüğünde, öldüğünde, nişan aldığında, kavga ettiğinde ya da bir araca bindiğinde de bırakırsın.
- Prepare hot dogs bir dizi beceri kontrolü çalıştırır. Hiç ıskalamazsan mükemmel (A), bir ıskada nadir (B), daha fazla ıskada sıradan (C) bir sosisli olur. Her sosisli sosisli itibarını artırır. 2. seviyeden itibaren partilerin yarısı şanslıdır ve birden fazla sosisli verir.
- Start selling: yakındaki yayalar büfeye yürür ve bir teklif yapar (tek kaliteden 1 ile 3 sosisli, seviyenin aralığından bir fiyatla). Teklifi müşterinin yanında kabul et. Bir müşteri 30 sn bekler. Büfeden 10 m’den fazla uzaklaşmak ya da stoğun bitmesi satışı durdurur.
- Depozitonu geri almak için büfeyi gişeye geri ver. Büfe sendeyken çıkış yapmak depozitoyu kaybettirir; resource durursa iade edilir.
İtibar karakterde saklanır (rep.hotdog, QBCore’un kullandığı anahtarın aynısı), bu yüzden oturumlar arasında kalır. Seviyen, From reputation değerine ulaştığın en yüksek seviyedir; seviye büfenin her kaliteden kaç sosisli tuttuğunu ve fiyatlarını belirler.
Kurulum
AI Core tarifiyle (recipe) kurulur. Elle: klasörü resources/[ai]/ içine koy ve ensure ai-core satırından sonra ensure ai-jobs ekle. ai-core ve OneSync gerektirir.
Toplama rotaları varsayılan olarak scrapmetal, grape ve coral verir. Bu eşyaların envanterinin eşya listesinde olduğundan emin ol ya da rotanın eşyasını panelden değiştir. Varsayılan iş araçları GTA modelleridir (taxi, bus, rumpo, trash2, flatbed), ek araç gerekmez.
Panel ayarları
Admin paneli > Work routes. Üç sekmesi vardır: Routes, Stops ve Hot dog stand. Varsayılanlar data/routes.json, data/stops.json ve data/hotdog.json dosyalarından gelir.
Routes sekmesi
Her rota için bir kayıt. Varsayılan rotalar taxi, bus, trucker, garbage, recycle, vineyard, diving, tow ve news.
Route
| Ayar | Neyi değiştirir | Birim | Yeni rota için varsayılan |
|---|---|---|---|
| Name | Depo isteminde ve blip’te gösterilen ad. 1-48 karakter. | boş | |
| Kind | Sıradaki durağın nasıl seçildiği: Random stops, Stops in order, Gathering on foot ya da Towing broken-down cars (yukarıya bak). | Random stops | |
| Jobs | Rotayı sadece bu mesleklerin üyeleri başlatabilir. Herkes için meslekleri ve çeteleri boş bırak. Kilitli bir rotanın deposu ve blip’i sadece onu kullanabilecek oyunculara görünür. | boş (herkes) | |
| Gangs | Bu çetelerin üyeleri de başlatabilir. | boş | |
| Only on duty | Meslek üyelerinin o meslekte mesaide olması gerekir. | kapalı | |
| Depot | Oyuncuların işe başladığı ve bıraktığı yer. Orada dur ve konumunu kullan. | 0, 0, 0 | |
| Stops per shift | Bir mesaide kaç durak olduğu. 0, mesainin oyuncu bitirene kadar sürdüğü anlamına gelir. 0-100. | 5 | |
| Time per stop | Bir duraktaki işin ne kadar sürdüğü (ilerleme çubuğu). 0-120. | sn | 5 |
| Depot blip | Deponun harita blip’inin sprite’ı, rengi ve boyutu. | sprite 67, renk 5, boyut 0.65 |
Work vehicle
| Ayar | Neyi değiştirir | Birim | Varsayılan |
|---|---|---|---|
| Vehicle model | İş aracının spawn adı (taxi, bus, mule, trash). Boş: araç yok (toplama rotaları). | boş | |
| Vehicle spawn | İş aracının belirdiği yer ve baktığı yön. | 0, 0, 0 | |
| Pay per stop | Her duraktan sonra ödeme hesabına yatırılır. 0-100,000. | $ | 100 |
| Pay account | Ödemenin gittiği para hesabı. | bank | |
| Broken-down cars | Sadece çekici rotaları: duraklarda bekleyen araçların spawn adları; biri rastgele seçilir. En fazla 40 ad. | 12 GTA aracı (sultanrs, zion, oracle...) |
Gathering
| Ayar | Neyi değiştirir | Birim | Varsayılan |
|---|---|---|---|
| Item per stop | Her durakta verilen eşya. | boş | |
| Fewest items per stop | Durak başına en düşük sayı. 1-100. | 1 | |
| Most items per stop | Durak başına en yüksek sayı. Her durak ikisi arasında rastgele bir sayı verir. 1-100. | 3 |
NPC (isteğe bağlı, depoda duran bir kişi)
| Ayar | Neyi değiştirir | Varsayılan |
|---|---|---|
| Model | Ped modeli; boş bırakılırsa NPC olmaz. Oyuncular onu 50 m içinden görür. | boş (çöp deposunda s_m_y_garbage, dalış deposunda a_m_m_salton_01 vardır) |
| What it does | Bir bekleme animasyonu: hareketsiz durur, sabırsızca bekler, pano tutar, telefona bakar, kahve içer, sigara içer, nöbet tutar, polis bekleyişi, takılır. | Hareketsiz durur |
| Where it stands | NPC’nin yeri ve baktığı yön. Ayarlanmazsa depo noktasında durur. | depo |
Varsayılan rotalar:
| Rota | Tür | Araç | Durak başına ücret | Durak başına süre | Mesai başına durak |
|---|---|---|---|---|---|
Downtown Cab Co. (taxi) | Random stops | taxi | $120 | 4 sn | 8 |
Dashound Bus (bus) | Stops in order | bus | $60 | 6 sn | 0 (sonsuz) |
Post OP Freight (trucker) | Random stops | rumpo | $250 | 8 sn | 5 |
Los Santos Sanitation (garbage) | Random stops | trash2 | $90 | 6 sn | 10 |
Recycling Center (recycle) | Gathering | yok, scrapmetal verir | 5 sn | 0 (sonsuz) | |
Marlowe Vineyard (vineyard) | Gathering | yok, grape verir | 4 sn | 0 (sonsuz) | |
Del Perro Diving (diving) | Gathering | yok, coral verir | 8 sn | 7 | |
Hayes Towing (tow) | Towing | flatbed | $250 | 8 sn | 5 |
Weazel News (news) | Random stops | rumpo | $180 | 15 sn | 5 |
Stops sekmesi
Her durak için bir kayıt. Durağı olmayan bir rota başlatılamaz. Bir rotayı silmek duraklarını korur.
| Ayar | Neyi değiştirir | Varsayılan |
|---|---|---|
| Route | Bu durağın ait olduğu rotanın id’si (taxi, bus...). | taxi |
| Name | Durağın adı. 1-48 karakter. | boş |
| Place | Çalışanın durduğu yer. Orada dur ve konumunu kullan. | 0, 0, 0 |
Hot dog stand sekmesi
Stand
| Ayar | Neyi değiştirir | Birim | Varsayılan |
|---|---|---|---|
| Open | Kapalı gişeyi gizler. Zaten kiralanmış büfeler geri verilene kadar çalışmaya devam eder. | açık | |
| Counter | Oyuncuların büfeyi kiraladığı ve geri verdiği yer. | 39.31, -1005.54, 29.48 (Legion Square) | |
| Stand spawn | Kiralanan büfenin belirdiği yer, büfenin tezgâhının bakması gereken yöne dönük. | 38.15, -1001.65, 29.44 | |
| Stand model | Büfe objesi. | prop_hotdogstand_01 | |
| Jobs / Gangs / Only on duty | Kimlerin büfe kiralayabileceği (rotalardakiyle aynı kural). Boş: herkes. | boş | |
| Map blip | Gişenin blip’i. | sprite 542, renk 17, boyut 0.6 |
Money
| Ayar | Neyi değiştirir | Birim | Varsayılan |
|---|---|---|---|
| Deposit | Büfe kiralanınca alınır, gişeye geri verilince iade edilir (çıkışta kaybedilir). 0-1,000,000. | $ | 250 |
| Deposit account | Depozitonun alındığı ve iade edildiği hesap. | bank | |
| Sales paid into | Müşterinin parasının gittiği hesap. | cash |
Cooking and reputation
| Ayar | Neyi değiştirir | Varsayılan |
|---|---|---|
| Skill checks | Sosisli başına beceri kontrolü. 1-10. | 3 |
| Reputation per perfect | Mükemmel bir sosislinin verdiği itibar. 0-100. | 3 |
| Reputation per rare | Nadir bir sosislinin verdiği itibar. 0-100. | 2 |
| Reputation per common | Sıradan bir sosislinin verdiği itibar. 0-100. | 1 |
| Highest reputation | İtibar burada artmayı bırakır. 0-100,000. | 200 |
Levels ve Prices (tek liste, en fazla 10 seviye; ilki 0’dan itibaren geçerlidir)
| Ayar | Neyi değiştirir |
|---|---|
| From reputation | Bu seviyenin başladığı itibar. |
| Hot dogs per quality | Büfenin bu seviyede her kaliteden kaç sosisli tutabildiği. |
| Perfect from / to, Rare from / to, Common from / to | O kaliteden bir sosislinin $ cinsinden fiyat aralığı. Her teklif aralıktan bir fiyat seçer. |
Varsayılan seviyeler:
| From reputation | Kalite başına sosisli | Perfect | Rare | Common |
|---|---|---|---|---|
| 0 | 15 | $8-12 | $6-9 | $4-6 |
| 50 | 30 | $9-13 | $7-10 | $5-7 |
| 100 | 45 | $10-14 | $8-11 | $6-9 |
| 200 | 60 | $11-15 | $9-12 | $7-9 |
Büfenin de rotalar gibi bir NPC kartı vardır (model, bekleme animasyonu, konum).
Komutlar
Yok.
Tuşlar
Her oyuncu bunları GTA’nın tuş ayarlarından (FiveM bölümü) değiştirebilir; sunucu sahibi varsayılanları admin panelinden (Keybinds) değiştirir.
| Varsayılan tuş | Ne yapar |
|---|---|
| G | İttiğin sosisli büfesini bırak (jobs_hotdog_release). |
Depolar, duraklar, gişe ve büfe etkileşim noktalarıdır: ai-core’un Interaction style (etkileşim stili) ayarına göre etkileşim tuşuyla (varsayılan E) bir istem ya da bir target seçeneği.
Neyin yerine geçer
fxProvide yok. Tek bir motor, QBCore / Qbox’ın ayrı meslek script’leri olarak sunduklarını (taksi, otobüs, tır, çöp, çekici, haber ve toplama işleri) karşılar; sosisli büfesi de qb-hotdogjob’un bir uyarlamasıdır. O script’lerin export’larına ya da event’lerine cevap vermez.
Uyumlu script’ler
İş aracı anahtarları AI Core’un anahtar katmanından, eşyalar envanter katmanından geçer. AI Core’un desteklediği her anahtar script’i ve envanter çalışır (bkz. Uyumluluk).
Bilinen sınırlar
- Mesai sadece bellekte tutulur: server’dan çıkmak ya da resource’u yeniden başlatmak onu bitirir ve iş aracı silinir.
- Oyuncu duraktan 12 m’den fazla, iş aracından 15 m’den fazla (sürüş rotaları) uzaktaysa ya da son duraktan 60 m/s’den hızlı gelirse (ışınlanma) server durağı reddeder.
- Sosisliler envanter eşyası değildir: stok büfede durur ve müşteriler sadece NPC’dir. Oyuncular birbirinden satın alamaz.
- Log kanalları:
work(rota ödemeleri) vehotdog(satışlar).
Meslekler ve hizmetler
İş rotaları, polis, ihbarlar, hapishane, ölüm ve EMS, bankacılık, patron menüleri ve belediye binası.
Geliştiriciler için ai-jobs
ai-jobs’un diğer script’lerle paylaştıkları (export’u yoktur): sosisli itibarı, iş aracı plakaları ve anahtarları, hesap defteri sebepleri ve özel event’leri.