Unreal Engine-də Python avtomatlaşdırması: plagini aktivləşdirib ilk skripti işə salmaq

Bu bələdçidə nə öyrənəcəksiniz?

Unreal Editor-da Python-dan istifadə etməyə başlamaq üçün əvvəlcə müvafiq plagini layihədə aktivləşdirmək, sonra isə kodu uyğun üsulla işlətmək lazımdır. Bu bələdçi plaqinin quraşdırılmasını, konsoldan kod işlətməyi, Python faylını icra etməyi və avtomatlaşdırmanı sonradan təkrarlana bilən edəcək seçimləri izah edir. Epic Games-in təlimatında Python redaktorda asset-lərin idarə edilməsi, səhnələrdə məzmunun yerləşdirilməsi və vaxt aparan bəzi işlərin avtomatlaşdırılması kimi məqsədlər üçün nəzərdə tutulur.

Əhatə dairəsini nəzərə almaq vacibdir: bu Python mühiti Unreal Editor üçündür. Layihə Play In Editor rejimində, müstəqil oyun kimi və ya paketlənmiş tətbiq şəklində işləyərkən Python kodundan istifadə olunmur. Buna görə də burada izah edilənlər gameplay məntiqi deyil, redaktor və istehsal prosesi avtomatlaşdırması üçün başlanğıc nöqtəsidir.

Tələblər

• Unreal Engine layihəsi və Unreal Editor.

• Layihə üçün aktivləşdiriləcək Python Editor Script Plugin.

• Təlimatda tövsiyə edilən ümumi redaktor əməliyyatları API-ləri üçün Editor Scripting Utilities plagini.

• Python-u ayrıca quraşdırmaq tələb olunmur: Epic Games-in sənədinə əsasən, Python Editor Script Plugin Python 3.11.8-i daxili şəkildə ehtiva edir.

Unreal Python API sənədi “5.8 (Experimental)” kimi işarələnib. Epic Games həmçinin bu funksiyanın eksperimental olduğu və xüsusilə məhsulun buraxılış mərhələsində ehtiyatla istifadə edilməli olduğu barədə xəbərdarlıq edir. Buna görə burada təsvir olunan addımları əvvəlcə istehsal layihəsinin surətində və ya sınaq layihəsində yoxlamaq məqsədəuyğundur. Mənbələrdə hesab tələbi də qeyd edilmir.

Addım-addım: Python-ı aktivləşdirib kodu işlətmək

1. Plaginləri layihədə aktivləşdirin

Unreal Editor-da nəzərdə tutulan layihəni açın və əsas menyudan Edit > Plugins yolunu izləyin. Plaginlər pəncərəsinin Scripting bölməsində Python Editor Script Plugin sətrini tapıb Enabled seçimini aktivləşdirin. Epic Games ümumi redaktor əməliyyatları üçün sadələşdirilmiş API-lər təqdim edən Editor Scripting Utilities plaginini də aktivləşdirməyi tövsiyə edir.

Bu ayar hər layihə üçün ayrıca edilməlidir. Plaginləri aktivləşdirdikdən sonra redaktoru yenidən başladın. Yenidən başlatma addımını ötürməyin; təlimatda plagin quraşdırıldıqdan sonra redaktorun yenidən başladılması tələb olunur.

2. Konsolun Python rejimindən istifadə edin

Sətir-sətir sınaq aparmaq və ya qısa kod parçasını dərhal icra etmək üçün Output Log panelindəki konsol girişini Python rejiminə keçirin. Konsolun giriş sətrini ~ düyməsi ilə də açmaq mümkündür. Python rejimində daxil edilən sətirlər dərhal icra olunur; bir neçə sətir üçün Shift+Enter düymələrindən istifadə etmək və ya çoxsətirli bloku mətn redaktorundan yapışdırmaq olar.

Bu üsul interaktiv sınaqlar üçün əlverişlidir. print funksiyasının çıxışı da Output Log panelinə yönləndirilir. Əmr konsolu Cmd rejimində olduqda isə py əmrindən sonra gələn hissəni Python kodu kimi icra etmək mümkündür. Mövcud skript faylını bu üsulla çağırmaq nümunəsi:

py "C:\MyScripts\my_script.py"

Buradakı fayl yolu icra ediləcək skriptin yerini göstərən təlimat nümunəsidir; öz faylınız üçün yolu uyğun şəkildə dəyişməlisiniz.

3. Skript faylını File menyusundan işə salın

Əvvəllər işlətmədiyiniz faylı seçmək üçün əsas pəncərədəki File > Execute Python Script seçimindən istifadə edin. Əvvəllər işə salınmış faylları Recent Python scripts siyahısından yenidən seçmək olar. Redaktor faylı diskdən yenidən oxuduğuna görə skriptdə etdiyiniz son dəyişikliklər də bu yolla icra olunur.

Bu üsul kodu təkrar-təkrar konsola yapışdırmadan fayl vasitəsilə icra etməyə imkan verir. Mənbədə faylın məzmununun nə etdiyinə dair avtomatik təhlükəsizlik və ya yoxlama addımı göstərilmir; buna görə icradan əvvəl skripti və hədəf layihəni yoxlayın.

4. Tam redaktorla əmr sətrindən işlədin

Skript layihə məzmunu və ya yüklənməsi vaxt aparan səhnə ilə qarşılıqlı əlaqədədirsə, tam Unreal Editor-ı başladan üsuldan istifadə etmək olar. Redaktor layihəni açır, standart başlanğıc səhnəsini yükləyir və mühit hazır olduqda skripti işə salır. Mənbə təlimatındakı Windows əmr sətri nümunəsi:

UnrealEditor-Cmd.exe "C:\projects\MyProject.uproject" -ExecutePythonScript="c:\my_script.py"

Bu seçim üçün layihədə Editor Scripting Utilities plagini aktiv olmalıdır; Python Scripting Plugin də əmrdə göstərilən layihədə əvvəlcədən aktivləşdirilməlidir. Təlimata əsasən, skript tamamlandıqdan sonra redaktor bağlanır.

5. İnterfeys olmadan işləyən commandlet seçimini nəzərdən keçirin

Commandlet üsulu sürətli icraya və redaktor interfeysini açmadan, yəni headless rejimdə işləməyə imkan verir. Təlimatda UnrealEditor-Cmd.exe ilə -run=pythonscript və -script arqumentlərindən istifadə göstərilir:

UnrealEditor-Cmd.exe "C:\projects\MyProject.uproject" -run=pythonscript -script="c:\my_script.py"

Bu üsul səhnələri avtomatik yükləmir. Skriptin səhnəyə ehtiyacı varsa, mənbədə səhnə yükləmə çağırışının skriptin ilk əməliyyatı olmalı olduğu qeyd edilir:

unreal.get_editor_subsystem(unreal.LevelEditorSubsystem).load_level("/Game/maps/UVlayoutTest.UVlayoutTest")

Commandlet nümunələrindəki layihə, skript və səhnə yolları sənəddə verilmiş nümunə dəyərləridir; onları real layihədəki yerlərə uyğunlaşdırmadan istifadə etmək olmaz.

6. Təkrarlanan işləri başlanğıcda icra edin

Eyni layihə və ya plaginlə işləyən komandanın hər açılışda eyni hazırlıq koduna ehtiyacı olduğu hallarda init_unreal.py faylından istifadə etmək olar. Redaktor konfiqurasiya edilmiş Python yollarında bu adda fayl taparsa, onu avtomatik icra edir. Təlimatda faylın layihənin və ya plaqinin Content/Python qovluğuna yerləşdirilə biləcəyi bildirilir.

Layihə hər açıldıqda icra olunacaq bir və ya bir neçə fayl təyin etmək üçün Edit > Project Settings bölməsində Plugins > Python ayarlarına keçib skriptləri Startup scripts sahəsinə əlavə edin. Ayarı dəyişdikdən sonra redaktoru yenidən başladın; skriptlər növbəti açılışda standart başlanğıc səhnəsi tam yükləndikdən sonra icra olunur.

Tez-tez edilən səhvlər

• Plagini yalnız bir dəfə aktivləşdirməyin kifayət etdiyini düşünmək: Python Editor Script Plugin hər layihə üçün ayrıca aktivləşdirilir.

• Python-ı oyun işləyərkən istifadə etməyə çalışmaq: Bu funksiya redaktor üçündür; Play In Editor, Standalone Game və paketlənmiş tətbiq zamanı istifadə olunmur.

• Commandlet-in səhnəni avtomatik yükləyəcəyini güman etmək: Mənbədə commandlet-in səhnələri avtomatik yükləmədiyi xüsusi olaraq qeyd olunur.

• Skript hazır olmadan onu işə salmaq: Təlimatda ExecCmd başlanğıc parametrində py əmri ilə skriptin işə salınması tövsiyə edilmir; redaktor mühiti və ya başlanğıc səhnəsi hələ hazır olmaya bilər.

• Eksperimental olduğunu nəzərə almamaq: Python dəstəyi eksperimental kimi təsvir olunur. Xüsusilə təhvil və ya buraxılış prosesinə daxil olacaq layihələrdə əvvəlcə nəzarətli sınaq aparılmalıdır.

Memarlıq və vizuallaşdırma iş axınlarına təsiri

Unreal Engine-də səhnə quran memarlar, interyer dizaynerləri və archviz komandaları üçün Python redaktorda təkrarlanan əməliyyatların skriptlə icrası, məzmunun idarə olunması və səhnədə elementlərin yerləşdirilməsi kimi işlərə əsas yarada bilər. Bununla belə, mənbələrdə konkret memarlıq avtomatlaşdırma skripti təqdim edilmir; iş axınına uyğunlaşdırma layihənin məzmunundan və yazılacaq koddan asılıdır. Konsol qısa sınaqlar, fayldan icra isə təkrar istifadə edilə bilən skriptlər üçün daha uyğun başlanğıc nöqtəsidir.

Bundan əlavə, mənbələrdə güclü videokart, ödənişli lisenziya və ya hesab tələbi qeyd olunmur. Buna görə də avadanlıq və ya xərc üstünlüyü barədə qəti nəticə çıxarmaq mümkün deyil. Komandalar üçün əsas yoxlama məqamları plaginlərin layihədə aktiv olub-olmaması, skriptin hansı redaktor kontekstində işləməsi və eksperimental funksiyanın təhvil prosesinə uyğunluğudur.

Növbəti addımlar

Əvvəlcə sınaq layihəsində plaginləri aktivləşdirib konsol və File menyusu vasitəsilə işlətmə üsullarını müqayisə edin. Sonra birdəfəlik əməliyyatları fayla köçürün; müntəzəm icrası lazım olan hazırlıq işlərini isə layihənin başlanğıc skriptləri kimi nəzərdən keçirin. Blueprint ilə istifadə tələb olunursa, Python düyünlərinin yalnız Editor Utility Widget və Editor Utility Blueprint kimi redaktor siniflərində istifadə edilə bildiyini unutmayın. Mənbəyə əsasən, Execute Python Script düyünü kod parçasını icra edir, fayl işlətmir; fayl və ya kod üçün Execute Python Command seçimi mövcuddur. Xəta çıxışlarına Output Log panelində baxmaq olar.

Mənbə və lisenziya

Bu bələdçi Epic Games-in Unreal Editor-da Python istifadəsinə başlamaq və Python API sənədlərindən yararlanmaqla hazırlanıb. Mənbə səhifələr bu məzmun üçün sərbəst lisenziya əsasında təqdim olunub; mətn Azərbaycan dilinə uyğunlaşdırılaraq yenidən yazılıb.