> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wuwa.moe/llms.txt
> Use this file to discover all available pages before exploring further.

# 기여 가이드라인

핀을 등록할 때 어떤 기준으로 등록해야 하는지 정리한 페이지예요.

***

## 어떤 핀을 등록하나요?

<CardGroup cols={2}>
  <Card title="등록하는 것" icon="check" color="#16a34a">
    * 별의 소리를 획득할 수 있는 것
    * 업적을 달성할 수 있는 것
    * 예외적으로 공유할 가치가 있는 것
  </Card>

  <Card title="등록하지 않는 것" icon="xmark" color="#dc2626">
    * 매일 리젠되는 상자나 오브젝트
    * 자동으로 획득되는 보상
    * 별의 소리가 없어 공유 가치가 낮은 것
  </Card>
</CardGroup>

<Note>
  핵심 기준은 **"별의 소리 또는 업적을 얻을 수 있는가?"** 예요.
  매일 리젠되는 것은 대부분 별의 소리가 없기 때문에 등록하지 않아요.
  텔레포트 요소나 지역별 수집요소처럼 별도 카테고리가 존재하는 것은 예외적으로 등록 대상이에요.
</Note>

***

## 카테고리 분류 기준

등록할 때 카테고리를 올바르게 선택하는 것이 중요해요.

| 조건                     | 카테고리     |
| ---------------------- | -------- |
| 보상이 보물상자               | **보물상자** |
| 보물상자는 아니지만 별의 소리 획득 가능 | **보상요소** |
| 지역 임무                  | **지역임무** |
| 위에 해당하지 않는 경우 (업적 등)   | **기타요소** |

<Tip>
  위에서 아래로 순서대로 판단하면 돼요. 가장 먼저 해당하는 카테고리를 선택해주세요.
</Tip>

***

## 도전 핀

도전은 시작 지점과 보상 획득 지점이 다른 기믹을 통칭해요.
도전에 성공하면 보상을 받을 수 있어요.

### 기본 원칙

도전 핀은 **시작 지점**에 등록해요.
보상 위치가 아닌 시작 위치에 남기는 이유는, 도전을 시작해야 보상을 얻을 수 있기 때문이에요.

### 예외: 인게임 지도에 시작점이 표시되는 경우

라하이 로이 이후 지역에 등장하는 일부 도전(공중 기계 건설 트랙, 호크아이 드론 등)은 인게임 지도에 시작 지점이 직접 표시돼요.
이 경우에는 시작 지점을 이미 알 수 있으므로, **보상(상자) 위치**에 핀을 남겨요.

***

## 좌표가 동기화되지 않는 공간

소노라처럼 인게임 지도에 좌표가 동기화되지 않는 실내 공간이 있어요.
이 경우 해당 공간의 **진입점**에 핀을 일렬로 배치하는 것을 원칙으로 해요.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/wuma/images/sonora-pins-example.png" alt="소노라 진입점에 핀을 일렬로 배치한 예시" />
</Frame>

***

## 카테고리 추가 요청

아래에 해당하지만 카테고리가 아직 없는 경우, 추가 요청을 할 수 있어요.

* 지역별 고유 수집요소 (사운드박스, 마지막 녹음 테이프 등)
* 지역별 텔레포트 가능 요소 (메카스카우트, 보이드매터 필드 등)

요청 채널:

* [명조 맵스 채널 (아카라이브)](https://arca.live/b/wuwamaps)
* [카카오톡 1:1 오픈채팅](https://open.kakao.com/o/swRaXY2g)