> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/custom-items.md). # 사용자 지정 아이템 모든 씬에서 재사용할 수 있는 자신만의 사용자 지정 아이템을 만드세요. 사용자 지정 아이템을 정의하면 어떤 씬에서도 쉽게 재사용하거나 다른 씬 제작자와 공유할 수 있습니다. 사용자 지정 아이템은 하나의 엔티티로 구성될 수도 있고, 원하는 만큼 많은 엔티티로 구성될 수도 있습니다. 사용자 지정 아이템은 기존 Smart Item의 변형일 수도 있고, 자체적으로 맞춤 제작된 모델과 기능을 갖춘 완전히 사용자 지정된 항목일 수도 있습니다. {% embed url="" %} ## 사용자 지정 아이템을 정의하는 방법 엔티티 트리의 엔티티를 마우스 오른쪽 버튼으로 클릭하거나 [엔티티 트리](/creator/content-creator-ko/scene-editor/get-started/scene-editor-essentials.md#the-entity-tree), 또는 여러 엔티티를 선택한 다음 마우스 오른쪽 버튼으로 클릭합니다. 다음을 선택하세요 **사용자 지정 아이템 만들기**. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e2d3666b2958e72bd78207ed4ac8e0f9908e02be%2Fcreate-custom-item.png?alt=media) 그다음 화면 하단 영역에서 새 사용자 지정 아이템의 이름을 지정하라는 메시지가 표시됩니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ee1372916ffe9ea085734e64823ec5da994b6e21%2Fname-custom-item.png?alt=media) 이제 아이템이 **사용자 지정 아이템** 탭의 화면 하단에 표시됩니다. 이 탭은 작업 공간에 사용자 지정 아이템이 하나 이상 있을 때만 표시됩니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aa8e9586dc8aa8ed34e1d5358f1c072ff821a6f6%2Fcustom-items.png?alt=media) 사용자 지정 아이템을 정의할 때 같은 계층 수준의 여러 엔티티는 선택할 수 있지만, 공통 조상이 없는 서로 다른 부모의 엔티티는 선택할 수 없습니다. 중첩된 엔티티는 자동으로 사용자 지정 아이템의 일부로 포함되므로 선택할 필요가 없습니다. 씬에 있는 원래 엔티티는 사용자 지정 아이템 정의 작업의 영향을 받지 않습니다. {% hint style="warning" %} **📔 참고**: 사용자 지정 아이템을 정의하면 선택한 엔티티의 각 구성 요소 상태를 스냅샷으로 저장합니다(루트 엔티티의 위치, 회전, 스케일은 제외). 여기에는 **동작**, **트리거**, **멀티플레이어**, **스크립트**, **가시성**, 및 기타 모든 구성 요소가 포함됩니다. 모든 Smart Item 동작과 트리거는 자체 복사본을 참조합니다. 예를 들어, 엘리베이터와 버튼이 포함된 사용자 지정 아이템을 정의하면, 각 복사본의 버튼은 원본 엘리베이터가 아니라 자신이 속한 엘리베이터 복사본을 제어합니다. {% endhint %} ### 사용자 지정 아이템 사용하기 아이템을 **사용자 지정 아이템** 탭에서 씬으로 간단히 끌어다 놓으세요. 추가한 후에는 사용자 지정 아이템의 어떤 속성이든 자유롭게 변경할 수 있으며, 변경 사항은 *해당 복사본* 에만 영향을 줍니다. 또한 사용자 지정 아이템의 원본이 된 아이템을 편집하거나 삭제할 수도 있지만, 이는 기존 복사본이나 이후 복사본에는 영향을 주지 않습니다. 사용자 지정 아이템은 엔티티 트리에서 다른 아이콘으로 표시됩니다. 오른쪽의 아이템 속성 메뉴 상단에서도 어떤 사용자 지정 아이템에서 만들어졌는지 확인할 수 있습니다. 사용자 지정 아이템 정의를 삭제하려면 **사용자 지정 아이템** 메뉴에서 아이템을 마우스 오른쪽 버튼으로 클릭하고 **삭제**. 이 작업은 씬에 있는 아이템의 기존 복사본에는 영향을 주지 않으며, 고아가 된 사용자 지정 아이템은 씬에서 변경되지 않은 상태로 남습니다. 사용자 지정 아이템 정의를 삭제하면 사용자 지정 아이템 탭에서만 제거됩니다. 사용자 지정 아이템 정의의 이름을 바꾸려면 **사용자 지정 아이템** 탭에서 사용자 지정 아이템 정의를 마우스 오른쪽 버튼으로 클릭하고 **이름 바꾸기**. 이미 만들어진 사용자 지정 아이템의 정의는 수정할 수 없습니다. 새 정의를 만들고 원본을 삭제해야 합니다. ### 사용자 지정 아이템을 동적으로 생성하기 각 사용자 지정 아이템은 합성 파일로 저장되며, 이는 엔티티와 구성 요소의 트리를 설명하는 파일입니다. 즉, 씬이 실행되는 동안 각 복사본을 직접 배치하는 대신 사용자 지정 아이템의 새 복사본을 생성할 수 있습니다. 사용자 지정 아이템을 생성하는 방법은 두 가지입니다: * **코드 없이**: 다음을 사용하세요 **엔티티 생성** 액션을 씬 편집기에서 사용합니다. 다음을 참조하세요 [엔티티 생성에 대하여](/creator/content-creator-ko/scene-editor/interactivity/smart-items-advanced.md#about-spawning-entities). * **코드 사용**: 다음을 사용하세요 `Composite.instance()` 를 SDK에서 사용합니다. 다음을 참조하세요 [합성](/creator/content-creator-ko/sdk7/architecture/composites.md). ### 사용자 지정 아이템 공유하기 사용자 지정 아이템을 다른 제작자와 공유하여, 그들이 자신의 씬에서 사용할 수 있게 할 수 있습니다. 사용자 지정 아이템은 각 항목이 로컬 컴퓨터의 별도 폴더에 저장됩니다. 사용자 지정 아이템 탭 오른쪽 상단의 폴더 아이콘 Code 을 클릭하여 해당 폴더를 열 수 있습니다. 또한 기기에서 이 폴더를 수동으로 찾을 수도 있습니다: * Windows의 경우: *User/AppData/Roaming/creator-hub/Custom Items* * Mac의 경우: *Users/username/Library/Application Support/creator-hub/Custom Items* {% hint style="warning" %} **📔 참고**: *Library* 폴더는 Mac에서 기본적으로 숨겨져 있습니다. 가장 쉽게 접근하는 방법은 이동 > 폴더로 이동을 연 다음 입력하는 것입니다 *application support/creator-hub* {% endhint %} 다른 사람과 공유하려면, 사용자 지정 아이템 폴더를 열고 해당 아이템의 전체 폴더를 복사하면 됩니다. 전송을 쉽게 하려면 폴더를 zip으로 압축하는 것이 좋습니다. 이 폴더에는 사용자 지정 아이템을 사용하는 데 필요한 모든 내용이 들어 있습니다. 사용자 지정 아이템을 사용하는 사람은 자신의 컴퓨터에 있는 사용자 지정 아이템 폴더 안에 아이템 폴더의 압축을 풀어야 합니다. 아이템이 자신의 Refresh 탭에 표시되려면 새로 고침 버튼을 클릭해야 할 수도 있습니다 **사용자 지정 아이템** 탭. 모든 **에셋** 도 사용자 지정 아이템에서 사용하는 모든 3D 모델, 이미지, 스크립트, 사운드, 비디오를 포함하여 사용자 지정 아이템의 폴더에 저장됩니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-ko/scene-editor/interactivity/custom-items.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.