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:
- Yoksa
fx_pocketbook_metatablosunu oluşturur ve son temiz çalıştırmanın hash'ini okur. sql/install.sqlo zamandan beri değişmediyse ve dosyadaki her tablo varsa orada durur. Konsoldatabase ready in N ms (schema unchanged, setup skipped)yazar. Bir tablo eksikseN table(s) missing; creating them.yazar.- 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 EXISTSveINSERT IGNOREifadeleridir; var olan tablolar ve satırlar asla değiştirilmez ya da silinmez. - Her ifade çalıştıysa yeni hash'i kaydeder. Biri başarısız olduysa her biri için
Database setup error: ..., ardındanDatabase 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