This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

title
.kojo 口上文件写作指南

EraUma 自 v1.33 (kuuga) 开始，依赖引擎版本提高到了 EraElectron v4.0.1 (x) 和 ere.app v1.0.9 (lipiah) 及以上版本，同时开始支持 .kojo 口上文件的使用。.kojo 口上文件的创作和使用方式可见 EraElectron Wiki 中的介绍，本文主要针对 EraUma 的口上创作进行约定。

基本结构

EraUma 的口上分为招募、日常、育成、爱慕、调教和地下室等六个部分，在写作时请尽量不要将所有内容堆到一个 .kojo 文件中，至少按照上面的分类分为六个文件，并在命名时按照一定的规律。例如对 119 号角色梦之旅而言，理想情况下她的口上由至少 6 个文件组成：

• rec-119.kojo：招募口上；
• daily-119.kojo：日常口上；
• edu-119.kojo：育成口上；
• love-119.kojo：爱慕口上；
• ero-119.kojo：调教口上；
• basement-119.kojo：地下室口上。

只有这个角色的口上完成度 100% 的理想状态下才需要 6 个文件，其中只有招募、日常和育成三类口上是必需，爱慕是建议，调教和地下室都是可选的，口上作者可以量力而行。
若写的是某角色的第二（或第三、第四……）口上，招募口上也是可选的非必需部分。
目白城实装后可能会出现第七部分：目白城口上，对应文件 mejiro-119.kojo，也会是可选部分。

EraUma 的口上以事件为基本单位，.kojo 文件中的一篇即对应一个事件，请尽量符合以下结构：

# 示例.kojo
事件名:
# 事件发生的时间、地点、条件等信息，以注释形式写出
- 事件的具体内容
- 事件的具体内容2
# ...

请分开写通用内容和触发内容，例如给一个角色指导学习时概率触发一个事件，则指导学习和指导学习触发的事件要写在两个篇目下：

# 示例.kojo
# 指导学习时会显示的文本内容
指导学习:
# 指导学习的奖励、效果等信息，如果要套用通用奖励效果就不用写，以注释形式写出
- 指导学习的内容

# 指导学习概率触发的事件
触发事件:
# 触发条件、概率、奖励等，以注释形式写出
- 触发事件的内容

最好每篇对应一个事件，不要把多个事件写在同一篇里。

除非对程序逻辑有充分了解，所有的条件请以字符串写出，请勿自己尝试写条件，例如：

# 示例.kojo
# 除非特别了解，不要这样写：
事件名:
- if: era.get('base:0:体力') / era.get('maxbase:0:体力') >= .45
  content: 我还能战！

# 一般这么写就可以，后面的交给程序开发
事件名2:
- if: # TODO: 角色体力高于45%时
  content: 她还能战！

TODO 标记有利于开发者快速定位需要重写的条件。

角色的发言建议以以下格式书写：

# 示例.kojo
事件名:
- color: %代表色%
  content:
  - fontWeight: bold
    content: %角色名%
  - 「角色的台词」

- color: %代表色%
  content:
  - fontWeight: bold
    content: %角色名%
  - （角色的心理活动台词）

- color: %代表色%
  content:
  - （
  - fontWeight: bold
    content: %角色名%
  - 「回忆中角色的台词」）

- color: %代表色%
  content:
  - fontWeight: bold
    content: ？？？
  - 「未知角色的一句台词」

- color: %代表色%
  content: 事件从该角色视角展开时的旁白

- 「玩家的台词」

- （玩家的心理活动）

- acc: 0
  content: 「按钮中的玩家的台词」

- acc: 1
  content: （按钮中的玩家的心理活动）

另外，建议口上作者如无必要，全程使用全角标点符号 ，。！？（）……—— 等，以保持统一风格。

关键词约定

本节约定 EraUma 的 .kojo 文件中用于动态指定的关键词及其对应含义。如何定义关键词的含义是作者的自由，但如果和约定不符请加注释或者在提交文件前说明。

以下是建议作者遵循并使用的关键词约定：

关键词	含义
%你%	玩家的称呼，一般是你
%玩家名%	玩家的本名，游戏开头 Offer 上签的名字
%训练员头衔%	玩家声望决定的头衔等级的称呼，有失格、普通、中坚、传奇等数个等级
%称呼%	角色对玩家的称呼，如果同一事件中出场了多个动态指定的称呼（例如还需要玩家对角色的称呼），就写成%X对Y的称呼%（X和Y都是角色名）
%骏川缰绳%	EraUma 中有一些特殊角色，其显示名会随着游戏进程变化，比如骏川缰绳在告知本名后显示名会从骏川小姐变成骏川缰绳，这种特殊角色的显示名需要动态指定
%代表色%	角色的代表色

以下是作者可以遵循并使用的关键词约定（主要由 EraUma 自由的性别设定造成）：

关键词	含义
%她%	角色的性别指示代词，如果一个事件中只使用了一名角色的性别指示代词可以只用%她%表示，但如果需要使用多个角色的性别指示代词请写成%X她%的形式（X是角色显示名）；特别的，如果指示代词都用于指示马娘，也可以直接使用%她%（马娘的默认性别会根据游戏选项统一设置和变化）
%马娘%	马娘角色的性别指示代词，有马娘和马郎两种可能
%你们%	包含角色在内的群体角色的称呼，如果包含玩家在内可以固定使用你们
%先生%、%小姐%	对角色的敬称
%少年%、%少女%	对少年角色的称呼
%男孩%、%女孩%	对儿童角色的称呼
%男性%、%女性%	对生理性别的称呼（FUTA 属于女性大类）
%公马%、%母马%	对性奴角色的蔑称
%哥哥%、%姐姐%	对有血缘关系或者照顾关系的年长角色的称呼
%弟弟%、%妹妹%	对有血缘关系或者照顾关系的年幼角色的称呼
%兄弟%、%姐妹%	对有血缘关系或者照顾关系的一组角色的称呼