unrealmate 0.1.5

All-in-one CLI toolkit for Unreal Engine developers

🎮 UnrealMate

All-in-one CLI toolkit for Unreal Engine developers

Unreal Engine geliştiricileri için hepsi bir arada CLI araç kiti

🇬🇧 English • 🇹🇷 Türkçe

Speed up your Unreal Engine workflow with powerful CLI commands

---

🇬🇧 English

📋 Table of Contents

• Features
• Installation
• Quick Start
• Commands
• Examples
• Contributing

✨ Features

🔧 Git Tools Manage your Git workflow efficiently ✅ Generate optimized .gitignore ✅ Setup Git LFS automatically ✅ Clean temporary files (save GBs!)	📦 Asset Management Keep your assets organized ✅ Scan & report all assets ✅ Auto-organize into folders ✅ Find duplicate files
📊 Blueprint Analysis Understand your Blueprint complexity ✅ Analyze BP statistics ✅ Complexity scoring ✅ Export HTML/JSON reports	🩺 Project Health Keep your project healthy ✅ Health score (0-100) ✅ Configuration checks ✅ Best practice validation

🚀 Installation

The easiest way to install UnrealMate v0.1.5 🚀via pip:

pip install unrealmate

Verification

unrealmate --help

Dev Installation (Optional)

If you want to contribute or develop:

git clone https://github.com/gktrk363/unrealmate.git
cd unrealmate
python -m venv venv
# Windows: venv\Scripts\activate
# Mac/Linux: source venv/bin/activate
pip install -e .

⚡ Quick Start

# Navigate to your UE project
cd "C:/Projects/MyGame"

# Check project health
unrealmate doctor

# Setup Git (one-time)
unrealmate git init
unrealmate git lfs

# Clean temporary files (save space)
unrealmate git clean

# Scan assets
unrealmate asset scan

# Analyze blueprints
unrealmate blueprint analyze

📖 Commands

🔧 Git Commands

Command	Description
unrealmate git init	Generate .gitignore for UE projects
unrealmate git lfs	Setup Git LFS for large files
unrealmate git clean	Remove temporary/cache files

# Examples
unrealmate git init              # Create .gitignore
unrealmate git clean --dry-run   # Preview what will be deleted

📦 Asset Commands

Command	Description
unrealmate asset scan	Scan and report all assets
unrealmate asset organize	Auto-organize assets into folders
unrealmate asset duplicates	Find duplicate assets

# Examples
unrealmate asset scan --all              # Show all files
unrealmate asset organize --dry-run      # Preview organization
unrealmate asset duplicates --content    # Accurate duplicate scan

📊 Blueprint Commands

Command	Description
unrealmate blueprint analyze	Analyze Blueprint statistics
unrealmate blueprint report	Generate complexity report

# Examples
unrealmate blueprint analyze --all        # Show all BPs
unrealmate blueprint report -o report.html   # Generate HTML report

🩺 Health Commands

Command	Description
unrealmate doctor	Check project health & configuration
unrealmate version	Show version info

🤝 Contributing

Contributions are welcome! Here's how:

1. 🍴 Fork the repository
2. 🌿 Create a feature branch (git checkout -b feature/amazing-feature)
3. ✍️ Commit your changes (git commit -m '✨ Add amazing feature')
4. 📤 Push to the branch (git push origin feature/amazing-feature)
5. 🔃 Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🇹🇷 Türkçe

📋 İçindekiler

• Özellikler
• Kurulum
• Hızlı Başlangıç
• Komutlar
• Katkıda Bulunma

✨ Özellikler

🔧 Git Araçları Git iş akışınızı verimli yönetin ✅ Optimize edilmiş .gitignore oluştur ✅ Git LFS'i otomatik kur ✅ Geçici dosyaları temizle (GB'larca yer kazan!)	📦 Asset Yönetimi Asset'lerinizi düzenli tutun ✅ Tüm asset'leri tara ve raporla ✅ Klasörlere otomatik düzenle ✅ Tekrarlayan dosyaları bul
📊 Blueprint Analizi Blueprint karmaşıklığınızı anlayın ✅ BP istatistiklerini analiz et ✅ Karmaşıklık puanlaması ✅ HTML/JSON rapor çıkart	🩺 Proje Sağlığı Projenizi sağlıklı tutun ✅ Sağlık puanı (0-100) ✅ Yapılandırma kontrolleri ✅ Best practice doğrulama

🚀 Kurulum

UnrealMate'i kurmanın en kolay yolu pip kullanmaktır:

pip install unrealmate

Doğrulama

unrealmate --help

Geliştirici Kurulumu (Opsiyonel)

Eğer projeye katkıda bulunmak istiyorsanız:

git clone https://github.com/gktrk363/unrealmate.git
cd unrealmate
python -m venv venv
# Windows: venv\Scripts\activate
# Mac/Linux: source venv/bin/activate
pip install -e .

⚡ Hızlı Başlangıç

# UE projenize gidin
cd "C:/Projects/MyGame"

# Proje sağlığını kontrol et
unrealmate doctor

# Git kurulumu (bir kere)
unrealmate git init
unrealmate git lfs

# Geçici dosyaları temizle (yer açın)
unrealmate git clean

# Asset'leri tara
unrealmate asset scan

# Blueprint'leri analiz et
unrealmate blueprint analyze

📖 Komutlar

🔧 Git Komutları

Komut	Açıklama
unrealmate git init	UE projeleri için .gitignore oluştur
unrealmate git lfs	Büyük dosyalar için Git LFS kur
unrealmate git clean	Geçici/önbellek dosyalarını sil

# Örnekler
unrealmate git init              # .gitignore oluştur
unrealmate git clean --dry-run   # Silinecekleri önizle

📦 Asset Komutları

Komut	Açıklama
unrealmate asset scan	Tüm asset'leri tara ve raporla
unrealmate asset organize	Asset'leri klasörlere otomatik düzenle
unrealmate asset duplicates	Tekrarlayan asset'leri bul

# Örnekler
unrealmate asset scan --all              # Tüm dosyaları göster
unrealmate asset organize --dry-run      # Düzenlemeyi önizle
unrealmate asset duplicates --content    # İçeriğe göre karşılaştır (doğru)

📊 Blueprint Komutları

Komut	Açıklama
unrealmate blueprint analyze	Blueprint istatistiklerini analiz et
unrealmate blueprint report	Karmaşıklık raporu oluştur

# Örnekler
unrealmate blueprint analyze --all        # Tüm BP'leri göster
unrealmate blueprint report -o report.html   # HTML rapor oluştur

🩺 Sağlık Komutları

Komut	Açıklama
unrealmate doctor	Proje sağlığını ve yapılandırmasını kontrol et
unrealmate version	Versiyon bilgisini göster

🤝 Katkıda Bulunma

Katkılarınızı bekliyoruz! İşte nasıl yapılır:

1. 🍴 Repoyu fork'layın
2. 🌿 Feature branch oluşturun (git checkout -b feature/harika-ozellik)
3. ✍️ Değişikliklerinizi commit'leyin (git commit -m '✨ Harika özellik ekle')
4. 📤 Branch'e push'layın (git push origin feature/harika-ozellik)
5. 🔃 Pull Request açın

📄 Lisans

Bu proje MIT Lisansı ile lisanslanmıştır - detaylar için LICENSE dosyasına bakın.

---

👤 Author / Geliştirici

gktrk363

---

⭐ Star this repo if it helped you! / Yardımcı olduysa yıldız ver!

Made for Unreal Engine developers <3 Unreal Engine geliştiricileri için yapıldı <3

🎮 Happy Game Development! / İyi Oyun Geliştirmeler! 🎮