> 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). # 사용자 지정 아이템 어떤 씬에서든 재사용할 수 있도록 자신만의 사용자 지정 아이템을 만드세요. 사용자 지정 항목을 정의하면 어떤 장면에서든 쉽게 재사용하거나 다른 장면 제작자와 공유할 수 있습니다. 사용자 지정 항목은 하나의 엔티티로 구성될 수도 있고, 원하는 만큼 많은 엔티티로 구성될 수도 있습니다. 사용자 지정 항목은 기존 스마트 항목의 변형이 될 수도 있고, 자체적으로 맞춤화된 모델과 기능을 갖춘 완전히 새로운 항목일 수도 있습니다. {% 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\&token=98f0efb0-8490-45d1-8180-3003a9f9a640) 그다음 화면 아래쪽에서 새 사용자 지정 항목의 이름을 입력하라는 메시지가 표시됩니다. ![](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\&token=9331e0f5-8e09-4033-a0e2-158068d35227) 이제 항목은 **사용자 지정 항목** 탭에 화면 하단에 표시됩니다. 이 탭은 작업 공간에 사용자 지정 항목이 최소 하나 이상 있을 때만 표시됩니다. ![](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\&token=bd6dccd4-6f4f-4b4d-8fae-c8f7c7f435f4) 사용자 지정 항목을 정의할 때는 같은 계층 수준에서 여러 엔티티를 선택할 수 있지만, 공통 조상 없이 서로 다른 상위 항목에 속한 엔티티는 선택할 수 없습니다. 중첩된 엔티티는 자동으로 사용자 지정 항목의 일부로 포함되므로 선택할 필요가 없습니다. 장면에 있는 원래 엔티티는 사용자 지정 항목을 정의하는 작업의 영향을 받지 않습니다. {% hint style="warning" %} **📔 참고**: 사용자 지정 항목을 정의할 때는 선택한 엔티티의 각 구성 요소 상태를 스냅샷으로 저장합니다(루트 엔티티의 위치, 회전, 크기는 제외). 여기에는 **동작**, **트리거**, **멀티플레이어**, **스크립트**, **가시성**, 그리고 기타 모든 구성 요소가 포함됩니다. 모든 스마트 항목의 동작과 트리거는 자체 복사본을 참조합니다. 예를 들어, 엘리베이터와 버튼이 포함된 사용자 지정 항목을 정의하면 각 엘리베이터 복사본의 버튼은 자신이 속한 엘리베이터 복사본을 제어하며, 원본 엘리베이터 복사본은 제어하지 않습니다. {% 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` 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 what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.