模板:ISEvent

模板文档  

这个文档嵌入自模板:ISEvent/doc。

此模板尚在测试中。

此模板尚在测试中。

目
录

• 1 简述
• 2 架构
• 3 如何撰写
  • 3.1 定义事件
  • 3.2 定义场景
  • 3.3 定义选项

简述

此模板为系列模板，旨在通过基于Vue组件框架的HTML+JS方式书写灵活性更高的集成战略事件列表。 包含以下组件：

• Widget:ISEvent —— 核心JS处理库，可通过GitHub仓库进行底层处理代码修改和提交。
• 模板:ISEvent —— 本模板。数据外包装。
• 模板:ISEvent/scene —— 场景定义类模板。
• 模板:ISEvent/choose —— 选项定义类模板。

架构

本系列模板的基础架构如下：

• 数据外包装：包裹整个数据供核心处理库处理。
  • 事件：多个场景的集合体。
    • 场景：一个具有图像、标题和解说的场景，可以包含若干选项；等效于游戏中事件的“一屏”。
      • 选项：一个具有选项名称、选项详情和图标的选项；可以互动用于场景之间跳转。

如何撰写

首先，在页面中放置 Widget:ISEvent，并使用 {{#vardefine:theme|<主题名>}}{{#vardefine:link|<收藏品一览页面名>}}定义收藏品页面跳转（如：傀影与猩红孤钻、长生者宝盒）。

之后放置本模板（{{ISEvent}}）。

定义事件

在ISEvent中，用 |事件X=（X=1,2,3...）定义一个事件。

• 为了维护方便，你可以在新的类别起使用新的X命名方式（如“story1”等）。

定义场景

定义好一个事件后，即可在此事件中，用 {{ISEvent/scene}} 模板插入一个场景。具体参数如下：

• etype （可选）指定场景所属类别，将会变为一个二级标题（如：不期而遇）。只在该类别第一个事件的第一个场景填写。
• edesc （可选）为当前事件书写前置说明文字。只在该事件的第一个场景填写。
• 无名第一参数 指定该场景的别名，用于这个事件的内部导航，可视情况自定。
• 无名第二参数 指定该场景的显示图片，自动调用Wiki内图像，不需要扩展名。
• 无名第三参数 指定该场景的标题。
• 无名第四参数 指定该场景的描述。
• 选项 （可选）指定该场景包含的选项。

一个事件常常拥有许多个场景，此时只需要把多个 {{ISEvent/scene}} 连续排列即可。

这里是一个水月与深蓝之树“悬高之葬”事件的场景样例（略去选项，有删减）：

{{ISEvent/scene|etype=不期而遇|开始|Avg_pic_rogue_2_1|悬高之葬|你正站在一座悬崖墓园内。这里正在举行送别逝者的仪式。……}}
{{ISEvent/scene|结束|Avg_pic_rogue_2_1|悬高之葬|祷告结束，你抬头向悬崖下方望去。……}}

定义选项

用 {{ISEvent/choose}} 在场景中插入若干选项。具体参数如下：

• 无名第一参数 指定选项类型；
• 无名第二参数 指定选项名称。
• desc1 （可选）指定该选项的附加说明文字，以游戏内为准。
• desc2 （可选）指定该选项的附加信息，一般用于补充该选项的说明。
• dest （可选）指定要跳转的目标场景的序号。
  以初始场景为0，按书写顺序依次递增。

选项类型将会决定该选项的一些附加参数，可用类型如下：

1、系统类型

该类型与游戏内同步，为游戏内实际出现的选项类型。

• simple：简单选项。这将会生效下列参数：
  • 无名第三参数 指定选项图标，根据ID自动调用Wiki内图像，不需要扩展名。
• collection：获得具体收藏品的选项。这将会生效下列参数：
  • 无名第三参数 指定收藏品的图鉴ID。
  • 随着yj长期变动收藏品ID导致图片刷新爆炸，本类型已废弃。新的该类型选项请改用collection2
• collection2：获得具体收藏品的选项。这将会生效下列参数：
  • 无名第三参数 指定收藏品的图鉴ID。
  • iconId 指定收藏品的图标ID。
• item：获得具体的集成战略专属道具的选项。这将会生效下列参数：
  • 无名第三参数 指定道具名称。
• custom：一种更加普适性的选项模板，其最初用于萨卡兹的无终奇语的“构想”类选项。
  • 无名第三参数 指定任意图像作为选项图标（仅限Wiki内图像），不需要扩展名。
  • customBadgeText：（可选）自定义图标上的角标文字。

2、辅助展示类型

该类型为优化呈现效果的辅助型“选项”，并不出现在游戏中，但可以优化事件在页面上的显示效果。

• desc：用于穿插描述而用的说明性文字。
  • 此类型无参数，并弃用原本的第二参数。
• guide：用于对某些复杂情况进行先行分歧，并可点击以前往的按钮。
  • 此类型无参数，并弃用原本的第二参数。
  • 此类型具有额外的参数规则：使用desc1书写按钮文字，且为无名第二参数指定具有相同含义的文字以在面包屑中正常显示文字。

这里是一些探索者的银凇止境事件的选项样例：

{{ISEvent/choose|simple|扑进去！|population|desc1=获得{{color|#b4f7ff|2}}希望|dest=2}}
{{ISEvent/choose|collection|搜索营地|220|desc1=获得收藏品{{color|#b4f7ff|树痕之盔}}|dest=1}}
{{ISEvent/choose|item|强化训练|高级物资配给券|desc1=获得进阶券<br/>{{color|#b4f7ff|高级物资配给券}}|dest=2}}
{{ISEvent/choose|desc|desc1={{fa|info-circle}} '''以下选项随机出现3个'''}}