> ## Documentation Index
> Fetch the complete documentation index at: https://docs.projectreal.gg/llms.txt
> Use this file to discover all available pages before exploring further.

# getcustomasset

> ينسخ regular workspace file موجودا إلى ExtraContent/<hwid>/ ويعيد rbxasset:// string لمسار asset المنسوخ.

<div className="real-function-page">
  ```lua theme={null}
  getcustomasset(path: string): string
  ```

  ## أسماء بديلة

  * `getsynasset`

  ## الوسائط

  <ParamField path={"path"} type={"string"} required>
    Path يتم حله داخل workspace بعد separator normalization وفحص workspace-boundary. يجب ان يكون الهدف موجودا وان يكون regular file؛ folders و invalid filenames و DOS device names و blocked extensions غير مقبولة.
  </ParamField>

  ## القيم الراجعة

  <ResponseField name={"assetId"} type={"string"}>
    String بالشكل rbxasset://\<hwid>/\<workspace-relative-path> مع استخدام forward slashes في relative path.
  </ResponseField>

  ## مثال

  انسخ workspace file موجودا إلى asset folder واطبع rbxasset path المعاد.

  ```lua theme={null}
  local path = "assets/example.txt"
  writefile(path, "asset bytes")

  local assetId = getcustomasset(path)
  print(assetId)
  print(getsynasset(path))
  ```
</div>