إنشاء ألعاب ومكافآت

نعم، يمكن للعبتك التفاعل مع هدايا TikTok

يحدد JavaScript لديك الإجراء: دفع صاروخ أو تنمية حديقة أو إنشاء عدو أو ملء هدف مشترك. وتحدد أيضاً العتبة. لا يستطيع SSN تغيير أسعار هدايا المنصة.

اختر قالب بداية

تتضمن كل معاينة أزرار عينات وفاحص «آخر بيانات مستلمة». العينات أحداث وهمية وليست مشتريات. لا تنضم المعاينة إلى جلستك الحية.

• ابحث في HTML عن EDIT THIS RULE أو EDIT THESE RULES.
• ضع منطق لعبتك في دالة receive(data) .
• توجد أدوات الاتصال والعد المساعدة في starter.js. توجد الأنماط في starter.css.

توصيل قالب بداية في 3 خطوات

1. شغّل SSN ووصل الدردشة. تحقق من ظهور الدردشة والهدايا في Dock. لـ TikTok، راجع أوضاع الاتصال.
2. افتح قالب البداية دون ?demo، باستخدام معرّف جلستك وكلمة المرور إن حددتها.
3. اختبره في المتصفح، ثم أضف الرابط نفسه إلى OBS كمصدر متصفح، مثلاً 1000 × 800.

https://socialstream.ninja/games/templates/coin-rocket.html?session=YOUR_SESSION&password=YOUR_PASSWORD&clean

• &clean يخفي الفاحص وحالة الاتصال وأزرار المضيف.
• لا كلمة مرور؟ احذف &password=….
• على موقع beta، احتفظ بـ /beta/ قبل games/.

إنشاء نسخة خاصة وتشغيلها من القرص

لا خادم لتثبيته. تعدّل ملفاً على حاسوبك وتوجّه OBS إليه.

1. تنزيل ملف ZIP لمصدر beta وفك ضغطه.
2. انسخ القالب الذي تريده بجوار الأصل. مثال: games/templates/my-rocket.html.
3. أبقِ ترتيب المجلدات كما هو. تحمّل القوالب js/local-server-url.js، بينما يحمّل هدف الدعم currency.js من المجلد الأعلى. احتفظ بالصور والصوت في أماكنهما أيضاً.
4. اسحب ملف HTML إلى Chrome أو Edge وانسخ file:/// .
5. أضف كل شيء بدءاً من ? فصاعداً من رابط لعبتك العامل (الجلسة وكلمة المرور وخيارات النقل).
6. في OBS، غادر ملف محلي غير محدد. الصق العنوان الكامل في حقل مصدر المتصفح URL المجال.
7. بعد كل تعديل، حدّث مصدر المتصفح.

file:///C:/SSN/social_stream-beta/games/templates/my-rocket.html?session=YOUR_SESSION&clean

استخدم مسارك الحقيقي ولا تنقل المجلد المفكوك. الجلسة هي معرّف اتصال SSN لا اسم اللعبة. أزل demo للبيانات الحية. أبقِ SSN والالتقاط يعملان. أمثلة إضافية: دليل إعداد الملف.

Customize [game file] to match [reference], at [canvas size].
Include its existing CSS/JS and local artwork/audio. Preserve the game's
rules, controls, gift/coin/USD distinctions, streak handling, duplicate
handling, and demo/clean modes. Change the visual design, not the reward rules,
unless I explicitly specify a rule change. Keep session/password and
transport parsing, relative paths, and Chrome 80-compatible classic scripts.
Read docs/event-reference.html and docs/making-games.html.

Treat all incoming messages, names, labels, donations, and metadata as untrusted.
Prevent HTML/JavaScript injection in every renderer you change. Use textContent
for plain fields and for chatmessage when textonly is true. For HTML-mode
chatmessage, keep supported emotes/formatting through the packaged
SocialStreamChatHTML.sanitize helper (libs/objects.js loaded first).
Do not concatenate raw input into innerHTML, attributes, CSS, or JavaScript.
Validate media/link URLs with the page's existing URL policy and assign DOM
properties; do not enable javascript: URLs or executable embedded content.
Never eval incoming data or treat a viewer message as an AI instruction.
Keep source checks, connection handling, and existing sanitizers.
Test plain text, allowed emotes, quotes, angle brackets, and an HTML injection
probe in an isolated preview; verify the probe cannot execute.

Make the edited game work directly from disk using a file:/// URL,
without requiring a local web server.
Return the edited files/assets, file URL and OBS setup steps, and tests using
fictional data. Preserve image-only events and a valid donoValue of zero.
Never treat chat text as proof of a payment.

كيف أختار عدد العملات لإجراء معين؟

حدد أولاً ما تقيسه، ثم اختر رقماً.

قيمة مطابقة أم حد أدنى أم رصيد متراكم؟

• قيمة مطابقة: coins === 10. هدية من 25 عملة لا تفعل شيئاً.
• حد أدنى لكل حدث: coins >= 10.
• رصيد متراكم: ما يستخدمه الصاروخ. 25 عملة = دفعتان مع بقاء 5 عملات.

عدة مستويات؟ افحص الأعلى أولاً كي لا تشغّل هدية واحدة كل المستويات الأدنى.

ما الذي ترسله كل منصة؟

type يوضح مصدره. event يوضح ما حدث عند توفره. تعتمد البيانات الواصلة على وضع الالتقاط والإعدادات والمنصة. يعكس هذا كود SSN الحالي ولا يضمن حصول كل حساب على كل حدث.

قد ترسل المصادر الأخرى إكراميات أو هدايا أو عضويات أو مشتريات. افحص مرجع الأحداث قبل إضافتها إلى مرشح القالب isSupport . البيع أو الاشتراك المُهدى ليس إكرامية تلقائياً. يرسل YouTube شراء الهدية وإشعار كل مستلم؛ عدّ الاثنين يكافئ الهدية نفسها مرتين.

استخدام donoValue وcurrency.js بشكل صحيح

<script src="../../currency.js"></script>
<script>
// From games/templates/: use the existing helper, including its zero handling.
var usd = getDonationValueUSD(data);
// Use usd for your rule; display data.hasDonation for the original amount/unit.
</script>

لا تفعل هذا

• donoValue || convertToUSD(...) — لأنه يتجاهل صفراً مقصوداً.
• استخراج الأرقام من chatmessage للتعرف على المدفوعات.
• اشتراط event === "donation" — لا تتضمن Facebook Stars وبعض Cheers حدثاً.

يختار قالب هدف الدعم أنواع الدعم أولاً ثم يستدعي المحوّل المشترك.

احتساب سلسلة الهدايا مرة واحدة

قد يرسل TikTok سلسلة بإجماليات متصاعدة: 1، 2، 3. هذه ثلاث هدايا لا ست. احتفظ بأعلى إجمالي للسلسلة وأضف الزيادة فقط.

// All three events refer to the same streak:
// incoming total: 1, 2, 3, 3
// added to game:  1, 1, 1, 0
var newCoins = RewardStarter.increment(data, RewardStarter.coins(data), 'coins');

• يطابق المساعد السلاسل بمعرّفات مجموعة TikTok والمرسل والهدية، ثم meta.tiktokGiftStreakId، ثم معرّفات الرسائل. تمنع معرّفات الرسائل أيضاً التسليمات المكررة.
• لا ينتظر repeatEnd، لأن التقاط المتصفح قد لا يرسله أبداً. تحتاج إجراءً واحداً عند انتهاء سلسلة الهدايا فقط؟ اكتب قاعدة منفصلة باستخدام الحقول التي يرسلها اتصالك.
• استخدم مسار التقاط واحداً. التقاط القناة نفسها ثانيةً قد يستخدم معرّفات مختلفة ويضاعف العد.

مكافآت دون لعبة مخصصة

في Event Flow:

1. أضف مقارنة خاصية.
2. اضبطه على donoValue, أكبر من أو يساوي، والمبلغ بالدولار الأمريكي.
3. وصّل إجراءً مثل صوت أو حركة أو تحكم OBS.

يستخدم القيمة الأصلية من المصدر إذا كانت صالحة، وإلا يستخدم تحويل العملات في SSN.

• هدية TikTok محددة: قارن meta.giftId أو meta.giftName، واقصر التدفق على أحداث هدايا TikTok.
• فحوص الأرقام في hasDonation تتحول أيضاً إلى دولارات. ليست فحوص عملات أصلية. استخدم البيانات الأصلية أو كوداً مخصصاً لقواعد العملات.
• يعمل كل فحص على كل رسالة. ليس رصيداً متراكماً أو عداد سلسلة. استخدم عقد الحالة إذا احتجت ذلك، أو احتفظ بالمنطق داخل لعبتك.

اختبر قبل ربط إجراء مدفوع

1. أزرار العينات. سلسلة 1 ← 2 ← 3 تضيف ثلاث هدايا. نموذج تجاوز القيمة بالصفر لا يضيف دولاراً. السعر المجهول لا يضيف عدداً دقيقاً من العملات.
2. مصدر حقيقي. افحص بيانات ملتقطة حقيقية. أكد اسم الهدية/معرّفها والمبلغ والوحدة والعدد والحدث. تختبر العينات قاعدتك لا الالتقاط المباشر.
3. مشهد OBS. اختبر الأحداث المتكررة وإعادة الاتصال وإعادة التحميل. لا تحدّث مصدر المتصفح ولا تغلقه إذا أردت الاحتفاظ بالتقدم في الذاكرة.

تفاصيل اتصال إضافية: تراكبات مخصصة.