1. 🧪 ขวดยาใหญ่ (High Potion): สามารถให้บอท auto ใช้ได้ตอน HP ต่ำกว่า 30%
2. ⚔️ อาวุธหลักของตัวละคร (Main Weapon)
3. 🛡️ ฮีลหมู่ (Group Heal)
4. 🩹 ฮีลธรรมดา (Single Heal)
5. 🟠 ยาส้ม / หรือยาขาว (Orange/White Potion): บอทสามารถ auto ใช้เองได้ตอน HP ต่ำกว่า 71%
6. 🔮 Orb: เพื่อไว้ใช้ฮีล (ฮีลเดี่ยว/ฮีลหมู่) หรือสลับใช้ Pray เพื่อช่วยหนี
7. ❄️🙏 สกิลแช่แข็ง (Frozen) หรือ Pray: สำหรับใช้หนีในยามวิกฤต (Frozen / Pray Escape)
8. ✨ สกิลรักษา (Cure): ไว้ใช้แก้ตอนที่โดนตาบอด (Blind/Poison)
9. 🪄 คทา (Staff) / 🔮 Orb: ใช้สำหรับสลับอาวุธมาใช้สกิลช่วยหนี (Frozen / Pray Escape)
10. 🗡️ ดาบคู่ (Dual Blades): ใช้สำหรับสลับเพื่อบัฟตัวเอง (Skill Rotation)

1. 🧪 High Potion: Auto-used by bot when HP falls below 30%.
2. ⚔️ Character Main Weapon
3. 🛡️ Group Heal Skill
4. 🩹 Single Heal Skill
5. 🟠 Orange / White Potion: Auto-used by bot when HP falls below 71%.
6. 🔮 Orb Weapon: Equipped to cast healing spells or Pray escape.
7. ❄️🙏 Frozen or Pray Skill: Emergency skill for escapes (Frozen / Pray Escape).
8. ✨ Cure Skill: Used to cure Blind/Poison debuffs.
9. 🪄 Staff / 🔮 Orb Weapon: Swapped to cast emergency escape skills (Frozen / Pray Escape).
10. 🗡️ Dual Blades Weapon: Swapped to cast self-buff skills (Skill Rotation).

• ❤️ HP: ปริมาณเลือดปัจจุบันของตัวละคร
• ⚔️ Fight: สถานะการต่อสู้ (Fighting)
• 🔥 ATK: ระบบตั้งตีสวนกลับอัตโนมัติ
• 💚 HEAL: สถานะการใช้สกิลฮีล (สาย Orb)
• 👤 Feud: ตรวจจับศัตรู/ตาแดงในพื้นที่
• 🗡️ Sword: จำนวนมอนสเตอร์ที่กำลังโจมตีเราอยู่
• ⚙️ MACRO: รายชื่อ Macro ที่กำลังเปิดใช้งานอยู่

• ❤️ HP: Current Character Health Point
• ⚔️ Fight: Combat status (Fighting)
• 🔥 ATK: Auto Counter-attack system
• 💚 HEAL: Auto-heal skill status (Orb class)
• 👤 Feud: Detected enemies/red names in area
• 🗡️ Sword: Count of monsters attacking you
• ⚙️ MACRO: List of currently active macros

General Hotkeys: ปุ่มคีย์ลัดทั่วไปที่เกมกำหนดมาให้ หากใช้ตามค่าเริ่มต้น (Default) ไม่จำเป็นต้องแก้ไขส่วนนี้ครับ

General Hotkeys: Standard game keys. No changes required if you are using the default in-game settings.

🪄 Skill Usage Keys (ปุ่มเรียกใช้ไอเทม/สกิล)

🪄 Skill Usage Keys Mapping

ส่วนควบคุมหลัก (Main Controls)

• ➕ Create New Macro: ปุ่มสำหรับสร้างมาโครใหม่
• ⌨️ F1 / Hotkey: ปุ่มลัดที่ใช้ในการเรียกใช้งานมาโครนั้นๆ
• 🗑️ ลบทิ้ง (Delete): ลบมาโครนี้ออกจากระบบ
• 🔁 Repeat:
  • 0 = วนทำงานทุก Step ไปเรื่อยๆ ไม่สิ้นสุด
  • ตัวเลขอื่นๆ = จำนวนรอบที่ต้องการให้ทำงาน (เช่น 3 คือกดครบทุก Step 3 รอบแล้วหยุด)

• ➕ Create New Macro: Create a new macro entry.
• ⌨️ F1 / Hotkey: The physical key assigned to trigger this macro.
• 🗑️ Delete: Permanently remove this macro.
• 🔁 Repeat:
  • 0 = Infinite loop through all steps.
  • Numbers = Execute the sequence for a specific count (e.g., 3 repeats).

โครงสร้าง Step และคำสั่งพิเศษ

Step Structure & Commands

• 🆔 #1: ลำดับขั้นตอน (Step) การทำงาน
• ⚡ $ คำสั่งพิเศษ: หากระบุชื่อคำสั่งที่มีเครื่องหมาย $ นำหน้า จะเป็นการเรียกใช้ฟังก์ชันของบอทโดยตรง
  • $on_off_bot = สั่งเปิด/ปิดการทำงานหลักของบอท (เช็ค Status แต่ไม่ปิดมาโครอื่น)
  • 📖 คลิกที่นี่เพื่อดูคู่มือและรายชื่อฟังก์ชันมาโครทั้งหมดใน ข้อ 10 (คลังฟังก์ชัน $Functions) →
• ⏱️ Delay (0s): ระยะเวลารอหลังจากจบ Step นี้ (รองรับหน่วย s หรือ ms)
• ❌ X: ลบ Step นี้ทิ้ง | Add Step: เพิ่มขั้นตอนการทำงานใหม่

• 🆔 #1: The execution order (Step number).
• ⚡ $ Commands: Keys starting with $ trigger internal bot functions.
  • $on_off_bot = Toggle main bot logic (Status checking) without stopping other macros.
  • 📖 Click here to explore the complete list of macro functions in Step 10 ($Functions Library) →
• ⏱️ Delay (0s): Wait duration after this step (Use s or ms).
• ❌ X: Remove step | Add Step: Append a new action to the sequence.

💡 แผนภาพอธิบายการทำงานร่วมกับ Macro Studio (เข้าใจง่ายที่สุด)

💡 Conceptual Workflow with Macro Studio

• 🔒 Lock Buttons (ล็อคปุ่ม): แนะนำสำหรับการใช้งานฟาร์มจริง เมื่อเปิดใช้งาน จะซ่อนตัวจับย้าย ⠿ ปุ่มปิด ✖ และปุ่มปรับขนาด ◢ ทั้งหมด เพื่อให้เหลือปุ่มสะอาดตาสวยงาม และป้องกันอุบัติเหตุคลิกไปโดนลากเคลื่อนย้ายปุ่มขณะเล่นเกม
• 🔒 Lock Buttons: Recommended for active farming. When enabled, it hides the drag handle ⠿, close button ✖, and resize grip ◢, keeping the overlay clean and preventing accidental moves during gameplay.
• 🔳 Show Borders (แสดงขอบ): เปิด/ปิดการแสดงเส้นกรอบสะท้อนแสงรอบๆ ปุ่มลอย เพื่อเพิ่มมิติและความโดดเด่น
• 🔳 Show Borders: Toggles neon glowing outlines around the floating buttons.
• 🌓 Opacity (ความโปร่งใส): แถบเลื่อนสำหรับปรับความจาง/เข้มของปุ่มลัดทั้งหมดพร้อมกัน เพื่อไม่ให้บังทัศนวิสัยบนหน้าจอเกม
• 🌓 Opacity: Slider to adjust the overall transparency of all buttons on your screen.
• 🏷️ Show Hotkeys (แสดงคีย์ลัด): แสดงข้อความคีย์ลัดในวงเล็บต่อท้ายชื่อ เช่น Potion On/Off (5)
• 🏷️ Show Hotkeys: Displays target trigger key suffix on buttons, e.g. Potion On/Off (5).
• 🔢 Show Numbers (แสดงลำดับ): แสดงตัวเลขลำดับ [1], [2], [3] นำหน้าชื่อปุ่ม
• 🔢 Show Numbers: Displays button sequence numbers, like [1], [2], [3], in front of button labels.
• 🎨 Theme (เปลี่ยนธีมสี): เมนูเลือกชุดสีปุ่มลอยด่วน มีให้เลือกใช้งานกว่า 10 ธีมสีสไตล์โปรเจกต์ระดับพรีเมียม (เช่น Catppuccin, Cyberpunk, Matrix, Nord)
• 🎨 Theme: Switch between 10 high-quality modern themes (e.g. Catppuccin, Cyberpunk, Matrix, Nord) to match your game style.
• 🔀 ลากสลับลำดับ: ที่รายการมาโครด้านล่าง คุณสามารถกดที่สัญลักษณ์ ☰ ค้างไว้แล้วลากขึ้น-ลง เพื่อจัดเรียงลำดับปุ่มกดบนหน้าจอได้อย่างอิสระ
• 🔀 Reorder List: Press and hold the ☰ grip on any list item to drag and change the visual order of the buttons.
• 🟢 สวิตช์เปิด/ปิด (Visibility Toggle): กดสวิตช์สีเขียว/เทาด้านขวาของแต่ละรายการเพื่อสั่ง แสดง หรือ ซ่อน ปุ่มลอยปุ่มนั้นๆ บนจอเกม
• 🟢 Visibility Toggle: Click the green/grey switch to instantly show or hide that specific button on your screen.
• 🗑️ ลบปุ่ม (Delete Button): กดไอคอนถังขยะสีแดง 🗑 เพื่อลบปุ่มลอยที่ไม่ต้องการออกจากระบบถาวร
• 🗑️ Delete Button: Click the red trash bin icon 🗑 to remove the button permanently.

• 📝 Name (ชื่อปุ่ม): ข้อความที่จะเขียนแสดงอยู่บนปุ่มลอย
• 📝 Name: The label text displayed on the floating button.
• ⌨️ Hotkey (ปุ่มคีย์ลัด): คีย์ลัดแป้นพิมพ์ของคอมพิวเตอร์ที่ต้องการให้ปุ่มนี้กดแทน (เช่น 5, F1, Ctrl+F5) **ต้องสะกดและเขียนให้ตรงกับ Hotkey ของมาโครนั้นๆ ใน Macro Studio**
• ⌨️ Hotkey: The keyboard key simulated and sent to the game window (e.g. 5, F1, Ctrl+F5). **Must match the Hotkey of the macro in Macro Studio**
• 🎨 Button Bg (สีปุ่ม): คลิกปุ่ม Choose เพื่อเลือกสีพื้นหลังปุ่มลอยเฉพาะปุ่มนี้ ทำให้ปุ่มสำคัญโดดเด่นแยกจากปุ่มอื่น (เช่น ยาสีแดง วาร์ปสีฟ้า บัฟสีม่วง)
• 🎨 Button Bg: Set a custom background color for this specific button to differentiate it (e.g. Red for potions, Blue for escape warps).
• 🔤 Button Text (สีข้อความ): คลิก Choose เพื่อเปลี่ยนสีตัวอักษรของปุ่มนี้โดยเฉพาะ เพื่อให้คมชัดอ่านง่าย
• 🔤 Button Text: Customize text label color for this button.
• ⚡ Active Bg (สีขณะปุ่มทำงาน): คลิก Choose เพื่อเลือกสีพื้นหลังปุ่มลอยขณะที่มาโครนั้นกำลังทำงาน/เปิดใช้งานอยู่ (เช่น ปุ่ม F1 ตรวจสอบกับสถานะ Bot ทำงาน, และปุ่มอื่นๆ ตรวจสอบตาม macro_flags ในหน้าบอท) ทำให้คุณเห็นสถานะการทำงานของบอทได้ชัดเจนในหน้าจอเกมทันที
• ⚡ Active Bg: Click Choose to customize the button's background color when that macro is actively running (e.g. F1 checks if the main script is running, and other keys check their respective running flags in macro_flags), providing instant visual feedback on active tasks directly on your screen.
• 🌓 Opacity (ความโปร่งใสพิเศษ): ติ๊กถูกที่ช่อง Override จากนั้นเลื่อนแถบความโปร่งใส เพื่อตั้งค่าความโปร่งใสแยกต่างหากเฉพาะปุ่มนี้คนเดียว (ไม่ใช้ค่าความโปร่งใสร่วมกับส่วนกลาง)
• 🌓 Opacity Override: Check Override to assign a custom transparency level for this button only, independent of the global setting.
• 🔄 Restore Default (ปุ่มคืนค่าเริ่มต้น): ลบสีธรรมดา สีข้อความ สีขณะทำงาน และค่าโปร่งใสพิเศษทั้งหมดที่ตั้งไว้เฉพาะปุ่มนี้ และปรับกลับไปใช้ธีมสีหลักและค่าความโปร่งใสส่วนกลางของระบบทันที
• 🔄 Restore Default: Erase custom background, text colors, active background color, and opacity overrides, returning the button back to the global theme colors.

• 💾 Save (บันทึกโปรไฟล์): คัดลอกปุ่มลอยและพิกัดตำแหน่งทั้งหมดในปัจจุบันไปเก็บไว้ในช่องโปรไฟล์ที่เลือก และอัปโหลดขึ้นคลาวด์ทันที
• 💾 Save: Copy your active layout configuration into the selected profile slot, triggering an instant automatic cloud sync update.
• 📂 Load (โหลดใช้งาน): ดึงข้อมูลปุ่มและตำแหน่งที่เคยบันทึกไว้ในโปรไฟล์นั้นๆ กลับมาแสดงผลแทนที่เลย์เอาต์ปัจจุบันทันที
• 📂 Load: Restore the selected profile's settings, layout coordinates, and active theme to your gameplay screen.
• 🔄 Reset (ล้างค่าโปรไฟล์): ลบข้อมูลโปรไฟล์ดังกล่าวออกจากฐานข้อมูลคลาวด์ เพื่อเคลียร์ช่องให้ว่างพร้อมสำหรับการบันทึกค่าใหม่
• 🔄 Reset (Restore Default): Erase the saved layout settings inside that profile slot, restoring the slot to default (empty) state.

ภาพรวมหน้าจอ Map Editor: ด้านบนคือ Dropdown เลือกแผนที่, ตรงกลางคือ Canvas แผนที่พิกัดจริง, ด้านซ้ายคือแถบควบคุม Farming Spots และ Map Macros

Map Editor Overview: Top map selector, center interactive canvas, and left sidebar controlling Farming Spots and Map Macros.

• เปิดหน้าเว็บ Map Editor (ผ่านเมนู /map_editor หรือคลิกปุ่ม 🗺️ Waypoint Editor จากหน้า Config Editor)
• Open the Map Editor page via /map_editor or click the 🗺️ Waypoint Editor button.
• ที่แถบด้านบน ให้คลิกเลือกแผนที่จาก Dropdown -- Choose a Map -- (เช่น The Last Ground, Fire Dragon, Cruma#4F, Arena, Full Map - Tower of Insolence#1 ฯลฯ)
• At the top bar, pick your desired map from the -- Choose a Map -- dropdown (e.g. The Last Ground, Fire Dragon, Cruma#4F, Arena, etc.).
• ระบบจะแสดงภาพแผนที่จริงของเกมบน Canvas ตรงกลาง พร้อมโหลดจุด Waypoints และพิกัดเริ่มต้นให้ทันที
• The real in-game map will display on the center canvas with default coordinates pre-loaded.

📌 ภาพหน้าจอจริง: เมนู Dropdown "SELECT MAP" สำหรับเลือกแผนที่ที่ต้องการบอท

📌 Real UI Example: "SELECT MAP" dropdown for choosing your target map.

• ที่เมนูด้านซ้าย ให้คลิกแท็บ Farming Spots
• In the left sidebar, click on the Farming Spots tab.
• กำหนดพิกัดจุดยืนฟาร์ม (Target Center): เลื่อนเมาส์ไปคลิกบนภาพแผนที่ตรงตำแหน่งที่คุณต้องการให้ตัวละครยืนตีมอนสเตอร์ จะปรากฏวงกลมมาร์กเกอร์สีม่วงพร้อมพิกัด (x, y)
• Place Coordinates: Click directly on the map where you want the character to hunt; a circular target marker with (x, y) coordinates will appear.
• ปรับขนาดรัศมี (Radius Slider): ปรับแถบเลื่อนรัศมี (ค่าปกติประมาณ 50-70 พิกเซล) เพื่อกำหนดระยะขอบเขตวงกลมว่าให้บอทเดินล่ามอนสเตอร์วนอยู่เฉพาะภายในบริเวณนี้
• Adjust Radius: Use the radius slider (recommended 50-70px) to define the perimeter circle that keeps the bot focused inside this area.
• รองรับหลายจุดฟาร์ม (Multiple Spots): สามารถคลิกปุ่ม + Add Spot เพื่อสร้างจุดฟาร์มเพิ่มเติม เช่น Spot 1, Spot 2 สำหรับวนสลับจุดในแผนที่เดียวกัน
• Multi-Spot Support: Click + Add Spot to create alternate farming positions (e.g. Spot 1, Spot 2) to rotate between locations on the same map.

📌 ภาพหน้าจอจริง: แท็บ "MY FARMING SPOTS" พิกัดจุดยืนฟาร์ม และมาร์กเกอร์จุดฟาร์มบนแผนที่

📌 Real UI Example: "MY FARMING SPOTS" tab with target coordinates and visual map markers.

• ที่เมนูด้านซ้าย ให้สลับไปที่แท็บ Map Macros แล้วกดปุ่ม + New
• In the left sidebar, switch to the Map Macros tab and click the + New button.
• ระบบสร้างโครงสร้างให้อัตโนมัติ (Smart Generation):
  • กำหนด Hotkey เริ่มต้นตรงประเภทแผนที่:
    • แผนที่ดันเจี้ยนพิเศษ (Tower of Insolence, Cruma, Arena, Demonic Island, Harnak) → ใช้ Ctrl+F8
    • แผนที่โลกทั่วไป (The Last Ground, Fire Dragon, Ancient Battleground) → ใช้ Ctrl+Shift+F8
  • สร้าง Step #1 ให้อัตโนมัติ: ใส่คำสั่งเดินทางเข้าแผนที่ที่เหมาะสม (เช่น $go_favorite_map(1) หรือ $go_npc('tp', 1)) พร้อมตั้ง Delay รอโหลดแมพ 5s
  • สร้าง Step #2 ให้อัตโนมัติ: ใส่คำสั่ง $auto_navigate("
• ⚡ ระบบซิงค์ Standard Config ข้อ 4 อัตโนมัติ (New in V2.7.9+):
  เมื่อกดสร้างมาโคร ระบบจะไปปรับค่า Standard Config ข้อ 4 (วิธีเดินทางกลับจุดฟาร์มเมื่ออยู่เมือง) ให้ตรงกับปุ่ม Hotkey ทันที!
  • หากมาโครเป็น Ctrl+F8 → ปรับเป็น ข้อ 2. เดินในหอคอยโอหัง/อารีน่า (Ctrl+F8)
  • หากมาโครเป็น Ctrl+Shift+F8 → ปรับเป็น ข้อ 3. เดินในแผนที่โลก หลังจาก teleport (Ctrl+Shift+F8)
  โดยระบบจะบันทึกค่าและซิงค์ให้แบบอัตโนมัติ 100% เบื้องหลังทันทีเมื่อกด Save หรือเลือกแผนที่ (ไม่จำเป็นต้องกดเลือกเอง)

📌 ภาพหน้าจอจริง: แท็บ "Map Macros" และปุ่ม "+ New" สำหรับสร้างมาโครนำทางชุดใหม่

📌 Real UI Example: "Map Macros" tab with the "+ New" button to add a navigation macro.

• ตรวจสอบ Step #1 (สเต็ปเดินทางเข้าแผนที่):
  • ตรวจสอบ Dropdown ฟังก์ชัน (เช่น go_favorite, go_npc, go_fav_dun, go_floor)
  • ปรับตัวเลขพารามิเตอร์ให้ตรงกับลำดับในเกมของคุณ (เช่น ลำดับช่อง Favorite หรือเลขชั้น)
  • ตรวจสอบช่อง Delay ให้เป็น 5s (หรือเพิ่มเป็น 6s-7s หากเครื่องโหลดเข้าแผนที่ช้า)
• ตรวจสอบ Step #2 (Auto Navigate นำทางเดินไปจุดฟาร์ม):
  • Repeat: จำนวนรอบการทำซ้ำ (ปกติคือ 1)
  • Order Mode:
      🔁 Sequence: เดินไปยังจุดฟาร์มตามลำดับ
      🎲 Random: สุ่มเลือกจุดฟาร์ม
  • Threshold: ค่าความแม่นยำในการเปรียบเทียบภาพมินิแมพ (แนะนำคงค่าไว้ที่ 0.9)
  • Select Spot(s) (Farming Spots): *สำคัญมาก* ตรวจสอบว่ามีเครื่องหมายถูก ☑️ ติ๊กเลือกจุดฟาร์มที่คุณต้องการให้มาโครนี้เดินไป (ต้องติ๊กอย่างน้อย 1 จุด เช่น Default)

📌 ภาพหน้าจอจริง: การตั้งค่า Step #1 (go_favorite), Step #2 (Auto Navigate), และการติ๊กเลือกจุดฟาร์มเป้าหมาย ☑️ Default

📌 Real UI capture: Setting Step #1 (go_favorite), Step #2 (Auto Navigate), and selecting target spot ☑️ Default.

• เมื่อตั้งค่าพิกัดและมาโครเรียบร้อยแล้ว ให้คลิกปุ่ม ☁️ Save to Cloud ที่มุมบนขวา (หรือกดคีย์ลัดตัว S หรือ Ctrl+S บนคีย์บอร์ด)
• Once coordinates and macro steps are set, click ☁️ Save to Cloud on the top right (or press S / Ctrl+S).
• การบันทึกแบบ Lossless Merge: ระบบจะดึง Config ล่าสุดบน Cloud ของคุณมาผสานรวมเข้ากับพิกัดและมาโครใหม่ก่อนส่งบันทึกเสมอ ทำให้การตั้งค่าอื่นๆ ทั้งหมดของบอท (เช่น ค่า HP, สกิลบัฟ, ป้องกันบอส) ปลอดภัย 100% ไม่สูญหาย
• Lossless Merge Protection: The system retrieves your remote config and merges it with your local changes before uploading, ensuring zero setting loss.
• เมื่อบันทึกเสร็จสมบูรณ์ ป้ายสถานะจะเปลี่ยนเป็น Synced (สีเขียว) พร้อมข้อความแจ้งเตือน "✅ บันทึกขึ้น Cloud สำเร็จครบถ้วน!"
• Upon successful upload, the status badge turns Synced (Green) with an alert confirming complete synchronization.
• เปิดโปรแกรมบอทบนคอมพิวเตอร์ของคุณ แล้วกดเริ่มทำงาน บอทจะดึงพิกัดและมาโครล่าสุดจาก Cloud ไปใช้งานได้ทันที
• Launch the bot on your PC; it automatically pulls the latest Cloud waypoints and macros to begin farming immediately.

📌 ภาพหน้าจอจริง: เมนูแท็บ "⚡ Action Zones" ทางด้านซ้าย และการแสดงผลวงกลมขอบเขตเส้นประพร้อมไอคอนสายฟ้า ⚡ [Ctrl+Shift+F7] Zone 1 บน Canvas

📌 Real Map Editor Interface: "⚡ Action Zones" tab on the left panel, and interactive dashed trigger circle ⚡ [Ctrl+Shift+F7] Zone 1 on the canvas.

• Trigger Once per Route (ไม่กดย้ำซ้ำซ้อน): ในระหว่างการเดินนำทาง 1 รอบ เมื่อตัวละครเหยียบเข้าโซนและมาโครถูกสั่งรันแล้ว ระบบจะบันทึกรหัสโซนไว้ใน triggered_nav_zones ทำให้บอทจะไม่สั่งรันมาโครซ้ำอีก แม้ตัวละครจะยังคงเดินอยู่ภายในโซนนั้นจนกว่าจะจบรอบการเดิน
• Trigger Once per Route: During an active navigation session, once a zone fires its macro, its ID is flagged in triggered_nav_zones, preventing redundant multi-casting while character remains within zone boundaries.
• รองรับหลายโซนบนแผนที่เดียวกัน (Multi-Zone Support): สามารถกำหนดได้หลายโซน เช่น โซนที่ 1 กดบัฟเร่งความเร็วที่ปากทางเข้า, โซนที่ 2 กดสกิลหายตัวก่อนเลี้ยวเข้าห้องบอส/จุดฟาร์ม
• Multi-Zone Stacking: Configure multiple distinct triggers across the route (e.g. Zone 1: Speed Buff at entry portal, Zone 2: Stealth skill before entering hostile room).
• Lossless Cloud Sync 100%: ทุกการตั้งค่าในแท็บ Action Zones จะถูกบันทึกเข้าสู่ navigation_macro_zones ใน config.json และซิงค์ขึ้น Cloud อัตโนมัติเมื่อกด ☁️ Save to Cloud ไม่สูญหายแน่นอน
• Lossless Cloud Sync: Zone geometries and inline macro parameters automatically serialize into navigation_macro_zones in config.json upon clicking ☁️ Save to Cloud.

เพื่อให้บอทสามารถล็อกเป้าหมายบอส Zariche ได้อย่างถูกต้อง 100% และไม่หลุดไปตีมอนสเตอร์ทั่วไป จำเป็นต้องตั้งค่าในเกมตามหัวข้อ 9.1 และ 9.2 ด้านล่างนี้อย่างเคร่งครัด

For the bot to accurately lock onto the Zariche boss without straying to standard mobs, you must configure in-game settings strictly as described in sections 9.1 and 9.2 below.

ภาพการตั้งค่า Combat > Targeting > Auto-Hunt Target Priority: เปิดเฉพาะ Priority 1 ส่วนที่เหลือปิดทั้งหมด

Targeting settings: Enable Priority 1 (Scan number) ON, and set all others to OFF.

ภาพการตั้งค่า Combat > Scanning: เปิดเฉพาะ Special Monsters (ติ๊กถูก Boss Monsters) และปิด Players กับ Monsters ทั้งหมด

Scanning filters: Special Monsters ON (Boss Monsters checked only), Players OFF, Monsters OFF.

• ฟังก์ชันไม่มีพารามิเตอร์: เขียนชื่อฟังก์ชันได้โดยตรง เช่น $reload_config หรือ $wait_group_heal_ready()
• Parameterless Functions: Specify directly, e.g. $reload_config or $wait_group_heal_ready()
• ฟังก์ชันที่มีพารามิเตอร์: ใส่ค่าในวงเล็บ คั่นด้วยเครื่องหมายจุลภาค , รองรับตัวเลขจำนวนเต็ม (int), ทศนิยม (float), ค่าจริงเท็จ (boolean), และข้อความ (string) เช่น $check_in_position(8), $wait_own_hp_below(0.70), $go_npc('tp', 1)
• Parameterized Functions: Pass arguments inside parentheses separated by commas, supporting integers, floats, booleans, and strings (e.g. $check_in_position(8), $wait_own_hp_below(0.70), $go_npc('tp', 1)).
• การหน่วงเวลา (Delay): ในแต่ละ Step ยังคงสามารถกำหนดค่า Delay (เช่น 100ms, 500ms, 5s) ได้ตามปกติ โดยบอทจะรันฟังก์ชันให้เสร็จก่อน แล้วจึงหน่วงเวลาตามที่กำหนดก่อนไป Step ถัดไป
• Delay Specification: Each step retains its independent Delay setting (e.g. 100ms, 5s); the bot executes the function and then waits for the specified delay before proceeding.

การทำงานโดยละเอียด: เป็นฟังก์ชันที่ทำหน้าที่เป็น Synchronization Gate (ตัวกั้นจังหวะการเดิน) สำหรับมาโครที่ทำงานร่วมกับระบบนำทาง (Auto Navigate) เช่น ใน Action Zone หรือมาโครหลบหนี ฟังก์ชันนี้จะ บล็อกการทำงานของสเต็ปถัดไปไว้ชั่วคราว เพื่อรอจนกว่าตัวละครจะก้าวเดินไปถึงจุดหมายปลายทาง (Destination Reached หรือจุด Spot Center) จริงๆ ก่อน หรือจนกว่าการนำทางจะเสร็จสิ้น
• หากตัวละครเดินถึงจุดหมายอย่างรวดเร็ว (เช่น ใช้เวลาจริงเพียง 2.5 วินาที) บอทจะออกจากฟังก์ชันและเริ่มรันสเต็ปถัดไปทันทีโดยไม่ต้องรอครบเวลา
• หากติดขัดหรือเดินไม่ถึงภายในเวลาที่กำหนด เมื่อครบเวลา timeout (เช่น 8 หรือ 10 วินาที) บอทจะ Time out และปล่อยให้สเต็ปต่อไปทำงานทันที ป้องกันไม่ให้มาโครค้างตลอดไป

Detailed Mechanism: Operates as an intelligent Synchronization Gate during autonomous navigation. It halts execution of subsequent macro steps until the character physically reaches the designated destination spot (verified via NAV_DESTINATION_REACHED or navigation engine completion).
• If destination is reached early (e.g. 2.5s), it unlocks immediately without waiting for the full timeout.
• If obstructed, upon reaching the specified timeout limit (e.g. 8s or 10s), it safely times out and proceeds to the next step, preventing deadlocks.

🧭 $auto_navigate(map_name, route_name="Default", debug=0.9, order_mode="sequence")

การทำงาน: สั่งให้ระบบ Auto Navigate เริ่มต้นประมวลผลคำนวณเส้นทางเดินและหลบหลีกสิ่งกีดขวางบนแผนที่จริง โดยเปรียบเทียบพิกัดแบบ Dynamic กับมินิแมพเพื่อนำพาตัวละครเดินไปยังจุดฟาร์มที่ระบุ มีระบบตรวจจับคำขอซ้อนเพื่อป้องกันการทำงานซ้ำซ้อน

Functionality: Initiates autonomous pathfinding and obstacle avoidance towards specified farming spots. Uses dynamic minimap template matching with concurrency guards.

⭐ $go_favorite_map(fav_number)

การทำงาน: เปิดแผนที่โลก (World Map คีย์ลัด M) สลับไปที่แท็บรายการโปรด (Favorites รูปดาว) แล้วคลิกเลือกจุดวาร์ปในรายการที่ fav_number เพื่อวาร์ปเข้าสู่แผนที่

Functionality: Opens the World Map (M), switches to the Favorites tab, and executes the teleport for bookmark index fav_number.

📍 $go_warp(warp_index)

การทำงาน: เปิดเมนูจุดวาร์ปประจำแผนที่โลกของแผนที่นั้นๆ แล้วคลิกเทเลพอร์ตไปยังหมายเลขจุดวาร์ปที่ warp_index (เช่น Ancient Battleground)

Functionality: Warps to a designated waypoint slot warp_index from the standard zone teleport list.

🏰 $go_fav_dun(index, target_level=None)

การทำงาน: เปิดเมนูดันเจี้ยน > แท็บ Favorites เลือกช่องดันเจี้ยนลำดับที่ index และคลิกลูกศรเลือกระดับชั้น target_level (เช่น หอคอยครูม่า Cruma#4F, Cruma#5F)

Functionality: Navigates Dungeon Menu → Favorites tab → slot index → selects floor index arrow target_level.

🏢 $go_floor(floor)

การทำงาน: เปิดหน้าต่างเลือกชั้นหอคอยโอหัง (Tower of Insolence) แล้วคลิกเลือกชั้นที่ระบุตามค่า floor

Functionality: Opens the Tower of Insolence scroll floor menu and clicks target floor number floor.

🧑 $go_npc(npc_type, target_index)

การทำงาน: เปิดแถบรายชื่อ NPC ประจำเมือง ค้นหา NPC ตามหมวดหมู่ npc_type ลำดับที่ target_index และสั่งให้ตัวละครวิ่งไปสนทนาเพื่อส่งตัวเข้าสู่แผนที่ (เช่น Arena, Demonic Island, Harnak)

Functionality: Opens town NPC directory, navigates to category npc_type index target_index, and interacts to enter the zone.

🩸 $wait_own_hp_below(threshold=0.95, condition=None)

การทำงาน: รอจนกว่าหลอด HP ของตัวละครเราจะลดต่ำกว่าเกณฑ์ % ที่ระบุ (ยืนยันติดต่อกัน 3 ครั้ง) จึงจะไปยังสเต็ปถัดไป หากระบุ condition จะต้องตรงเงื่อนไขสถานะนั้นด้วย ถ้ายังไม่ตรงเงื่อนไขจะวนรออยู่ที่สเต็ปนี้ จนกว่าเงื่อนไขทั้ง 2 ข้อจะเป็นจริง

Functionality: Blocks until player HP drops below threshold (verified across 3 consecutive checks). If condition is specified, character must ALSO satisfy the condition (e.g. hunting/town/stand); otherwise it will continue holding and waiting at this step.

💚 $wait_own_hp_more_than(threshold=0.95, condition=None)

การทำงาน: รอจนกว่าหลอด HP ของตัวละครเราจะฟื้นฟูกลับขึ้นมามากกว่าเกณฑ์ % ที่กำหนด (ยืนยันติดต่อกัน 3 ครั้ง) จึงจะไปยังสเต็ปถัดไป หากระบุ condition จะต้องตรงเงื่อนไขสถานะนั้นด้วย ถ้ายังไม่ตรงเงื่อนไขจะวนรออยู่ที่สเต็ปนี้ จนกว่าเงื่อนไขทั้ง 2 ข้อจะเป็นจริง

Functionality: Blocks until player HP recovers above threshold (verified across 3 consecutive checks). If condition is specified, character must ALSO satisfy the condition; otherwise it will continue holding and waiting at this step.

👥 $wait_friend_hp_below(threshold=95)

การทำงาน: วนตรวจสอบแถบ HP ของเพื่อนร่วมปาร์ตี้ทุกคน (Party 1, 2, 3) โดยบล็อกรอจนกว่าจะมีเพื่อนคนใดคนหนึ่งมี HP ต่ำกว่าเกณฑ์ % ที่กำหนด

Functionality: Monitors party HP bars (Slots 1-3) and halts until at least one party member's HP drops below threshold.

🤝 $wait_friend_hp_above(threshold=92, timeout=6.0)

การทำงาน: รอจนกว่าเพื่อนทุกคนในปาร์ตี้จะมี HP ฟื้นฟูกลับขึ้นมามากกว่าหรือเท่ากับเกณฑ์ที่กำหนด หรือจนกว่าจะหมดเวลา timeout เพื่อสั่งปิด Group Heal ประหยัด MP

Functionality: Waits until all party members are healed to ≥ threshold or until timeout expires to trigger Group Heal shut-off.

⏳ $wait_group_heal_ready()

การทำงาน: ตรวจสอบสถานะคูลดาวน์ของสกิล Group Heal โดยรอจนกว่าไอคอนสกิลจะสว่างพร้อมใช้งาน จึงปล่อยให้สเต็ปถัดไปกดร่ายสกิล

Functionality: Blocks until the Group Heal skill icon becomes bright and off-cooldown.

🛡️ $wait_safe_icon(threshold=0.5)

การทำงาน: รอจนกว่าตัวละครจะเข้าสู่เขตปลอดภัย (Safe Zone ในเมือง) โดยตรวจจับไอคอนโล่/สัญลักษณ์ Safe Zone บนหน้าจอเกม

Functionality: Waits until the town Safe Zone icon is detected on screen.

⚔️ $wait_until_attacked_hidden()

การทำงาน: บล็อกการทำงานจนกว่าสถานะการถูกโจมตี (ไฟแดงรอบจอ/Combat Aggro) จะหายไปทั้งหมด จึงเริ่มทำสเต็ปถัดไป

Functionality: Halts execution until all combat aggro indicators (red combat borders) completely subside.

🎯 $found_boss(timeout=600)

การทำงาน: บล็อกรอจนกว่าจะพบบอส Zariche ปรากฏตัวออกมา โดยตรวจจับการโผล่ขึ้นมาของ รูปไอคอนถังขยะในแถบ Scan เมื่อพบบอสจะส่งค่า True และปล่อยให้สเต็ปถัดไปทำงานทันที (เช่น สลับอาวุธ หรือเปิดสกิลบัฟพิเศษสู้บอส)

Functionality: Blocks until the Zariche boss spawns, verified by the appearance of the trashcan icon anchor in the scan bar. Returns True and proceeds to the next macro step.

🎉 $not_found_boss(timeout=600)

การทำงาน: บล็อกรอจนกว่าบอส Zariche จะถูกกำจัดและตายลง โดยตรวจจับว่า รูปถังขยะในแถบ Scan หายไปต่อเนื่องเกิน 3 วินาที เมื่อบอสตายจะส่งค่า True และปล่อยให้สเต็ปถัดไปทำงานทันที (เช่น สลับอาวุธกลับ หรือเตรียมเก็บไอเทม)

Functionality: Blocks until the Zariche boss is defeated, verified by the trashcan icon disappearing from the scan bar for over 3 seconds. Returns True and releases subsequent macro steps.

💤 $do_nothing(seconds=None)

การทำงาน: ใช้สำหรับใส่จังหวะพัก (Sleep / Delay) ในขั้นตอนของ Macro โดยไม่ทำอะไรเลย เหมาะสำหรับการสร้างช่องว่างเวลาระหว่างสเต็ป:
• หากระบุ seconds (เช่น $do_nothing(3.5)): ตัวบอทจะหน่วงเวลาหลับตามจำนวนวินาทีที่ระบุ (ตรวจจับคำสั่งหยุดมาโครทุก 100ms เพื่อความปลอดภัย ไม่ค้าง)
• หากไม่ระบุพารามิเตอร์ ($do_nothing() หรือ $do_nothing): จะผ่านฟังก์ชันทันที โดยปล่อยให้เวลาการหน่วงเป็นไปตามค่า Timeout ของสเต็ปมาโครในหน้า GUI ควบคุมเอง

Functionality: Serves as an intentional idle/sleep pause step within macro execution sequences:
• If seconds is specified (e.g. $do_nothing(3.5)): Sleeps for the exact specified duration with high-frequency stop cancellation checks.
• If called with no arguments ($do_nothing()): Immediately returns, delegating duration timing entirely to the macro step's configured Timeout setting in the GUI.

การทำงานโดยละเอียด: สั่งสลับชุดอุปกรณ์/เซ็ตไอเทมในเกม (ช่อง Preset 1, 2 หรือ 3) อัตโนมัติ พร้อมระบบความปลอดภัยและการตรวจสอบเงื่อนไขก่อนสลับ:
1. ตรวจสอบเงื่อนไขพิเศษ (ถ้ามีระบุ): ตรวจสอบว่าตรงกับเงื่อนไขที่กำหนดหรือไม่ (เช่น ต้องอยู่ในเมือง หรือต้องกำลัง Auto Hunt อยู่) หากไม่ตรงเงื่อนไขจะยกเลิกการสลับทันทีเพื่อไม่รบกวนหน้าจอเกม
2. บอทกดเปิดเมนู Preset ในเกม
3. ตรวจสอบขอบปุ่ม Preset ว่าเป็นสีเทาพร้อมกดหรือไม่ (หากกำลังใช้งานอยู่แล้วหรือติดคูลดาวน์ บอทจะข้ามไปกดปิดหน้าต่างทันที ไม่กดย้ำ)
4. ตรวจสอบปุ่มปิดรูป 'X' แล้วคลิกปิดหน้าต่างอย่างสมบูรณ์ รองรับทุก Resolution (FHD/HD) และ HUD Scale (75%/100%)

Detailed Mechanism: Swaps equipment preset sets (Slots 1, 2, or 3) autonomously with condition-based checks and smart button state verification (checks gray border readiness to avoid duplicate clicking) and safely closes the menu via 'X' button recognition across FHD/HD and HUD scales.

การทำงานโดยละเอียด: ควบคุมการตั้งค่าเปิด/ปิดระบบเก็บของขณะล่า (Loot while hunting) อัตโนมัติ โดยมีขั้นตอนตรวจสอบความแม่นยำสูง 6 ขั้นตอน:
1. เปิดเมนูหลัก: กดปุ่ม Open Menu (ค่าเริ่มต้น: ') และรอจนกระทั่งสไลด์เมนูปรากฏขึ้นทางขวา
2. กดปุ่มตั้งค่า (Settings Gear): คำนวณพิกัดและตรวจจับไอคอนฟันเฟืองด้านล่างสุดของสไลด์เมนู (รองรับทั้ง FHD 1080p, HD 900p, HUD 75% และ HUD 100%)
3. เลือกแท็บที่ 2: คลิกแท็บที่ 2 นับจากด้านบนสุดของแถบซ้าย โดยทำงานแบบอิสระจากภาษาในเกม (Language-independent ไม่ดูข้อความภาษาอังกฤษ)
4. ตรวจจับตำแหน่ง Looting (i): ค้นหาข้อความ/ไอคอนข้อมูล loot while hunting (i) ทางด้านขวาเพื่อระบุแถวการตั้งค่าอย่างแม่นยำ
5. ตรวจสอบสถานะและคลิกปุ่ม: ตรวจสอบความสว่างของปุ่ม (Active vs Inactive) หากต้องการ $loot_on ให้เลือก [ ON ] หากต้องการ $loot_off ให้เลือก [ OFF ] (หากตรงกับสถานะเป้าหมายอยู่แล้วจะไม่กดซ้ำ)
6. ปิดหน้าต่างตั้งค่า: กดปุ่ม Esc เพื่อปิดเมนู หากปิดไม่สำเร็จ จะคลิกที่ปุ่มลูกศรชี้ขวา ->] ที่มุมขวาบนของหน้าจอ
🛡️ ระบบ Retry: ทุกสเต็ปมีระบบตรวจสอบสถานะความสำเร็จ หากยังไม่สำเร็จจะทำการลองใหม่ (Retry) ต่อเนื่อง 10 วินาที โดยกดซ้ำวินาทีละ 1 ครั้ง

Detailed Mechanism: Toggles in-game "Loot while hunting" ON or OFF with a robust 6-step verified UI flow:
1. Open Menu: Presses open menu key (') and verifies slide-out panel appearance.
2. Click Settings: Locates and clicks the gear icon at the bottom of the slide menu across FHD/HD and 75%/100% HUD scales.
3. Select Tab 2: Selects the 2nd tab from the top on the left sidebar (strictly language-independent).
4. Locate Looting Info: Anchors to the loot while hunting (i) setting row.
5. Verify & Toggle: Measures button brightness states; clicks [ ON ] for $loot_on or [ OFF ] for $loot_off with state verification.
6. Safely Exit: Closes settings via Esc key or right-pointing arrow exit button (->]).
🛡️ 10s Retry Guard: Every step includes an automated 10-second retry loop with 1-second intervals if transitions fail.

การทำงานโดยละเอียด: ฟังก์ชันรับประกันสถานะ Auto Hunt แบบ Idempotent โดยตรวจจับสถานะจริงของปุ่ม Auto Hunt บนหน้าจอก่อนกดเสมอ:
• ตรวจสอบสีของปุ่ม Auto Hunt (สีเขียว/สีแดง = กำลังเปิด ON, สีเทา = ปิดอยู่ OFF)
• หากสถานะตรงตามที่ต้องการอยู่แล้ว: จะคืนค่าทันที (0ms delay) โดยไม่มีการกดปุ่มซ้ำ เพื่อไม่ให้เกิดปัญหากดเปิดแล้วกลับกลายเป็นปิด
• หากสถานะไม่ตรงตามเป้าหมาย: จะกดปุ่ม Auto Hunt (ค่าเริ่มต้น: C) 1 ครั้ง แล้วรอตรวจสอบสีปุ่มซ้ำ หากยังไม่เปลี่ยนสถานะ จะทำการ Retry ซ้ำสูงสุดตามจำนวน max_retries (ค่าเริ่มต้น 3 ครั้ง)
• รองรับ Alias คำสะกดเดิม: $en_sure_auto_hunt_off() และ $en_sure_auto_hunt_on()

Detailed Mechanism: Idempotently enforces Auto Hunt ON or OFF by inspecting live button color (green/red = active ON, gray = inactive OFF):
• If already in the target state, immediately returns (0ms) without redundant keypresses.
• If state differs, presses keys.auto_hunt (default C) and verifies state transition with up to max_retries (default 3).
• Backwards compatible aliases: $en_sure_auto_hunt_off() and $en_sure_auto_hunt_on().