From 0219c6e7206de5f15f480cbeb7be2712f76ecf4a Mon Sep 17 00:00:00 2001
From: Sutthisan Thongprasop <103308315+somboytiger@users.noreply.github.com>
Date: Fri, 8 May 2026 15:04:58 +0700
Subject: [PATCH] Revise README for player guide on leveling system

Updated README to provide detailed player guide for the leveling and economy system, including mechanics, jobs, tools, and FAQs.
---
 README.md | 283 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 282 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c1e9410..41d3a4e 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,282 @@
-# level-economy
\ No newline at end of file
+# 📊 ระบบเลเวล / เศรษฐกิจ — คู่มือผู้เล่น
+
+> คู่มือสำหรับผู้เล่น SaLee — อธิบายทุกระบบที่เกี่ยวกับ XP, เหรียญ, อาชีพ, การ์ด, ของตกแต่ง (มีปรับเปลี่ยนในอนาคต)
+
+---
+
+## 🌍 สิ่งที่ควรรู้ก่อนเริ่ม
+
+- **ระบบเป็น Global** — เลเวล, เหรียญ, ของในกระเป๋า ใช้ร่วมกันทุกเซิร์ฟเวอร์ที่มีบอท ไม่ได้แยกต่อ server
+- **ไม่ได้ XP จากแชท/พูด** — ต้องใช้คำสั่ง `/level work`, `/level daily`, `/level gamble`, `/level rob` เท่านั้น
+- **เลเวลสูงสุด** — Lv.100
+
+---
+
+## 💪 พลังงาน (Stamina)
+
+แต้มจำกัดสำหรับใช้คำสั่งแบบใช้แรง — กันคนเล่นทั้งวัน
+
+### พื้นฐาน
+- เริ่มต้น **5 แต้ม** ที่ Lv.0
+- เพิ่ม **+1 แต้ม ทุก ๆ 10 เลเวล** → Lv.100 = 15 แต้มสูงสุด
+- ฟื้นฟู **1 แต้ม ทุก 10 นาที**
+- ซื้อเพิ่มได้ในราคา **50 เหรียญ / 1 แต้ม** (ใช้คำสั่ง `/level stamina`)
+
+### ค่าใช้จ่ายต่อคำสั่ง
+
+| คำสั่ง | เสีย stamina |
+|---|---|
+| `/level work` | 2 |
+| `/level gamble *` | 1 |
+| `/level rob` | 3 |
+
+---
+
+## 🎯 อาชีพ (Job)
+
+ต้องเลือกอาชีพก่อนถึงจะ `/level work` ได้
+
+### อาชีพทั้งหมด
+
+| อาชีพ | กิจกรรม | ของที่ได้ |
+|---|---|---|
+| 🎣 นักตกปลา | ตกปลา | ปลาคาร์ป, ปลาทูน่า, ปลาหมึก, ฉลาม, โลมาทอง |
+| ⛏️ นักขุดเหมือง | ขุดเหมือง | หิน, เหล็ก, ทอง, เพชร, มรกต |
+| 🏹 นักล่าสัตว์ | ล่าสัตว์ | กระต่าย, กวาง, หมูป่า, หมี, มังกร |
+| 🪓 คนตัดไม้ | ตัดไม้ | ไม้โอ๊ค, ไม้สน, ไม้เชอร์รี่, ไม้มะเกลือ, ต้นไม้โลก |
+| 🌾 เกษตรกร | ทำไร่ | ข้าวสาลี, ข้าวโพด, แครอท, สตรอเบอร์รี่, แอปเปิลทอง |
+
+### กฎการเปลี่ยนอาชีพ
+- **ครั้งแรก ฟรี** — เลือกได้ครั้งเดียวจากที่ไม่มีอาชีพ
+- **เปลี่ยนครั้งต่อไป เสีย 500 เหรียญ**
+- ใช้คำสั่ง `/level job change` หรือ `/level job list` ดูทั้งหมด
+
+---
+
+## 🛠️ ทำงาน (Work)
+
+หา XP + เหรียญ + ของจากการทำงานตามอาชีพ
+
+### กลไก
+- คูลดาวน์เริ่มต้น **30 นาที** ต่อครั้ง (ลดลงตามเลเวล — ดูหัวข้อ "โบนัสตามเลเวล")
+- เสีย **2 stamina**
+- ได้ **XP, เหรียญ, ของ** ตาม rarity ที่สุ่มได้
+
+### ของที่ได้
+
+| Rarity | ความหายาก | ราคาขายโดยประมาณ |
+|---|---|---|
+| ⚪ ทั่วไป | สูง | 5–18 เหรียญ |
+| 🔵 หายาก | ปานกลาง | 25–40 เหรียญ |
+| 🟣 Epic | ต่ำ | 80–100 เหรียญ |
+| 🟡 ตำนาน | ต่ำมาก | 250–300 เหรียญ |
+
+> ของยิ่งหายาก ยิ่งโผล่น้อย — เก็บไว้ขายตอนเลเวลสูงคุ้มกว่า (โบนัสขาย)
+
+---
+
+## 🔧 เครื่องมือ (Tools)
+
+ซื้อเครื่องมือเพื่อเพิ่มโอกาสได้ของหายากตอน `/level work`
+
+| Tier | ปลดล็อก | ราคา | โบนัสของหายาก |
+|---|---|---|---|
+| ✋ เครื่องมือเริ่มต้น | Lv.1 | ฟรี | ปกติ (1.0×) |
+| 🟫 เครื่องมือไม้ | Lv.5 | 500 | +20% (1.2×) |
+| ⚙️ เครื่องมือเหล็ก | Lv.15 | 5,000 | +50% (1.5×) |
+| 🟡 เครื่องมือทอง | Lv.30 | 25,000 | +100% (2.0×) |
+| 💎 เครื่องมือเพชร | Lv.60 | 100,000 | +200% (3.0×) |
+
+### วิธีใช้
+1. `/economy tools shop` — ดูเครื่องมือของอาชีพปัจจุบัน
+2. `/economy tools buy tier:<...>` — ซื้อ
+3. ใช้ทำงานต่อได้เลย — โบนัสจะมีผลทันทีตอน `/level work`
+
+> เครื่องมือผูกกับอาชีพ — เปลี่ยนอาชีพ ของเก่าจะไม่ใช้งาน ต้องซื้อใหม่
+
+---
+
+## 📈 โบนัสตามเลเวล
+
+ยิ่งเลเวลสูง ยิ่งได้เปรียบ:
+
+### คูลดาวน์ Work ลดลง
+- ลด **1% ต่อ 5 เลเวล** (สูงสุด 50%)
+- Lv.5 → ลด 1% (เหลือ ~29:42 นาที)
+- Lv.50 → ลด 10% (เหลือ ~27 นาที)
+- Lv.100 → ลด 20% (เหลือ **24 นาที**)
+
+### ขายของได้แพงขึ้น
+- โบนัส **+5% ต่อ 10 เลเวล**
+- Lv.50 → +25%
+- Lv.100 → **+50%** จากราคาปกติ
+
+### Stamina เพิ่มขึ้น
+- +1 แต้มต่อ 10 เลเวล (เริ่ม 5 → จบ 15)
+
+---
+
+## 🎁 รางวัลรายวัน (Daily)
+
+`/level daily` — รับเหรียญทุก 24 ชม.
+
+| สเตรค | เหรียญที่ได้ |
+|---|---|
+| วันที่ 1 | 50 |
+| วันที่ 2 | 60 |
+| วันที่ 3 | 70 |
+| วันที่ 4 | 80 |
+| วันที่ 5 | 90 |
+| วันที่ 6 | 100 |
+| **วันที่ 7+** | **120** (สูงสุด) |
+
+> หยุดเก็บเกิน 24 ชม. → สเตรครีเซ็ตกลับเป็น 1
+
+---
+
+## 🎰 เสี่ยงโชค (Gamble)
+
+ใช้ `/level gamble` เสี่ยง 3 รูปแบบ:
+
+| เกม | จ่าย | คูลดาวน์ | Stamina | XP/รอบ |
+|---|---|---|---|---|
+| 🪙 **โยนเหรียญ** (coinflip) | 2× | 30 วิ | 1 | +5 |
+| 🎲 **ทอยเต๋า** (dice) | 6× | 60 วิ | 1 | +5 |
+| 🎰 **สล็อต** (slot) | 2× / 10× / 20× | 90 วิ | 1 | +5 |
+
+### กติกา
+- **Bet ขั้นต่ำ:** 10 เหรียญ
+- **Bet สูงสุด:** 5,000 เหรียญ
+- เสียทั้งหมดถ้าผิด ได้คูณตัวเลขถ้าถูก
+- ทุกการเล่น (แพ้/ชนะ) ได้ XP +5
+
+---
+
+## 💰 ขโมย (Rob)
+
+`/level rob user:<...>` — ขโมยเหรียญจากคนอื่น
+
+### ข้อจำกัด
+- ผู้ขโมย **ต้อง Lv.5 ขึ้นไป** + เป้าหมาย **ต้อง Lv.5 ขึ้นไป**
+- เป้าหมายต้องมีเหรียญ **อย่างน้อย 100 เหรียญ**
+- คูลดาวน์ **2 ชม.** ต่อครั้ง
+- เสีย **3 stamina**
+
+### ผลลัพธ์
+- โอกาสสำเร็จพื้นฐาน **50%**
+- **สำเร็จ** → ได้ 5–15% ของเหรียญเป้าหมาย
+- **ล้มเหลว** → คุณเสีย 5–10% ของเหรียญตัวเอง
+
+### โล่กัน
+- ขโมยเสร็จ → เป้าหมายได้ **โล่กัน 6 ชม.** ห้ามโดน rob ซ้ำ
+- มีโอกาส **60%** ที่เป้าหมายจะได้รับ DM แจ้งเตือนว่าโดนขโมย
+
+---
+
+## 🛒 ร้านค้า (Shop)
+
+`/economy shop` — ดูสินค้าทั้งหมด
+
+ร้านค้าเป็น **global เหมือนกันทุกเซิร์ฟเวอร์** — สินค้าจัดการโดยทีมพัฒนา ของจะเพิ่มเรื่อย ๆ
+
+### ประเภทสินค้า
+
+#### 🎴 ซองการ์ด (Card Pack)
+สุ่มได้การ์ดสะสมตาม rarity ที่ระบุไว้บนซอง — มี 3 ระดับ:
+- **ซองธรรมดา** — โอกาสได้ rare ขึ้นไปต่ำ
+- **ซองหายาก** — โอกาสได้ epic ขึ้นไปสูง
+- **ซอง Epic** — โอกาสได้ legendary สูงสุด
+
+#### 🎨 ของตกแต่งโปรไฟล์ (Cosmetic)
+3 ประเภท:
+- **🖼️ พื้นหลัง** — ภาพใหญ่ในโปรไฟล์
+- **🖼️ กรอบ** — กรอบรอบรูปใน profile
+- **🏅 ตรา** — emoji ใต้ชื่อใน profile
+
+ซื้อแล้วต้องใช้คำสั่ง `/economy equip set` เพื่อ "ใส่"
+ใส่ `id:none` เพื่อถอด
+
+---
+
+## 🎒 กระเป๋า (Inventory)
+
+| คำสั่ง | ทำอะไร |
+|---|---|
+| `/economy inventory` | ดูของในกระเป๋า + มูลค่ารวม |
+| `/economy sell item:<key>` | ขายของชิ้นเดียว |
+| `/economy sell item:<key> amount:<...>` | ขายเป็นจำนวน |
+| `/economy sell all:true` | ขายทั้งหมดในกระเป๋า |
+
+### ราคาขาย
+- ราคาฐานตามที่กำหนด (เช่น ปลาคาร์ป 8 เหรียญ, มังกร 300 เหรียญ)
+- คูณด้วย **โบนัสตามเลเวล** (สูงสุด +50% ที่ Lv.100)
+
+---
+
+## 🎴 การ์ดสะสม (Cards)
+
+`/economy cards` — ดูการ์ดที่มีทั้งหมด จัดกลุ่มตาม rarity
+
+- ได้จากการ **เปิดซอง** ในร้านค้าเท่านั้น
+- ไม่สามารถขายได้ — เป็นของสะสม
+- ใช้แสดงใน `/level profile`
+
+---
+
+## 👤 โปรไฟล์ (Profile)
+
+`/level profile [user]` — ดูโปรไฟล์ของตัวเองหรือคนอื่น
+
+แสดง:
+- **เลเวล + แถบ XP**
+- **เหรียญ**
+- **อาชีพ + เครื่องมือ**
+- **Stamina**
+- **Daily streak**
+- **การ์ดสะสม**
+- **ของตกแต่งที่ใส่อยู่** (พื้นหลัง / กรอบ / ตรา)
+
+ดูบนเว็บได้ด้วย: `https://salee.oreshi.com/profile/<user_id>`
+
+---
+
+## 🏆 อันดับ (Leaderboard)
+
+`/level leaderboard` — Top 10 global
+
+เลือกได้ 2 หมวด:
+- `by:level` — เรียงตามเลเวล
+- `by:coin` — เรียงตามเหรียญ
+
+ดู Top 50 ได้บนเว็บ: `https://salee.oreshi.com/leaderboard`
+
+---
+
+## 💡 เคล็ดลับ
+
+- **โฟกัสทำงาน + เก็บเดลี่** ให้ครบทุกวัน — XP/เหรียญรายได้สม่ำเสมอที่สุด
+- **เก็บเงินซื้อเครื่องมือเหล็ก (Lv.15)** ก่อน — โบนัสของหายาก +50% ทำให้ทำงานคุ้มขึ้นมาก
+- **อย่าใช้ stamina หมด** — ใช้ทำ work ดีกว่า gamble ในระยะยาว (work ได้ของขายต่อด้วย)
+- **gamble ใช้ทุน** — ถ้าแพ้ติดกัน หยุดก่อน เสียเปล่าเปลือง
+- **rob ต้องเลือกเป้า** — เป้าที่ active บ่อย ๆ จะมีโล่กันตลอด ลองคนที่ไม่ค่อยเข้า
+- **เก็บการ์ดตำนาน** — เป็น flex ใน profile ที่หาไม่ได้ง่าย ๆ
+- **ของตกแต่ง Epic+** — ใส่แล้ว profile ดูแตกต่างจากคนอื่นชัด
+
+---
+
+## ❓ คำถามที่พบบ่อย
+
+**Q: เลเวลและเหรียญหายไหมถ้าออกจากเซิร์ฟเวอร์?**
+A: ไม่หาย — ระบบเป็น global ผูกกับ Discord ID ของคุณ
+
+**Q: ทำไมแชทแล้วไม่ได้ XP?**
+A: ระบบนี้ออกแบบให้หา XP จาก action โดยตรงเท่านั้น (work, gamble, daily, rob) — กัน spam แชท
+
+**Q: เครื่องมือทำงานยังไง?**
+A: ผูกกับอาชีพปัจจุบัน — ถ้าเปลี่ยนอาชีพแล้วซื้อใหม่ ของเก่าจะไม่ใช้งาน
+
+**Q: ขโมยล้มเหลวบ่อยมาก ทำไม?**
+A: โอกาสพื้นฐาน 50% — เป็น 50/50 ต้องยอมรับความเสี่ยง ใช้กับเป้าที่มีเงินเยอะ ๆ จะคุ้มกว่า
+
+**Q: บอทเปลี่ยนค่าได้ไหม?**
+A: ทีมพัฒนาอาจปรับสมดุลในอนาคต — ติดตามใน [เว็บ docs](https://salee.oreshi.com/docs)