دليل شامل عن بناء لعبة موبايل من الصفر باستخدام LibGDX

package com.yourcompany.myfirstgame; // تأكد من تحديث اسم الحزمة (package) 

import com.badlogic.gdx.ApplicationAdapter; // الفئة الأساسية لتطبيق LibGDX
import com.badlogic.gdx.Gdx; // يوفر الوصول إلى وظائف النظام الأساسية (الرسومات، المدخلات، الصوت)
import com.badlogic.gdx.graphics.GL20; // واجهة OpenGL ES 2.0 للرسومات
import com.badlogic.gdx.graphics.Texture; // لتمثيل الصور
import com.badlogic.gdx.graphics.g2d.SpriteBatch; // لرسم الصور (Sprites) بكفاءة
import com.badlogic.gdx.InputProcessor; // واجهة للتعامل مع مدخلات المستخدم (اللمس، لوحة المفاتيح)

// فئة اللعبة الرئيسية التي ترث من ApplicationAdapter
public class MyFirstGame extends ApplicationAdapter implements InputProcessor {

    // SpriteBatch هو كائن يستخدم لرسم الصور (Sprites).
    // من الأفضل أن يكون لديك كائن SpriteBatch واحد فقط في لعبتك.
    SpriteBatch batch;

    // Texture هو كائن يمثل صورة تم تحميلها في ذاكرة وحدة معالجة الرسومات (GPU).
    // سنستخدمها لرسم صورة بسيطة على الشاشة.
    Texture img;

    // متغير لتتبع موضع الصورة
    float x, y;

    // ------------
    // دالة create(): يتم استدعاؤها مرة واحدة عند بدء تشغيل التطبيق.
    // هنا نقوم بتهيئة موارد اللعبة وتحميل الأصول.
    // ------------
    @Override
    public void create () {
        // تهيئة SpriteBatch
        batch = new SpriteBatch();

        // تحميل الصورة من مجلد assets/.
        // تأكد من وجود ملف "badlogic.jpg" في مجلد "core/assets/".
        // يمكنك استبداله بأي صورة أخرى (مثل "my_player.png").
        img = new Texture("badlogic.jpg");

        // تعيين الموضع الأولي للصورة في منتصف الشاشة تقريبًا
        x = Gdx.graphics.getWidth() / 2f - img.getWidth() / 2f; // منتصف العرض
        y = Gdx.graphics.getHeight() / 2f - img.getHeight() / 2f; // منتصف الارتفاع

        // تعيين هذه الفئة (MyFirstGame) كمعالج للمدخلات.
        // هذا يسمح لنا بتلقي أحداث اللمس والنقر.
        Gdx.input.setInputProcessor(this);

        Gdx.app.log("MyFirstGame", "اللعبة بدأت! تم تهيئة الموارد.");
    }

    // ------------
    // دالة render(): يتم استدعاؤها بشكل متكرر في كل إطار (Frame).
    // هنا نقوم بتحديث منطق اللعبة ورسم العناصر على الشاشة.
    // ------------
    @Override
    public void render () {
        // 1. تحديث منطق اللعبة (Game Logic Update)
        // في هذه اللعبة البسيطة، لا يوجد منطق تحديث معقد.
        // يمكن أن يكون هنا تحديث لموضع اللاعب، حركة الأعداء، الكشف عن التصادمات، إلخ.
        // Gdx.graphics.getDeltaTime() يعطي الوقت المنقضي منذ الإطار الأخير، مفيد للحركة المستقلة عن الإطارات.

        // 2. مسح الشاشة (Clear the Screen)
        // يمسح الشاشة بلون معين (هنا، لون أزرق داكن).
        // GL20.GL_COLOR_BUFFER_BIT يحدد أننا نمسح مخزن الألوان.
        Gdx.gl.glClearColor(0.2f, 0.2f, 0.3f, 1); // R, G, B, Alpha (0.0-1.0)
        Gdx.gl.glClear(GL20.GL_COLOR_BUFFER_BIT);

        // 3. بدء الرسم (Begin Drawing)
        // يجب أن تبدأ SpriteBatch قبل أي عمليات رسم.
        batch.begin();

        // 4. رسم الصورة (Draw the Image)
        // نرسم الصورة (img) في الموضع (x, y).
        batch.draw(img, x, y);

        // 5. إنهاء الرسم (End Drawing)
        // يجب أن تنهي SpriteBatch بعد الانتهاء من جميع عمليات الرسم.
        batch.end();
    }

    // ------------
    // دالة dispose(): يتم استدعاؤها مرة واحدة عند إغلاق التطبيق.
    // هنا نقوم بتحرير الموارد التي تم تحميلها لمنع تسرب الذاكرة.
    // ------------
    @Override
    public void dispose () {
        // تحرير موارد SpriteBatch
        batch.dispose();
        // تحرير موارد Texture (الصورة)
        img.dispose();
        Gdx.app.log("MyFirstGame", "اللعبة أغلقت! تم تحرير الموارد.");
    }

    // ------------
    // دوال InputProcessor: للتعامل مع مدخلات المستخدم.
    // ------------

    // يتم استدعاؤها عند لمس الشاشة أو النقر بزر الفأرة.
    @Override
    public boolean touchDown (int screenX, int screenY, int pointer, int button) {
        Gdx.app.log("Input", "تم لمس الشاشة عند: (" + screenX + ", " + screenY + ")");
        // يمكنك هنا إضافة منطق لتغيير موضع الصورة أو إطلاق حدث ما
        x = screenX - img.getWidth() / 2f;
        y = Gdx.graphics.getHeight() - screenY - img.getHeight() / 2f; // تحويل الإحداثيات (LibGDX يستخدم الأصل في الأسفل)
        return true; // يشير إلى أن الحدث قد تم التعامل معه
    }

    // يتم استدعاؤها عند سحب الإصبع على الشاشة أو سحب الفأرة.
    @Override
    public boolean touchDragged (int screenX, int screenY, int pointer) {
        Gdx.app.log("Input", "تم سحب اللمس إلى: (" + screenX + ", " + screenY + ")");
        x = screenX - img.getWidth() / 2f;
        y = Gdx.graphics.getHeight() - screenY - img.getHeight() / 2f;
        return true;
    }

    // يتم استدعاؤها عند رفع الإصبع من الشاشة أو رفع زر الفأرة.
    @Override
    public boolean touchUp (int screenX, int screenY, int pointer, int button) {
        Gdx.app.log("Input", "تم رفع اللمس من: (" + screenX + ", " + screenY + ")");
        return true;
    }

    // يتم استدعاؤها عند الضغط على زر في لوحة المفاتيح.
    @Override
    public boolean keyDown (int keycode) {
        Gdx.app.log("Input", "تم الضغط على زر لوحة المفاتيح: " + keycode);
        return true;
    }

    // يتم استدعاؤها عند رفع زر من لوحة المفاتيح.
    @Override
    public boolean keyUp (int keycode) {
        return false;
    }

    // يتم استدعاؤها عند كتابة حرف (مثل عند استخدام لوحة المفاتيح الافتراضية).
    @Override
    public boolean keyTyped (char character) {
        return false;
    }

    // يتم استدعاؤها عند تحريك الفأرة (لا ينطبق على اللمس).
    @Override
    public boolean mouseMoved (int screenX, int screenY) {
        return false;
    }

    // يتم استدعاؤها عند التمرير بعجلة الفأرة.
    @Override
    public boolean scrolled (float amountX, float amountY) {
        return false;
    }

    // ------------
    // دوال دورة حياة التطبيق الإضافية (مفيدة للأجهزة المحمولة)
    // -----------

    // يتم استدعاؤها عند تغيير حجم الشاشة.
    @Override
    public void resize(int width, int height) {
        Gdx.app.log("MyFirstGame", "تم تغيير حجم الشاشة إلى: " + width + "x" + height);
        // يمكنك هنا تحديث الكاميرا أو viewports لضمان أن اللعبة تتكيف مع الحجم الجديد.
    }

    // يتم استدعاؤها عندما يتم إيقاف اللعبة مؤقتًا (مثلاً عند تلقي مكالمة هاتفية).
    @Override
    public void pause() {
        Gdx.app.log("MyFirstGame", "اللعبة في وضع الإيقاف المؤقت.");
    }

    // يتم استدعاؤها عندما يتم استئناف اللعبة من وضع الإيقاف المؤقت.
    @Override
    public void resume() {
        Gdx.app.log("MyFirstGame", "اللعبة استؤنفت.");
    }
}