CraftPresence

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

特点

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

启动器和整合包集成支持

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

• 一个 ATLauncher 实例（instance.json）；

• 一个有效的 Twitch/Overwolf/Curse/GDLauncher Manifest文件（manifest.json, minecraftinstance.json）；

• 一个 MCUpdater 实例（instance.json）；

• 一个 Modrinth 实例（profile.json）；

• 一个 MultiMC 实例（instance.cfg）；

• 一个 Technic installedPacks 文件（installedPacks）。

如果使用这些启动器中的任何一个，请注意以下几点：

• 在 v1.6.0 之前，它会将整合包名称显示在你的显示屏上，并显示它的图标（当你不在服务器中时）。

• 从 v1.6.0 到 v2.0.0，它会将整合包的名称解析为 &PACK& 占位符，你可以将其配置为在 RPC 中使用。

• 在 v2.0 中，整合包信息会被解析为 pack.name 和 pack.icon，你可以在 RPC 中配置使用。

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

示例：All the Mods 7 将解析为 allthemods7。

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

指令

CraftPresence 目前提供以下命令：

• /cp compile "[expr]" — 通过 Starscript 测试占位符表达式的输出；

• /cp search (type:typeName, [searchTerm], all) — 搜索可用于 Rich Presence 的有效占位符；

• /cp reload — 重新加载模组数据；

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

• /cp export — 查看模组数据的导出命令；

• /cp view — 帮助命令，显示可用于查看和控制各种显示数据的命令；

• /cp view placeholders — 显示所有可用于 RPC 的占位符；

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

• /cp view assets (custom | all) — 显示所有可用的所有图标键资源；

• /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 reboot — 重启 RPC；

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

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

请记住以下两点：

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

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

键位绑定

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

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

注意：

• 在 v1.5.5 到 v1.8.0，键位绑定现在在配置 GUI 的 Accessibility Settings（辅助功能设置）中自定义，而不是普通的控制菜单。

• 在 v1.8.0 及更高版本中，键位绑定现在在配置 GUI 的专用菜单或适用版本的普通控制菜单中自定义。

关于占位符和和函数

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

请记住以下几点：

• 在 v2.0.0，占位符已被重写，以便与 Starscript 兼容。

• 本节的旧版列表可在 此处 查看。

• 所有占位符、函数和代码表达式都必须用大括号括起来（例如：{foo.bar}）。

• 如果你需要在函数参数中将占位符与其他数据结合起来，请使用 getResult 函数。

• StandardLib 中还有其他函数和标准变量。

画廊

主菜单显示：在主菜单上使用默认设置时的显示

主世界显示：在单人游戏的主世界时的显示

下界显示：在单人游戏的下界时的显示

末地显示：在单人游戏的末地时的显示

服务器显示示例（Hypixel）：带小图标的 Hypixel 显示修改，服务器信息可配置