OZ-TESTDRIVING

🔥 TOP FEATURES

✅ Vehicle categories (database-based)
✅ Test drive system with time limit
✅ End test drive at any time with the F key
✅ Locales system (DE/EN expandable)
✅ Marker & Blip at the shop
✅ ESX menu (standard)
✅ Support for oz_notify / only_helpnotify

📺 SHOWCASE & DOCUMENTATION

🎬 Showcase Video: YouTube
📚 Full Documentation: GitBook

⚙️ REQUIREMENTS

• Framework: ESX (es_extended)
• oxmysql

⚙️ Installation

1. Script installieren

• Place the folder, for example as oz_testdriving, in your resources folder.

• Add the following to the server.cfg file:

ensure oz_testdriving

2️. Prepare database

Your vehicles table needs a category column:

ALTER TABLE vehicles ADD category VARCHAR(50);

Example categories:

UPDATE vehicles SET category = 'Sport' WHERE model IN ('comet2','jester');
UPDATE vehicles SET category = 'SUV'   WHERE model IN ('baller','granger');

3️. check fxmanifest.lua

shared_scripts {
    'config.lua',
    'locales/*.lua'
}

client_script 'client.lua'
server_script 'server.lua'

🧭 Use in the game

• Go to the marker at the vehicle shop

• Press E → Categories menu opens

• Choose a category

• Choose a vehicle

• Test drive starts automatically

⏹ Cancel test drive

• Press F to end the test drive immediately.

🌍 Locales (multilingualism)

Set language (config.lua)

Config.Locale = 'de' -- 'de' or 'en'

Add new language

1. Create new file: locales/fr.lua

2. Enter translations

3. Config.Locale = 'fr'

🛠 Configuration (config.lua)

🔒 Safety & Notices

• Vehicles are spawned as mission entities.

• Vehicles are always deleted after test drives.

• The player will be reliably teleported back.

• Abuse through endless loops is not possible.

📞 SUPPORT

Discord: https://discord.gg/QaMEA95qbS