00_setup.lua — เริ่มตรงนี้#
Config.General = {
Debug = false,
Locale = 'th',
Jobs = { OnDuty = 'police', OffDuty = 'offpolice' },
AdminGroups = { admin = true, superadmin = true, dev = true }
}
Config.Features = {
Overview = true,
Dispatch = true,
Search = true,
Cases = true,
Jail = true,
Statistics = true
}General ที่ตั้งได้#
| ค่า | ตั้งอะไร | ผลลัพธ์ |
|---|---|---|
Debug | เปิดข้อมูลช่วยตรวจปัญหา | ใช้ตอน DEV/Support; Production แนะนำ false |
Locale | ภาษาของ resource | ข้อความจะใช้ Locale ที่มีใน config/locales/ |
Jobs.OnDuty / OffDuty | ชื่อ ESX Job ตอนเข้าเวรและออกเวร | สถานะตำรวจและเงื่อนไข On-duty/Off-duty จะอิงชื่อนี้ |
AdminGroups | ESX group ที่เป็น Admin ของ nX Police | ใช้กับ POLICE+, Admin Economy, Statistics Reset และส่วน Admin ที่คู่มือระบุ |
Features — เปิด/ปิดระบบ#
Feature เป็นสวิตช์หลักของระบบและหน้าที่เกี่ยวข้อง ให้เปิดเฉพาะส่วนที่เซิร์ฟเวอร์ใช้งานจริง
| กลุ่ม | Feature | ผลเมื่อเปิด |
|---|---|---|
| ภาคสนาม | Overview, Dispatch, Search, QuickMenu, Countdown, Curfew, Squad, HelicopterCamera | เปิด Dashboard, แจ้งเหตุ, ค้นตัว, เมนูด่วน, Countdown, Curfew, Squad และกล้องเฮลิคอปเตอร์ตามลำดับ |
| คดี/คุก | Cases, Jail, JailCard, JailEscape, JailAnnouncement, CaseScreenshot | เปิดแฟ้มคดี, คุมขัง, บัตรลดเวลา, ระบบหลบหนี, ประกาศคุก และรูปคดี |
| จัดการ | Management, Personnel, Ranks, Charges, JailLocations, EquipmentManagement | เปิดหน้าจัดการ บุคลากร ยศ ข้อหา สถานที่คุมขัง และการจัดการอุปกรณ์ |
| การเงิน | Bank, Paycheck, Safe, AgencyShop, OnlineRewards | เปิดธนาคาร เงินเดือน ตู้หน่วยงาน ร้านค้า และรางวัลตามเวลาเข้าเวร |
| เสริม | Playpass, Statistics | เปิด Playpass integration และ Statistics/Ranking |
config/customer — Gameplay / Policy#
| ไฟล์ | ใช้ตั้งค่า |
|---|---|
00_setup.lua | General / Features |
01_police.lua | Duty / Search / Cuff / Quick Menu / Countdown |
02_dispatch.lua | Dispatch / Curfew / Squad / Helicopter Camera |
03_cases_jail.lua | Case policy / Jail / Escape / Jail Card / Screenshot |
04_management.lua | Mailbox / Rank Permissions / Equipment Management |
05_economy.lua | Bank / Welfare / Paycheck / Safe / Shop policy / Reward policy |
06_services.lua | Reports / Announcements / Playpass / Statistics |
07_ui.lua | Notification / UI |
08_integrations.lua | Advanced Integrations |
Config.Cuff — กุญแจมือ / Item ปลด#
Config.Cuff = {
AutoUncuffOnDeath = true,
Whitelist = {
0, 1, 2, 20, 30, 31, 32, 33, 34, 35, 249,
-- 'F6',
-- 'T',
-- 'ALT+K',
},
UnlockItem = {
Enabled = false,
Item = 'handcuff_key',
Amount = 1,
ConsumeOnUse = false,
AllowSelfUse = true,
RequireForPoliceUncuff = false
}
}| ค่า | ความหมาย |
|---|---|
AutoUncuffOnDeath | true = เมื่อตายระบบปลดกุญแจมืออัตโนมัติ; false = ตายแล้วยังคงสถานะกุญแจมือ |
Whitelist | รายการปุ่มที่ยังกดได้ตอนถูกล็อคมือ: ใส่ FiveM Control ID เป็นตัวเลข หรือ Key Mapping เช่น F6/T/ALT+K เป็นข้อความในรายการเดียวกัน; UI ที่เชื่อมกับปุ่มนั้นสามารถใช้สิทธิ์จากปุ่มเดียวกันได้ |
UnlockItem.Enabled | เปิด/ปิดไอเทมปลดกุญแจมือ |
Item / Amount | ชื่อและจำนวน item ที่ต้องมี |
ConsumeOnUse | true = ใช้สำเร็จแล้วหักของ; false = ต้องมีของแต่ไม่หัก |
AllowSelfUse | อนุญาตผู้ที่กำลังถูก cuff ใช้ item ปลดตัวเอง |
RequireForPoliceUncuff | ถ้า true ตำรวจต้องมี Unlock Item ก่อนใช้คำสั่งถอดกุญแจมือ |
ค่าเริ่มต้น UnlockItem.Enabled=false และ RequireForPoliceUncuff=false จึงไม่เปลี่ยนการถอดกุญแจมือเดิมจนกว่าจะเปิดเอง
GPS Cutter — ConsumeOnUse#
Config.Jail.Escape.GpsCutter = {
Enabled = true,
Item = 'gps_cutter',
Amount = 1,
ConsumeOnUse = true
}ConsumeOnUse=true = ใช้ GPS Cutter สำเร็จแล้วหัก item ส่วน false = ต้องมี item ตามจำนวนที่กำหนดแต่ใช้แล้วไม่หัก
config/data — รายการที่แก้บ่อย#
Field หลักของไฟล์ Data#
| ไฟล์ | ตั้งอะไรได้ | ผลลัพธ์ |
|---|---|---|
ranks.lua | grade, name, label, salary, permission | กำหนดยศ ชื่อที่แสดง เงินเดือน และชุดสิทธิ์ของแต่ละยศ |
charges.lua | หมวดสี/คดีแดง และข้อหา fine, jail, ตัวคูณ, เพดาน, evidenceItems, jailLocation | กำหนดค่าปรับ เวลาเจล Auto Charge และสถานที่คุมขังเริ่มต้นของข้อหา |
jail_locations.lua | key, name, coords, death, exit, radius, isDefault | กำหนดพื้นที่คุมขัง จุดกลับเมื่อเสียชีวิต จุดออก และคุกเริ่มต้น |
shop_items.lua | ชื่อ/รายละเอียด/รูป/ราคา/จำนวนสูงสุดต่อครั้ง/น้ำหนัก | กำหนดสินค้าที่ซื้อได้ในร้านหน่วยงาน |
rewards.lua | minutes, item, label, amount, image | กำหนดรางวัลที่รับได้เมื่อเวลาเข้าเวรสะสมถึงที่กำหนด |
UI ที่ลูกค้าตั้งได้#
ค่าหน้าตา/การแจ้งเตือนอยู่ที่ config/customer/07_ui.lua:
AllowWhileDead— true = ตายแล้วยังเปิด UI ที่เชื่อมกับ nX Police ได้; false = บล็อกการเปิดและปิด UI ของ nX Police ที่เปิดค้างเมื่อผู้เล่นตายDisplay.EnableAnimations— เปิด/ปิด Animation ของ Police CommandDispatchCases— อนุญาตตัวกรองประเภทเหตุและเปิด/ปิดเสียง;AlertSoundเลือกเสียง GTA หรือไฟล์เสียงในweb/dist/assets/พร้อมตั้ง VolumeSettings.MinFontScale / MaxFontScale / DefaultFontScale— กำหนดช่วงและขนาดตัวอักษรเริ่มต้นJailHud.Position / OffsetX / OffsetY— เลือกตำแหน่ง HUD เจลและขยับเพิ่มเติมJailHud.Custom— กำหนดตำแหน่ง CSS เองเมื่อต้องการจัดละเอียดJailHud.AvoidOverlap— เปิดการหลบพื้นที่ UI ที่กำหนดและปรับระยะชดเชยที่เปิดให้ตั้ง
config/locales/th.lua — ข้อความ#
ข้อความภาษาไทยที่ลูกค้าปรับได้อยู่ใน config/locales/th.lua ให้แก้เฉพาะข้อความที่ต้องการแสดงผลตาม key ที่มีอยู่
Notification Provider#
เลือก internal หรือ external ที่ config/customer/07_ui.lua:
Config.Notification = {
Enabled = true,
Provider = 'internal', -- internal / external
Duration = 4500,
External = { Resource = '', FallbackToInternal = true }
}ถ้าใช้ external ให้เชื่อม Adapter ที่หน้า Integrations → External Notification เพื่อไม่ให้วิธีเชื่อมซ้ำอยู่ในหน้า Config
config/functions — Customer Hooks#
config/functions/client.lua และ config/functions/server.lua เป็นจุดสำหรับเชื่อม resource ภายนอกหรือ override พฤติกรรมที่เปิดให้ลูกค้าแก้ รายละเอียด signature และตัวอย่างอยู่ที่หน้า Integrations
ค่าที่ไม่อยู่ใน Customer Config#
ค่าที่ไม่ปรากฏใน Customer Config ไม่ต้องสร้างเพิ่มหรือย้ายกลับจาก Version เก่า ให้ใช้เฉพาะค่าที่คู่มือของ Version ปัจจุบันระบุ