X3D Fortune (หมอดู)

หมอดูฟรีสำหรับ ESX: ดวงรายวัน ราศีจากวันเกิด เซียมซี 28 ใบ ไพ่ยิปซี 22 ใบ 9 หัวข้อ และดวงรายเดือนเปิดไพ่ 10 ใบ

การติดตั้ง

วางโฟลเดอร์ x3d_fortune ไว้ใน resources/ ห้ามเปลี่ยนชื่อโฟลเดอร์
เพิ่มใน server.cfg (ไม่ต้องรัน SQL):

ensure es_extended
ensure x3d_fortune

ต้องมี

resource	จำเป็นไหม	ใช้ทำอะไร
`es_extended`	จำเป็น	ESX Legacy (1.9+ ถ้าใช้ `Config.BirthStorage = 'meta'`)

ตั้งค่าทั้งหมด: `config/config.lua`

ราคา

ค่า	ค่าเริ่มต้น	ความหมาย
`Config.Account`	`'money'`	หักเงินจากบัญชีไหน: `'money'` เงินสด หรือ `'bank'`
`Config.SiamsiPrice`	`200`	เซียมซีต่อครั้ง
`Config.TarotPrice`	`500`	ไพ่ยิปซี 1 ใบ
`Config.TarotMonthPrice`	`1500`	ดวงรายเดือน 10 ใบ
`Config.TarotReversedChance`	`3`	โอกาสไพ่กลับหัว 1 ใน N

ดวงรายวันและราศีฟรีเสมอ

ทั่วไป

ค่า	ค่าเริ่มต้น	ความหมาย
`Config.Locale`	`'th'`	ภาษาหน้าต่าง `'th'` หรือ `'en'` (คำทำนายเป็นภาษาไทย)
`Config.RateWindow` / `Config.RateMax`	`10000` / `10`	กดได้ไม่เกิน N ครั้งต่อช่วงเวลา (มิลลิวินาที)
`Config.NearRadius`	`30.0`	อยู่ห่างหมอดูไม่เกินเท่านี้ เซิร์ฟเวอร์ถึงยอมให้ดูดวง
`Config.BirthStorage`	`'meta'`	เก็บวันเกิดใน `xPlayer.setMeta` หรือ `'kvp'` สำหรับ ESX รุ่นเก่า

หมอดู: `Config.NPC`

ค่า	ค่าเริ่มต้น	ความหมาย
`coords`	Rockford Hills	ตำแหน่งและทิศ (`vector4`)
`model`	`'a_f_o_ktown_01'`	โมเดล ped
`scenario`	`'PROP_HUMAN_SEAT_CHAIR'`	ท่าทาง (ต้องมีเก้าอี้ หรือเปลี่ยนเป็นท่ายืน)
`streamDistance`	`50.0`	ระยะที่ NPC โผล่
`interactDistance`	`2.5`	ระยะกด [E]
`blip`	เปิด	`sprite`, `color`, `scale`, `name = { th, en }`
`speech`	เปิด	เสียงทักทายตอนเข้าใกล้

ปรับให้เข้ากับเซิร์ฟ: `addons/`

ไฟล์	ฟังก์ชัน	ค่าเริ่มต้น
`addons/notify/client.lua`	`Notify(message, kind)`	esx_notify, ox_lib, ESX ตามลำดับ
`addons/prompt/client.lua`	`Prompt.Draw3D`, `Prompt.SetBlipName`, `Prompt.IsInteractPressed`	ป้าย 3D, [E]
`addons/locale/shared.lua`	`T(th, en)`	ตาม `Config.Locale`

สำหรับสคริปต์อื่น

-- client
exports['x3d_fortune']:Open()      -- เปิดหน้าหมอดู เช่นจาก ox_target (เซิร์ฟเวอร์ยังเช็คระยะ)
exports['x3d_fortune']:Close()
exports['x3d_fortune']:IsOpen()    --> boolean

คำสั่งคอนโซลเซิร์ฟเวอร์ fortune_selftest ตรวจข้อมูลคำทำนายทั้งหมด

ปัญหาที่พบบ่อย

อาการ	สาเหตุ / วิธีแก้
ขึ้น "ต้องอยู่กับหมอดู"	ย้ายหมอดูแล้วแต่ยืนไกลเกิน `Config.NearRadius`
ใส่วันเกิดแล้วไม่จำ	ESX รุ่นเก่าไม่มี `setMeta` ให้ตั้ง `Config.BirthStorage = 'kvp'`
NPC ยืนลอย / นั่งกลางอากาศ	`scenario` เป็นท่านั่ง ต้องวางตรงเก้าอี้ หรือเปลี่ยนเป็น `'WORLD_HUMAN_STAND_IMPATIENT'`
ภาษาไทยบนป้ายเป็นกล่อง	ต้องมี resource ที่สตรีมฟอนต์ `font4thai`