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.
This commit is contained in:
Sutthisan Thongprasop
2026-05-08 15:04:58 +07:00
committed by GitHub
parent ce35cb3187
commit 0219c6e720

283
README.md
View File

@@ -1 +1,282 @@
# level-economy
# 📊 ระบบเลเวล / เศรษฐกิจ — คู่มือผู้เล่น
> คู่มือสำหรับผู้เล่น 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 | ความหายาก | ราคาขายโดยประมาณ |
|---|---|---|
| ⚪ ทั่วไป | สูง | 518 เหรียญ |
| 🔵 หายาก | ปานกลาง | 2540 เหรียญ |
| 🟣 Epic | ต่ำ | 80100 เหรียญ |
| 🟡 ตำนาน | ต่ำมาก | 250300 เหรียญ |
> ของยิ่งหายาก ยิ่งโผล่น้อย — เก็บไว้ขายตอนเลเวลสูงคุ้มกว่า (โบนัสขาย)
---
## 🔧 เครื่องมือ (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%**
- **สำเร็จ** → ได้ 515% ของเหรียญเป้าหมาย
- **ล้มเหลว** → คุณเสีย 510% ของเหรียญตัวเอง
### โล่กัน
- ขโมยเสร็จ → เป้าหมายได้ **โล่กัน 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)