POLICE+ Admin Tools

POLICE+ คือ Editor สำหรับ Admin ใช้สร้าง Door Lock และ Jail Location จากในเกม โดยระบบทำงานเป็น Draft ก่อน จึงสามารถเลือก Object, ทดลองล็อก/ปลดล็อก และตรวจพื้นที่คุกก่อน Copy Config ไปใช้จริง

เปิดใช้งาน#

/police+

เมื่อเปิด ระบบจะโหลด Config.DoorLock.Doors และ Config.Jail.DefaultLocations ปัจจุบันเข้ามาเป็น Draft ชั่วคราว โดยเริ่มที่ Door Mode

Door Mode — ประตู#

เล็ง Crosshair ไปที่ Object ประตูก่อนใช้คำสั่งเพิ่ม/รวมกลุ่ม ระบบจะพยายามเก็บตำแหน่งตอนประตูปิดจริงให้อัตโนมัติ รวมถึงประตูเลื่อนหรือ sensor door บางชนิด

ประตูเดี่ยว#

1. เปิด /police+
2. เล็งกลาง Object ประตู
3. กด E
4. รอ Toast ยืนยันการจับตำแหน่ง
5. กด G ทดลองล็อก/ปลดล็อก
6. ปรับระยะตามต้องการ
7. กด C แล้ววาง Config ใน config/data/doors.lua

ประตูคู่ / หลายบาน#

1. เล็งบานแรกแล้วกด E เพื่อสร้างกลุ่ม
2. เล็งบานที่สองแล้วกด H
3. เพิ่มบานอื่นด้วย H ต่อได้
4. กด G ตรวจว่าทุกบานล็อก/ปลดล็อกพร้อมกัน

Internal Policy ปัจจุบันรองรับสูงสุด 8 leaves ต่อ Door Group และ 128 Door Drafts ต่อ session

Jail Mode — พื้นที่คุก#

กด TAB เพื่อเข้าสู่ Jail Mode จากนั้นยืนตามตำแหน่งจริงที่ต้องการบันทึก

ขั้นตอนสร้าง Jail ใหม่#

1. ไปยืนบริเวณศูนย์กลางคุก
2. เปิด /police+ และกด TAB
3. กด SHIFT + E
4. ใช้ E ตั้ง center
5. ไปจุด death แล้วกด H
6. ไปจุด exit แล้วกด G
7. ปรับ radius ด้วยลูกศรและดูวง Preview
8. กด C แล้ววางใน config/data/jail_locations.lua

Jail ใหม่เริ่มต้น radius 25m และได้ key/name ชั่วคราวแบบ jail_### / พื้นที่คุก ### ซึ่งแก้ให้สื่อความหมายหลัง Copy ได้

Copy Config ให้ถูกตำแหน่ง#

Door#

POLICE+ Copy เฉพาะรายการด้านใน ไม่รวม wrapper Doors = { ... } ให้วางภายใน:

-- config/data/doors.lua
Config.DoorLock.Doors = {
    -- วางรายการที่ Copy ตรงนี้
}

Jail#

เช่นเดียวกัน ให้เอารายการที่ Copy ไปวางด้านใน:

-- config/data/jail_locations.lua
Config.Jail.DefaultLocations = {
    -- วางรายการที่ Copy ตรงนี้
}

ทำให้ถาวร#

1. กด C Copy Draft
2. วางในไฟล์ config/data/doors.lua หรือ config/data/jail_locations.lua
3. ตรวจ ID/key ไม่ซ้ำและแก้ label/name หากต้องการ
4. บันทึกไฟล์
5. restart nX_police
6. ทดสอบอีกครั้งหลังโหลด Config จริง

การปิด Editor ก่อน Copy ไม่ถือเป็นการ Save และ Draft ชั่วคราวจะถูกยกเลิก

Internal Policy ที่ลูกค้าไม่ต้องตั้ง#

• Door raycast ภายในปัจจุบัน 15m
• Door Draft สูงสุด 128 กลุ่ม
• สูงสุด 8 leaves ต่อ Door Group
• Jail Draft สูงสุด 64 พื้นที่
• Preview sync, door close calibration, sensor-door capture, anti-spam และ server validation เป็น Internal Runtime

ตัวเลขเหล่านี้เป็น Internal Policy และอาจเปลี่ยนตาม Version ไม่ควรสร้าง Config.DoorLock.Editor เองใน Customer Config

Troubleshooting#

Checklist ก่อน Production#

• Door ID และ Jail key ไม่ซ้ำ
• ประตูคู่ LIVE TEST พร้อมกันถูกต้อง
• ระยะ interact/display เหมาะสม
• Jail center / death / exit ถูกจุด
• radius ครอบพื้นที่พอดี
• มี isDefault = true ตามที่ต้องการ
• Copy ไปไฟล์ data ถูกตำแหน่ง
• restart และทดสอบจาก Config จริงอีกครั้ง