roll20 여러 토큰의 레이어를 한번에 변경하는 매크로(API사용)

2020. 1. 23. 00:21

세션을 진행하다보면 한번에 여러가지 토큰의 레이어를 변경해야할 때가 있습니다. 동시공개되는 핸드아웃이나 맵이나 토큰 등이 있지요.

세팅할 때 조금 번거롭긴 하지만 이 매크로를 사용하면 세션 중에 매크로를 작동시키는 것으로 간편하게 토큰의 공개여부를 변경할 수 있습니다.

해당 매크로는 TokenMod라는 API를 사용합니다. API를 사용하기 위해서는 GM이 Pro계정을 사용하고 있어야합니다.

+API는 방을 복사할 때 같이 복사가 안 되므로 방을 복사하신 경우 반드시 API를 다시 추가해주세요.
다행히도 토큰 id는 그대로 복사되므로 다른 부분은 건드릴 필요가 없습니다.

1. API설치

API의 설치방법에 대해서는 이 게시글 (배경음/효과음매크로)을 참고해주세요.

이 API는 이 게시글 (마소차지용 토큰 배포글)과 이 게시글(배경변경용 매크로)에서도 사용하고 있습니다. 참고 삼아 읽어보셔도 좋습니다.

맵의 원하는 위치에 토큰을 배치합니다.

이 매크로는 토큰의 아이디를 입력해주어야 합니다.

그럼 토큰의 아이디를 확인하기 위해 다음의 명령어를 채팅창에 입력해주세요.

@{target|token_id}

그러면 화면의 위쪽에 다음과 같은 안내메세지가 뜹니다. 그럼 맵 위에서 원하는 토큰을 클릭합시다.

그럼 채팅창에 다음과 같이 방금 클릭한 토큰의 ID가 뜹니다.
+ 혹시 다른 사람들에게 보이는게 신경쓰인다면 앞에 /w gm 명령어를 입력해주시면 귓말로 옵니다.

세션 중 원하는 타이밍에 동시에 공개하고 싶은 토큰이나 동시에 제거하고 싶은 토큰을 기억해두고 각자 기록해둡시다. 아래의 매크로 입력에 필요합니다.

위는 제가 실제로 사용한 핸드아웃 회수용(gm레이어로 옮기는 용도) 매크로입니다.

이 매크로에 사용되는 명령어의 기본은 다음과 같습니다.

!token-mod --set layer|objects --ids 토큰id

!token-mod --set layer|gmlayer --ids 토큰id

위쪽의 objects가 적힌 것이 플레이어들에게 보이는 오브젝트 레이어로 이동시키기 위한 명령어입니다.

아래쪽의 gmlayer가 적힌 것이 플레이어들에게 보이지않는 gm용 레이어로 이동시키기 위한 명령어입니다.

위의 단계에서 기록해둔 토큰 id를 붉은 색 부분에 입력하시면 됩니다. 중간에 띄어쓰기를 넣어 구분만 해주신다면 예시처럼 한번에 여러 id를 입력하셔도 됩니다. 동시에 공개하고 싶은 핸드아웃이 있거나, 혹은 동시에 제거해야하는 토큰들이 있다면 유용하겠지요.

!token-mod --set layer|objects --ids ?{시점|시점1,토큰id|시점2,토큰id}

!token-mod --set layer|gmlayer --ids ?{시점|시점1,토큰id|시점2,토큰id}

매크로를 여러 개 만들지 않고 특정 타이밍을 선택하면 그에 해당하는 토큰들을 공개하거나 제거하는 매크로를 만들고 싶을 땐 위와 같이 입력하면 됩니다. 시점1, 시점2 부분에 타이밍에 대해 적어두면 좋겠지요.

!token-mod --set layer|?{어느쪽?|공개,objects|제거,gmlayer} --ids 토큰id

위와 같이 입력하면 토큰의 공개/제거를 선택할 수 있는 매크로를 만들 수 있습니다.

하다가 막히는 부분이 있으시면 @kra_trpg로 질문주세요.