> For the complete documentation index, see [llms.txt](https://wiki.beartown.kr/beartown/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.beartown.kr/beartown/basic/accessories/music/sheet.md).

# 악보 작성

{% hint style="warning" %}
**이 페이지는 현재 업데이트 중인 내용을 다룹니다.**\
업데이트 상황에 따라 내용에 변동이 생길 수 있습니다.
{% endhint %}

하나의 악보는 최대 2분까지의 음악을 연주할 수 있습니다.

## 음계

<figure><img src="/files/bA1BbYThX0oSUpuKCWrf" alt=""><figcaption></figcaption></figure>

베어타운 음악 시스템에서 음계는 위와 같이 <mark style="color:green;">**0\~24**</mark> 사이의 숫자 또는 <mark style="color:green;">**F#\~F2#**</mark>의 기호로 표시돼요.\
악보에 숫자나 기호 등 문자를 적어 연주하고자 하는 음의 높이를 표현할 수 있어요.

문자를 <mark style="color:yellow;">**공백( )**</mark>으로 구분하여 차례대로 연주할 수 있어요.\ <mark style="color:blue;">예) 6 10 13</mark>

문자를 <mark style="color:yellow;">**더하기 기호(+)**</mark>로 구분하여 동시에 연주할 수 있어요.\ <mark style="color:blue;">예) 6+10+13</mark>

## 쉼표

<mark style="color:yellow;">**DL-(숫자)**</mark> 구문으로 숫자 부분에 적은 틱만큼 재생을 멈출 수 있어요.\
실제 악보에서의 쉼표와 같은 역할을 해요.\
이 구문은 다음에 나오는 재생 속도 구문에 영향을 받지 않아요.\ <mark style="color:blue;">예) 6 10 13 DL-20 11 5 8</mark>

## 재생 속도

베어타운 음악 시스템은 마인크래프트의 기본 시간 단위 1틱 단위까지 표현할 수 있어요.\
1틱은 서버가 완전히 쾌적한 상태일 때를 기준으로 1/20초, 즉 0.05초에 해당해요.

별다른 지시가 없는 경우 하나의 공백( )은 1틱 간격을 의미하고,\
아래의 구문을 통해 음악의 재생 속도를 지정하거나 변화시킬 수 있어요.

<mark style="color:yellow;">**TICKSET-(숫자)**</mark> 구문으로 공백의 길이를 입력한 숫자로 <mark style="color:green;">**지정**</mark>할 수 있어요.\
예)&#x20;

<mark style="color:yellow;">**TICKADD-(숫자)**</mark> 구문으로 공백의 길이에 입력한 숫자를 <mark style="color:green;">**더할(+)**</mark> 수 있어요.\
예)&#x20;

<mark style="color:yellow;">**TICKSUB-(숫자)**</mark> 구문으로 공백의 길이에서 입력한 숫자를 <mark style="color:green;">**뺄(-)**</mark> 수 있어요.\
예)

<mark style="color:yellow;">**TICKMUL-(숫자)**</mark> 구문으로 공백의 길이에 입력한 숫자를 <mark style="color:green;">**곱할(×)**</mark> 수 있어요.\
예)

<mark style="color:yellow;">**TICKDIV-(숫자)**</mark> 구문으로 공백의 길이를 입력한 숫자로 <mark style="color:green;">**나눌(÷)**</mark> 수 있어요.\
예)

## 구간 반복

<mark style="color:yellow;">**LOOP-(숫자)**</mark> 및 <mark style="color:yellow;">**END**</mark> 구문으로 특정 부분을 반복하여 연주할 수 있어요.\
실제 악보에서의 도돌이표와 같은 역할을 해요.\ <mark style="color:blue;">예) LOOP-2 6 10 13 END 18</mark>\ <mark style="color:red;">잘못된 예1) LOOP 6 10 13 END</mark> - LOOP- 뒤 횟수가 쓰이지 않았어요.\ <mark style="color:red;">잘못된 예2) LOOP-2 6 10 13</mark> - END가 쓰이지 않았어요.

## 가져오기

다른 악보의 내용을 다음 구문으로 간편하게 가져올 수도 있어요.

<mark style="color:yellow;">**IMPORT-(악보이름)**</mark> 구문으로, 현재 악보에서 재생하던 것을 잠시 중단하고 다른 악보의 내용을 재생할 수 있어요.\
예) 6 10 13 IMPORT-TEST 18

<mark style="color:yellow;">**SYNC-(악보이름)**</mark> 구문으로, 현재 악보와 동시에 다른 악보의 내용을 재생할 수 있어요.\
예) 6 10 13 SYNC-TEST 18

## 기타 구문

소리를 재생하는 일반 구문과 달리 화면에 문구를 띄우거나 입자를 발생시키는 구문도 입력할 수 있어요.

<mark style="color:yellow;">**TITLE-(문구)-(지속시간)**</mark> 구문으로 연주자의 화면에 일정 틱 동안 문구를 표시할 수 있어요.\
문구 내에서 띄어쓰기는 <mark style="color:yellow;">**밑줄(\_)**</mark>로 표현할 수 있어요.\
예)&#x20;

VIP 유저에 한하여 <mark style="color:yellow;">**(파티클명)-(개수)-(속도)**</mark> 구문으로 입자를 발생시킬 수 있어요. \
파티클명은 [이 링크](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html)의 *Enum Constant Summary* 문단에서 확인할 수 있어요.\
개수는 최대 20개, 속도는 0.5\~2.0 사이로 지정할 수 있어요.\
서버 상태에 따라 기능 자체가 비활성화되거나 파티클 개수에 추가로 제한이 걸릴 수 있어요.\ <mark style="color:red;">**이 기능을 이용해 고의로 랙을 유발해서는 안 돼요!**</mark>\
예)&#x20;


---

# 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://wiki.beartown.kr/beartown/basic/accessories/music/sheet.md?ask=<question>&goal=<endgoal>
```

`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.