[{"data":1,"prerenderedAt":313},["ShallowReactive",2],{"/docs/scripts/treasurehunt/setup/installation":3,"/docs/scripts/treasurehunt/setup/installation-surround":301,"/docs/scripts/treasurehunt/setup/installation-implemented-suggestions":312},{"id":4,"title":5,"body":6,"description":291,"extension":292,"head":293,"implementedSuggestions":293,"meta":294,"navigation":295,"path":296,"schemaOrg":293,"seo":297,"sitemap":298,"stem":299,"__hash__":300},"docs/1.docs/scripts/6.treasurehunt/2.setup/1.installation.md","Installation",{"type":7,"value":8,"toc":286},"minimark",[9,14,81,92,96,262,266,269,282],[10,11,13],"h2",{"id":12},"requirements","Requirements",[15,16,17,30],"table",{},[18,19,20],"thead",{},[21,22,23,27],"tr",{},[24,25,26],"th",{},"Requirement",[24,28,29],{},"Purpose",[31,32,33,45,55,63,73],"tbody",{},[21,34,35,42],{},[36,37,38],"td",{},[39,40,41],"code",{},"sky_base",[36,43,44],{},"Framework, inventory, accounts, SQL and shared interactions",[21,46,47,52],{},[36,48,49],{},[39,50,51],{},"sky_jobs_base",[36,53,54],{},"Shared initialization and character identity",[21,56,57,60],{},[36,58,59],{},"OneSync",[36,61,62],{},"Server-side position checks and shared activity state",[21,64,65,70],{},[36,66,67],{},[39,68,69],{},"oxmysql",[36,71,72],{},"Transactional persistence through Sky Base",[21,74,75,78],{},[36,76,77],{},"Configured inventory provider",[36,79,80],{},"Equipment use, purchases and delivery of finds",[82,83,84,85,87,88,91],"p",{},"Set Sky Base's SQL provider to ",[39,86,69],{},". Treasure Hunt checks this at startup because progression and discovery updates use transactions. ",[39,89,90],{},"ox_inventory"," is supported through the inventory bridge, but is not a required inventory resource.",[10,93,95],{"id":94},"install","Install",[97,98,99,104,130,134,150,161,165,171,181,185,188,230,240,244],"steps",{},[100,101,103],"h3",{"id":102},"place-the-resource","Place the resource",[82,105,106,107,110,111,114,115,121,122,125,126,129],{},"Extract your resource download and place the folder containing ",[39,108,109],{},"fxmanifest.lua"," in your server's ",[39,112,113],{},"resources"," directory. Keep its name ",[116,117,118],"strong",{},[39,119,120],{},"sky_treasurehunt",". Retain the included ",[39,123,124],{},"stream",", ",[39,127,128],{},"source/html",", configuration and credit files.",[100,131,133],{"id":132},"register-all-inventory-items","Register all inventory items",[82,135,136,137,142,143,145,146,149],{},"Use ",[138,139,141],"a",{"href":140},"../reference/inventory-items","Inventory items"," to register the 12 equipment items and 60 finds. The resource includes English and German ",[39,144,90],{}," import templates and matching PNG images in ",[39,147,148],{},"config/inventory/",".",[82,151,152,153,156,157,160],{},"Merge the definitions into the inventory you actually use. The resource's ",[39,154,155],{},"import.sql"," creates Treasure Hunt tables; it does ",[116,158,159],{},"not"," insert items into an ESX inventory database.",[100,162,164],{"id":163},"configure-the-database","Configure the database",[82,166,167,168,170],{},"Connect ",[39,169,69],{}," to your database and configure it in Sky Base. Treasure Hunt creates its tables and applies its included migrations during startup. The database user needs permission to create and alter those tables and read and write their data.",[82,172,173,175,176,180],{},[39,174,155],{}," is the manual table-creation reference for the current release. It does not disable startup migrations. See ",[138,177,179],{"href":178},"../reference/database-and-updates","Database and updates"," before updating an existing installation.",[100,182,184],{"id":183},"start-dependencies-first","Start dependencies first",[82,186,187],{},"Keep your existing framework and inventory setup, then use this order for the relevant resources:",[189,190,196],"pre",{"className":191,"code":192,"filename":193,"language":194,"meta":195,"style":195},"language-cfg shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","ensure oxmysql\n# Start your framework and inventory before Sky Base.\nensure sky_base\nensure sky_jobs_base\nensure sky_treasurehunt\n","server.cfg","cfg","",[39,197,198,206,212,218,224],{"__ignoreMap":195},[199,200,203],"span",{"class":201,"line":202},"line",1,[199,204,205],{},"ensure oxmysql\n",[199,207,209],{"class":201,"line":208},2,[199,210,211],{},"# Start your framework and inventory before Sky Base.\n",[199,213,215],{"class":201,"line":214},3,[199,216,217],{},"ensure sky_base\n",[199,219,221],{"class":201,"line":220},4,[199,222,223],{},"ensure sky_jobs_base\n",[199,225,227],{"class":201,"line":226},5,[199,228,229],{},"ensure sky_treasurehunt\n",[82,231,232,233,239],{},"Enable OneSync in your server configuration. The resource manifest declares it as a requirement. The ",[138,234,238],{"href":235,"rel":236},"https://docs.fivem.net/docs/server-manual/server-commands/#resource-commands",[237],"nofollow","FiveM server-command reference"," explains resource start commands.",[100,241,243],{"id":242},"choose-the-first-settings","Choose the first settings",[82,245,246,247,125,250,253,254,257,258,261],{},"Check ",[39,248,249],{},"Config.Locale",[39,251,252],{},"Config.Shop.locations"," and ",[39,255,256],{},"ServerConfig.Shop.Currency",". All four methods are enabled by default. Settings are edited in the shipped Lua files; there is no Treasure Hunt ",[39,259,260],{},"/jobconfig"," page.",[10,263,265],{"id":264},"verify-the-installation","Verify the installation",[82,267,268],{},"Join as a regular player and visit the dealer near the Vespucci docks. Confirm that the shop opens, the starter detector and shovel can be purchased and used, and a completed find enters the inventory. Reopen the album and reconnect to check that the discovery and progression remain.",[82,270,271,272,276,277,281],{},"Then try a magnet cast, a dive with a filled scuba set and one bin search. Use ",[138,273,275],{"href":274},"./first-steps","First steps"," for the workflow and ",[138,278,280],{"href":279},"../reference/troubleshooting","Troubleshooting"," if anything fails.",[283,284,285],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":195,"searchDepth":202,"depth":208,"links":287},[288,289,290],{"id":12,"depth":208,"text":13},{"id":94,"depth":208,"text":95},{"id":264,"depth":208,"text":265},"Set up Sky Treasure Hunt with Sky Base, Jobs Base, OneSync, oxmysql and the required inventory items.","md",null,{},true,"/docs/scripts/treasurehunt/setup/installation",{"title":5,"description":291},{"loc":296},"1.docs/scripts/6.treasurehunt/2.setup/1.installation","pOOzrNhxesNoHjyqAuDJTOks1WVPSPxiRznEWsZbz-w",[302,307],{"title":303,"path":304,"stem":305,"description":306,"children":-1},"Overview","/docs/scripts/treasurehunt/overview","1.docs/scripts/6.treasurehunt/1.overview","Install and configure Sky Treasure Hunt, explore its four search methods, and manage equipment, skills and the find album.",{"title":308,"path":309,"stem":310,"description":311,"children":-1},"Configuration","/docs/scripts/treasurehunt/setup/configuration","1.docs/scripts/6.treasurehunt/2.setup/2.configuration","Find the Lua settings for language, the dealer, equipment, search areas, rewards, progression and administrator access.",[],1791911969844]