S. M PRO TEAM VersionStatus

«العربية متوفرة في الأسفل.»

S. M PRO TEAM VersionStatus plugin for the Godot Engine to check the game version and detect the availability of a new update.

The plugin connects to the official S. M PRO TEAM version management server, retrieves the version information associated with your Project ID, then compares the local game version with the version available on the server, and saves the update link for use inside the game.

Features

· Game version checking · Automatic update detection · Mandatory update support · Access to the update link · Centralized version management service · Configuration based on Project ID

Requirements

· Godot 4.5 or later · Internet connection · A Project ID issued by the S. M PRO TEAM dashboard

Installation Install the plugin inside your Godot project, then enable it from:

"Project > Project Settings > Plugins"

Getting the Project ID

1. Open the official S. M PRO TEAM dashboard: https://s-m-pro.onrender.com/dashboard
2. Sign in with your Google account.
3. Create a new project and fill in the following information: · Game / application name · Current version number · Update status (optional / mandatory) · Update link
4. Copy the Project ID. It looks like this:

"SMP-XXXXXXXX"

Plugin Setup

Add the plugin's node: Click "Create New Node" and search for a node named Version Status, then add it to your scene (it must be added to the main scene).

Select the Version Status node, then in the Inspector tab (window), enter your game's "current!" "version number" in

Your_game_version.

For example:

"1.0.0"

The local game version will be compared with the version saved on the server for your project's ID.

Select the Version Status node, then in the Inspector tab (window), enter your "Project ID" in

project_id.

For example:

"SMP-XXXXXXXX"

Replace it with the ID you copied from the dashboard.

That's it. You do not need to modify anything else.

You can add ColorRect, Sprite2D, panel, and Button nodes to create and customize your own Pop-up window, provided that the Pop-up window nodes are children of the Version Status node.

Select the Version Status node, then in the Inspector tab (window), add the update button to the update_button field.

And add the "Later / skip" button to the skip field in the Inspector.

Guidance:

When the game starts, the plugin automatically sets the Visible property of the Version Status node to false. This hides the Version Status node and all of its child UI nodes, including the Pop-up nodes that you created and customized.

The plugin then checks the game version and determines whether a new update is available.

When a new update is detected, the plugin automatically changes the Visible property of the Version Status node to true. This makes the Version Status node and all of its child nodes visible, including the Pop-up interface that you designed.

Therefore, you should place all the Pop-up UI nodes that you want to display when an update is available as children of the Version Status node.

You do not need to change the Visible property manually. The plugin automatically controls the visibility of the Pop-up according to the update status.

Note:

Do not modify the Name and Code values under the Version tab in the Export window, whether you are exporting for Android or any other platform.

The plugin automatically manages these values based on the version number entered in the Your_game_version property of the Version Status node in the Inspector.

Manually modifying the Name and Code values under the Version tab in the Export window may prevent the plugin from working correctly and may also cause installation issues after exporting the game.

Tutorials

YouTube Playlist

"VersionStatus Tutorial Playlist"

https://www.youtube.com/playlist?list=PLIVn33Xm3e8A

Tutorial Video

"Watch the VersionStatus tutorial video on YouTube" https://youtu.be/G8noBkkyJEM

If the video does not appear inside the application you are reading the description from, open the link directly in your browser or YouTube.

Documentation

The plugin folder contains a complete README file explaining the installation, setup, commands, examples, and license information.

License

The S. M PRO TEAM VersionStatus plugin is subject to the S. M PRO TEAM Custom License.

The license allows personal and commercial use of the plugin in its original, unmodified form. Modifying the plugin or redistributing it as a standalone product is not permitted.

See the full license text: S. M PRO TEAM Custom License

S. M PRO TEAM

Plugin developed by: S. M PRO TEAM Website:

https://s-m-pro.onrender.com

Note
##----------End of English Description--------  


break. 


## -------------بداية الوصف العربي-----------

الوصف:

S. M PRO TEAM VersionStatus

العربية

إضافة S. M PRO TEAM VersionStatus لمحرك Godot لفحص إصدار اللعبة ومعرفة توفر تحديث جديد.

تتصل الإضافة بسيرفر S. M PRO TEAM الرسمي لإدارة الإصدارات، وتحصل على معلومات الإصدار المرتبطة بمعرّف المشروع (Project ID) الخاص بك، ثم تقارن إصدار اللعبة المحلي بالإصدار الموجود في السيرفر، وتحفظ رابط التحديث لاستخدامه داخل اللعبة.

المميزات

· فحص إصدار اللعبة · اكتشاف التحديثات تلقائيا · دعم التحديث الإجباري · الوصول إلى رابط التحديث · خدمة إدارة إصدارات مركزية · إعداد يعتمد على معرّف المشروع (Project ID)

المتطلبات

· Godot 4.5 أو أحدث · اتصال بالإنترنت · معرّف مشروع (Project ID) صادر من لوحة تحكم S. M PRO TEAM

التثبيت قم بتثبيت الإضافة داخل مشروع Godot ثم فعّلها من:

"Project > Project Settings > Plugins"

الحصول على معرّف المشروع (Project ID)

1. افتح لوحة تحكم S. M PRO TEAM الرسمية: https://s-m-pro.onrender.com/dashboard
2. سجّل الدخول بحساب Google الخاص بك.
3. أنشئ مشروعا جديدا واملأ البيانات التالية: · اسم اللعبة / التطبيق · رقم الإصدار الحالي · حالة التحديث (اختياري / إجباري) · رابط التحديث
4. انسخ معرّف المشروع (Project ID). يبدو بهذا الشكل:

"SMP-XXXXXXXX" 

إعداد الإضافة

اضاف النود الخاص بالإضافة : اضغط عل "إنشاء نود جديدة (Create New Node)" وابحث عن نود اسمها Version Status ثم اضافها الي مشهدك (يجب اضافتها الي المشهد الرئيسي)

حدد على نود Version Status وفي تبويب (نافذة) الـ Inspector واكتب "رقم إصدار" لعبتك "الحالي!" في

Your_game_version 

مثلاً :

 "1.0.0"

سيتم مقارنة إصدار اللعبة المحلي بالإصدار المحفوظ في السيرفر للمعرّف الخاص بمشروعك.

حدد على نود Version Status وفي تبويب (نافذة) الـ Inspector واكتب "معرّف المشروع" الخاص بك في

project_id 

مثلاً :

 "SMP-XXXXXXXX"

استبدله بالمعرّف الذي نسخته من لوحة التحكم.

هذا كل شيء. لا تحتاج لتعديل أي شيء آخر.

يمكنك إضافة نودات ColorRect و Sprite2D و panel و Button ، لكي تنشئ وتخصص النافذة المنبسقه الخاصة بك (Pop-up )، بشرط أن تكون نودات النافذة المنبسقه تابعة (إبن) لنود Version Status.

حدد على نود Version Status وفي تبويب (نافذة) الـ Inspector قم بإضافة زر التحديث الي حقل update_button.

وقم بإضافة زر "لاحقاً/ skip" إلي حقل skip في Inspector.

توجيه:

عند تشغيل اللعبة، تقوم الإضافة تلقائيًا بجعل قيمة Visible في نود Version Status تساوي false، مما يؤدي إلى إخفاء نود Version Status وجميع نودات واجهة المستخدم الموجودة بداخلها، بما في ذلك نودات نافذة الـ Pop-up التي قمت بإنشائها وتخصيصها.

بعد ذلك، تقوم الإضافة بفحص إصدار اللعبة والتحقق من وجود تحديث جديد.

عند اكتشاف تحديث جديد، تقوم الإضافة تلقائيًا بتغيير قيمة Visible في نود Version Status إلى true، وبذلك تظهر نود Version Status وجميع النودات التابعة لها، بما في ذلك واجهة الـ Pop-up التي قمت بتصميمها.

لذلك، يجب عليك وضع جميع نودات واجهة الـ Pop-up التي تريد إظهارها عند توفر تحديث كأبناء لنود Version Status.

لا تحتاج إلى تغيير قيمة Visible يدويًا، فالإضافة تتولى إخفاء وإظهار نافذة الـ Pop-up تلقائيًا حسب حالة التحديث.

ملاحظة:

يُمنع تعديل قيمتي Name و Code داخل تبويب Version في نافذة التصدير، سواء كان التصدير لنظام Android أو لأي منصة أخرى.

تتولى الإضافة ضبط هذه القيم تلقائيًا بناءً على رقم الإصدار الذي أدخلته في خاصية Your_game_version من Inspector لنود Version Status.

قد يؤدي إجراء أي تعديل يدوي على قيم Name و Code داخل تبويب Version في نافذة التصدير إلى عدم عمل الإضافة بشكل صحيح، وقد يتسبب أيضًا في حدوث مشاكل في تثبيت اللعبة بعد التصدير.

الدروس التعليمية

قائمة تشغيل YouTube

"قائمة تشغيل دروس VersionStatus"

https://www.youtube.com/playlist?list=PLIVn33Xm3e8A

فيديو الشرح

"مشاهدة فيديو شرح VersionStatus على YouTube" https://youtu.be/G8noBkkyJEM

إذا لم يظهر الفيديو داخل التطبيق الذي تقرأ منه الوصف، افتح الرابط مباشرة في المتصفح أو YouTube.

التوثيق

يحتوي مجلد الإضافة على ملف README كامل يشرح التثبيت والإعداد والأوامر والأمثلة ومعلومات الترخيص.

الترخيص

تخضع إضافة S. M PRO TEAM VersionStatus لـ S. M PRO TEAM Custom License.

يسمح الترخيص بالاستخدام الشخصي والتجاري للإضافة بصيغتها الأصلية غير المعدّلة. لا يُسمح بتعديل الإضافة أو إعادة توزيعها كمنتج مستقل.

راجع نص الترخيص الكامل: S. M PRO TEAM Custom License

S. M PRO TEAM

تم تطوير الإضافة بواسطة: S. M PRO TEAM

.

الموقع:

https://s-m-pro.onrender.com