S. M PRO TEAM VersionStatus

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

S. M PRO TEAM VersionStatus is a Godot plugin for checking your game's version and detecting available updates.

The plugin connects your game to your own server, retrieves version information, compares it with the local game version, and provides the update URL for your game.

Features

• Game version checking
• Automatic update detection
• Required update support
• Update URL access
• Automatic "VersionStatus" Autoload registration
• Automatic "DataControl" Autoload registration
• Example server written in Python
• Example project files included

Requirements

• Godot 4.5 or later
• A server that supports update notifications

Installation

Install the plugin into your Godot project and enable it from: "Project > Project Settings > Plugins"

When enabled, the plugin automatically registers:

• VersionStatus
• DataControl

Both are available globally from your project's scripts.

Configuration

Open addons/S. M PRO TEAM VersionStatus/Data_Control.gd and replace the URL with your own server URL:

var your_url = "https://xxxx-example-xxxx.com"

Set your game's current version:

var Your_game_version = "1.0.0"

The local version is compared with the version provided by your server.

Check for Updates

Call:

VersionStatus.Server_Connection()

After the server response is received, the plugin compares the server version with the local game version.

If an update is available:

if VersionStatus.update == true:
    # Call your popup window here
    pass

When the server version differs from the local game version:

VersionStatus.update = true

Required Updates

Your server can indicate that an update is required.

Use:

if VersionStatus.supposed == true:
    # Put the command to hide the "Skip Update / Later" button here
    pass

When a required update is specified, "VersionStatus.supposed" becomes "true". You can use this value to hide the button that allows the player to skip or postpone the update.

Update URL

The update URL is available through:

VersionStatus.update_url

Example:

OS.shell_open(VersionStatus.update_url)

Use this variable in your update button to open the URL provided by your server.

Available Variables

Available Function

VersionStatus.Server_Connection()

Starts the connection to your version checking server.

Example

Start the version check when the game starts:

func _ready():
    VersionStatus.Server_Connection()

Show your update popup:

if VersionStatus.update == true:
    # Call your popup window here
    pass

Handle a required update:

if VersionStatus.supposed == true:
    # Put the command to hide the "Later" button here
    pass

Open the update URL:

OS.shell_open(VersionStatus.update_url)

Server

The repository includes an example Python server:

server/
├── app.py
└── requirements.txt

You can host the server using a service that supports Python applications. Render is recommended for hosting the server.

Tutorials

YouTube Tutorial Playlist

The tutorial playlist will be added here later.

"VersionStatus Tutorial Playlist" (#link-will-be-added-later)

Tutorial Video

The tutorial video will be added here later.

"Watch the VersionStatus Tutorial on YouTube" (#tutorial-video-link-will-be-added-later)

If the video cannot be displayed in your current application, open the link directly in your browser or YouTube.

Documentation

A complete README with installation instructions, configuration details, examples, server information, and license information is included with the plugin.

License

S. M PRO TEAM VersionStatus is distributed under the S. M PRO TEAM Custom License.

The license permits personal and commercial use and modification according to its terms.

See the complete license: S. M PRO TEAM Custom License

Created by: S. M PRO TEAM

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

S. M PRO TEAM VersionStatus

العربية

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

تتصل الإضافة بالسيرفر الخاص بك، وتحصل على معلومات الإصدار، ثم تقارن إصدار اللعبة المحلي بالإصدار الموجود في السيرفر، وتحفظ رابط التحديث لاستخدامه داخل اللعبة.

المميزات

• فحص إصدار اللعبة
• اكتشاف التحديثات تلقائيا
• دعم التحديث الإجباري
• الوصول إلى رابط التحديث
• تسجيل "VersionStatus" تلقائيا كـ Autoload
• تسجيل "DataControl" تلقائيا كـ Autoload
• سيرفر Python تجريبي
• ملفات مثال مرفقة مع الإضافة

المتطلبات

• Godot 4.5 أو أحدث
• سيرفر يدعم تنبيهات التحديثات

التثبيت

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

"Project > Project Settings > Plugins"

عند تفعيل الإضافة، يتم تسجيل:

VersionStatus DataControl

تلقائيا كـ Autoload، ويمكن الوصول إليهما من أي سكربت في المشروع.

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

افتح:

addons/S. M PRO TEAM VersionStatus/Data_Control.gd

ضع رابط السيرفر الخاص بك:

var your_url = "https://xxxx-example-xxxx.com"

استبدل الرابط برابط السيرفر الخاص بك.

ضع إصدار لعبتك الحالي:

var Your_game_version = "1.0.0"

سيتم مقارنة إصدار اللعبة المحلي بالإصدار الموجود في السيرفر.

فحص التحديثات

استدعِ:

VersionStatus.Server_Connection()

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

إذا كان هناك تحديث:

if VersionStatus.update == true: # استدعِ هنا أمر ظهور النافذة المنبثقة pass

عندما يختلف إصدار السيرفر عن إصدار اللعبة المحلي:

VersionStatus.update = true

التحديث الإجباري

يستطيع السيرفر تحديد أن التحديث إجباري.

استخدم:

if VersionStatus.supposed == true: # ضع هنا أمر إخفاء زر "عدم التحديث / تخطي التحديث / لاحقا" pass

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

VersionStatus.supposed = true

يمكنك استخدام هذه القيمة لإخفاء زر تخطي التحديث أو تأجيله.

رابط التحديث

يتم حفظ رابط التحديث داخل:

VersionStatus.update_url

مثال:

OS.shell_open(VersionStatus.update_url)

استخدم هذا المتغير داخل زر التحديث لفتح الرابط الذي يرسله السيرفر.

المتغيرات المتاحة

المتغير| الوظيفة "DataControl.Your_game_version"| إصدار اللعبة الحالي "VersionStatus.update"| يحدد وجود تحديث "VersionStatus.supposed"| يحدد أن التحديث إجباري "VersionStatus.update_url"| رابط التحديث

الدالة المتاحة

VersionStatus.Server_Connection()

تبدأ الاتصال بسيرفر فحص الإصدار.

مثال

ابدأ فحص الإصدار عند تشغيل اللعبة:

func _ready(): VersionStatus.Server_Connection()

إظهار نافذة التحديث:

if VersionStatus.update == true: # استدعِ هنا أمر ظهور النافذة المنبثقة pass

التعامل مع التحديث الإجباري:

if VersionStatus.supposed == true: # ضع هنا أمر إخفاء زر "لاحقا" pass

فتح رابط التحديث:

OS.shell_open(VersionStatus.update_url)

السيرفر

يحتوي المستودع على سيرفر Python تجريبي:

server/ ├── app.py └── requirements.txt

تستطيع استضافة السيرفر على خدمة تدعم تطبيقات Python.

أرشح Render لاستضافة السيرفر.

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

قائمة تشغيل YouTube

سيتم إضافة قائمة تشغيل الدروس التعليمية الخاصة بـ VersionStatus هنا لاحقا.

"قائمة تشغيل دروس VersionStatus" (#ساضع-الرابط-لاحقا)

فيديو الشرح

سيتم إضافة فيديو الشرح هنا لاحقا.

"مشاهدة فيديو شرح VersionStatus على YouTube" (#رابط-فيديو-الشرح-سيوضع-لاحقا)

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

التوثيق

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

الترخيص

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

يسمح الترخيص بالاستخدام الشخصي والتجاري وتعديل الإضافة وفقا للشروط الموضحة فيه.

راجع نص الترخيص الكامل:

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

S. M PRO TEAM

تم تطوير الإضافة بواسطة:

S. M PRO TEAM

الموقع:

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