Başlangıç

Kurulum

FX Pocketbook'u kur: üç resource, başlatma sırası, isteğe bağlı fx-radio, veritabanı, eşyalar, kurulum kontrolü ve komutlar.

#1. Üç resource'u kopyala

Üç klasörü de resources/ içine koy:

Klasör Bu adı koru, çünkü
fx-pocketbook Diğer resource'lar exports['fx-pocketbook'] çağırır; assets resource'u da bu ad ve sonuna -assets eklenerek bulunur
fx-pocketbook-assets Arayüz görselleri ve sesleri https://cfx-nui-fx-pocketbook-assets/... adresinden yükler. Adı <defter resource adı>-assets olmalı
fx-pocketbook-anims Tutma ve yazma animasyonları bu addaki bir resource'tan yüklenir

fx-pocketbook-assets büyük görselleri, sesleri ve 15 defterin stream edilen modellerini tutar. fx-pocketbook'un kod güncellemesi oyunculara bunları yeniden indirtmesin diye ayrı tutulur.

#2. Başlatma sırası

fx-pocketbook manifest'i oxmysql, fx-pocketbook-assets ve fx-pocketbook-anims resource'larını bağımlılık olarak listeler: üçü olmadan defter başlamaz. Defteri veritabanı, framework ve envanterden sonra başlat:

cfgensure oxmysql
ensure vorp_core
ensure vorp_inventory
ensure fx-pocketbook-assets
ensure fx-pocketbook-anims
ensure fx-pocketbook

RSG'de vorp_core ve vorp_inventory yerine rsg-core ve rsg-inventory yaz.

Banka ve ahır script'lerini de (vorp_banking, rsg-banking, gum_stables, vorp_stables, rsg-horses, rsg-wagons) fx-pocketbook'tan önce başlat: adaptörler bunların başlayıp başlamadığına bakar.

Tutma ve yazma animasyonları (fx_phone@base, fx_phone@female, fx_phone_write@base, fx_phone_write@female) fx-pocketbook-anims adlı bir resource'tan yüklenir. Yüklenemezlerse client konsolu holding: writing animation ... could not be loaded (is fx-pocketbook-anims started?) yazar.

#Sırt telsizi (isteğe bağlı)

Sırt telsizi ayrı bir resource'tur: fx-radio (pma-voice üzerinde sesli kanallar). Defterin ona ihtiyacı yoktur: onsuz sinyal kasabalardan ve sinyal direklerinden gelir. Başlatılmışsa şarjlı aküyle takılı bir telsiz deftere her yerde sinyal verir ve defter mağazası telsizi, aküsünü ve şarj aletini de satar. Defter fx-radio'nun başlayıp durduğunu kendisi fark eder, bu yüzden fx-pocketbook'tan önce ya da sonra başlatılabilir. Kendi kurulumu fx-radio dokümantasyonundadır.

#3. Framework

luaConfig.Framework = 'auto' -- auto | vorp | rsg

'auto', vorp_core başlamışsa VORP'u, rsg-core başlamışsa RSG'yi seçer. İkisi de başlamışsa hiçbir şey seçilmez; 'vorp' ya da 'rsg' yazmalısın.

RSG'de Config.MoneyAccount 'cash' ya da 'bank' olabilir. VORP'ta defterin kendi para işlemleri için yalnızca 'cash' çalışır; başka bir değerde pocketbook_health uyarır.

#4. Veritabanı

Hiçbir SQL'i elle içe aktarmazsın. Bütün tablolar tek dosyada, sql/install.sql içinde. Her başlangıçta server/database.lua şunu yapar:

  1. Yoksa fx_pocketbook_meta tablosunu oluşturur ve son temiz çalıştırmanın hash'ini okur.
  2. sql/install.sql o zamandan beri değişmediyse ve dosyadaki her tablo varsa orada durur. Konsol database ready in N ms (schema unchanged, setup skipped) yazar. Bir tablo eksikse N table(s) missing; creating them. yazar.
  3. Dosya değiştiyse ya da bir tablo eksikse dosyadaki her ifadeyi çalıştırır. Bunlar CREATE TABLE IF NOT EXISTS, ALTER TABLE ... ADD COLUMN IF NOT EXISTS ve INSERT IGNORE ifadeleridir; var olan tablolar ve satırlar asla değiştirilmez ya da silinmez.
  4. Her ifade çalıştıysa yeni hash'i kaydeder. Biri başarısız olduysa her biri için Database setup error: ..., ardından Database setup finished with N error(s). Run pocketbook_health. yazar ve dosyayı bir sonraki başlangıçta yeniden çalıştırır.

MariaDB ve MySQL 8 üzerinde çalışır. MySQL 8 ADD COLUMN IF NOT EXISTS bilmez; bu yüzden script her böyle sütuna kendisi bakar ve yalnızca eksikse ekler.

Defterin diğer server script'leri veritabanına sorgu atmadan önce bu adımın bitmesini bekler.

sql/install.sql dosyasını elle içe aktarman hiç gerekmez. Yine de yaparsan RSG'de önce dosyadaki INSERT IGNORE INTO items bloğunu sil: o blok VORP'un items tablosu içindir. MySQL 8'de elle içe aktarırken ALTER TABLE ... ADD COLUMN IF NOT EXISTS satırları hata verebilir; otomatik kurulum bunları kendisi halleder.

Kurulum 94 fx_pocketbook_* tablosu ve fx_pocketbook_meta tablosunu oluşturur.

#5. Eşyalar

#VORP

Eşyalar aynı veritabanı adımında INSERT IGNORE ile VORP'un items tablosuna kendiliğinden eklenir. Bu, vorp_core kuruluysa, Config.Framework 'rsg' değilse ve 'auto' modunda rsg-core başlamamışsa olur. Eşyalar eklendikten sonra konsol şunu yazar:

cfg[fx-pocketbook] 25 item(s) added to VORP. Restart the server once so vorp_inventory loads them.

Sunucuyu bir kez yeniden başlat. Ekleme başarısız olursa konsol VORP items could not be added automatically; add them from sql/install.sql. yazar.

#RSG

RSG'de hiçbir şey eklenmez. Eşyaları rsg-core/shared/items.lua içine ekle. Yapıştırılacak satırlarla birlikte tüm eşyaların listesi Eşyalar sayfasında.

#Eşya görselleri

fx-pocketbook/setup/inventoryitem-images/ içindeki PNG'leri (200x200, arka plansız) envanterinin görsel klasörüne kopyala:

Envanter Klasör
vorp_inventory vorp_inventory/html/img/items/
rsg-inventory rsg-inventory/html/images/

Dosya adı eşya adıdır: pocketbook.png, her renk için pocketbook_<renk>.png, pocketbook_relay.png, pocketbook_phonograph.png ve diğerleri. Telsiz görselleri fx-radio ile gelir.

#6. Kurulumu kontrol et

Sunucu konsoluna yaz:

cfgpocketbook_health

Salt okunur bir kontroldür. Eşya ya da para hareket ettirmez. Şunları bildirir:

Anahtar Ne kontrol edilir
framework Config.Framework ile tam olarak bir framework seçilmiş ve çalışıyor
inventory vorp_inventory ya da rsg-inventory başlamış
money Config.MoneyAccount VORP'ta 'cash', RSG'de 'cash' ya da 'bank'
music Fonograf verileri yüklenmiş
relays Sinyal direği verileri yüklenmiş
action Temel uygulama eylemleri kayıtlı (telegram.send, telegram.profile, music.shareResolve, company.dashboard, billing.list, atlas.load, album.list)
database oxmysql başlamış ve information schema okunabiliyor
treasury apps/company/config_server.lua içindeki işletme kasası bağlantıları doğrulanabiliyor
table Her fx_pocketbook_* tablosu var
column Beklenen her sütun var
engine Her tablo InnoDB

İlk satır sonucu, seçilen framework'ü ve kaç tablo ile sütunun kontrol edildiğini verir. Sonra her sorun için bir satır gelir: [fx-pocketbook] <anahtar>: <mesaj>. Son satır bunun bir oyun testi olmadığını hatırlatır: eşya, para ve ağ denenmez.

Komut 10 saniyede bir çalışabilir. Oyun içinde command.pocketbook_health ACE iznini ister.

#Defteri açmak

Oyuncu defteri bir defter eşyası kullanarak ya da F1'e (Config.OpenMenuKey) basarak açar. Config.Access.RequireItem = true iken iki durumda da envanterde bir defter eşyası gerekir. Bkz. config.lua.

#Oyuncu komutları

Komut Ayar Ne yapar
/pocketbook Config.Command Defteri açar ve kapatır. Yalnızca Config.MenuOpenMode 'command' ya da 'both' iken kaydedilir
/pocketbird Config.Telegram.Birds.WhistleCommand birdwhistle eşyası gibi posta kuşunu çağırır. '' komutu kaldırır
/yardim [metin] Config.MDT.Doctor.Calls.Command Görevdeki doktorların Resmî Defter'de gördüğü bir yardım çağrısı bırakır. '' komutu kaldırır

#Yönetici ve konsol komutları

Bunlar kısıtlı komutlardır. Sunucu konsolu her zaman çalıştırabilir; bir oyuncunun command.<ad> ACE iznine ihtiyacı vardır.

Komut Ne yapar
pocketbook_health Kurulum kontrolü, yukarıya bak
pocketbook_remove_relay <id> Bir sinyal direğini siler (fx_pocketbook_relays.id). Eşya geri verilmez
pocketbook_retry_log <id> Discord'a gönderilemeyen bir log satırını yeniden kuyruğa koyar
pocketbook_hold Oyun içinde. Defteri elde, yazarken de defteri ve kalemi yerine oturtmak için fx-toolbag aracını açar. Kaydetmek herkes için holding.json dosyasını yazar ve command.pocketbook_hold ister. Adı Config.Holding.TuneCommand
pocketbook_broadcast <şablon> <nonce> apps/telegram/config_server.lua içindeki BroadcastTemplates'ten önceden tanımlı bir resmî telgrafı her posta kutusuna gönderir. Nonce 16 ile 64 arası harf, rakam ya da - olur; aynı nonce ile yeniden göndermek iki kez göndermez
pocketbook_broadcast_status <id> Bir duyurunun durumunu yazar
pocketbook_broadcast_cancel <id> Bir duyurunun kalan teslimatını iptal eder
pocketbook_close_mailbox <adres> <posta kutusu id> <nonce> <gerekçe> Bir telgraf posta kutusunu kapatır. Gerekçe en az 8 karakter olmalı. Yazışmalar saklanır
pocketbook_resolve_*, pocketbook_bank_resolve Defterin bir yönetici için beklettiği bir işlemi kapatır. Bkz. Sorun giderme

#Diğer ACE izinleri

İzin Neye izin verir
pocketbook.news.moderate Gazete'yi yönetmeye. Adı Config.News.ModeratorAce
fx-pocketbook.postmaster Telgraf ilan panosunu yönetmeye; Config.Telegram.Board.ModeratorJobs'a ek olarak
cfgadd_ace group.admin command.pocketbook_health allow
add_ace group.admin command.pocketbook_remove_relay allow
add_ace group.admin pocketbook.news.moderate allow
add_ace group.admin fx-pocketbook.postmaster allow