Dokumentace Pulse Phone
Požadavky
2. Požadavky
| Co | Povinné? | Co se stane bez toho |
|---|---|---|
| Zapnutý OneSync | Povinné | Kontrola při startu selže s OneSync ... off. Přidejte set onesync on. |
| Game build 2699 nebo novější | Povinné | Model telefonu se nestreamuje. Nastavte sv_enforceGameBuild. |
| oxmysql (nebo ghmattimysql, mysql-async) na MariaDB 10.6+ nebo MySQL 8 | Doporučeno | Když neběží žádný SQL resource, data se ukládají do key/value úložiště serveru. Uchovají se, ale nelze se na ně dotazovat, a nad zhruba 30 hráčů byste měli použít databázi. |
| Voice script: pma-voice, mumble-voip, SaltyChat, TokoVOIP nebo YACA | Doporučeno | Hovory se spojí, ale není slyšet zvuk. |
| screenshot-basic | Doporučeno (standardní resource, nebo odlehčená kopie ve vašem downloadu: viz rychlý start, krok 6) | Fotoaparát záběry zarámuje, ale fotky uložit nedokáže. |
| Framework | Volitelné | Telefon běží jako standalone: telefony jsou vázané na licenci hráče a telefon má vlastní banku. |
Kompletní blok pro server.cfg:
set onesync on
set sv_enforceGameBuild 2699 # or newer
ensure oxmysql
# ... your framework, then your inventory, banking, garage and housing scripts ...
ensure pma-voice
ensure screenshot-basic
ensure phone
# ... scripts that use the phone ...Databáze. Které úložiště telefon použije, se rozhoduje při každém startu:
| Váš server | Kam telefon ukládá data |
|---|---|
| Běží oxmysql, mysql-async nebo ghmattimysql a databáze odpovídá | Do databáze. Tabulky se vytvoří při prvním startu a nové se po každé aktualizaci přidají samy. |
| Neběží vůbec žádný SQL resource | Automaticky do key/value úložiště serveru. Přetrvá restarty, ale nelze se na něj dotazovat. Nad zhruba 30 hráčů, nebo pokud konzole varuje, že ukládání úložiště je pomalé, použijte databázi. |
| SQL resource běží, ale databáze do 30 sekund neodpoví | Nic se neukládá, dokud neodpoví. Konzole řekne proč, telefon to zkouší znovu každých 15 až 60 sekund a jakmile databáze odpoví, sám dokončí start. |
V posledním případě můžete telefonu nařídit, aby místo toho použil key/value úložiště, přes set phone_db_fallback "kvp" v server.cfg; tato data zůstanou v key/value úložišti a nikdy se později nezkopírují do databáze, takže to používejte na testovacím serveru, ne jako obchvat rozbitého připojení. Každý dotaz má navíc 10sekundový limit: dotaz, na který databáze nikdy neodpoví, se aplikaci, která se ptala, nahlásí jako neúspěšný a konzole ho jednou uvede.
Podporované databáze: MariaDB 10.6 nebo novější, nebo MySQL 8.0 nebo novější. phone.sql každého vydání se před sestavením balíčku ověří na čisté databázi MariaDB běžící v SQL módu MySQL 8. Starší verze (MariaDB 10.4 nebo 10.5, MySQL 5.7) nejsou testované a nejsou podporované, i když mohou fungovat.
phone.sql je jen pro hostingy, které nedovolí resourcům vytvářet tabulky. Není v něm uvedena žádná collation: platí výchozí utf8mb4 vašeho serveru, stejně jako když telefon tabulky vytváří sám. Lze ho bezpečně spustit na existující databázi a opětovné spuštění nového souboru po aktualizaci přidá jen to, co chybí.
sv_stateBagStrictMode může zůstat zapnutý. Vše, co ostatní hráči z telefonu vidí (animaci držení, telefon v ruce, jeho displej, svítilnu), nastavuje server po ověření hodnoty, nikdy hra hráče.
Přechod z jiného telefonu
Tabulky jiného telefonu. Pokud telefon, který jste dříve používali, zanechal tabulky se stejnými názvy (například phone_messages), při prvním startu se přejmenují na old_<name>, aby si Pulse Phone mohl vytvořit vlastní. Nic se nemaže. Pokud váš databázový uživatel nesmí přejmenovávat tabulky, kontrola při startu ukáže [FAIL] Database s názvy tabulek: dejte uživateli práva ALTER, nebo každou přejmenujte na old_<name> ve svém databázovém nástroji (HeidiSQL, phpMyAdmin) a restartujte.