> 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). # 버그 신고 버그가 검토되고 수정될 수 있도록 신고하는 방법 Creator Hub의 Decentraland SDK와 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\&token=ffa85157-31ad-401f-9165-f3f2e254d818) 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\&token=51b8197d-55b5-4512-99fc-db28ee27d001) 개발자는 설명이 더 필요하거나 추가 정보가 필요하면 티켓에 후속 질문을 할 수 있습니다. 버그 보고 업데이트에 대한 이메일 알림을 받게 됩니다. {% 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\&token=b58f4ce6-c1aa-4bce-8f58-e4903592f2e2) 플레이그라운드를 사용하면 이슈 재현이 간단해지고, 운영체제, SDK 버전, Node 버전 등에 관계없이 링크를 여는 모든 사람이 같은 출력을 볼 수 있습니다. 또한 영향을 받는 조건을 빠르게 반복 확인하고 문제의 원인을 정확히 파악하는 데 도움이 됩니다. 문제를 재현할 수 있을 만큼만 예제를 가능한 한 간결하게 유지하세요. 더 단순한 예제는 문제의 출처에 대한 모호함을 줄이는 데 도움이 됩니다. {% hint style="warning" %} **📔 참고**: Playground에서는 씬에 에셋을 가져올 수 없습니다. 따라서 문제를 재현하려면 3D 모델이나 사운드 파일을 가져와야 하는 경우, 거기에서는 표시할 수 없습니다. {% endhint %} ## 로그 가져오기 버그를 신고할 때는 Decentraland Explorer의 로그를 확인하는 것이 종종 유용합니다. 로그를 가져오려면 채팅을 열고 다음을 입력하세요 `/logs`. 그러면 Decentraland Explorer의 로그가 있는 새 창이 열립니다. 다음 파일을 이슈 보고에 첨부하세요: `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 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/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 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.