모드 스크립트 소개 (API)

2025년 11월 07일 18:33

이 페이지는 프로 구독자 전용 기능 또는 구독자가 생성한 게임 내 플레이어에게만 제공되는 기능에 관한 내용입니다. 이 기능을 사용하시려면 계정 업그레이드를 고려해 보세요.

Mod 스크립트(API) 는 게임을 커스터마이징하고 향상시키는 강력한 방법을 제공합니다. 게임 플레이 중 Roll20에 지시하는 코드 스크립트를 생성합니다. 예를 들어, 피스 이동, 토큰에 상태 마커 추가, 주사위 굴리기 등이 포함됩니다. 모드(API) 사용은 시작하기 쉽고 직관적이지만, 그 가능성은 무한합니다.

모드(API) 가이드 및 문서

감사의 말씀

Roll20 커뮤니티에 지식을 기꺼이 공유해 주시고 헌신해 주신 포럼 챔피언(그리고 비전의 서술술사) 더 에런님께 특별한 감사를 드립니다!

원클릭 스크립트 라이브러리를 사용하여 모드(API) 스크립트를 설치하려면 어떻게 해야 하나요?

원하는 게임의 게임 랜딩 페이지로 이동하세요.
설정 드롭다운을 클릭하고 모드(API) 스크립트를 선택하세요.
스크립트 라이브러리 드롭다운에서 필요한 스크립트를 찾으십시오.
스크립트 추가 버튼을 클릭하세요.
이제 게임에서 스크립트를 사용하기 시작할 수 있습니다!

자신만의 코드를 작성하거나 외부 소스의 코드를 사용하려면 모드(API) 스크립트를 어떻게 설치하나요?

이는 당사의 원클릭 스크립트 라이브러리를 사용하여 스크립트를 설치하는 과정과 유사합니다.

원하는 게임의 게임 랜딩 페이지로 이동하세요.
설정 드롭다운을 클릭하고 모드(API) 스크립트를 선택하세요.
모드(API) 설정 페이지에서 새 스크립트 탭을 클릭하세요.
코드 편집기 창으로 이동하게 되며, 해당 창에서 스크립트 코드를 입력하고 스크립트 이름을 지정할 수 있습니다.
스크립트 코드를 복사하여 붙여넣고 스크립트 이름을 지정하세요.
스크립트 저장 버튼을 클릭하세요.
모드(API) 샌드박스가 재시작되며, 이제 게임 내에서 스크립트를 사용하기 시작할 수 있습니다.

외부 출처에서 스크립트를 획득한 경우, 중요한 정보와 지침은 해당 스크립트의 설명을 참조하십시오.

도움말 내 스크립트가 작동하지 않아!

Mod(API) 문제 해결에 대한 일반적인 도움이 필요하시다면, 여기에서 저희 가이드를 확인해 보세요. 더 고급 디버깅 조언과 정보를 원하신다면, 여기에서 저희 글을 확인해 보세요. 문제가 계속 발생한다면,저희 Mod (API) 포럼에 게시글을 작성해 주시기 바랍니다.

스크립트를 작성하려면 시작하기 위해 무엇이 필요할까요?

Roll20 모드 스크립트(API)는 JavaScript로 작성됩니다. 시작하기 위해서는 언어에 대한 기본적인 이해만 있으면 됩니다. 하지만 자바스크립트를 더 깊이 배우고 싶다면, 이 코드아카데미강좌가 도움이 될 수 있습니다.

시작하려면, 먼저 고급 사용 가이드를 확인하세요.

어떻게 작동하나요?

게임 진행 중 발생하는 이벤트를 감지하는 스크립트를 작성합니다. 스크립트는 규칙이 준수되는지 확인하고, 객체와 토큰의 속성을 변경하며, 심지어 사용자 정의 채팅 명령을 제공할 수도 있습니다. 당신의 스크립트는 게임 전체에 영향을 미치며, GM과 모든 플레이어의 행동에 영향을 줍니다. 고급 스크립트는 독립적으로 실행될 수도 있으며, 순찰 경로에서 토큰을 이동시키거나 플레이어의 턴이 너무 오래 걸릴 때 알림을 보내는 등의 자동 작업을 수행합니다.

미리 만들어진 스크립트는 어디에서 찾을 수 있나요?

Mod(API) 스크립트 커뮤니티는 상당히 활발하여 회원들이 끊임없이 스크립트를 제작하고 논의하고 있습니다. 새로운 스크립트를 찾을 수 있는 기본적인 장소는 3곳입니다:

GitHub의 공식 Roll20 모드(API) 스크립트 저장소. 여기서는 저자들이 저장소에 포함시키기 위해 제출한 스크립트의 최신 버전을 확인할 수 있습니다.
Roll20 모드(API) 스크립트 포럼. 여기서 스크립트가 가장 먼저 등장하며, 작성 중이거나 수정이 필요한 스크립트에 대한 논의가 이루어집니다. 여기서는 여러분이 생각해낸 스크립트를 작성하거나 필요한 스크립트를 찾는 데 도움을 요청하고 커뮤니티의 도움을 받을 수도 있습니다.
위키의 모드(API) 스크립트 색인. 사용 가능한 스크립트에 관한 유용한 정보원입니다.

커뮤니티에 기여하는 모드(API) 스크립트

Roll20 커뮤니티에 공유하고 싶은 스크립트를 제작하신다면, Roll20 Mod(API) 스크립트 저장소에 포함되도록 제출하실 수 있습니다. Roll20 직원에게 스크립트 승인을 받고 저장소에 포함되면 계정에 "API 스크립터"포럼 태그가 활성화되며, Patreon 또는 Patreon 유사 사이트를 통한 홍보가 가능해집니다(자세한 내용은 아래 참조). 스크립트를 저장소에 올바르게 제출하기 위해 필요한 절차를 확인하려면 공식 Roll20 모드(API) 스크립트 저장소()를 방문하세요.

커뮤니티 시트 기여자를 위한 Patreon 및 Tipeee 연결 규칙

Roll20 모드(API) 스크립트 저장소에 기여하는 모드(API) 스크립트 작성자들은 구독/기부 서비스 사이트인 Patreon과 Tippee를 통해 광고를 게재할 수 있습니다. Roll20은 어떠한 결제 거래에 대해서도 책임을 지지 않으며, 어떠한 사적 합의도 강제할 수 없습니다.

자격 요건을 충족하기 위해서는 모드(API) 스크립트 작성자가 먼저 자신의 스크립트 기여물을 Roll20 직원에게 승인받고 Roll20 모드(API) 스크립트 저장소에 포함되어야 합니다.

GitHub에 스크립트를 제출할 때 함께 포함해야 하는sheet.json파일에 Patreon 또는 Tipeee 계정 정보를 포함해야 합니다.

Patreon 또는 Tipeee를 통해 광고를 게재하려면 JSON 파일에 다음 필드 중 하나를 추가해야 합니다:

patreon: 여기에 Patreon 캠페인 URL을 입력하면, 선택 시 스크립트 설명 아래에 표시됩니다. (예: "https://www.patreon.com/<name>")

tipeee: 여기에 Tipeee URL을 입력하면, 선택 시 스크립트 설명 아래에 표시됩니다. (예: "https://www.tipeee.com/<name>")

자세한 내용은 https://github.com/Roll20/roll20-api-scripts#contributing를 참조하십시오.

Roll20 포럼에서 Patreon/Tipeee 연결하기

Roll20 포럼에서 Patreon 또는 Tipeee 링크 게시가 허용되는 대상은 캐릭터 시트 또는 모드(API) 스크립트를 기여한 사전 승인된 커뮤니티 구성원에게만 해당됩니다. 사용자에게 직접 자금을 요청하고자 하는 경우 사적으로 진행할 수 있으나, 기여한 자료가 전혀 없는 공개 포럼에서는 그러한 링크를 게시할 수 없습니다.