Skip to content

Latest commit

 

History

History
97 lines (66 loc) · 8.61 KB

README_zh.md

File metadata and controls

97 lines (66 loc) · 8.61 KB

简体中文 | English

Where Is

一个 MCDReforged 的插件, 受到 Fallen_BreathHere and Ivan-1FWhere 启发

依赖

MinecraftDataAPI

MCDReforged >= 2.1.3

指令

  1. !!whereis 或者 !!vris(可在配置文件中修改):显示一个其他玩家的坐标。

指令格式: !!whereis <玩家> [参数(可选)]

​ 可以加-a 或者 -s(可以合成一个参数写作 -as 或者 -sa)。

-a 意为向所有(all)玩家发送坐标并高亮该玩家;

-s 意为提权(sudo),允许查看受保护的玩家的坐标。

​ 两个参数均需要插件配置中设置的 admin 等级来执行。

  1. !!here (可在配置文件中修改): 广播自己当前的坐标

​ 在配置文件中启用聊天中任意 here 指令解析时,聊天信息中用空格隔开的任意 !!here 字段均会被响应 2.1新版功能

配置文件

部分特性可由配置文件控制,默认自动生成于 config/where_is/config.json

修改配置文件之后需要使用!!MCDR plg reload where_is重载方可生效。

以下为配置文件内容

警告:下方被星号标记的两项的值须在更新到2.x版本前手动配置,否则您将在加载新版本时丢失本插件的全部配置,若您此前从未安装过本插件可无视该条信息

值的类型 默认值 说明
enable_where_is bool true 设置为true以启用查询玩家坐标的功能
enable_here bool true 设置为true以启用广播自己坐标的功能
enable_here bool false 设置为 true 以允许聊天中任意 here 指令解析功能 2.1 新版功能
*command_prefix dict(含固定的2个项目) '!!vris', '!!whereis' 插件指令前缀
broadcast_to_console bool true !!here!!vris <player> -a 会将坐标信息同时显示在服务端控制台
permission_requirements dict(含固定的3个项目) 见下表 指令要求的最小权限等级
*hightlight_time dict(含固定的2个项目) 见下表 当包含 -a 参数时高亮玩家的时间
display_waypoints dict(含固定的2个项目) 见下表 是否显示小地图坐标点
query_timeout int 3 Minecraft Data API的超时时间
click_to_teleport bool true 允许玩家点击补全传送指令 (仍需OP以执行)
location_protection dict(含固定的5个项目) 见下表 玩家坐标保护相关设定
dimension_translation_mode Literal['mcdr', 'minecraft'] 'mcdr' mcdr: 维度名称由MCDR翻译; minecraft: 维度名称由Minecraft翻译。在1.19及以上版本,用mcdr项可以避免因翻译键名改动造成的翻译失败
custom_dimension_name Dict[str, Dict[str, str] 内容过长不便展示 由 MCDR 翻译的维度名称的翻译键值映射。首层键名为语言,二级键名为维度ID(支持非原版维度,原版维度必须填写且应去掉命名空间)
custom_vanilla_translation_key Dict[str, str] 内容过长不便展示 由 Minecraft 翻译的维度键名映射 (支持非原版维度,原版维度必须填写且应去掉命名空间). 2.1 新版功能

上述提到的含固定键值对的的配置项如下:

上述星标项的配置内容:

command_prefix 的键 值类型 默认值 说明
where_is List[str] ['!!vris', '!!whereis'] 查询玩家坐标的指令前缀
here List[str] ['!!here'] 广播自己坐标的指令前缀
highlight_time 的键 值类型 默认值 说明
where_is int 0 当查询其他玩家并广播其坐标时玩家被高亮的时长
here int 15 当广播自己坐标时自己被高亮的时长

其余为常规项:

permission_requirements 的键 值类型 默认值 说明
where_is int 1 允许查询其他玩家坐标的最小权限要求
here int 0 允许广播自己的坐标的最小权限要求
admin int 3 允许附带额外参数查询其他玩家坐标的最小权限要求
display_waypoints的键 值类型 默认值 说明
voxelmap bool true true 时显示一个附带点击事件的文本 ([+V]) 点击高亮坐标,Ctrl点击添加坐标点到 Voxelmap
xaero_minimap bool true true 时显示一个附带点击事件的文本 ([+x]) , 点击添加路径点到 Xaero's Minimap
location_protection 的键 值类型 默认值 说明
enable_whitelist bool false 启用查询白名单,启用时限制白名单外的玩家被查询
enable_blacklist bool true 启用查询黑名单,启用时限制黑名单内的玩家被查询
whitelist list 空列表 白名单,限制除此之外的玩家被查询
blacklist list 空列表 黑名单,限制该列表内的玩家被查询
protected_text dict 'en_us': 'He/She\'s in your heart!' 'zh_cn': 'Ta在你心里!' 当玩家被阻止查询时显示的信息,提供了MCDR语言偏好设置的支持

示例