DZX Poe2 Filter

🎯 Advanced Item Filter for Path of Exile 2
เป็น Item Filter ที่พัฒนาขึ้นสำหรับ Path of Exile 2 โดยเฉพาะ
รองรับการรวมไฟล์อัตโนมัติด้วย Python เนื่องจาก PoE2 ยังไม่รองรับ Import Function

✨ Features | คุณสมบัติ

• 🎮 รองรับหลายแพลตฟอร์ม: PC และ PS5
• 🔊 เสียงแจ้งเตือน: เสียงพิเศษสำหรับไอเทมสำคัญ
• 🎨 หลายโหมด: Normal, No-Hide, Color-Only, Breach และอื่นๆ
• 🛠️ ปรับแต่งได้: แยกไฟล์ตามหมวดหมู่ เพื่อการแก้ไขที่ง่าย
• 🔄 อัพเดตสม่ำเสมอ: ติดตามการเปลี่ยนแปลงของเกมอย่างต่อเนื่อง
• 🌐 Web Preview: สามารถดูตัวอย่าง Filter ในรูปแบบ HTML ได้

📋 Table of Contents | สารบัญ

• Download | ดาวน์โหลด
• Installation | การติดตั้ง
• Filter Variants | รูปแบบ Filter
• Developer Guide | คู่มือนักพัฒนา
• Discord Notifications | การแจ้งเตือนผ่าน Discord
• Contributing | การมีส่วนร่วม
• Credits | เครดิต

📥 Download | ดาวน์โหลด

  

🔧 Installation | การติดตั้ง

วิธีติดตั้งแบบง่าย (Easy Installation)

1. ดาวน์โหลดไฟล์: ไปที่ Releases Page และดาวน์โหลดเวอร์ชันล่าสุด
2. แตกไฟล์: แตกไฟล์ zip ที่ดาวน์โหลดมา
3. คัดลอกไฟล์: คัดลอกไฟล์ทั้งหมดไปยังโฟลเดอร์เกมตามแพลตฟอร์มของคุณ

📍 Installation Paths | เส้นทางการติดตั้ง

Windows

%userprofile%\Documents\My Games\Path of Exile 2

หรือเส้นทางเต็ม:

C:\Users\[ชื่อผู้ใช้]\Documents\My Games\Path of Exile 2

Linux (Steam Proton)

~/.steam/steam/steamapps/compatdata/2694490/pfx/drive_c/users/steamuser/My Documents/My Games/Path of Exile 2

หรือสำหรับ Steam Flatpak:

~/.var/app/com.valvesoftware.Steam/.local/share/Steam/steamapps/compatdata/2694490/pfx/drive_c/users/steamuser/My Documents/My Games/Path of Exile 2

PlayStation 5

สำหรับ PS5 ให้ใช้ลิงก์ดาวน์โหลดด้านบนเพื่อนำเข้าผ่าน Path of Exile Website

🎯 การเลือก Filter

หลังจากติดตั้งแล้ว ในเกมให้ไปที่:

1. Settings → Game → Item Filter
2. เลือก Filter ที่ต้องการจากรายการ (ดูรายละเอียดใน Filter Variants)

🎨 Filter Variants | รูปแบบ Filter

เรามี Filter หลายรูปแบบให้เลือกใช้ตามความต้องการ:

Filter Name	Description	แนะนำสำหรับ
dzx-poe2.filter	🌟 Main Filter - Filter หลักที่แนะนำ	ผู้เล่นทั่วไป
dzx-poe2-no-hide.filter	👁️ No Hide - ไม่ซ่อนไอเทมใดๆ	ผู้เล่นใหม่, การทดสอบ
dzx-poe2-Color-Only.filter	🎨 Color Only - แสดงสีเฉพาะ	ผู้เล่นที่ไม่ชอบเสียง
dzx-poe2-breach.filter	⚔️ Breach Mode - สำหรับ Breach	การเล่น Breach League
dzx-poe2-Divine-Mirror.filter	💎 Divine & Mirror - เน้นไอเทมหายาก	การฟาร์มไอเทมหายาก
dzx-poe2-PS5.filter	🎮 PS5 Version - เวอร์ชัน PS5	ผู้เล่น PlayStation 5

💡 คำแนะนำ: หากเป็นครั้งแรกแนะนำให้ใช้ dzx-poe2-no-hide.filter เพื่อเรียนรู้ไอเทมต่างๆ แล้วค่อยเปลี่ยนไปใช้ dzx-poe2.filter

📋 Filter Groups | กลุ่ม Filter

Filter ของเราถูกแบ่งออกเป็นกลุ่มต่างๆ เพื่อให้ง่ายต่อการจัดการและแก้ไข:

💰 Currency & Economy | สกุลเงินและเศรษฐกิจ

• currency.filter - จัดการสกุลเงินทั้งหมด (Chaos, Divine, Mirror, Exalted)
• gold.filter - ระบบ Gold ในเกม (แสดงเมื่อมีจำนวนมาก)
• scroll_of_wisdom.filter - Scroll of Wisdom สำหรับ identify ไอเทม

🎯 Item Rarity | ความหายากของไอเทม

• rarity_magic.filter - ไอเทม Magic (สีน้ำเงิน) ที่มีคุณภาพดี
• rarity_rare.filter - ไอเทม Rare (สีเหลือง) ที่มี Item Level สูง
• rarity_unique.filter - ไอเทม Unique (สีน้ำตาล/ส้ม) ทั้งหมด
• mirror_tier.filter - ไอเทมระดับ Mirror Tier (มูลค่าสูงมาก)

💎 Equipment & Accessories | อุปกรณ์และเครื่องประดับ

• amulets.filter - สร้อยคอ (แสดงเฉพาะที่มีคุณภาพ)
• belts.filter - เข็มขัด (เน้น Rare และมีคุณภาพ)
• ring.filter - แหวน (เน้น Breach Ring และ Rare)
• jewel.filter - Jewel ทุกประเภท (รวม Timeless Jewel)

⚔️ Weapons & Armor | อาวุธและเกราะ

• crafting.filter - ไอเทมสำหรับ Crafting (Base Items ที่มีมูลค่า)
• salvage.filter - ไอเทมที่สามารถ Salvage ได้ (มี Socket หรือ Quality)

🎲 Special Items | ไอเทมพิเศษ

• charms.filter - Charm ที่มีคุณภาพสูง (Quality ≥ 18, Item Level ≥ 82)
• relics.filter - Relic ทุกประเภท (Unique และ Normal)
• talisman.filter - Talisman ต่างๆ (เน้น Rabbit/Fox Talisman)
• soul_core.filter - Soul Core สำหรับ Crafting

🗝️ Keys & Access | กุญแจและการเข้าถึง

• key.filter - กุญแจทุกประเภท (Breachstone, Simulacrum, Tablet)
• waystones.filter - Waystone แบ่งตาม Tier (Tier 13+ มีเสียงพิเศษ)

💎 Gems & Skills | เพชรและสกิล

• uncut_gems.filter - เพชรดิบทุกประเภท (เน้น Level 20 และ Rakiata's Flow)
• rune.filter - Rune และ Soul Core สำหรับ Crafting

🍶 Consumables | ของใช้

• flasks.filter - Flask ทุกประเภท (เน้น Ultimate Life/Mana Flask)

🎰 Gacha Items | ไอเทม Gacha

• gacha.filter - ไอเทมที่สามารถใช้ในระบบ Gacha ได้

🗺️ Maps & Areas | แผนที่และพื้นที่

• map_breach.filter - ไอเทมที่เกี่ยวข้องกับ Breach League

🎵 Sound System | ระบบเสียง

Filter ใช้ระบบเสียงแยกตามประเภทไอเทม:

เสียง	ไฟล์	ใช้สำหรับ
currency.mp3	สกุลเงินทั่วไป	Chaos, Exalted, Regal
divine.mp3	Divine Orb	Divine Orb
mirror.mp3	Mirror Tier	Mirror, Divine, Perfect Jeweller's
unique.mp3	ไอเทม Unique	Unique Items
rare.mp3	ไอเทม Rare	Rare Items
jewel.mp3	Jewel	ทุกประเภท Jewel
base_item.mp3	Base Items	Crafting Items
gacha.mp3	Gacha Items	ไอเทมสำหรับ Gacha
salvage.mp3	Salvage Items	ไอเทมที่สามารถ Salvage
special_currency.mp3	สกุลเงินพิเศษ	Perfect Jeweller's, Greater Jeweller's
waystone.mp3	Waystone	Waystone Tier 14+

🎨 Visual System | ระบบภาพ

สีหลักที่ใช้:

• 🔴 แดง: Mirror Tier, ไอเทมมูลค่าสูงมาก
• 🟡 เหลือง: Rare Items, สกุลเงินสำคัญ
• 🟠 ส้ม: Crafting Items, ไอเทมมีคุณค่า
• 🟣 ม่วง: Magic Items, สกุลเงินระดับกลาง
• 🔵 น้ำเงิน: Jewel, ไอเทมพิเศษ
• 🟢 เขียว: Charms, Rune, ไอเทมธรรมชาติ
• ⚪ ขาว: สกุลเงินทั่วไป, Gold

Minimap Icons:

• ⭐ Star: ไอเทมสำคัญมาก (Mirror Tier)
• 💎 Diamond: ไอเทมมีค่า (Rare, Unique)
• 🔸 Triangle: เพชรและไอเทมทั่วไป
• 🔹 Square: กุญแจและไอเทมพิเศษ
• ➕ Cross: Gold และไอเทมทั่วไป

👨‍💻 Developer Guide | คู่มือนักพัฒนา

🚀 Quick Start

# Clone the repository
git clone https://github.com/darkzerox/Darkxee-Poe2Filter.git
cd Darkxee-Poe2Filter

# Build filters
cd script
python start_build.py

# Preview in browser (optional)
# เปิดไฟล์ index.html ในเบราว์เซอร์

📋 Prerequisites

• Python 3.6+ (สำหรับ build script)
• Text Editor สำหรับแก้ไข filter files

📂 Project Structure | โครงสร้างโปรเจค

dzx-filter-poe2/
├── 📁 dzx_filter/              # ไฟล์ Filter และ Assets
│   ├── soundeffect/type-01/    # ไฟล์เสียงทั้งหมด (.mp3)
│   ├── fonts/                  # Font files (.ttf)
│   └── images/                 # รูปภาพและโลโก้
├── 📁 script/                  # Build Scripts
│   ├── start_build.py         # สคริปต์หลักสำหรับ build
│   ├── merge_file.py          # รวมไฟล์ filter
│   ├── build_css.py           # สร้าง CSS preview
│   └── build_html.py          # สร้าง HTML preview
├── 📄 dzx-poe2*.filter        # Filter files ที่ build แล้ว
└── 📄 index.html              # Web preview

🛠️ Build Scripts | สคริปต์สำหรับ Build

Script	Function	Usage
start_build.py	Main Build - รวมไฟล์และสร้าง filter ทั้งหมด	python start_build.py
merge_file.py	File Merger - รวมไฟล์ filter modules	Import by other scripts
build_css.py	CSS Generator - สร้าง CSS สำหรับ preview	Import by main script
build_html.py	HTML Generator - สร้างหน้า preview	Import by main script

🔄 Development Workflow

1. แก้ไข Filter: แก้ไขไฟล์ในโฟลเดอร์ dzx_filter/
2. Build Filter: รัน python script/start_build.py
3. ทดสอบ: คัดลอก filter ไฟล์ไปยังโฟลเดอร์เกม
4. Preview: เปิด index.html เพื่อดู preview

🤝 Contributing | การมีส่วนร่วม

เรายินดีรับการมีส่วนร่วมจากทุกคน!

วิธีการมีส่วนร่วม:

1. 🍴 Fork โปรเจคนี้
2. 🌿 Create Branch: git checkout -b feature/amazing-feature
3. ✨ Make Changes: แก้ไขหรือเพิ่มฟีเจอร์
4. 🔨 Build & Test: รัน build script และทดสอบ
5. 📝 Commit: git commit -m 'Add amazing feature'
6. 📤 Push: git push origin feature/amazing-feature
7. 🔄 Pull Request: สร้าง Pull Request

📋 Guidelines

• ใช้ชื่อ branch ที่สื่อความหมาย
• Test filter ก่อนส่ง PR
• เขียน commit message ที่ชัดเจน
• อัพเดต README หากมีการเปลี่ยนแปลงใหญ่

🐛 Issues & Support | การรายงานปัญหา

หากพบปัญหาหรือมีข้อเสนอแนะ:

• 🐛 Bug Reports: Create Issue
• 💡 Feature Requests: Create Issue
• ❓ Questions: Discussions

💡 หมายเหตุ: Filter นี้จะมีการอัพเดตอย่างสม่ำเสมอ กรุณาติดตามการอัพเดตและ Star โปรเจคเพื่อรับการแจ้งเตือน

🔔 Discord Notifications | การแจ้งเตือนผ่าน Discord

โปรเจคนี้มีระบบแจ้งเตือนอัตโนมัติผ่าน Discord เมื่อมีการปล่อยเวอร์ชันใหม่

วิธีตั้งค่า Discord Webhook:

1. สร้าง Webhook ใน Discord:

   • เปิด Discord Server ของคุณ
   • คลิกขวาที่ช่องที่ต้องการรับการแจ้งเตือน
   • เลือก "Server Settings" > "Integrations" > "Webhooks"
   • คลิก "New Webhook"
   • ตั้งชื่อและรูปภาพตามต้องการ
   • คัดลอก Webhook URL

2. เพิ่ม Webhook URL ใน GitHub Secrets:

   • ไปที่ GitHub Repository > "Settings" > "Secrets and variables" > "Actions"
   • คลิก "New repository secret"
   • ตั้งชื่อเป็น DISCORD_WEBHOOK_URL
   • วางค่า Webhook URL ที่คัดลอกมาจาก Discord
   • คลิก "Add secret"

3. เสร็จสิ้น! ทุกครั้งที่มีการปล่อย Release ใหม่ Discord จะได้รับการแจ้งเตือนโดยอัตโนมัติ

🙏 Credits | เครดิต

พิเศษขอบคุณ:

• NeverSink - สำหรับ Original Filter Style และแนวคิด
• Path of Exile 2 Community - สำหรับ feedback และการทดสอบ
• Contributors - ทุกคนที่มีส่วนร่วมในการพัฒนา

🎨 Style ต่างๆ จะใช้ของต้นฉบับจาก NeverSink's เพื่อความสะดวกและคุ้นเคย พร้อมปรับปรุงเพิ่มเติมให้เหมาะสมกับ Path of Exile 2

---

🌟 หากชอบโปรเจคนี้ อย่าลืม Star ให้กำลังใจด้วยนะ! 🌟

_{Made with ❤️ by Darkxee for the Path of Exile 2 Community}