การติดตั้ง

คู่มือนี้ใช้แพ็กเกจเผยแพร่ที่คอมไพล์อินเทอร์เฟซไว้แล้ว คุณไม่จำเป็นต้องใช้ Node.js หรือคอมไพล์ UI ใหม่เพื่อติดตั้ง

ข้อกำหนด

ส่วนประกอบ	จำเป็นเมื่อใด
`oxmysql` และการเชื่อมต่อฐานข้อมูลที่ใช้งานได้	จำเป็นสำหรับบันทึกข้อมูลของรีซอร์ส
Qbox, QBCore หรือ ESX	เมื่อใช้ระบบเศรษฐกิจและสิทธิ์ของเฟรมเวิร์กเหล่านี้ คุณเชื่อมต่อระบบเศรษฐกิจอื่นได้ด้วย callbacks แบบ standalone
แพ็กสัก	เป็นตัวเลือก ติดตั้งได้ทั้งหมด บางแพ็ก หรือไม่ติดตั้งเลย
`ox_lib`	เป็นตัวเลือกสำหรับการแจ้งเตือน TextUI โดยมีทางเลือกแบบ native ให้ใช้
ระบบรูปลักษณ์	หากเซิร์ฟเวอร์ของคุณใช้ระบบนี้ ให้อ่าน bridge สำหรับรูปลักษณ์

พิมพ์เขียวแชร์กันผ่านรหัส คุณไม่จำเป็นต้องเพิ่มไอเท็มในอินเวนทอรีเพื่อใช้การตั้งค่าที่ให้มา

วางรีซอร์ส

แตกแพ็กเกจไปยังโฟลเดอร์รีซอร์สของเซิร์ฟเวอร์
ในคู่มือนี้ใช้ cxg-tattoos เป็นชื่อโฟลเดอร์ หากโฟลเดอร์ของคุณใช้ชื่ออื่น ให้ใช้ชื่อจริงในคำสั่ง ensure และ restart
คงโครงสร้างที่ให้มาไว้ ตรวจสอบว่ามี config.lua, shared/tattoos.json, bridge/ และ ui/dist/index.html พร้อมกับไฟล์อื่นในแพ็กเกจ
ตั้งค่าการเชื่อมต่อฐานข้อมูลและตรวจสอบว่า oxmysql เริ่มทำงานได้ถูกต้อง

ลำดับการเริ่มทำงาน

ตัวอย่างสำหรับ Qbox ที่ไม่มีแพ็กภายนอก:

โค้ด

ensure oxmysql
ensure qbx_core
ensure cxg-tattoos

สำหรับ QBCore หรือ ESX ให้แทนที่ qbx_core ด้วย qb-core หรือ es_extended หากใช้ระบบรูปลักษณ์ ให้เริ่มระบบนั้นก่อนรีซอร์สนี้ สำหรับ standalone ให้ตั้งค่า callbacks สำหรับการชำระเงินและสิทธิ์ ก่อน

หากมีแพ็ก ให้เริ่มเฉพาะแพ็กที่ติดตั้งไว้ก่อนรีซอร์ส ตัวอย่างเช่น:

โค้ด

ensure oxmysql
ensure qbx_core
ensure xgc_TattooClasic
ensure xgc_TattooGangs
ensure cxg-tattoos

อย่าเพิ่มบรรทัด ensure สำหรับแพ็กที่คุณไม่มี แหล่งข้อมูลเริ่มต้นสามารถคงไว้ใน Config.TattooCatalog.sources ได้ ระบบจะข้ามแพ็กที่ไม่ได้เริ่มทำงาน

การเริ่มทำงานครั้งแรก

รีซอร์สจะเตรียมพื้นที่จัดเก็บให้อัตโนมัติ การติดตั้งใหม่ไม่จำเป็นต้องนำเข้าสคีมาด้วยตนเอง

ก่อนทดสอบ ให้ตรวจสอบรายการต่อไปนี้ใน config.lua:

Config.Locale: ภาษาหลัก
Config.Purchases: ระบบเศรษฐกิจและบัญชีที่ใช้เรียกเก็บเงิน
Config.Permissions: สิทธิ์การเข้าถึงสำหรับผู้ดูแล
Config.Identity: ระบบอัตลักษณ์ของเซิร์ฟเวอร์และตัวระบุที่ใช้บันทึกและเรียกคืนข้อมูลผู้เล่น ดูที่ ระบบอัตลักษณ์
Config.Shops: ตำแหน่งเริ่มต้นของร้านค้า

เดินไปยังร้านที่ตั้งค่าไว้แล้วใช้ปฏิสัมพันธ์ ตรวจสอบแคตตาล็อก การแสดงตัวอย่าง และการซื้อด้วยตัวละครทดสอบ จากนั้นโหลดตัวละครอีกครั้งเพื่อดูว่ารอยสักยังอยู่หรือไม่

คำสั่งผู้ดูแลที่มีมาให้ตั้งค่าใน Config.AdminCommand; ชื่อเริ่มต้นคือ /tattooadmin อ่าน สิทธิ์และการชำระเงิน ก่อนใช้งาน

ใช้การเปลี่ยนแปลง

หลังแก้ไข config.lua หรือ bridge ให้บันทึกไฟล์แล้วรีสตาร์ตรีซอร์ส:

โค้ด

restart cxg-tattoos

ระบบจะอ่านแหล่งข้อมูลแคตตาล็อกอีกครั้งเมื่อเริ่มทำงาน และซิงก์ข้อมูลจากแผงควบคุมได้ การตั้งค่าที่บันทึกผ่านแผงควบคุมจะยังคงอยู่ อ่าน การตั้งค่า และ แคตตาล็อก ก่อนคาดหวังว่าค่าจากไฟล์จะเขียนทับค่าเหล่านั้น

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

อาการ	สิ่งที่ควรตรวจสอบ
รีซอร์สเริ่มทำงานไม่ได้	`oxmysql` เริ่มทำงานแล้ว การเชื่อมต่อใช้งานได้ และแพ็กเกจมีไฟล์ครบ
แพ็กไม่ปรากฏในร้าน	รีซอร์สนั้นเริ่มทำงานแล้ว `enabled` ไม่ได้เป็น `false` และเส้นทาง JSON ตรงกับของแพ็ก
อินเทอร์เฟซว่างเปล่า	คัดลอก `ui/dist/index.html` พร้อมไฟล์ที่อ้างถึงใน `ui/dist/assets/` มาด้วยกัน
แผงควบคุมปฏิเสธการเข้าถึง	ตรวจ `Config.AdminCommand.permission`, bindings ของสิทธิ์ และ roles หรือ ACE ที่ตั้งค่าไว้
การชำระเงินถูกปฏิเสธ	ตรวจเฟรมเวิร์กที่เลือก ชื่อรีซอร์ส ยอดเงิน และ callbacks แบบ standalone หากเกี่ยวข้อง
มีปฏิสัมพันธ์ร้านสักสองรายการในตำแหน่งเดียวกัน	ตรวจว่ามีรีซอร์สระบบรูปลักษณ์หรือร้านค้าอื่นเปิดใช้งานตำแหน่งนั้นด้วยหรือไม่ ให้เหลือทางเข้าร้านที่ต้องการใช้เพียงรายการเดียว
การเปลี่ยนร้านค้าหรือระดับไม่มีผล	ตรวจว่ามีการบันทึกการตั้งค่าจากแผงควบคุมไว้แล้วหรือไม่ ให้แก้ค่าที่มีผลจริงจากแผงควบคุม

คุณเปิด Config.Debug และ Config.Permissions.debug ชั่วคราวเพื่อวินิจฉัยปัญหาได้ ปิดใช้งานเมื่อเสร็จแล้ว

ไปยังการตั้งค่า