> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwacks.com/llms.txt
> Use this file to discover all available pages before exploring further.
# بيانات اللاعب
> احفظ مستندات مخصّصة لكل لاعب — التقدّم والإعدادات والحالة.
export const Scope = ({children}) =>
النطاق: {children}
;
تتيح لك **بيانات اللاعب** حفظ أي JSON تريده لكل لاعب: المستوى، والعملات، والمحتوى المفتوح،
والتفضيلات — أي شيء تحتاجه لعبتك. ونطاق هذه المستندات محصور باللاعب المسجَّل دخوله.
بيانات اللاعب تخصّ كل لاعب على حدة؛ أما **قالبها** فيُعرَّف لكل **إصدار لعبة**.
للإعداد المعتاد جانبان: **عرِّف الشكل في لوحة التحكم**، ثم **اقرأه واكتبه من حزمة التطوير**.
يُعرِّف **قالب بيانات اللاعب** بنية نوع معيّن من المستندات وقيمه الافتراضية، فتبقى السجلات
متّسقة بين اللاعبين والإصدارات. عرِّف القوالب في لوحة التحكم، ويرثها اللاعبون تلقائيًا.
شغِّل **Code Generation → Sync Schemas** في نافذة Flock لتحويل كل قالب إلى صنف C# مُحدَّد
الأنواع، ثم اقرأ مستند اللاعب المسجَّل دخوله واكتبه مباشرةً:
```csharp theme={null}
// Read (paginates and caches the player's documents on first call)
var progress = await FlockClient.Instance.Player.GetPlayerProgressAsync();
// Mutate the typed object and save it back
progress.Level = 2;
progress.Coins += 100;
await progress.UpdateAsync();
```
وتأتي أسماء الدوال والحقول من قالبك — فالقالب `PlayerProgress` يُنتج `GetPlayerProgressAsync`.
اقرأ صفوف اللاعب باستخدام عقد *Flock | Player*، أو مزوّد اللاعب في C++. ولن تمرّر معرّف لاعب
أبدًا — فالاستدعاءات تعمل نيابةً عن اللاعب المسجَّل دخوله.
```cpp theme={null}
Sdk->GetPlayerProvider()->GetMyDataByTag(TEXT("currency"),
[](TFlockResult Result)
{
int32 Coins = 0;
Result.Value.Data.TryGetInt(TEXT("coins"), Coins);
});
```
وبعد مزامنة المخطّط يختصر هذا إلى **عقدة واحدة** تُعيد بنية مُحدَّدة الأنواع بمنافذ حقيقية،
وتصبح الكتابة عقدة ثانية — راجع [العمل مع بيانات لعبتك](/ar/sdk/unreal#work-with-your-game-data).
وعمليات الكتابة تُصفّ في طابور عند انقطاع الاتصال وتُعاد تلقائيًا عند عودته.
أبقِ المستندات صغيرة ومحدّدة الغرض (مستند `progression` وآخر `settings` مثلًا) بدل مستند ضخم
واحد — فذلك يجعل التحديثات الجزئية وتتبّع الأخطاء أسهل بكثير.