# 허드 추가/제거

### addHud

허드를 만들고, 해당 허드를 반환합니다

`function addHud(p: entity, id: string, location: vector, scale: vector, object: object, aligned: textalignment=center aligned, textaligned: textalignment=left aligned):: entity`

#### p: 허드를 나타낼 대상을 의미합니다

플레이어 또는 플레이어가 아닌 엔티티가 들어갈 수 있습니다

플레이어가 아닌 엔티티의 경우에는 그 엔티티를 볼 수 있는 모든 플레이어에게 허드가 표시됩니다

#### id: 허드를 구분하는 string입니다. 이미 같은 id의 허드가 있을경우 그 허드를 덮어씌웁니다

#### location: 허드가 표시되는 위치입니다

x,y는 좌표, z는 레이어를 의미합니다. 레이어값이 클수록 앞에 표시됩니다

왼쪽 상단 좌표가 (0,0), 오른쪽 하단 좌표가 (1920,1080)입니다

<figure><img src="https://2580338160-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKuhi8aSwWgM2WuG3xVEN%2Fuploads%2F4kJh6964Y3grDReahfg5%2F11.png?alt=media&#x26;token=b7d86aad-030f-4c70-ad83-f28ee200b7ee" alt=""><figcaption></figcaption></figure>

허드의 왼쪽 상단 좌표가 기준이 됩니다

16:9비율이 아닌 모니터에 대해서는 aligned 매개변수를 확인하세요

#### scale: 허드의 크기입니다

허드가 화면에 보이지 않는다면 x,y값이 너무 작지는 않은지 확인하세요

z는 대부분의 상황에서 1로 고정해도 무방합니다

#### object: 허드의 형태입니다

아이템 또는 string이 들어갑니다

#### aligned: 허드의 정렬 방식입니다

기본 값은 center aligned이고, 정렬을 하지 않으려면 인수에 {\_}를 넣으세요

<figure><img src="https://2580338160-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKuhi8aSwWgM2WuG3xVEN%2Fuploads%2FBjx8F5fM8rBWFRJbGlyA%2F22.png?alt=media&#x26;token=52779f50-ada8-4d1a-96d8-3fefb4c5fd85" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2580338160-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKuhi8aSwWgM2WuG3xVEN%2Fuploads%2FQwDwWH6J7kiXtXD2D4ih%2FHoneycam%202025-11-11%2002-53-18.gif?alt=media&#x26;token=77aa2031-06db-4477-b4dd-da4684aaa82e" alt=""><figcaption></figcaption></figure>

#### textaligned: object가 string일때, 해당 텍스트 디스플레이의 정렬 방식입니다

### removeHud

```c
function removeHud(p: entity, ids: strings)
function removeHud(e: entities)
```

#### p: 허드를 제거할 대상을 의미합니다

#### ids: 제거할 허드들의 id들을 의미합니다

### clearHuds

```c
function clearHuds(p: entity)
```

#### p: 모든 허드를 제거할 대상을 의미합니다

### dismount event

엔티티가 죽을때를 포함해서 호출되는 dismount 이벤트에서 해당 엔티티의 허드를 자동적으로 제거합니다

### join event

접속시 다른 플레이어의 허드를 hide하여 안보이게 합니다