ss_easter von ShoeShuffler/Shuffle Shop platziert sammelbare Eier an konfigurierten Orten für Qbox-Charaktere. Der Code verwendet qbx_core, ox_lib, oxmysql, ox_inventory und ox_target. Die mitgelieferte Konfiguration enthält 24 Eierstandorte; Modelldateien werden zusätzlich benötigt und sind nicht automatisch im Script enthalten.
Modelle, Items und Speicherung vorbereiten
Die README verlinkt ShopFusion-Modelle und erlaubt die Konfiguration eigener Modelle. Ordne jedem Schlüssel in Config.EggLocations ein Inventaritem und jedem Modell ein gestreamtes Prop zu. Prüfe die enthaltenen Inventaranweisungen für deine installierte ox_inventory-Version, statt Beispielfelder ungeprüft zu übernehmen.
Beim Ressourcenstart erstellt der Server die Tabelle ss_easter, falls sie fehlt. Sammlungen werden als JSON unter einer eindeutigen citizenid gespeichert; vorgesehen ist also ein Einsammeln jedes Eis pro Charakter. Sichere die Datenbank und erhalte die Tabelle bei Updates; ihr Leeren setzt den Sammelverlauf zurück.
Inventar und Belohnungen müssen getestet werden
Der Server prüft eine konfigurierte Ei-ID und lehnt das Einsammeln aus mehr als acht Metern Entfernung ab. Er prüft den gespeicherten Sammelstand, schreibt ihn aber vor AddItem und kontrolliert nicht, ob das Hinzufügen erfolgreich war. Bei vollem Inventar kann ein Ei deshalb als eingesammelt gelten, ohne zugestellt zu werden. Prüfe die Fehlerbehandlung vor dem Aktivieren von Belohnungen.
Lesen des Sammelstands, Speichern, Itemausgabe und Bankprämien für Meilensteine bilden keine gemeinsame Transaktion und sind nicht durch eine Sammelsperre pro Charakter geschützt. Teste wiederholte und gleichzeitige Anfragen, Inventarkapazität, erneute Verbindungen, getrennte Charaktere und jeden konfigurierten Meilenstein. Der Client entfernt das lokale Ei vor einer Serverantwort; auch abgelehnte Anfragen benötigen deshalb einen Wiederherstellungsweg.
Quelle und Prüfumfang
Quellcode am 10. September 2026 anhand von Revision b1a881576314632512409295b5c221648da70438 geprüft; das Manifest nennt Version 1.0.0. Es wurden keine Eiermodelle installiert und keine Datenbank-, Belohnungs- oder Mehrspielertests durchgeführt.