双蝴蝶结项圈

这是一款双蝴蝶结项圈：皮带主体配有两侧蝴蝶结、上下花边、缝线、金属件和铃铛。随附的调色 HUD 可以分别调整这 6 个部位的颜色。

OpenCollar（OC）

本项圈使用基于 OpenCollar（OC）开源脚本、由 poipoi 修改的开源版本，提供权限管理、牵引和 RLV 等功能。OC 功能的详细用法请查看官网： https://opencollar.cc/

下面主要介绍这款项圈的双语言设置：如何修改翻译，以及如何切换显示语言。

两张语言卡

• Text.en：英文原文与参考，保留原样。
• Text.alt：可替换的附加语言，随附版本为简体中文。你可以把它换成其他语言。
• 同时使用英文和一种附加语言。替换 Text.alt 会替换原来的附加语言，不会增加第三种语言。

切换显示语言

1. 点击项圈，打开主菜单。
2. 首次默认英文。进入 Settings > Languages（设置 > 语言设置）。
3. 点击 Install Language（安装第二语言），等待安装成功提示。加载时英文菜单仍可使用。
4. 安装成功后仍保持英文。重新进入 Settings > Languages，点击 🌐 简体中文，即可切换到随附的中文。
5. 切回英文时，进入 设置 > 语言设置，点击 🌐 EN。换成其他语言后，按钮会显示你在 lang.name 中填写的语言名称。

安装成功后会保存缓存，以后启动时直接复用有效缓存，不用再次读卡，并保留你选择的语言。启动时不会自动安装第二语言。

修改、替换或移除 Text.alt 后，项圈会回到英文，第二语言暂时不可切换。放好完整的新卡后，进入 Settings > Languages > Install Language 重新安装。已安装且卡片未变时，也可以点击 Reinstall Language（中文界面为“重装第二语言”）主动重装。

所有者或佩戴者可以操作。这个选择对整个项圈生效，不是每位使用者各自选择一种语言。

制作自己的翻译

1. 先在库存里备份项圈，以及原来的 Text.alt。
2. 在允许放置物品的地方放出项圈，右键编辑，打开 Contents（内容）。语言卡放在项圈主体的内容里，不是调色 HUD。
3. 打开 Text.en，复制完整文字。新建一张 Notecard，粘贴进去，作为翻译底稿。
4. 只翻译每行第一个等号后面的内容。等号前面的键名必须原样保留，一条记录保持在一行。
5. 找到 lang.name=EN，把 EN 改成语言显示名称，例如 lang.name=简体中文。不要重复添加 lang.name。
6. 把完成的卡准确命名为 Text.alt。将项圈里原来的 Text.alt 移出并备份，再放入新卡。不要保留名为 Text.alt 1 的副本代替它。
7. 保存后进入 Settings > Languages，点击 Install Language。等待安装成功，再切换语言。不需要改脚本或手动重置。

也可以直接编辑项圈内容中的 Text.alt。以后修改、保存这张卡，需要回到语言设置重新安装。

哪些内容不能翻译

• 保留键名、等号，以及 {1}、{2} 等占位符。可按语言语序移动占位符，但不要改编号、遗漏或多加。
• 保留 %WEARERNAME%、%NOACCESS% 等替换标记。
• 保留原有 emoji、链接、命令和资产名称。
• 保留字面形式的 \n，它表示换行；不要把同一条记录拆成多行。原文中的转义引号也应保留。
• 不要修改 Text.buttons，它负责按钮动作映射。
• 不要留下重复键名。暂时不翻译某条时，请保留英文。安装时需要与英文原文完整对应的键名。

例子，复制时不要包含本段说明：

addons.addon_connected=外接设备已连接：{1}

这条中的 addons.addon_connected 和 {1} 保持原样，只改“外接设备已连接：”这部分。

简短提醒

• 按钮文字尽量短；btn. 开头的值最多 20 个 UTF-8 字节，lang.name 最多 19 个字节。中文通常每字占 3 字节。
• 安装失败或中断时仍可使用英文；请保留 Text.en，修正 Text.alt 后重试。
• 这些语言卡控制项圈菜单与提示，不改变调色 HUD 图片上的文字。