Troubleshooting

Commands deny access

• Confirm the global permissions bootstrap is loaded before sky_base.
• Confirm the player belongs to a group listed for that command in Config.CommandPermissions.
• Reconnect the player after changing principals.
• Restart the resource after changing command permission groups.
• Remember that an unlisted command is console-only.

See Permissions for framework-specific setup.

Job Configurator changes do not match config.lua

When Config.UseJobConfigurator is enabled, saved configurator values take priority over matching Lua fallback values. Make the change in /jobconfig, or intentionally disable configurator use before relying only on fallback job definitions.

A workshop interaction is missing

• Verify its feature is enabled.
• Verify the point exists for the correct job.
• Check public and job restrictions.
• Confirm marker, NPC, and interaction settings are not all disabled.
• Check that sky_jobs_base started before sky_mechanicjob.

Parts Shop orders cannot be collected

• Create a Parts Delivery point for the mechanic job.
• Confirm the delivery point has enough free space.
• Wait for the configured delivery time.
• Verify the ordered items still exist in the delivery catalog and inventory.
• Check company permission and balance when company-card payment was used.

An item cannot be used or installed

• Confirm the exact item name matches the configuration.
• Confirm the item is defined in the active inventory.
• Check whether the related feature is enabled.
• Verify the player is near the required vehicle or workshop point.
• Check whether the workflow requires a lift, engine hoist, or wheel flow.

Tuning or mileage does not persist

• Confirm automatic database queries succeeded or import import.sql manually.
• Confirm the vehicle uses a stable, normalized plate.
• With owned-vehicle persistence enabled, confirm the plate exists in the framework vehicle ownership table.
• Check for another resource that overwrites vehicle properties or handling.

Custom handling becomes stronger after every entry

Keep Config.CustomHandlingOptions.overwriteHandling disabled unless another resource resets handling on vehicle entry. Repeated multiplier application can stack vehicle behavior.

Electric vehicle diagnostics are incorrect

Use game build 3258 or newer for native electric detection. On older builds, add custom and missing electric models to Config.ElectricVehicleFallback.models.

Dealer payout uses the wrong currency

Choose account only for a real framework account. Choose item when the currency is an inventory item. Confirm the selected account or item exists before testing a sale.

Duplicate mechanic salary payments

Set framework salary values for the mechanic grades to 0 when Sky Jobs Base handles the salary. Do not run both salary systems for the same job.

Database checklist

The installation is incomplete if any of these required tables are missing:

• sky_mechanic_vehicle_tuning
• sky_mechanic_tuning_orders
• sky_mechanic_vehicle_profiles
• sky_mechanic_vehicle_history
• sky_mechanic_part_deliveries

Getting support

Before opening a support request, collect the resource versions, framework, inventory, relevant configuration values, exact server-console error, and steps needed to reproduce the issue.