FiveM EUP Analyzer

---

📦 Overview

FiveM EUP Analyzer is a modern tool built for developers who manage EUP clothing packs. It provides automatic scanning, component breakdown, texture mapping, ID catalog generation, note management, and a clean UI focused on workflow efficiency.

Whether you're managing a large clothing pack or tracking hundreds of variants,
this tool helps you:

• Organize your clothing components
• Detect errors faster
• Track textures (a–z)
• Document your YDD/YTD files
• Generate proper FiveM catalog IDs

---

🚀 Features

🔍 Full EUP Folder Scanner

• Scans entire EUP stream directories
• Detects all .ydd and .ytd files
• Validates naming format
• Automatically maps textures (a–z) to parent YDD

🧑‍🤝‍🧑 Ped Selector

After scanning:

• Choose Male or Female
• Automatically filters all components

📊 Smart Statistics

• Total YDD files
• Component total
• Prop total
• Format error count

🧩 Component & Prop Breakdown

Organized using official GTA clothing categories:

• Hair, Beard, Torso, Gloves, Feet, Accessories
• Props: glasses, ears, masks, watches, etc.
• Click a category → open detailed listing

📁 Detailed Table View

Columns include: ID | Base Name | Variant | Texture | Notes

Additional features:

• Descending auto-ID generation based on LAST catalog ID
• Skip ID mode (hide ID column)
• Pagination (default 25 per page)

📝 Notes System (per YDD & per Texture)

• Add notes to YDD
• Add notes to each texture (a, b, c...)
• Automatically saved to: cache/notes-<md5_of_path>.json

📂 File Detail Modal

Includes:

• Base folder
• Subfolder
• Full path
• File location
• Texture list

Utility buttons:

• Copy Base Path
• Copy Folder Path
• Copy File Path
• Copy Texture Names
• Open Folder in Explorer

---

🛠 Requirements

• Python 3.9 or higher
• Any OS (Windows / Linux / macOS) - but only tested on Windows 11
• FiveM resource or EUP clothing files

---

📂 Folder Structure

FiveM-EUP-Analyzer/
  │ app.py
  │ README.md
  │ LICENSE
  │ .gitignore
  │ requirements.txt
  │
  ├── cache/
  │ └── notes-xxxx.json
  │
  ├── templates/
  │ └── index.html
  │
  └── static/
    │
    ├── css/
    │ └── style.css
    │
    └── js/
      └── app.js

---

🧰 Installation

1. Clone Repository

git clone https://github.com/ShennBoku/FiveM-EUP-Analyzer.git
cd FiveM-EUP-Analyzer

2. Install Dependencies

pip install -r requirements.txt

3. Launch the App

python app.py

4. Open in Browser

http://127.0.0.1:3000

---

✨ Notes File Format

Example stored notes file:

{
  "mp_m_freemode_01_mp_m_zzakyogo^jbib_000_u.ydd": {
    "ydd": "Varsity Kyogo Family",
    "textures": {
      "a": "Base Version",
      "b": "Shenn Kyogo",
      "c": "Jangboy Kyogo",
      "d": "Rant Kyogo"
    }
  },
  "mp_f_freemode_01_mp_f_zzakyogo^jbib_000_u.ydd": {
    "ydd": "Varsity Kyogo Family",
    "textures": {
      "a": "Base Version",
      "b": "Michelle Kyogo"
    }
  }
}

---

📄 License

This project is licensed under the MIT License

© 2025 Afdhalul Ichsan Yourdan (ShennBoku / KYG - Ostara)

---

Made with ❤️ for the FiveM development community.