{"name":"createLocation","title":"createLocation","type":"command","url":"https://community.bistudio.com/wiki/createLocation","revid":322768,"updated":"2022-06-23T13:56:55Z","groups":["Locations"],"status":"ok","games":{"arma1":"1.08","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.08","arma3_since":"0.50","locality":{"effect":"local"},"description":"Creates a location of the specified class and dimensions at the specified position.\nClasses are defined in `CfgLocationTypes`; for possible location types see Location Types.\nThe alternative syntax allows to convert a non-editable (built-in) terrain location into an editable one, with the following restrictions:\n\n- it cannot be deleted (but can be setType to \"Invisible\" to hide it)\n- it cannot be moved","syntaxes":[{"syntax":"createLocation [className, position, sizeX, sizeY]","params":[{"name":"className","type":"String","type_expr":"String"},{"name":"position","type":"Position2D, Position3D or Object","type_expr":"Position2D | Position3D | Object"},{"name":"sizeX","type":"Number","description":"in meters","type_expr":"Number"},{"name":"sizeY","type":"Number","description":"in meters","type_expr":"Number"}],"returns":{"type":"Location","type_expr":"Location"},"form":"unary","right":{"text":"[className, position, sizeX, sizeY]"}},{"syntax":"createLocation [location]","since":"arma3 2.10","params":[{"name":"location","type":"Location","description":"a terrain's location. If a scripted location is provided, it is simply returned","type_expr":"Location"}],"returns":{"type":"Location","type_expr":"Location","description":"a script-editable location"},"form":"unary","right":{"text":"[location]"}}],"examples":[{"code":["_location = createLocation [\"NameVillage\", [4035,2151,10], 100, 100];"]},{"code":["_location = createLocation [\"NameVillage\", [4035,2151,10], 30, 30];\n_location setText \"Player town\";"]},{"text":"```sqf\nprivate _terrainLocation = nearestLocation [player, \"nameCity\"];    // assuming it returns a built-in location\n_terrainLocation setType \"Invisible\";                                // does not do anything\nprivate _editableLocation = createLocation [_terrainLocation];        // does the conversion\n_editableLocation setType \"Invisible\";                                // hides the location\n```","code":["private _terrainLocation = nearestLocation [player, \"nameCity\"];\t// assuming it returns a built-in location\n_terrainLocation setType \"Invisible\";\t\t\t\t\t\t\t\t// does not do anything\nprivate _editableLocation = createLocation [_terrainLocation];\t\t// does the conversion\n_editableLocation setType \"Invisible\";\t\t\t\t\t\t\t\t// hides the location"]}],"see_also":["setText","nearestLocation","nearestLocations","locationPosition","nearestLocationWithDubbing","setRectangular","rectangular","size"]}