롤20 API

  무료 플러스 프로
롤20 API    

페이지는 Pro 구독자 또는 구독자가 만든 게임의 플레이어에게만 제공되는 기능에 대해 설명합니다. 이 기능을 사용하려면 계정을 업그레이드해주세요

TheRoll20 API provides a powerful way to customize and enhance your game. 게임 중 Roll20에 지시하는 코드 스크립트를 만들 수 있습니다. 예를 들어, 말 조각을 이동하거나 토큰에 상태 표시기를 추가하거나 주사위를 굴릴 수 있습니다. API를 사용하는 것은 시작하기 쉽고 간단하지만 가능성은 무한합니다.


 

API 가이드 및 문서


감사의 말

롤20 커뮤니티와 지식을 공유하기 위해 우리 포럼 챔피언 (Arcane Scriptomancer인) The Aaron에게 특별한 감사의 말씀을 드립니다.


원클릭 스크립트 라이브러리를 사용하여 API 스크립트를 설치하는 방법은 무엇인가요?

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

내가 직접 코드를 작성하거나 외부 소스에서 코드를 사용하려면 API 스크립트를 어떻게 설치해야 하나요?

원클릭 스크립트 라이브러리를 사용하여 스크립트를 설치하는 것은 비슷한 과정입니다.

  1. 원하는 게임의 게임 랜딩 페이지로 이동하십시오.
  2. 설정 드롭다운을 클릭하고 API 스크립트를 선택하십시오.
  3. API 설정 페이지에서 새 스크립트 탭을 클릭하십시오.
  4. 스크립트 코드를 삽입하고 스크립트에 이름을 지정할 수 있는 코드 편집기 창으로 이동합니다.
  5. 스크립트 코드를 복사하여 스크립트에 이름을 제공하십시오.
  6. 스크립트 저장 버튼을 클릭하십시오.
  7. API 샌드박스가 다시 시작되며 이제 스크립트를 게임 내에서 사용할 수 있습니다.

스크립트를 외부 소스에서 얻었다면, 중요한 정보와 지침에 대해서는 스크립트 설명을 참조하십시오.


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

API 문제 해결에 대한 일반적인 지원이 필요한 경우, 여기서 확인하십시오. 고급 디버깅 조언과 정보가 필요한 경우, 여기서 확인하십시오. 여전히 문제가 있는 경우 API 포럼에 게시물을 작성해 주세요.


스크립트를 작성하려면 어떤 것이 필요한가요?

Roll20 API용 스크립트는JavaScript으로 작성됩니다. 언어에 대한 기본적인 이해만 있으면 시작할 수 있지만, 자바스크립트에 대해 더 자세히 알고 싶다면 이 코딩 아카데미강좌를 통해 배울 수 있습니다. 

시작하려면 첫 번째로 방문해야 할 곳은 고급 사용 가이드입니다.


어떻게 작동하나요?

게임 중에 발생하는 이벤트를 수신하는 스크립트를 작성합니다. 스크립트는 규칙이 준수되는지 확인하고, 개체와 토큰의 속성을 변경하고, 사용자 지정 채팅 명령을 제공할 수도 있습니다. 당신의 스크립트는 GM과 모든 플레이어의 행동에 영향을 주는 게임 전반에 걸친 영향을 미칩니다. 고급 스크립트는 독립적으로 실행하여 순찰 경로에서 토큰을 이동하거나 플레이어의 차례가 너무 오래 걸리는 경우 플레이어를 넛지하는 등의 자동 작업을 수행할 수도 있습니다.


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

API 스크립트 커뮤니티는 회원들이 항상 스크립트를 만들고 토론하는 등 상당히 활발하게 활동하고 있습니다. 새 스크립트를 찾을 수 있는 세 가지 기본 위치가 있습니다:

  • 공식 Roll20 API 스크립트 저장소은 GitHub에 있습니다.여기에서는 작성자가 저장소에 포함되도록 제출한 스크립트의 현재 버전을 찾을 수 있습니다.
  • Roll20 API 스크립트 포럼입니다. 여기에서는 스크립트가 처음으로 나타나고 작성 중이거나 변경이 필요한 스크립트에 대한 토론이 진행됩니다. 여기에서는 생각한 스크립트를 만들거나 필요한 스크립트를 찾기 위해 커뮤니티에 도움을 요청할 수도 있습니다.
  • 위키의 API 스크립트 색인. 사용 가능한 스크립트에 대한 정보를 얻을 수 있는 좋은 출처입니다.

커뮤니티에 API 스크립트 기여하기

다른 Roll20 커뮤니티에 제공하고 싶은 스크립트를 만든 경우, 이를 제출하여 Roll20 API 스크립트 저장소에 포함시킬 수 있습니다. Roll20 스태프에 의해 승인된 스크립트가 저장소에 포함되면 계정에 "API Scripter"포럼 태그가 잠금 해제되며 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을 여기에 입력하면 선택 시 script 설명 아래에 나타납니다. (예:"https://www.patreon.com/<name>")

tipeee: Tipeee의 URL을 여기에 입력하면 선택 시 script 설명 아래에 나타납니다. (예: "https://www.tipeee.com/<name>")

자세한 정보는 https://github.com/Roll20/roll20-api-scripts#contributing을 참조하십시오.

Roll20 포럼에서 Patreon/Tipeee 링크하기

Roll20 포럼에서 Patreon이나 Tipeee에 링크하는 것은 사전 승인된 커뮤니티 회원만 허용됩니다. 이 회원들은 캐릭터 시트나 API 스크립트 중 하나를 기여한 사람들입니다. 사용자들로부터 자금을 모으기 위해 직접 요청하고 싶다면 개인적으로 그렇게 할 수 있지만, 기여된 자료 없이 공개 포럼에는 해당 링크를 포함할 수 없습니다.

도움이 되었습니까?
67명 중 52명이 도움이 되었다고 했습니다.