롤20 API) 모드

2024년 06월 05일 07:00

	무료	플러스	프로
롤20 API) 모드

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

The 롤20 API) 모드 는 게임을 맞춤 및 향상시키는 강력한 방법을 제공합니다. 게임 중 Roll20에 지시하는 코드 스크립트를 만들 수 있습니다. 예를 들어, 말 조각을 이동하거나 토큰에 상태 표시기를 추가하거나 주사위를 굴릴 수 있습니다. 모드 (API) 사용은 시작하기 쉽고 간단하지만, 가능성은 무한합니다.

스크립트 인덱스 (커뮤니티 위키)

감사의 말

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

Mod (API) 스크립트를 원클릭 스크립트 라이브러리를 사용하여 설치하는 방법

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

모드 (API) 스크립트를 설치하는 방법을 작성하려는 경우 또는 외부 소스에서 코드를 사용하려는 경우

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

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

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

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

모드 (API) 문제 해결에 일반적인 지원이 필요한 경우, 여기에서 문서를 확인하십시오. 고급 디버깅 조언과 정보가 필요한 경우, 여기서 확인하십시오. 문제가 계속되는 경우, Mod (API) 포럼에 글을 게시해 주시기 바랍니다.

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

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

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

어떻게 작동하나요?

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

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

Mod (API) 스크립트 커뮤니티는 멤버들이 지속적으로 스크립트를 생성하고 논의하는 활발한 활동을 합니다. 새 스크립트를 찾을 수 있는 세 가지 기본 위치가 있습니다:

공식 Roll20 Mod (API) 스크립트 저장소는 GitHub에 있습니다. 여기서 저자들이 제출한 스크립트의 최신 버전을 찾을 수 있습니다.
Roll20 Mod (API) 스크립트 포럼은 스크립트가 먼저 나타나고 스크립트에 대한 논의가 이뤄지는 곳입니다. 여기에서는 생각한 스크립트를 만들거나 필요한 스크립트를 찾기 위해 커뮤니티에 도움을 요청할 수도 있습니다.
위키의 Mod (API) 스크립트 인덱스는 이용 가능한 스크립트에 대한 정보를 제공합니다.

커뮤니티에 Mod (API) 스크립트 제출하기

Roll20 커뮤니티에 제공하고 싶은 스크립트를 만들었다면, Roll20 Mod (API) 스크립트 저장소에 포함되도록 제출할 수 있습니다. Roll20 스태프에게 승인을 받아 저장소에 포함된 스크립트는 "API Scripter" 포럼 태그를 해제하고 Patreon 또는 Patreon과 유사한 사이트를 통해 광고할 수 있습니다. 저장소에 스크립트를 올바르게 제출하려면 공식 Roll20 Mod (API) 스크립트 저장소로 이동하세요.

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

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

광고할 수 있는 조건은 Roll20 스태프에게 승인을 받아 Roll20 Mod (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 링크를 게시하는 것은 성인 시트나 Mod (API) 스크립트 중 하나를 기여한 사전 승인된 커뮤니티 회원에게만 허용됩니다. 사용자들로부터 자금을 모으기 위해 직접 요청하고 싶다면 개인적으로 그렇게 할 수 있지만, 기여된 자료 없이 공개 포럼에는 해당 링크를 포함할 수 없습니다.