[{"data":1,"prerenderedAt":223},["ShallowReactive",2],{"/docs/scripts/activities/reference/troubleshooting":3,"/docs/scripts/activities/reference/troubleshooting-surround":212,"/docs/scripts/activities/reference/troubleshooting-implemented-suggestions":222},{"id":4,"title":5,"body":6,"description":202,"extension":203,"head":204,"implementedSuggestions":204,"meta":205,"navigation":206,"path":207,"schemaOrg":204,"seo":208,"sitemap":209,"stem":210,"__hash__":211},"docs/1.docs/scripts/7.activities/5.reference/3.troubleshooting.md","Troubleshooting",{"type":7,"value":8,"toc":195},"minimark",[9,14,188,192],[10,11,13],"h2",{"id":12},"common-problems","Common problems",[15,16,17,51,69,79,92,102,120,135,149,159,174],"accordion",{},[18,19,21],"accordion-item",{"label":20},"The resource does not start or its UI is missing",[22,23,24,25,29,30,29,33,36,37,40,41,44,45,50],"p",{},"Check OneSync, ",[26,27,28],"code",{},"oxmysql",", ",[26,31,32],{},"sky_base",[26,34,35],{},"sky_jobs_base"," and their start order. Keep the resource folder named ",[26,38,39],{},"sky_activities"," and deploy the complete package, including ",[26,42,43],{},"source/html",". Read the first server error and the client F8 log. Follow ",[46,47,49],"a",{"href":48},"../setup/installation","Installation",".",[18,52,54],{"label":53},"Changes in config.lua have no effect",[22,55,56,57,60,61,64,65,50],{},"Check ",[26,58,59],{},"Config.UseActivitiesConfig",". In the default editor mode, global operator settings come from ",[26,62,63],{},"/activitiesconfig"," and the database; the corresponding Lua operator values are ignored. Startup options and bowling geometry still come from their files. Existing activity rules must be edited on the saved activity. See ",[46,66,68],{"href":67},"../setup/configuration","Configuration",[18,70,72],{"label":71},"The configurator reports missing permission",[22,73,74,75,78],{},"Check the configured administrator groups or the ",[26,76,77],{},"sky.activities.admin"," ACE permission and your player's group membership. Restart after changing startup permission configuration. The activity editor remains available in Lua settings mode, but its global settings are read-only.",[18,80,82],{"label":81},"Props or NPCs disappear, animations stop, or players are flagged",[22,83,84,85,87,88,50],{},"Check the anticheat log for the resource, action and model. Allow ",[26,86,39],{}," in Resource Protection and its required entity, weapon, movement and camera categories. Test with normal-player protection enabled. Preview/podium NPCs use actual player models. Follow ",[46,89,91],{"href":90},"../setup/anticheat","Anticheat & resource protection",[18,93,95],{"label":94},"A custom map is missing or players fall through it",[22,96,97,98,50],{},"Verify the map resource, exported collision and world coordinates before testing Activities. Leave the IPL field empty for permanently loaded maps; otherwise enter the actual IPL identifier. Check bounds, entry and exit positions. An editor validation success does not validate the physical MLO. See ",[46,99,101],{"href":100},"../mapping/custom-maps","Custom maps & IPLs",[18,103,105],{"label":104},"A bowling MLO is installed but no lanes are available",[22,106,107,108,111,112,115,116,50],{},"Check the master Bowling switch and that hall's location switch in the effective settings source. Every ",[26,109,110],{},"resources"," entry in ",[26,113,114],{},"config/bowling.lua"," must exactly match a started resource. After changing resource names or geometry, restart Activities. Do not run another bowling gameplay script on the same lanes. See ",[46,117,119],{"href":118},"../mapping/bowling-mlos","Bowling MLOs",[18,121,123],{"label":122},"K4MB1 overlaps the Sky hall or has invisible walls",[22,124,125,126,129,130,134],{},"Disabling ",[26,127,128],{},"sky_delperro"," stops its gameplay but does not remove streamed geometry. Follow the exact ",[46,131,133],{"href":132},"../mapping/bowling-mlos#replace-the-sky-del-perro-building","Sky Del Perro file exclusions",", retain the shared bowling assets, then reload and reconnect. Also check other resources replacing the same GTA world files.",[18,136,138],{"label":137},"Bowling pins, returns or displays do not line up",[22,139,140,141,143,144,148],{},"Check the installed map version against its preset. Lane floor origins, pin feet, ball centers, approach positions and screen rotations are different measurements. Correct ",[26,142,114],{}," using the ",[46,145,147],{"href":146},"../mapping/bowling-mlos#add-your-own-bowling-location","venue geometry contract",". Check duplicate map decoration and machine compatibility; K4MB1 has machine animation disabled in its preset.",[18,150,152],{"label":151},"A kart checkpoint or objective cannot be reached",[22,153,154,155,50],{},"Check placement order, direction, bounds and collision. Ensure each allowed driver has a grid slot, and combat teams have enough spawns and their return zones. Run the editor validation and a private test, then verify with another client. See ",[46,156,158],{"href":157},"../mapping/activity-editor","Activity editor",[18,160,162],{"label":161},"A native billiard table or dartboard cannot be used",[22,163,164,165,168,169,173],{},"Confirm the sport and ",[26,166,167],{},"Sports.automatic"," are enabled and the object uses a ",[46,170,172],{"href":171},"../features/table-sports","supported model",". Decorative replacements with different model names are not automatically compatible. Check whether a saved override disabled that station.",[18,175,177],{"label":176},"Edited signs still show the old text",[22,178,179,180,183,184,50],{},"Replace the named entry in the YTD from ",[26,181,182],{},"catalogue.csv",", not just its PNG template. Keep the exact texture name, upload the dictionary and reconnect after restarting. Check shared uses and additional YTDs listed in the catalogue. See ",[46,185,187],{"href":186},"./editable-signs","Editable signs",[10,189,191],{"id":190},"information-to-include-in-a-support-report","Information to include in a support report",[22,193,194],{},"Include the resource version, effective configuration mode, affected activity/venue ID, map resource names and versions, and steps to reproduce. Add the relevant server/F8 error and anticheat denial if present. For geometry problems, show the exact lane or placement and its configuration. Remove webhook URLs, database credentials and other secrets before sharing logs or files.",{"title":196,"searchDepth":197,"depth":198,"links":199},"",1,2,[200,201],{"id":12,"depth":198,"text":13},{"id":190,"depth":198,"text":191},"Resolve Activities startup, configuration, anticheat, custom-map, bowling and texture problems.","md",null,{},true,"/docs/scripts/activities/reference/troubleshooting",{"title":5,"description":202},{"loc":207},"1.docs/scripts/7.activities/5.reference/3.troubleshooting","5qMNEYSsbDWhms_3wWg5x4l8v1OieW7jzaZF5q6oRq0",[213,217],{"title":187,"path":214,"stem":215,"description":216,"children":-1},"/docs/scripts/activities/reference/editable-signs","1.docs/scripts/7.activities/5.reference/2.editable-signs","Replace text and branding on the included venue signs by editing their YTD textures.",{"title":218,"path":219,"stem":220,"description":221,"children":-1},"Overview","/docs/scripts/sky-dj/overview","1.docs/scripts/7.sky-dj/1.overview","Install DJ System, create your first club, and find the guides for mixing, spatial audio, lighting and portable boomboxes.",[],1792607509458]