> ## 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>/로 복사하고 복사된 asset path에 대한 rbxasset:// string을 반환합니다.

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

  ## 별칭

  * `getsynasset`

  ## 인수

  <ParamField path={"path"} type={"string"} required>
    separator normalization 및 workspace-boundary checks 후 workspace 안에서 해석되는 path입니다. 대상은 존재하는 regular file이어야 합니다. folders, invalid filenames, DOS device names, blocked extensions는 허용되지 않습니다.
  </ParamField>

  ## 반환값

  <ResponseField name={"assetId"} type={"string"}>
    rbxasset://\<hwid>/\<workspace-relative-path> 형식의 String입니다. relative path에는 forward slashes를 사용합니다.
  </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>