[{"data":1,"prerenderedAt":921},["ShallowReactive",2],{"/docs/jobs/mechanicjob/features/handling-editor":3,"/docs/jobs/mechanicjob/features/handling-editor-surround":909,"/docs/jobs/mechanicjob/features/handling-editor-implemented-suggestions":920},{"id":4,"title":5,"body":6,"description":896,"extension":897,"head":898,"implementedSuggestions":898,"meta":899,"navigation":901,"path":902,"schemaOrg":898,"seo":903,"sitemap":906,"stem":907,"__hash__":908},"docs/1.docs/0.jobs/2.mechanicjob/3.features/13.handling-editor.md","Handling Editor",{"type":7,"value":8},"minimark",[9,13,18,43,112,121,134,138,141,837,841,844,864,868],[10,11,12],"p",{},"Give each vehicle the driving feel that fits your server. Adjust handling directly in-game, test the result on the road, and keep the setups you want to use again.",[14,15,17],"h2",{"id":16},"getting-started","Getting started",[10,19,20,21,25,26,30,31,34,35,38,39,42],{},"The Handling Editor is an ",[22,23,24],"strong",{},"administrator tool",". Access requires the ",[27,28,29],"code",{},"handlingeditor"," command permission; having a mechanic job alone does not grant access. The shipped permission groups are ",[27,32,33],{},"god",", ",[27,36,37],{},"superadmin",", and ",[27,40,41],{},"admin",".",[44,45,46,54,61,75,86,105],"ol",{},[47,48,49,50,53],"li",{},"Sit in the ",[22,51,52],{},"driver seat"," of the vehicle you want to tune.",[47,55,56,57,60],{},"Enter ",[27,58,59],{},"/handlingeditor"," in chat and check the vehicle name and plate in the header.",[47,62,63,64,67,68,71,72,42],{},"Choose ",[22,65,66],{},"Simple"," or ",[22,69,70],{},"Advanced",", make your edits, and review them under ",[22,73,74],{},"Changes",[47,76,77,78,81,82,85],{},"Select ",[22,79,80],{},"Apply",". Use ",[22,83,84],{},"Current vehicle"," for your first test, then confirm the handling basis and apply the changes.",[47,87,88,89,92,93,96,97,100,101,104],{},"Open ",[22,90,91],{},"Telemetry",", select a test mode, choose ",[22,94,95],{},"Start test",", and then ",[22,98,99],{},"Drive",". Press ",[22,102,103],{},"F7"," with the default controls to return to the editor.",[47,106,107,108,111],{},"Use ",[22,109,110],{},"Save profile"," to keep the setup. Once tested, you can apply it permanently to a plate or model.",[10,113,114,115,117,118,120],{},"Editing, importing, or loading a profile prepares a draft. ",[22,116,80],{}," changes the vehicle; ",[22,119,110],{}," keeps a reusable setup. Closing the editor does not undo changes you have already applied.",[10,122,123,124,127,128,133],{},"An authorized administrator can also use ",[27,125,126],{},"/handlingeditor [playerId]"," for another online administrator. The target needs editor permission and must be in the driver seat. From the server console, provide a player ID. See ",[129,130,132],"a",{"href":131},"../setup/permissions","Permissions"," for command-access setup.",[14,135,137],{"id":136},"editor-features","Editor features",[10,139,140],{},"Open a feature below for its controls, examples, and screenshots. Select a screenshot to view it at full size.",[142,143,144,199,346,373,433,609,708,751],"accordion",{},[145,146,149,154,179,185],"accordion-item",{"icon":147,"label":148},"i-lucide-sparkles","Simple · Tune the driving feel",[10,150,151,153],{},[22,152,66],{}," groups related handling values into accessible presets and controls. Use it to establish the overall feel of a vehicle before fine-tuning individual properties.",[155,156,157,160,167,173],"ul",{},[47,158,159],{},"Choose presets from the dropdowns for the available tuning groups.",[47,161,162,163,166],{},"Adjust ",[22,164,165],{},"Body roll"," to change how planted the vehicle feels.",[47,168,162,169,172],{},[22,170,171],{},"Brake response"," to coordinate braking strength and balance.",[47,174,88,175,178],{},[22,176,177],{},"?"," to see an explanation and the handling fields affected by a control.",[10,180,181,182,184],{},"Simple and Advanced work on the same draft. You can switch between them as you refine a setup. Change one group at a time, review ",[22,183,74],{},", and use the undo and redo controls as needed.",[10,186,187],{},[129,188,190],{"href":189},"/docs/mechanicjob/handling-editor/simple-tuning-frame.png",[191,192],"img",{"alt":193,"className":194,"height":197,"src":189,"width":198},"Simple tuning with preset dropdowns, body-roll adjustment, and brake-response controls",[195,196],"w-full","h-auto",627,1140,[145,200,203,208,233,242,247,308,313,327,337],{"icon":201,"label":202},"i-lucide-sliders-horizontal","Advanced · Edit values and apply a setup",[10,204,205,207],{},[22,206,70],{}," gives you individual handling fields with sliders, number inputs, units, and available explanations.",[44,209,210,217,220,227],{},[47,211,212,213,216],{},"Select the handling block, such as ",[22,214,215],{},"Base handling",", from the first dropdown.",[47,218,219],{},"Narrow the list with the category dropdown or property search.",[47,221,222,223,226],{},"Enable ",[22,224,225],{},"Useful only"," to focus on common tuning fields.",[47,228,229,230,232],{},"Edit the value and use ",[22,231,74],{}," to review the draft before applying it.",[10,234,235],{},[129,236,238],{"href":237},"/docs/mechanicjob/handling-editor/advanced-tuning-frame.png",[191,239],{"alt":240,"className":241,"height":197,"src":237,"width":198},"Advanced handling fields with block and category filters, property search, and numeric controls",[195,196],[10,243,244],{},[22,245,246],{},"Choose where the changes apply",[248,249,250,266],"table",{},[251,252,253],"thead",{},[254,255,256,260,263],"tr",{},[257,258,259],"th",{},"Application target",[257,261,262],{},"What happens",[257,264,265],{},"When to use it",[267,268,269,282,295],"tbody",{},[254,270,271,276,279],{},[272,273,274],"td",{},[22,275,84],{},[272,277,278],{},"Changes remain on this spawned vehicle until its entity is deleted.",[272,280,281],{},"A temporary experiment or first road test.",[254,283,284,289,292],{},[272,285,286],{},[22,287,288],{},"Persist for plate",[272,290,291],{},"A saved rule restores the setup when a vehicle with that plate is spawned.",[272,293,294],{},"A specific vehicle that needs its own handling.",[254,296,297,302,305],{},[272,298,299],{},[22,300,301],{},"Persist for model",[272,303,304],{},"A saved rule applies to that model; a plate rule takes priority for overlapping fields.",[272,306,307],{},"A tested setup intended for a whole model.",[10,309,310],{},[22,311,312],{},"Choose the handling basis",[155,314,315,321],{},[47,316,317,320],{},[22,318,319],{},"Use vehicle base"," removes installed custom-handling effects from untouched fields while keeping your edits.",[47,322,323,326],{},[22,324,325],{},"Use current custom handling"," keeps the installed Mechanic handling and places your editor values on top.",[10,328,329,330,332,333,336],{},"Review the validation findings and confirm ",[22,331,80],{},". Fields marked ",[22,334,335],{},"Export only"," can be kept in profiles and exports, but do not change the vehicle live.",[10,338,339],{},[129,340,342],{"href":341},"/docs/mechanicjob/handling-editor/apply-handling-frame.png",[191,343],{"alt":344,"className":345,"height":197,"src":341,"width":198},"Apply handling dialog with current-vehicle, plate, and model targets and a choice of handling basis",[195,196],[145,347,350,356,361,364],{"icon":348,"label":349},"i-lucide-flag","Flags · Control individual handling flags",[10,351,88,352,355],{},[22,353,354],{},"Flags",", select a flag group from the dropdown, and search by name, effect, bit, or hexadecimal value.",[10,357,358,359,42],{},"Toggle individual bits or edit the decimal and hexadecimal representation. Read the available explanation before changing a flag and review the result in ",[22,360,74],{},[10,362,363],{},"Some flags have no reliably documented effect. Those entries are identified in the editor; a visible switch is not a guarantee of a specific driving effect.",[10,365,366],{},[129,367,369],{"href":368},"/docs/mechanicjob/handling-editor/flags-frame.png",[191,370],{"alt":371,"className":372,"height":197,"src":368,"width":198},"Flags editor with a group dropdown, search, decimal and hexadecimal values, and individual switches",[195,196],[145,374,377,383,415,421,424],{"icon":375,"label":376},"i-lucide-layers","Layers · See which values take priority",[10,378,379,382],{},[22,380,381],{},"Layers"," shows how the effective handling is assembled. Inspect the layers in this order:",[44,384,385,391,397,403,409],{},[47,386,387,390],{},[22,388,389],{},"Vehicle basis"," — the unchanged handling foundation.",[47,392,393,396],{},[22,394,395],{},"Custom tuning"," — installed Mechanic handling changes.",[47,398,399,402],{},[22,400,401],{},"Model rule"," — the persistent setup for the model.",[47,404,405,408],{},[22,406,407],{},"Plate rule"," — a more specific setup for that vehicle plate.",[47,410,411,414],{},[22,412,413],{},"Editor draft"," — the changes you are currently preparing.",[10,416,417,418,420],{},"Later layers take priority where they affect the same field. Use the inspector to find the source of a value and see which changes overlap. The editor draft still needs ",[22,419,80],{}," before it becomes a live change.",[10,422,423],{},"If a vehicle behaves differently from the rest of its model, check its plate rule as well as the model rule.",[10,425,426],{},[129,427,429],{"href":428},"/docs/mechanicjob/handling-editor/layers-frame.png",[191,430],{"alt":431,"className":432,"height":197,"src":428,"width":198},"Handling Layer Inspector showing vehicle basis, custom tuning, model and plate rules, and the editor draft",[195,196],[145,434,437,442,447,480,487,499,512,517,577,582,597,600],{"icon":435,"label":436},"i-lucide-gauge","Telemetry · Test, measure, and compare",[10,438,439,441],{},[22,440,91],{}," combines live vehicle data, road tests, saved runs, and comparison graphs.",[10,443,444],{},[22,445,446],{},"Start a test drive",[44,448,449,458,470,475],{},[47,450,451,452,454,455,457],{},"Apply your setup, then open ",[22,453,91],{},". Reopen ",[27,456,59],{}," first if the editor has closed.",[47,459,63,460,34,463,466,467,42],{},[22,461,462],{},"Acceleration",[22,464,465],{},"100–0 braking",", or ",[22,468,469],{},"Free drive",[47,471,77,472,474],{},[22,473,95],{}," to arm or begin recording.",[47,476,77,477,479],{},[22,478,99],{}," to return control to the vehicle.",[10,481,482,483,486],{},"The full editor gives way to a ",[22,484,485],{},"compact telemetry tablet in the bottom-right corner",". The tablet keeps speed, gear, RPM percentage, elapsed time, the relevant benchmark, top measured speed, distance, and test status visible while you drive.",[10,488,489,490,492,493,495,496,498],{},"Press ",[22,491,103],{}," with the default controls to return. If your server changes the editor return key, use that configured key instead. ",[22,494,99],{}," changes the view; ",[22,497,95],{}," controls recording.",[10,500,501],{},[129,502,504],{"href":503},"/docs/mechanicjob/handling-editor/mini-tablet-frame.png",[191,505],{"alt":506,"className":507,"height":510,"src":503,"width":511},"Mini telemetry tablet with a device frame, live speed, gear, RPM, road-test results, and the F7 return shortcut",[195,508,196,509],"max-w-sm","mx-auto",267,283,[10,513,514],{},[22,515,516],{},"Choose the right test",[248,518,519,532],{},[251,520,521],{},[254,522,523,526,529],{},[257,524,525],{},"Test",[257,527,528],{},"How it starts",[257,530,531],{},"How to finish",[267,533,534,550,562],{},[254,535,536,540,543],{},[272,537,538],{},[22,539,462],{},[272,541,542],{},"Arm it while stopped; capture begins when you reach 2 km/h.",[272,544,545,546,549],{},"Return and select ",[22,547,548],{},"Stop & save"," after the measurements you need.",[254,551,552,556,559],{},[272,553,554],{},[22,555,465],{},[272,557,558],{},"Reach at least 100 km/h. Measurement begins as speed drops below 100 km/h.",[272,560,561],{},"Brake to a stop; the completed run is saved automatically.",[254,563,564,568,573],{},[272,565,566],{},[22,567,469],{},[272,569,570,571,42],{},"Recording begins immediately after ",[22,572,95],{},[272,574,545,575,42],{},[22,576,548],{},[10,578,579],{},[22,580,581],{},"Compare the results",[10,583,584,585,588,589,592,593,596],{},"In ",[22,586,587],{},"Saved test runs",", select ",[22,590,591],{},"Compare"," on a previous run. The graph and benchmarks compare the current test with that run. Use ",[22,594,595],{},"Clear comparison"," to remove it from the comparison view.",[10,598,599],{},"Keep the vehicle, route, and conditions consistent. Record a baseline, change one area of the handling, and repeat the test. A benchmark stays empty until its required speed or distance has been reached.",[10,601,602],{},[129,603,605],{"href":604},"/docs/mechanicjob/handling-editor/telemetry-frame.png",[191,606],{"alt":607,"className":608,"height":197,"src":604,"width":198},"Telemetry workspace with live measurements, speed curves, benchmarks, and saved-run comparison",[195,196],[145,610,613,619,624,658,667,672,679,688,693,699],{"icon":611,"label":612},"i-lucide-save","Profiles · Save setups, revisions, and private drafts",[10,614,615,618],{},[22,616,617],{},"Profiles"," brings shared setups, revision history, private workspaces, and persistent override information together.",[10,620,77,621,623],{},[22,622,110],{}," and enter a name that identifies the vehicle and purpose. When profile versioning is enabled, you can also:",[155,625,626,633,649,655],{},[47,627,628,629,632],{},"Add a ",[22,630,631],{},"Revision note"," describing what changed.",[47,634,63,635,34,638,466,641,644,645,648],{},[22,636,637],{},"Draft",[22,639,640],{},"Road tested",[22,642,643],{},"Approved"," in the ",[22,646,647],{},"Release status"," dropdown.",[47,650,651,652,42],{},"Link a saved run through ",[22,653,654],{},"Telemetry evidence",[47,656,657],{},"Update the loaded profile or save a new profile with its own revision history.",[10,659,660],{},[129,661,663],{"href":662},"/docs/mechanicjob/handling-editor/save-profile-frame.png",[191,664],{"alt":665,"className":666,"height":197,"src":662,"width":198},"Save-profile dialog with a descriptive name, revision note, release-status dropdown, and telemetry evidence",[195,196],[10,668,669],{},[22,670,671],{},"Load and revise a shared setup",[10,673,674,675,678],{},"Search the profile library and select ",[22,676,677],{},"Load",". Review its values, make your edits, and save an updated revision or a separate copy. Select a profile to review its history and restore a previous revision when needed.",[10,680,681,682,684,685,687],{},"Shared profiles can be found and loaded by other administrators with editor access. Saving, loading, or marking a profile ",[22,683,643],{}," does not publish a vehicle rule. Use ",[22,686,80],{}," and choose the intended target when ready.",[10,689,690],{},[22,691,692],{},"Keep an experiment private",[10,694,107,695,698],{},[22,696,697],{},"Personal workspaces"," to save a private draft without creating a shared profile revision. Workspaces do not apply automatically.",[10,700,701],{},[129,702,704],{"href":703},"/docs/mechanicjob/handling-editor/profiles-frame.png",[191,705],{"alt":706,"className":707,"height":197,"src":703,"width":198},"Profile library with shared setups, revision history, personal workspaces, and plate and model overrides",[195,196],[145,709,712,718,739,742],{"icon":710,"label":711},"i-lucide-car","Fleet · Manage plate and model rules",[10,713,714,717],{},[22,715,716],{},"Fleet"," is the management view for published handling rules.",[155,719,720,723,726,729,732],{},[47,721,722],{},"Search for a model, plate, profile, or author.",[47,724,725],{},"Use the scope dropdown to show all rules, model rules, or plate rules.",[47,727,728],{},"Enable the conflict filter to find overlapping rules.",[47,730,731],{},"Review change history and restore previous published snapshots.",[47,733,734,735,738],{},"Remove a persistent rule or use ",[22,736,737],{},"Publish to model"," to extend a plate setup to the model.",[10,740,741],{},"A plate rule takes priority over a model rule for matching fields. Review the target before publishing a wider change. Closing the editor does not remove these saved rules.",[10,743,744],{},[129,745,747],{"href":746},"/docs/mechanicjob/handling-editor/fleet-frame.png",[191,748],{"alt":749,"className":750,"height":197,"src":746,"width":198},"Fleet Manager with rule filters, model and plate entries, conflict information, and change history",[195,196],[145,752,755,761,799,806,826],{"icon":753,"label":754},"i-lucide-file-code-2","Export · Import and share XML or JSON",[10,756,757,760],{},[22,758,759],{},"Export"," lets you move setups between the editor and your handling-file workflow.",[248,762,763,773],{},[251,764,765],{},[254,766,767,770],{},[257,768,769],{},"Format",[257,771,772],{},"Use it for",[267,774,775,789],{},[254,776,777,782],{},[272,778,779],{},[22,780,781],{},"XML",[272,783,784,785,788],{},"Handling data for a ",[27,786,787],{},"handling.meta"," workflow.",[254,790,791,796],{},[272,792,793],{},[22,794,795],{},"JSON",[272,797,798],{},"A Sky handling snapshot you can import back into the editor.",[10,800,801,802,805],{},"Choose the format from the dropdown and select ",[22,803,804],{},"Copy to clipboard",". Exporting does not overwrite files on your server.",[10,807,808,809,812,813,816,817,820,821,67,823,825],{},"To bring an existing setup in, select ",[22,810,811],{},"Import",", choose a JSON, XML, or META file, or paste its contents. The file picker accepts files up to ",[22,814,815],{},"1 MB",". Select ",[22,818,819],{},"Load into editor",", review the imported values, and use ",[22,822,80],{},[22,824,110],{}," as appropriate.",[10,827,828],{},[129,829,831],{"href":830},"/docs/mechanicjob/handling-editor/export-frame.jpg",[191,832],{"alt":833,"className":834,"height":835,"src":830,"width":836},"Export workspace with format selection, import, copy to clipboard, and handling-data preview",[195,196],626,1139,[14,838,840],{"id":839},"server-settings","Server settings",[10,842,843],{},"Editor settings can control the layer inspector, field explanations, validator, telemetry coach, profile versioning, workspaces, fleet management, and flag search. Available handling blocks also depend on the current vehicle.",[10,845,846,847,850,851,854,855,858,859,863],{},"With the Job Configurator enabled, manage editor settings through ",[27,848,849],{},"/jobconfig",". When it is disabled, ",[27,852,853],{},"Config.HandlingEditor"," in ",[27,856,857],{},"sky_mechanicjob/config/config.lua"," supplies the settings. See ",[129,860,862],{"href":861},"../setup/configuration","Configuration"," for how the two configuration modes work.",[14,865,867],{"id":866},"related-pages","Related pages",[155,869,870,876,882,888,892],{},[47,871,872],{},[129,873,875],{"href":874},"../overview","Mechanic Job overview",[47,877,878],{},[129,879,881],{"href":880},"./performance-systems","Performance Systems",[47,883,884],{},[129,885,887],{"href":886},"./tuning-and-orders","Tuning and Orders",[47,889,890],{},[129,891,862],{"href":861},[47,893,894],{},[129,895,132],{"href":131},"A free upgrade for sky_mechanicjob. Tune vehicles in-game, measure road performance, and manage your handling setups.","md",null,{"toc":900},false,{"icon":201},"/docs/jobs/mechanicjob/features/handling-editor",{"title":904,"ogImage":905,"description":896},"Handling Editor — Free Upgrade for sky_mechanicjob | Sky-Systems","https://www.sky-systems.net/docs/mechanicjob/handling-editor/advanced-tuning-frame.png",{"loc":902},"1.docs/0.jobs/2.mechanicjob/3.features/13.handling-editor","sjbjWctTFC8pjwZJLS10F3Z1br4wGOdQDHSPJqYXR-Y",[910,915],{"title":911,"path":912,"stem":913,"description":914,"icon":435,"children":-1},"Two-Step and Launch Control","/docs/jobs/mechanicjob/features/two-step-launch-control","1.docs/0.jobs/2.mechanicjob/3.features/12.two-step-launch-control","Install, use, tune, and troubleshoot the adaptive Two-Step and Launch Control system.",{"title":916,"path":917,"stem":918,"description":919,"icon":435,"children":-1},"Mobile Dyno","/docs/jobs/mechanicjob/features/mobile-dyno","1.docs/0.jobs/2.mechanicjob/3.features/14.mobile-dyno","Bring performance testing into your workshop with a mobile test bench, live screens, cooling controls, and four test profiles.",[],1788969562171]