> 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/sdk7/debugging/report-bug.md). # 버그 신고 버그가 검토되고 수정되도록 신고하는 방법 Decentraland SDK와 Creator Hub의 Scene Editor에서 버그나 문제가 발생하면 GitHub 저장소에 신고해 주세요 [여기](https://github.com/decentraland/sdk/issues/new/choose). ## 버그를 신고하기 전에 버그 보고서를 제출하기 전에 다음 사항을 확인해 주세요: * 문제가 이미 최신 릴리스에서 수정되었을 수도 있으니, SDK의 최신 버전을 사용하고 있는지 확인해 주세요. * 사용하려는 기능의 문서를 확인하여, 해당 기능이 예상대로 동작하도록 설계된 것인지 그리고 단순한 오해가 아닌지 확인해 주세요. * 문제가 씬 구성 방식 때문에 발생했을 가능성을 배제해 보세요. 팁은 [미리보기에서 디버그](/creator/content-creator-ko/sdk7/debugging/debug-in-preview.md) 및 [프로덕션에서 디버그](/creator/content-creator-ko/sdk7/debugging/debug-in-prod.md) 를 참고하세요. * 중복을 피하세요. 중복 신고를 방지하려면 [알려진 버그 목록](https://github.com/orgs/decentraland/projects/20/views/13) 을 확인해 주세요. 기존 이슈에 추가로 제공할 정보가 있다면, 새 이슈를 만들지 말고 해당 이슈에 댓글을 남겨 주세요. ## 버그 신고 SDK 관련 버그를 신고하려면 GitHub 계정이 필요합니다. 다음 단계를 따르세요: 1. 다음 링크를 방문하세요: [새 이슈 페이지](https://github.com/decentraland/sdk/issues/new/choose) 2. 클릭 **시작하기** 옆에 있는 **버그 신고**. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e570baea44fa2ebc22551edee413d515cc2e965d%2Freport-bug.png?alt=media) 3. 템플릿의 모든 필드를 작성해 주세요. 템플릿에는 각 섹션에 대한 안내가 포함되어 있습니다. 더 자세한 정보를 제공할수록 개발자가 문제를 더 빨리 식별하고 해결할 수 있습니다. 4. 클릭 **새 이슈 제출**. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fa14673bdfa946c4f579a941396e980e23ce3b77%2Fsubmit-issue.png?alt=media) 개발자는 설명이 더 필요하거나 추가 정보가 필요하면 티켓에 후속 질문을 할 수 있습니다. 버그 보고서 업데이트가 있으면 이메일 알림을 받게 됩니다. {% hint style="warning" %} **📔 참고**: SDK와 관련 없는 문제는 지원팀에 문의해 주세요. 문의하려면 이 페이지를 방문해 주세요 [intercom.decentraland.org](https://intercom.decentraland.org/) 또는 다음 주소로 이메일을 보내 주세요 . 또한 [Discord](https://decentraland.org/discord/). 팀은 월요일부터 일요일까지 UTC 기준 오후 12시부터 9시까지 도움을 드릴 수 있으며 가능한 한 빨리 답변드리기 위해 최선을 다할 것입니다. 위 시간대에는 Discord에서 60분 이내에, 이메일에는 24시간 이내에 답변을 받으실 수 있습니다. 또한 DAO 지원팀에는 다음에서 문의할 수 있습니다. [DAO Discord](https://discord.gg/bxHtcMxUs4). {% endhint %} **버그 보고 시 추가 팁:** * 버그마다 별도의 이슈를 생성하세요. 여러 문제가 발생했다면 각 문제마다 새 이슈를 생성해 주세요. * 장황한 설명은 피하세요. 필요한 경우에만 관련 명령줄 또는 콘솔 출력, 혹은 씬 코드를 포함하세요. * 가능하면 이미지나 동영상을 첨부해 주세요. 이슈 텍스트 영역에 쉽게 드래그 앤 드롭할 수 있으며, GitHub가 업로드와 연결을 처리합니다. ## Decentraland Playground 사용하기 문제를 보여 주는 코드 스니펫을 제공하는 것은 매우 유용합니다. 재현 가능성이 매우 중요합니다. 버그를 재현할 수 없다면 원인 파악과 수정이 어렵습니다. 이슈 텍스트에 코드 스니펫을 붙여넣을 수 있지만, 코드 스니펫을 제공하는 가장 좋은 방법은 [Decentraland Playground](https://playground.decentraland.org/). 다음 단계를 따르세요: 1. 왼쪽에 코드 스니펫을 작성하고, 오른쪽 패널에서 씬을 확인하세요. 2. 다음의 **공유** 버튼을 클릭한 다음 링크를 이슈 보고서에 붙여넣으세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27251378c6274dfa5888c63c4aa0e87d83bafd75%2Fplayground.png?alt=media) 플레이그라운드를 사용하면 이슈 재현이 간단해지고, 운영체제, SDK 버전, Node 버전 등에 관계없이 링크를 여는 모든 사람이 동일한 출력을 볼 수 있습니다. 또한 영향을 받는 조건을 빠르게 반복 확인하고 문제의 원인을 정확히 파악하는 데 도움이 됩니다. 문제를 재현할 수 있을 만큼만 유지하면서 예제는 최대한 간결하게 작성하세요. 더 단순한 예제는 문제의 원인에 대한 모호함을 줄여 줍니다. {% hint style="warning" %} **📔 참고**: 플레이그라운드에서는 씬에 에셋을 가져올 수 없습니다. 따라서 문제를 재현하려면 3D 모델이나 사운드 파일을 가져와야 하는 경우, 그곳에서는 표시할 수 없습니다. {% endhint %} ## 로그 가져오기 버그를 신고할 때 Decentraland 익스플로러의 로그를 확인하는 것이 종종 유용합니다. 로그를 가져오려면 채팅을 열고 `/logs`.를 입력하면 Decentraland 익스플로러 로그가 있는 새 창이 열립니다. 이슈 보고서에 `Player.log` 파일을 첨부해 주세요. ## 문서 편집 문서 웹사이트의 콘텐츠에서 문제를 발견하면 변경 요청을 제출할 수 있습니다. 페이지 맨 아래로 스크롤한 다음 **이 페이지 편집** 버튼을 클릭하세요. GitHub가 변경 사항으로 풀 리퀘스트를 만드는 과정을 안내합니다. 재단 팀이 변경 사항을 검토하고 유용하다고 판단되면 게시할 것입니다. ## 기능 요청 및 제안 문제를 신고하는 대신 새 기능이나 기능 추가에 대한 제안이 있다면 [Decentraland Discord 서버](https://dcl.gg/discord) 에 참여한 후 [Creator Hub 채널](https://discord.com/channels/417796904760639509/1288888172318560326) 에 메시지를 게시해 주세요. GitHub 이슈를 생성하지 마세요. --- # 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/sdk7/debugging/report-bug.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.