สร้างระบบ Housing ใน FiveM

ระบบบ้านช่วยให้ผู้เล่นรู้สึกว่ามี "สถานที่ของตัวเอง" ใน server เป็น feature ที่เพิ่ม engagement และ immersion อย่างมาก

Database Schema

CREATE TABLE `housing` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `name` VARCHAR(100) NOT NULL,
    `coords` TEXT NOT NULL,           -- JSON {x, y, z, h}
    `interior_coords` TEXT,           -- coords ข้างใน
    `price` INT DEFAULT 100000,
    `owner` VARCHAR(50) DEFAULT NULL, -- identifier
    `locked` TINYINT DEFAULT 1,
    `created_at` TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

CREATE TABLE `housing_storage` (
    `id` INT AUTO_INCREMENT PRIMARY KEY,
    `house_id` INT,
    `identifier` VARCHAR(50),
    `items` LONGTEXT,                 -- JSON inventory
    FOREIGN KEY (`house_id`) REFERENCES `housing`(`id`)
);

Config

Config = {}

Config.Houses = {
    {
        id = 1,
        name = 'บ้านหรู Mirror Park',
        coords = vector4(1271.8, -730.4, 67.8, 270.0),
        interior = vector4(266.0, -1007.4, 29.0, 270.0),  -- apartment interior
        price = 500000,
        garageCoords = vector4(1259.0, -733.0, 67.0, 90.0),
        maxGarage = 2
    },
    {
        id = 2,
        name = 'บ้านชั้นกลาง Vinewood',
        coords = vector4(325.5, 188.8, 104.5, 0.0),
        interior = vector4(346.7, -1013.3, -99.2, 0.0),
        price = 250000,
        garageCoords = vector4(330.0, 185.0, 104.0, 180.0),
        maxGarage = 1
    }
}

Core Functions (Server)

-- server.lua
local houseData = {}  -- cache

-- โหลดข้อมูลบ้านทั้งหมด
MySQL.query.await('SELECT * FROM housing', {}, function(result)
    for _, house in ipairs(result) do
        houseData[house.id] = house
    end
end)

-- ซื้อบ้าน
ESX.RegisterServerCallback('housing:buyHouse', function(source, cb, houseId)
    local xPlayer = ESX.GetPlayerFromId(source)
    local house = houseData[houseId]
    
    if not house then cb(false, 'ไม่พบบ้าน') return end
    if house.owner then cb(false, 'บ้านนี้มีเจ้าของแล้ว') return end
    
    local config = GetHouseConfig(houseId)
    if not config then cb(false, 'Config ไม่ถูกต้อง') return end
    
    if xPlayer.getMoney() < config.price then
        cb(false, 'เงินไม่พอ')
        return
    end
    
    xPlayer.removeMoney(config.price)
    
    MySQL.update.await(
        'UPDATE housing SET owner = ? WHERE id = ?',
        { xPlayer.identifier, houseId }
    )
    
    houseData[houseId].owner = xPlayer.identifier
    cb(true, 'ซื้อบ้านสำเร็จ!')
end)

-- ล็อค/ปลดล็อคบ้าน
RegisterNetEvent('housing:toggleLock')
AddEventHandler('housing:toggleLock', function(houseId)
    local src = source
    local xPlayer = ESX.GetPlayerFromId(src)
    local house = houseData[houseId]
    
    if not house or house.owner ~= xPlayer.identifier then
        TriggerClientEvent('M2.Notify:Notify', src, 'error', 'ไม่ใช่บ้านของคุณ', 3000)
        return
    end
    
    local newLocked = house.locked == 1 and 0 or 1
    MySQL.update.await('UPDATE housing SET locked = ? WHERE id = ?', { newLocked, houseId })
    houseData[houseId].locked = newLocked
    
    TriggerClientEvent('housing:updateLock', src, houseId, newLocked == 1)
end)

Client — เข้า/ออกบ้าน

-- client.lua
local insideHouse = nil

local function EnterHouse(house)
    local interior = house.interior
    SetEntityCoords(PlayerPedId(), interior.x, interior.y, interior.z)
    SetEntityHeading(PlayerPedId(), interior.w)
    insideHouse = house.id
    
    exports['M2.Notify']:Notify('success', 'เข้าบ้านแล้ว', 2000)
    TriggerEvent('housing:onEnter', house.id)
end

local function ExitHouse()
    local houseConfig = GetHouseConfig(insideHouse)
    local exitCoords = houseConfig.coords
    
    SetEntityCoords(PlayerPedId(), exitCoords.x, exitCoords.y, exitCoords.z)
    SetEntityHeading(PlayerPedId(), exitCoords.w)
    insideHouse = nil
    
    TriggerEvent('housing:onExit')
end

-- ตรวจสอบ proximity และแสดง interaction
Citizen.CreateThread(function()
    while true do
        local coords = GetEntityCoords(PlayerPedId())
        
        if insideHouse then
            -- ค้นหา exit point
            DrawText3D(coords.x, coords.y, coords.z + 0.5, '[E] ออกจากบ้าน')
            if IsControlJustReleased(0, 38) then
                ExitHouse()
            end
            Citizen.Wait(0)
        else
            -- ตรวจสอบบ้านใกล้เคียง
            for _, house in ipairs(Config.Houses) do
                local dist = GetDistanceBetweenCoords(coords, house.coords, true)
                if dist <= 2.0 then
                    DrawText3D(house.coords.x, house.coords.y, house.coords.z + 0.5,
                        '[E] เข้าบ้าน')
                    if IsControlJustReleased(0, 38) then
                        -- ตรวจสอบว่าล็อคไหม
                        TriggerServerEvent('housing:enter', house.id)
                    end
                    break
                end
            end
            Citizen.Wait(500)
        end
    end
end)

สรุป

Housing system ซับซ้อนกว่า job system แต่ให้ value สูงมากสำหรับ RP server เริ่มจาก basic buy/enter/exit ก่อน แล้วค่อยเพิ่ม garage, storage และ furniture system