개요서 통합

2024년 06월 05일 08:05

시트의 호환성 지정

개요서와의 호환성을 지정하려면sheet.json파일의 '개요서' 필드에 개요서의 짧은 이름을 포함하면 됩니다.

사용자 지정 시트를 사용하는 경우 게임 설정 페이지의 설정에서 게임에 사용할 개요서를 수동으로 선택할 수 있습니다.

시트에 끌어서 놓기 기능 활성화하기

기본 호환성 외에도 개요서의 정보를 시트에 직접 포함할 수 있는 방법을 Roll20에 알려주는 옵션이 있습니다. 이렇게 하면 플레이어가 개요의 항목을 시트에 직접 끌어다 놓으면 Roll20이 지정한 값을 채웁니다. 이렇게 하려면 채우려는 섹션을 둘러싼div태그에compendium-drop-target클래스를 추가해야 합니다. 반복되는 섹션의 경우필드세트태그 안에 넣습니다. 그런 다음 하나 이상의입력, 선택, 텍스트 영역태그에accept="속성 이름"속성을 추가합니다. 다음은 5판 SRD 개요서의불덩어리 항목()과 호환되는 간단한 예시입니다.

<fieldset class="repeating_spells">
  <div class="compendium-drop-.target">
    <입력 유형="text" name="attr_SpellName" accept="Name" />
    <입력 유형="text" name="attr_SpellDamage" accept="Damage" />
    <select name="attr_SpellSchool" accept="학교">
      <옵션 값="퇴마">퇴마</옵션>
      <옵션 값="주술">주술</옵션>
      <옵션 값="점술">점술</옵션>
      <옵션값="마법부여">마법부여</option>
      <옵션값="소환">소환</option>
      <옵션값="환상">환상</option>
      <옵션값="강령술">강령술</옵션>
      <옵션 값="Transmutation">Transmutation</옵션>
    </선택>
    <입력 유형="체크박스" 이름="attr_SpellRitual" 값="예" accept="Ritual">
  </div>
</fieldset>

accept="<Attribute Name>"의<Attribute Name>은 컴피디아 항목 하단의 속성 이름과 일치해야 합니다. 사용 가능한 속성 목록은 각 개요서를 참조하세요.
입력및텍스트 영역태그의 경우 개요의 값이 직접 삽입됩니다.
입력[유형=체크박스]및입력[유형=라디오]태그의 경우, 개요의 값이 태그의 값 속성과 정확히 일치하면 상자가 체크/라디오로 선택됩니다.
태그를 선택하면 값 속성 또는 옵션 태그 내부의 텍스트 중 Compendium 값과 일치하는 옵션 이 선택됩니다.
항목의 일반 텍스트 콘텐츠('속성' 헤더 위에 있는 콘텐츠)를 받으려면accept="콘텐츠"을 사용하면 됩니다.
accept="data"를 사용하여 개요 페이지의 모든 속성을 json 형식으로 수신할 수 있습니다.

이러한 값을 변경하는 과정에서 사용자가 직접 데이터를 입력한 것처럼 로컬 시트 워커 및 원격 API 이벤트가 트리거된다는 점에 유의하세요. 따라서 숨겨진 입력을 만들어 개요에서 데이터를 받은 다음, 데이터 표시 방식을 더 잘 제어하고 싶다면 시트 워커를 사용하여 해당 데이터를 추가로 처리할 수도 있습니다.

개요 버튼

개요 버튼을 사용하면 앱 내 개요에서 항목을 클릭하는 것과 같은 방식으로 캐릭터 시트에서 바로 개요 항목을 열 수 있습니다. 예를 들어, 주문의 경우 개요 버튼을 사용하여 해당 주문에 대한 전체 설명을 쉽게 볼 수 있는 등 규칙과 설명에 더욱 편리하게 액세스할 수 있습니다.

구문은<button type="compendium" value="<entryname>">입니다. 다음은 몇 가지 유효한 예입니다:

<버튼 유형="개요" 값="바드"></버튼>

이는 유효한 구문이지만, "음유시인"이라는 제목의 직업과 몬스터 개요 항목이 모두 존재하므로, 결과 창에는 둘 중 하나로 바로 이동하지 않고 선택 항목이 표시됩니다.

<버튼 유형="개요" 값="클래스:바드"></버튼>

이것이 기본 구문입니다. 카테고리를 지정하면 일치하는 항목이 하나만 표시됩니다.

<버튼 유형="개요" 값="클래스:바드#주문서술"></버튼>

하위 제목 뒤에 "#"을 추가하면 해당 섹션으로 바로 창이 열립니다. 이 예제에서는 주문 시전 섹션으로 미리 스크롤된 바드 클래스 항목이 열립니다. 해당 이름의 섹션을 찾을 수 없으면 창이 맨 위로 스크롤되어 열립니다.

개요에서 항목을 드래그하면 이 버튼 전용 속성인고유 이름이 속성은 카테고리와 항목 이름이 모두 포함된 문자열로, 개요에 일치하는 항목이 하나만 포함되도록 합니다. 따라서 개요 드롭 섹션에서 이 버튼의 구문은 다음과 같습니다:

<버튼 유형="개요" name="attr_infoButton" accept="고유명사"></버튼>

셰이워커를 통해 이 속성에 하위 섹션을 추가할 수도 있으므로, 도감에서 드랍한 아이템이 몬스터이고 버튼이 "액션" 섹션으로 바로 열리도록 하려면 버튼의 값을고유명 + "#액션"으로 설정하면 됩니다.