ตั้งค่าร้านค้าครั้งแรก

ผูก License

ค่า License เป็นกุญแจที่ให้ฝั่งเกม (devil_market) คุยกับฝั่ง Addon ได้ ค่าทั้งสองฝั่ง ต้องเหมือนกันเป๊ะ มิฉะนั้นระบบเติมเงินและ sync ข้อมูลจะใช้งานไม่ได้

เปิดไฟล์ config_main.lua แล้วแก้บรรทัด License:

Settings = {
    License = "YOUR_LICENSE_KEY_HERE", 
    -- ...ค่าอื่น ๆ
}

แล้วเปิดไฟล์ .env ฝั่ง Addon ใส่ค่า เดียวกันเป๊ะ กับด้านบน:

DEVIL_API_SECRET=YOUR_LICENSE_KEY_HERE

ตั้งตำแหน่งเปิดร้าน (Zone)

Zone คือจุดที่ผู้เล่นเดินเข้าไปแล้วกดปุ่มเปิดร้าน มักจะตั้งไว้กลางเมืองหรือจุดที่ผู้เล่นเข้าถึงง่าย

ใน config_main.lua ใต้ส่วน Zones ให้แก้พิกัด coords เป็นตำแหน่งที่คุณต้องการ:

Zones = {
    {
        coords = vector3(398.18, -822.82, 29.29), -- พิกัด Legion Square (ตัวอย่าง)
        label = "Devil Market - Legion Square",
        marker = {
            size = vector3(1.4, 1.4, 0.6),
            color = { r = 217, g = 160, b = 76, a = 140 },
            rotate = true,
        },
    },
}

เพิ่มสินค้าชิ้นแรก

ใต้ส่วน Products ให้เพิ่มสินค้าเข้าไป เริ่มจากไอเทมง่าย ๆ ก่อน เช่นน้ำดื่ม:

Products = {
    {
        category = "ของกินของใช้",
        items = {
            {
                label = "น้ำดื่ม",
                price = 15,
                pointPrice = 15,
                description = "น้ำดื่มบรรจุขวด",
                earnPoints = 1,
                type = "item",
                spawnName = "water",
                limitId = { enabled = true, id = "water_basic" },
            },
        },
    },
}

ค่าสำคัญที่ต้องเช็ค:

กำหนดสต็อกสินค้า

สินค้าทุกชิ้นที่เปิด limitId.enabled = true ต้องมี entry ใน config_limit.lua ที่มี key ตรงกับ limitId.id ไม่งั้นระบบจะสร้างค่า default 100/100 ให้อัตโนมัติ

เปิด config_limit.lua แล้วเพิ่ม entry สำหรับ water_basic:

["water_basic"] = {
    name = "น้ำดื่ม",
    currentStock = 100,
    maxStock = 100,
    resetToMax = true,           -- รีเติมเป็น 100 ทุกวัน
    category = "item",
}

ความหมาย: มีน้ำดื่ม 100 ขวดในสต็อก พอหมดจะรีเซ็ตเป็น 100 ใหม่ทุกวันเวลา 00:00 (ตามค่า AutoReset ในไฟล์เดียวกัน)

เปิดการแจ้งเตือน

เปิดไฟล์ config_notification.lua เพื่อปรับข้อความแจ้งเตือนตอนซื้อสำเร็จ:

Messages = {
    purchase_success = function(data)
        local name = data.name or 'ไอเท็ม'
        local count = data.count or 1
        return 'คุณได้รับ ' .. count .. 'x ' .. name
    end,
}

ค่าเริ่มต้นใช้ nc_notify ถ้าเซิร์ฟเวอร์ใช้ notify อื่น ดูวิธีเปลี่ยนใน ระบบแจ้งเตือน

รีสตาร์ทและทดสอบ

รีสตาร์ท resource ใน console:

restart devil_market

หรือถ้าแก้ทั้งสองฝั่ง รีสตาร์ท Addon ด้วย:

restart devil_marketaddons

(ถ้า Addon รันผ่าน PM2: pm2 restart devil-market-addons)

ทดสอบในเกม:

1. เข้าเซิร์ฟเวอร์
2. เดินไปยังตำแหน่ง Zone ที่ตั้งไว้
3. เห็น marker + ข้อความแจ้งเตือน Press [E] Open Devil Market
4. กด E → UI เปิดขึ้น → เห็นสินค้า "น้ำดื่ม"
5. ซื้อ 1 ชิ้น → ได้รับ water ในกระเป๋า + แจ้งเตือนสำเร็จ