🪪 FX-IDCARD

Advanced ID card system for RedM with photo capture, printing system, metadata/SQL modes, and full framework compatibility.

---

📦 INSTALLATION

ensure fx-idcard

• Place the script inside resources/fx-idcard • Add ensure fx-idcard to your server.cfg • Restart your server • Make sure oxmysql is started before this script

---

⚙️ DEPENDENCIES

oxmysql (Required)

• Used for database communication • Script will not work without it • You can use tools like HeidiSQL or phpMyAdmin to manage your database

---

🗄️ SQL INSTALLATION

CREATE TABLE IF NOT EXISTS `fx_idcard` (
  `charid` varchar(50) DEFAULT NULL,
  `data` longtext DEFAULT NULL
);

• Stores ID card data per player • Required if using SQL mode • Saves generated ID cards

---

📦 VORP ITEM INSTALL

INSERT INTO `items` (...)
VALUES
('man_idcard', 'ID Card', ...),
('woman_idcard', 'ID Card', ...),
('printphoto', 'Print Photo', ...)

• Required items for ID system • printphoto → required to create ID card • man_idcard / woman_idcard → ID card items

---

📦 RSG ITEM INSTALL

man_idcard = { name = 'man_idcard', label = 'Man Idcard', unique = true, useable = true },
woman_idcard = { name = 'woman_idcard', label = 'Women Idcard', unique = true, useable = true },

• Required if using RSG framework • Items must be usable • Unique recommended

---

⚙️ BASIC CONFIG

Config.Language = "en"
Config.TakeCardType = "item"
Config.ShowIdcardCommand = "idcard"

• Language → system language • TakeCardType → "item" or "sql" • ShowIdcardCommand → used for SQL mode

---

🎯 CARD TYPE SYSTEM

Config.TakeCardType = "item"

• item → gives ID card as inventory item • sql → stores ID in database • SQL mode allows only one ID per player

---

🎮 KEY SYSTEM

Config.Keybinds = {
    ["takephoto"] = 0x760A9C6F,
    ["printphoto"] = 0xC7B5340A,
    ["takeidcard"] = 0x2CD5343E,
}

• Defines player controls • takephoto → opens camera • printphoto → prints photo • takeidcard → creates ID card

---

📸 PHOTO SYSTEM

Config.Photographers = {
    ["Blackwater"] = {
        promptCoords = vector4(...),
        pedCoords = vector4(...),
        camCoords = vector4(...),
    }
}

• Defines photographer locations • Players take photo here • Camera fully customizable

---

👷 ID CARD NPC SYSTEM

Config.IDCardNPC = {
    ["Blackwater"] = {
        coords = vector4(...),
        models = "cs_brontesbutler",
        distance = 3,
    }
}

• NPC used to create ID card • Players interact to open system

---

timeSettings = {
    open = 8,
    close = 21,
}

• Restricts usage by time • Example → only daytime access

---

illegal = true

• Enables illegal ID system • Can create fake identity

---

💰 PRICE SYSTEM

Config.Prices = {
    printphoto = 5,
    idcard = 50,
    illegal = 100,
}

• Defines system costs • Set false → free usage

---

🎒 ITEM SETTINGS

Config.PrintPhotoItem = "printphoto"
Config.ManIdCardItem = "man_idcard"
Config.WomanIdCardItem = "woman_idcard"

• Defines item names • Must match database items

---

⏱️ PHOTO TIME SYSTEM

Config.SelectPhotoTime = 30

• Time limit to select photo • Prevents abuse

---

👁️ SHOW SYSTEM

Config.ShowDistance = 1.5

• Distance to show ID card • Used for nearby players

---

👷 NPC SPAWN SYSTEM

Config.PedSpawnDistance = 30

• NPC spawn distance • Improves performance

---

🔔 NOTIFY SYSTEM

Notify({
  text = "ID Card Created",
  type = "success"
})

• Framework-based notification system • Supports VORP / RSG

---

🎮 CLIENT EVENT

TriggerClientEvent("fx-idcard:client:showIDCardSQL")

• Displays ID card UI • Used for SQL mode

---

⚠️ IMPORTANT NOTES

• oxmysql must be running • Items must exist in database • Print photo required before ID creation • SQL table required for SQL mode • Config.TakeCardType must be correct

---

🚨 COMMON MISTAKES

• Missing printphoto item • Wrong item names • Not importing SQL • Using SQL mode without table • NPC not spawning (wrong coords)

---

🏁 SUMMARY

FX-IDCARD provides:

• Photo-based ID system • Metadata & SQL support • NPC interaction system • Illegal ID system • Full framework compatibility

---

© Fixitfy Development