CraftPresence

通过 jagrosh 的 Discord's Rich Presence API 和 Discord IPC API 完全自定义其他人看到你玩 Minecraft 的方式！

特点

除了能够更改你的 discord 状态（“Playing Minecraft”）之外，本模组还提供了大量自定义选项来详细指定其它人看你玩游戏的方式——显示当前生物群系，所在维度，以及所在的服务器，等等。自定义的可能性是无限的，唯一真正的限制是你的创意。

启动器和整合包集成支持

CraftPresence 将检测你的启动目录是否包含：

• 一个有效的 Twitch/Curse/GDLauncher Manifest文件 (manifest.json, minecraftinstance.json)
  

• 一个 MultiMC 实例 (instance.cfg)
  

• 一个 MCUpdater 实例 (instance.json)

• 一个 Technic installedPacks 文件（installedPacks）

如果使用这些启动器中的任何一个，它会将整合包名称放在你的显示器中并显示它的图标（当你不在服务器中时）。

注意：在 v1.6.0 及更高版本中，CraftPresence 会将包的名称解析为 &PACK& 占位符，你可以将其配置为在 RPC 中使用。

例如，这是模组将整合包名称转换为 iconKey（图标键）的方式：

示例：All the Mods 3 将解析为 allthemods3。

注意：MultiMC 本身也有一个图标键属性，用于代替整合包的显示名称转换功能。

指令

CraftPresence 目前提供以下命令：

• /cp view — 帮助命令，显示可用命令，或控制各种显示数据。

• /cp reload — 重新加载模组数据（在 v1.4.8 及更高版本中，这会强制触发 Tick 事件）

• /cp reboot — 重启 RPC

• /cp shutdown — 关闭 RPC（可以通过 /cp reboot 打开）

• /cp request — 查看加入请求信息

• /cp view currentData — 以文本形式显示你当前的 RPC 数据

• /cp view assets — 显示可用的所有图标键

• /cp view dimensions — 显示所有可用的维度名称，需要启用 Show Current Dimension（显示当前维度）

• /cp view biomes — 显示所有可用的生物群系名称，需要启用 Show Current Biome（显示当前生物群系）

• /cp view servers — 显示所有可用的服务器地址，需要启用 Show Game State（显示游戏状态）

• /cp view screens — 如果启用了 Per-Gui，则显示所有可用的 GUI 名称

• /cp view items — 如果启用了 Per-Item，则显示所有可用的物品名称

• /cp view entities — 如果启用了 Per-Entity，则显示所有可用的实体名称

• /cp (help | ?) — 帮助命令，显示上述命令和解释

请记住以下两点：

• 命令必须以 /craftpresence 或 /cp 为前缀

• 在 v1.5.0 及更高版本中，这些命令只能通过 Config Gui（配置 GUI）中的 Commands Gui（指令 GUI）使用。

键位绑定

CraftPresence 当前包含以下绑定的键位：

注意：在 v1.5.5 及更高版本中，键位绑定现在在配置 GUI 的 Accessibility Settings（辅助功能设置）中自定义，而不是普通的控制菜单。

• Open Config Gui （打开配置 GUI）—用于打开 CraftPresence 配置 GUI 的键位（默认：GRAVE/TILDE Key）

占位符

在某些配置区域，CraftPresence 提供了一些占位符以简化配置流程：

请记住以下三点：

• 在 v1.6.0 及更高版本中，你可以在 Rich Presence 中定义消息。

• 占位符不区分大小写，但应输入小写以防止在 v1.5.x 及以下版本中识别它们时出现问题。

• 从 v1.6.8 开始，你还可以使用缩小版的占位符，将其长度缩减为 4；&DIM& 和 &DIMENSION& 在这种情况下是相同的。

全局占位符

这些占位符可以添加到配置 GUI 的 Presence Settings 菜单中。

由于这些占位符是全局的，因此可以在 Presence Settings 中的任何 RPC 字段中设置它们，并通过它们的子占位符在更深层次上进行自定义。

• &MAINMENU& — 在主菜单中显示的消息。

• &BRAND& — minecraft 品牌标签，显示 minecraft 具有最终解释权。

• &MCVERSION& — minecraft 版本，显示 minecraft 具有最终解释权。

• &IGN& — 非世界玩家信息消息。

• &MODS& — 与你的模组数量一起显示的消息。

• &PACK& — 使用有效模组包时显示的消息。 

• &DIMENSION& — 维度消息（如果正在使用）。

• &BIOME& — 生物群落消息（如果正在使用）。

• &SERVER& — 服务器/单人消息（如果正在使用）。

• &SCREEN& — Gui 屏幕消息（如果正在使用）。

• &TILEENTITY& — 方块实体（方块/物品）消息，如果正在使用中。

• &TARGETENTITY& — 目标实体消息（如果正在使用）。

• &ATTACKINGENTITY& — 攻击实体消息（如果正在使用）。

• &RIDINGENTITY& — 骑行实体消息（如果正在使用）。