AWS Handling Editor
Permission-controlled handling editing with presets, JSON persistence and optional metadata writing.
Installation
Requirements
- FiveM; qb-core when Config.UseQBCorePermission=true.
- Write permission for the configured JSON/meta paths.
Startup order
This example selects one framework and target. Use the resources matching your configuration and start dependencies first.
ensure qb-core
ensure aws-hand
Setup steps
- Start vehicle resources before aws-hand so its aggregate HANDLING_FILE loads last.
- Back up vehicle handling.meta files before enabling source-file writes. Source writes are disabled by default in the prepared package.
- Configure the editor permission before allowing players onto the server.
Gameplay and usage
- Authorized staff can use /handle or /awshand while in the driver seat.
- Change a small handling value, save, then reconnect/restart to verify persistence.
Configuration
- config.lua: Command, CommandAlias, UseQBCorePermission and QBCorePermissionLevel.
- WriteSourceHandlingMeta, WriteAggregateHandlingMeta and BackupHandlingMetaBeforeWrite control persistent writes.
- data/handlings.json, data/templates.json and data/overrides_handling.meta hold package-owned data.
Exports and integrations
No public callable export is declared with exports() in these source files. Use the documented commands or configuration; internal network events are not a trusted integration API.
Troubleshooting
-
Confirm an ordinary player cannot edit or save handling.
-
Check both runtime handling and aggregate metadata after restart.
-
Include the package version, framework and exact server/F8 error when requesting support. Remove private tokens and player data.
Package reference
| Manifest | Version |
|---|---|
fxmanifest.lua |
2.1.0 |
Database files
No standalone SQL file is included. Check the installation steps above for tables created by server code.
Configuration reference
aws-hand/config.lua:Command,CommandAlias,RequireDriverSeat,UseQBCorePermission,QBCorePermissionLevel,SaveFilePath,TemplatesFilePath,WriteAggregateHandlingMeta,AggregateHandlingMetaPath,WriteSourceHandlingMeta,BackupHandlingMetaBeforeWrite,HandlingMetaScanFolders,SyncBytesPerSecond,SyncRequestDelay,EnableGlobalSpeedLimit,GlobalMaxSpeedKmh,TemplateScanFolders,AutoFindMevcutAraclar
Frequently asked questions
Does this need Keymaster or an escrow key?
The Lua sources in this delivery package were readable in the static audit. No /assetpacks requirement is added by this package. Required framework, inventory and map resources still need to be installed separately.
Can I change the folder or database table names?
Keep the supplied folder names. Historical event, SQL and KVP identifiers are retained to protect existing integrations and saved data. Renaming a table or event requires a separate migration.
Why is an interface or item missing?
Check the startup order, selected framework/target adapter, inventory item definitions and the server/F8 console. The package does not install an entire framework or inventory for you.
Has this been tested on my server?
ZIP integrity, source readability, script syntax and manifest references were checked locally. Multiplayer gameplay, your framework version and integrations require a FiveM server acceptance test before a public release.