매크로

2024년 06월 05일 07:47

매크로 은 자주 반복되는 명령어에 대한 사용자 정의 단축키입니다. 예를 들어, 캐릭터가 전투의 함성을 지르고 자주 사용되는 공격을 자동으로 수행하는 매크로를 만들 수 있습니다. 게임 플레이 중 반복적인 타이핑 대신 하나의 짧은 명령어를 사용할 수 있습니다.

빠른 액세스를 위해 이러한 명령을 빠른 바또는 토큰 동작에 추가할 수 있습니다.

매크로 생성 및 편집

"컬렉션" 탭으로 이동하려면 사이드바에 있는 작은 점이 그려진 이미지 아래에 있습니다. 매크로를 입력하려면 먼저 명령을 호출할 이름을 입력합니다. 예시: "test". 그런 다음 오른쪽에 명령을 입력합니다. 입력된 텍스트, 롤, 이모티콘이 될 수 있습니다. 이 정보 뒤에 'Enter'를 눌러 명령을 저장합니다.

매크로를 호출하려면#과 명령어(예:#test)를 입력한 후 Enter 키를 누릅니다.

자동 완성

일부 텍스트 영역은 매크로 호출("#" 사용),속성 호출("@" 사용),능력 호출("%" 사용)의 자동 완성을 지원합니다.

매크로(매크로 편집 창의 매크로)와 어빌리티(속성 & 어빌리티 탭)의 '액션' 텍스트 영역은 매크로 및 어트리뷰트 호출의 자동 완성을 지원합니다. 문자 채팅()은 매크로 및 어빌리티 호출의 자동 완성을 지원합니다.

자동 완성 목록을 트리거하려면 #, @ 또는 %와 문자 또는 숫자의 시퀀스를 입력하세요. 자동 완성 목록에는 해당 시퀀스를 포함하는 매크로, 속성 또는 능력이 표시됩니다.

컬렉션 탭에서 볼 수 있는 매크로만 자동 완성 목록에 표시됩니다. 마찬가지로, 제어 권한이 있는캐릭터()에 속한 속성(또는 능력)만 자동 완성 목록에 표시됩니다.

팁

키보드의 위쪽 및 아래쪽 방향키와 Enter 키를 사용하여 자동 완성 목록의 항목을 탐색하고 선택할 수 있습니다.

예를 들어, '지능'이라는 속성을 포함하는 캐릭터를 제어할 수 있는 권한이 있다면, 편집 매크로 창의 '작업' 텍스트 영역에 '@int'를 입력할 수 있습니다. 이렇게 하면 해당 속성을 포함하는 자동 완성 목록이 표시됩니다.

팁

캐릭터 시트에서 굴린 후 채팅 창에서 위쪽 화살표를 누르면 사용된 코드가 표시됩니다. 이를 통해 여러 굴림을 편리한 버튼으로 결합할 수 있습니다.

다중 명령

매크로 시스템의 강점 중 하나는 한 번의 명령으로 여러 작업을 실행할 수 있다는 점입니다. 이를 위해 각 항목을 개별 라인에 넣고 매크로를 실행할 때 순서대로 작업이 실행됩니다.

예시

예를 들어, 이모티콘과 공격 및 피해 굴림을 포함하는 매크로를 만들고 싶다면, 매크로는 다음과 같이 보일 것입니다.

매크로 이름:
dagger

매크로 본문:

/단검을 휘둘러
/굴려 1d20+10 대 AC
/굴려 1d4+9 피해

그런 다음 "#단검"을 입력하기만 하면 전체 스크립트가 실행되어 다음과 같이 표시됩니다:

예를 들어 매크로에는 명령줄과 비명령줄이 혼합되어 포함될 수도 있습니다:

#로프
/나는 모라딘의 힘을 부릅니다!
내가 너를 때린다!
/1d20+4 대 반사
/굴려 1d8+4 피해

이렇게 하면 먼저 이모티콘을 보낸 다음 "내가 당신을 때려눕혔어요!"를 채팅에 보낸 다음 두 개의 롤을 만듭니다.

매크로 중첩

매크로를 서로 중첩할 수 있으므로 매크로를 결합하여 한 번의 동작으로 여러 개의 매크로를 호출할 수 있습니다. 매크로를 중첩하려면 매크로 내부의 자체 줄에 호출하려는 매크로의 이름을 포함하기만 하면 됩니다.

예시

이 예제에서는 세 개의 매크로가 있습니다:#피해#공격및#둘 다

매크로 #대미지 = /롤 1d4+11
매크로 #공격 = /롤 1d20+9
매크로 #양쪽 모두 =
#공격
#대미지

굴림 쿼리에 중첩하기

롤 쿼리에서 매크로를 중첩하는 경우 매크로 이름이 제대로 인식되도록 매크로 이름 뒤에 공백이 있는지 확인하세요.

?{어떤 매크로?|공격,#사용-검 |방어,#사용-방패 }

문제 해결

연산 순서로 인해, 주사위 굴리기 쿼리 내에 중첩된 매크로 호출은 전체 쿼리가 실행되기 전에 완전히 확장됩니다. 이는 굴림 쿼리에 중첩된 매크로에 '문제가 있는 문자'가 포함되어 있으면 (예: '}', ',', '|') 해당 매크로가 전체 쿼리를 망칠 수 있다는 것을 의미합니다. 이유는 쿼리가 참조된 매크로의 문제가 있는 문자를 원래 구문의 일부로 취급하기 때문입니다.

이 경우 문제가 있는 문자를 (호출된 매크로 자체 내에서) 제거하거나 HTML 엔티티로 대체해야 할 수 있습니다.

HTML 엔티티 교체가 포함된 매크로는 더 이상 롤 쿼리 외부에서 작동하지 않을 수 있습니다. 은능력으로 저장해야 합니다.

컬렉션 매크로를 다시 열면 HTML 엔티티가 되돌릴 수 있으며, 해당 매크로가 저장된 경우 이러한 되돌림도 함께 적용됩니다. 이 동작은어빌리티에 존재하지 않습니다.

중첩 능력

능력은 특정 캐릭터에만 해당하는 매크로로, 저널 탭에서 찾을 수 있는 캐릭터 시트에서 생성됩니다. 매크로와 마찬가지로 능력은 서로 중첩될 수 있으며, 여러 능력을 연결하고 단일 작업으로 여러 능력을 호출할 수 있습니다.

어빌리티 중첩은 매크로 중첩과 비슷하지만 약간의 차이가 있습니다. 매크로처럼 호출하려는 어빌리티의 이름을 호출 어빌리티 내부의 자체 줄에 포함하기만 하면 됩니다. 또한 숫자 기호(#)를 백분율 기호(%)로 변경한 다음 능력명 앞에 세로 파이프(|)를 사용하여 캐릭터의 이름을 넣어 구분해야 합니다.

세로 파이프 키는 대부분의 키보드에서 백슬래시 키(\) 위에 있습니다. 이 키는 일반적으로 미국 키보드의 경우 엔터 키 근처에, 유럽 키보드의 경우 숫자 행에 있습니다.

Note

현재 어빌리티 참조 기호(%)는 속성 참조 기호(@)나 매크로 참조 기호(#)처럼 자동 완성되지 않습니다. 수동으로 전체 명령을 입력해야 합니다.

예시

이 예제에서는 세 가지 어빌리티(%damage%attack및%both)와 캐릭터의 이름(Bugbear)을 사용합니다.

능력%damage = /롤 1d4+11
능력%attack = /롤 1d20+9
능력%both =
%{Bugbear|attack}
%{Bugbear|damage}

더 많은 예제

다음은 몇 가지 시스템별 예시입니다:

DnD 5e/다음 매크로

패스파인더 매크로

능력 명령 버튼

어빌리티 명령 버튼을 사용하여 텍스트 채팅의 클릭 가능한 버튼에서어빌리티(또는 시트 버튼 롤)을 호출할 수 있습니다. They are very closely related to Mods (API) Command Buttons.

구문은 다음과 같습니다:

[라벨](~<keyword>|<ability name>)

속성과능력호출과 마찬가지로,키워드은선택된,대상또는 character_name의 선택입니다. character_id를 키워드로 사용할 수도 있습니다.

능력 명령 버튼이 캐릭터 창의 탭 중 하나에 저장되어 있는 경우 키워드를 생략할 수 있습니다:

[라벨](~<ability name>)

능력예시를 계속해서, Bob the Slayer는 다른 능력 중 하나에[Swing Axe!!](~Massive Axe) 를 삽입하여 적들을 더 쉽게 베어낼 수 있습니다.

속성 매크로

속성 매크로는 위에서 언급한 예제들을 결합합니다. 캐릭터에 할당된 속성을 변수 수정자로 활용하여 캐릭터를 기반으로 복잡한 매크로를 생성할 수 있습니다. 매크로의 변수는 캐릭터 속성에 연결되어 있으므로 캐릭터 편집기에서 수행한 변경 사항은 값이 자동으로 업데이트됩니다.

매크로로 선택한 토큰 사용하기

선택한 키워드를 사용하여 실행할 때 현재 선택된 화면 요소에서 정보를 추출할 수 있습니다. 예를 들어, 토큰의 Bar 1 값을 굴릴 때 선택한 토큰에서 값을 추출하려면 다음과 같이 작성할 수 있습니다:

/roll 1d20 + @{selected|bar1}

"bar1", "bar2" 또는 "bar3"을 사용할 수 있습니다. 또한 해당 토큰에 연결된 캐릭터에서 속성을 추출할 수 있습니다:

/roll 1d20 + @{selected|Intelligence}

현재 선택된 토큰의 이름을 "token_name" 변수를 사용하여 추출할 수 있습니다:

/em @{selected|token_name} 총을 발사합니다!

선택한 토큰에 캐릭터 일지가 연결되어 있는 경우 "character_name" 변수를 사용하는 대신 캐릭터 일지에서 이름을 추출할 수 있습니다:

/em @{selected|character_name} 방패로 막으세요!

능력을 변수로 사용하여 연결된 캐릭터 일지에서 능력을 실행할 수 있습니다:

>{selected|Attack}

마지막으로, 변수에 대한 3번째 인수를 도입하여 바 또는 속성의 "최대 값"을 추출할 수 있습니다:

/롤 1D20 + @{Guard|Intelligence|max}
/롤 1D20 + @{selected|bar2|max}

캐릭터, 속성 및 능력을 포함한 모든 이름은 사용할 때 대소문자를 구분하지 않습니다. 이는 "GUARD" 및 "guard" 모두 "Guard"라는 캐릭터와 일치합니다.

Note

캐릭터의 완전한 속성 목록을 찾으려면 해당 캐릭터 시트로 이동하여 탭 "Attributes & Abilities"를 클릭할 수 있습니다. 매크로에서 사용되는 자체 속성 ft h를 클릭하여 손쉽게 추가할 수 있습니다.

속성 및 캐릭터 시트

캐릭터 시트에는 커스텀 매크로에서 참조할 수 있는 수많은 속성이 소개되어 있습니다. 알아야 할 하나의 것은 Auto-Calc Formula Attribute입니다. 캐릭터 시트에는 종종 다른 속성을 포함한 공식을 기반으로 한 계산된 속성이 있습니다. 해당 속성을 참조하면 값 대신 수식이 표시됩니다.

{selected|character_name} @{selected|action_points} 포인트가 남았습니다.

롤프의 남은 포인트는 ((ceiling(((13+0)+(14+0))/12)+0)+0) 포인트입니다.

이 문제를 해결하려면 속성 참조를 인라인 롤로 래핑해야 합니다:

{selected|character_name} 에 [[@{selected|action_points}]] 포인트가 남았습니다.

롤프에게 3점이 남았습니다.

매크로로 타깃팅된 토큰 사용

선택된 토큰에서 정보를 검색하는 데 사용되는 "selected" 키워드와 유사하게, "target" 키워드는 대상 토큰의 변수 및 능력에 액세스할 수 있게 합니다. 이 명령은 플레이어가 일반적으로 선택할 수 없는 토큰에서 선택할 수 있도록 해주어 적에 대해 굴리기에 유용합니다. 예를 들어, 플레이어에게 "지능" 속성을 가진 대상에 대해 1d20을 굴리라고 지시하는 경우 굴림은 다음과 같이 나타납니다:

/roll 1d20 - @{target|intelligence}

그러면 플레이어가 어떤 토큰을 굴릴지 선택할 수 있는 프롬프트 화면이 나타납니다:

선택한 키워드와 유사하게 대상 키워드를 사용하며 두 가지 주요 차이점이 있습니다. 첫째로, "대상" 키워드는 플레이어가 제어하지 않는 토큰의 값을 활용할 수 있습니다. 둘째로, 속성의 "max" 부분을 참조하는 구문은 약간 다릅니다. 자세한 구문에 대한 자세한 내용은 아래의 고급 사용 부분을 참조하십시오.

타깃팅된 속성 호출에 대한 고급 사용법

대상 변수의 전체 구문은 다음과 같습니다:

@{target|<target_name>|<attribute_name>|<optional_flags>}

('target_name'은 원하는 대로 입력할 수 있으며 공백을 포함할 수 있습니다).

따라서 매크로에 여러 개의 대상을 포함시키고 싶다면 그렇게 할 수 있습니다:

{target|Target1|HP} vs @{target|Target2|AC}

속성의 최대값을 사용하려면:

{target|Target1|HP|max}

속성의 "max"를 사용하려면 위에서처럼 "target1"만 입력하더라도 반드시 속성 이름을 지정해야 함에 유의하십시오.

또한 여러 속성 쿼리에 동일한 target_name을 사용하는 경우 한 번만 메시지가 표시되며 동일한 토큰이 모든 속성 쿼리를 이행하는 데 사용됩니다. 이는 여러 줄의 매크로나 명령어가 있는 경우에도 적용됩니다:

/{target|foe|character_name}!
**명중**: [[1d20+3]] 대 @{target|foe|npc_AC} AC

반복 속성 참조

행 인덱스 기준

반복 행의 속성은 RowIndex로 참조할 수 있습니다. 속성의RowIndex 은 0에서 시작합니다(인덱스는 위쪽으로부터의 오프셋을 의미), 따라서 첫 번째 행은 $0, 두 번째 행은 $1, 세 번째 행은 $2 등을 사용합니다.

반복되는 섹션의 이름이 아이템인 경우, 다음 구문을 사용하여 캐릭터의 두 번째 아이템에 대한 아이템 보너스 속성에 액세스할 수 있습니다:

{selected|repeating_items_$1_itembonus}

참고:

RowID 기준

RowID를 사용하여 속성을 참조할 수도 있습니다. RowID를 사용하면 행의 삭제 또는 재정렬로 인한 순서 변경의 영향을 받지 않는다는 이점이 있습니다. RowID(문자 시트 작성자가 어떤 식으로든 제공하지 않은 경우)를 얻으려면 시트의 소스를 확인해야 합니다. data-reprowid라는 속성을 가진 태그를 찾을 때까지 HTML에서 위쪽으로 추적합니다. 이 속성의 값은RowID입니다:

<div class="repitem" data-reprowid="-KC0zCLum1Rq3V5wssyE">

그런 다음RowIndex대신RowID를 사용합니다:

{selected|repeating_items_-KC0zCLum1Rq3V5wssyE_itembonus}

주사위 굴리기 옵션

주사위 굴리기 옵션은 굴림 결과와 함께 수행할 특수 동작을 나타내는 플래그입니다.

이니셔티브를 위한 롤링

토큰 또는 이니셔티브를 선택하여 굴린 결과를 직접 턴 추적기로 보내려면 다음 굴림 옵션을 매크로에 포함하세요.

/roll 1d20 + 5 &{tracker}

Roll20의 "tracker" 주사위 굴리기 옵션은 굴림 결과를 표시하고 그 값을 턴 추적기에 사용합니다. 선택한 토큰이 턴 순서에 없으면 새로운 토큰이 추가됩니다. 이미 턴이 있는 경우, 새로운 값으로 업데이트됩니다.

또한 다음 플래그를 사용하여 선택한 토큰의 현재 턴 값에서 주사위 굴림 결과를 더하거나 뺄 수 있습니다:

/1d20 + 5 &{tracker:+}
/roll 1d20 + 5 &{tracker:-}

섀도우런과 같이 매 턴마다 현재 이니셔티브에서 10을 빼고 싶은 게임의 경우, 다음과 같은 글로벌 매크로를 사용할 수 있습니다:

/me @{selected|token_name} 차례가 끝납니다. [[10 &{tracker:-}]]

노트: 추적기 플래그는 일반 롤과 인라인 롤에서 모두 작동합니다.

이 구문을 사용하여 속성과 동일한 방식으로 이러한 값을 참조할 수도 있습니다: @{tracker|Item Name}

오류 메시지 억제

"noerror" 롤 옵션은 롤에서 발생하는 모든 오류(변수를 찾을 수 없는 오류 등)를 억제합니다.

/roll 1d20 + @{selected|nonexistent_attribute} &{noerror}

매크로와 함께 변수 사용하기

실행 시 지정한 매크로와 함께 변수를 포함하는 가장 쉬운 방법은 롤 쿼리을 사용하는 것입니다. 예를 들어, 롤에 변수 수정자를 추가하려면 다음과 같은 매크로를 만들 수 있습니다:

/roll 2d20 + ?{Modifier|0}

매크로가 실행되면 수정자를 포함할지 묻는 프롬프트가 나타납니다. 만약 수정자가 지정되지 않은 경우, 쿼리의 "|0" 부분은 기본값으로 0을 사용하도록 지정합니다.

굴림 쿼리에 대한 자세한 정보는 다이스 참조에서 확인할 수 있습니다.

채팅에서 변수 지정

매크로 롤에 변수 수정자를 사용하려면, 매크로 명령을 수정자로 끝내고 매크로를 호출할 때 지정하면 됩니다.

예를 들어: 1d20+x (여기서 x는 내 변수 값)에 대한 매크로가 필요한 경우 다음 매크로를 만들 수 있습니다.

#d20 /roll 1d20+

매크로를 실행할 때 다음을 입력하세요:

#d204

이 매크로는 결과 /roll 1d20+4를 생성합니다.

롤 쿼리에 대한 드롭다운 프롬프트

플레이어에게 제시될 수 있는 옵션 목록을 지정할 수 있습니다. 자유 형식 텍스트 필드만이 아니라.

다음은 구문입니다:

?{Name of Query|Option1|Option2|Option3|Option4|Option5}

라벨 외에도 다른 결과 값도 지정할 수 있습니다.

?{Name of Query|Label 1, value1|Label 2, value2}

Examples

특수 공격:

... + [[ ?{Sneak Attack?|No, 0|Yes, 3d6} ]] + ?{Power Attack?|No, 0|Yes, 6 [Power Attack!]}

D&D 5e Attack Roll:

[[ ?{공격 유형|표준, 1d20|우위, 2d20kh1|불리, 2d20kl1} ]]

치료 주문:

?{주문|
   경미한 상처 치료, **경미한 상처 치료** 대상은 [[1d8+5]] 체력을 회복합니다. | 
   보통 큰 상처 치료, **보통 큰 상처 치료** 대상은 [[2d8+8]] 체력을 회복합니다. | 
   심각한 상처 치료, **심각한 상처 치료** 대상은 [[3d8+8]] 체력을 회복합니다.
}

예시 (중첩된 주사위 질의)

?{질의 이름|
   라벨 1, ?{값1|
      라벨 1A, 값1A |
      라벨 1B, 값1B 
   } |
   
   라벨 2, ?{value2|value2} 
}

HTML 엔티티를 "스택"하여 중첩 수준을 더욱 높일 수 있습니다:

캐릭터	대체
&	&

예시

?{Name of Query|
   Label 1, ?{value1|
      Label 1A, ?{value1A&#124;
         Label 1Ai&#44; value1Ai &#124;
         Label 1Aii&#44; value1Aii
      &#125; |
      
      Label 1B, ?{value1B&#124;
         Label 1Bi&#44; value1Bi &#124;
         Label 1Bii&#44; value1Bii
      &#125;
   } |

   Label 2, ?{value2|value2} 
}

Macro Bar

화면 하단에 나타나는 막대에 나타낼 수 있는 모든 매크로의 빠른 액세스 버튼을 만들 수 있습니다. 먼저 매크로를 평소대로 만드세요. 매크로 빠른 액세스 바를 사용하려면 설정 메뉴에서 "매크로 빠른 액세스 바 표시"를 선택하세요.

매크로를 막대에 추가하려면 매크로 이름 옆의 "막대에 추가" 옵션을 선택하세요. If you have forgotten to turn the macro quick bar on, toggling on a macro will auto-enable the quick bar to display.

빠른 액세스 바와 선택한 매크로가 이제 캐릭터 초상화 아래 화면 하단에 표시됩니다. 버튼을 재배열하려면 버튼 위에 마우스를 올리고 나타나는 핸들을 사용하여 드래그하십시오. 버튼을 재조직하려면 핸들을 클릭하거나 드래그하여 제거하십시오.

Shift+Clicking on a Macro in the macro quick bar will open the editor for that specific macro.

Macro Menu

플레이어 또는 GM으로서 매크로 버튼을매크로 퀵바 에서 마우스 오른쪽 버튼을 클릭하여 매크로가 표시되는 방식에 영향을 주는 몇 가지 간단한 기능에 액세스 할 수 있는 구성 메뉴가 표시됩니다.

Rename

Select the Rename entry to bring up a dialog prompting you for a new name to display for the macro. This is particularly useful for macros created by dragging buttons out of character sheets.

Color

Select the Color entry to bring up a color picker. This allows you to change the background color of the Macro Button to make it easier to pick out your different buttons visually. 선택한 배경색과 대비를 유지하기 위해 버튼 텍스트의 색상이 변경됩니다.

롤 테이블

매크로에서 롤 테이블 을 사용할 수 있습니다. GM은 매크로에서 사용할 수 있도록 롤 테이블을 생성하고 플레이어에게 보이도록 해야 합니다.

주사위 굴리기 템플릿 사용하기

캐릭터 시트를 사용할 때 매크로나 능력에서 주사위 굴리기 템플릿을 사용하려면 굴리기 버튼을 클릭하거나 시트 굴리기를 호출하십시오. 시트 작성자가 이미 미리 설정해 두었으므로 추가 작업이 필요하지 않습니다.

사용자 정의 매크로 또는 사용자 정의 템플릿에서 롤 템플릿을 사용하려면 계속 읽어보세요.

굴리기 템플릿 사용하기는 간단합니다. 채팅 메시지에 굴리기 템플릿 사용을 나타내는 플래그를 포함하고 원하는 데이터를 제공하십시오. 다음은 시스템이나 캐릭터 시트에 관계없이 모든 게임에서 사용 가능한 기본 템플릿을 사용한 예제입니다.

&{template:default} {{name=테스트 공격}} {{attack=[[1d20]]}} {{damage=[[2d6]]}}

The &{template:<template_name>} 지정된 이름과 함께 사용할 롤 템플릿을 지정합니다. 그런 다음 템플릿에 대한 모든 데이터를 {{<propertyname>= <value>}} 형식으로 제공하면 됩니다. 사용해야 하는 "propertyname"은 템플릿에 따라 다릅니다. 캐릭터 시트 문서에서 사용 가능한 항목을 확인할 수 있으며, 내장된 템플릿에 대한 문서도 제공되었습니다. "값"은 텍스트 또는 인라인 롤(매크로, 능력 등 포함)일 수 있습니다. 매크로 또는 능력을 사용하는 경우 "/roll" 명령이 아닌 인라인 롤을 사용해야 합니다.

다음은 "%{Character|attack}" 능력을 사용하는 예입니다.

&{template:default} {{name=능력을 가진 테스트}} {{attack= %{Character_Name|attack} }} {{damage= #damagemacro }}

언제 굴림 템플릿을 사용할 수 있나요?

일반 메시지( "/desc" 또는 "/emote"와 같은 명령 없이)와 귓속말에서 굴림 템플릿을 사용할 수 있습니다. "/roll" 명령어로 굴림 템플릿을 사용할 수 없습니다. 대신, 굴림 템플릿은 인라인 굴림과 함께 사용하도록 되어 있습니다. 인라인 굴림을 사용하는 한, 매크로, 캐릭터 능력 및 시트 작성자는 굴림 버튼 내에서 굴림 템플릿을 사용할 수 있습니다.