Skip to content

Lazy-Bing-Server/WhereIs-MCDR

Repository files navigation

English | 简体中文

Where Is

A MCDReforged plugin, inspired by Fallen_Breath's Here and Ivan-1F's Where

Dependencies

MinecraftDataAPI

MCDReforged >= 2.12.0

Changed in v2.2:

No longer supports MCDR v2.11 or earlier

Commands

  1. !!whereis or !!vris(can be modified in config):Show coordinate of other player

Command format: !!whereis <player> [args(optional)] (multiple players allowed)

​ Optional arguments could be following values (multiple arguments should be divided by space):

-a, --all means broadcasting coordinate to all the players and highlight target player

-s, --sudo allows querying coordinate of protected players

Both 2 arguments requires admin permission level in the config file of this plugin

Changed in v2.2:

No longer supports arguments like -as and -sa, multiple players allowed

  1. !!here (can be modified in config): Broadcast your current coordinate

New in v2.1:

Inline !!here command divided by space can be responded if enabled

Optional argument can be used with both commands: (unavailable for inline !!here)

-h, --highlight Set highlight target player time, overrides config settings

Players won't be highlighted if their location is only queried, not broadcast

New in v2.2:

New optional argument -h <duration> introduced

Config File

Several features can be modified with configuration file, which will be generated automatically in config/where_is/config.json

Calling !!MCDR plg reload where_is to reload is required to make it loaded after modifying

Here is the config items in the file

Warning

These 2 items which are marked with asterisk below should be configured manually before you update to 2.x or you'll lose all the configuration during loading the new version!!! You can ignore this message if you haven't install this plugin before

Keys Value type Default value Introduction
enable_where_is bool true Set it to true to enable query other player location
enable_here bool true Set it to true to enable broadcast your location
enable_inline_here bool false Set it to true to make inline here enabled.
*command_prefix dict(which includes 2 items) In the following sheets Command prefix of this plugin
broadcast_to_console bool true !!here or !!vris <player> -a will also send message to server console
permission_requirements dict(which includes 3 items) In the following sheets Minimum permission of commands
*hightlight_time ``dict`(which includes 2 items) In the following sheets Highlight player time when coordinates are broadcasted to all the ones.
display_waypoints dict(which includes 2 items) In the following sheets If the text would include waypoint text of minimap
query_timeout int 3 Timeout of Minecraft Data API (seconds)
click_to_teleport bool true Allow player click to fill the teleport command (still requires operator permission)
location_protection dict(which includes 5 items) In the following sheets Player coordinate protection configuration
dimension_translation_mode Literal['mcdr', 'minecraft'] 'mcdr' mcdr: MCDReforged translates dimension names; minecraft: Minecraft translates dimension names. In 1.19 and later versions, using mcdr will avoid translation failure due to these dimension key change.
custom_dimension_name Dict[str, Dict[str, str]] Too long to show A mapping of dimension name translation for mcdr translation mode. This fist layer keys are the languages. The second layer keys are the dimension IDs (Non-vanilla dimensions are allowed. vanilla dimensions are required to fill and should omit the namespace).
custom_vanilla_translation_key Dict[str, str] Too long to show A mapping of dimension translation keys for minecraft translation mode. (Non-vanilla dimensions are allowed. vanilla dimensions are required to fill and should omit the namespace).

New in v2.1:

New configuration items: inline_here and custom_vanilla_translation_key

In the sheet above, the items which have stable items is showing below:

The asterisked items contents goes here:

Keys ofcommand_prefix Value type Default value Introduction
where_is str ['!!vris', '!!whereis'] Command prefix to query locations
here str ['!!here'] Command prefix to broadcast locations
Keys ofhighlight_time Value type Default value Introduction
where_is int 0 Highlight player time when querying other player's location and broadcast
here int 15 Highlight player time when broadcasting your location

The rest are the regular items:

Keys ofpermission_requirements Value type Default value Introduction
where_is int 1 Permissions which allows query location without extra arguments
here int 0 Permissions which allows broadcast your location without extra arguments
admin int 3 Permissions which allows query location with extra arguments
Keys ofdisplay_waypoints Value type Default value Introduction
voxelmap bool true If it is true a text ([+V]) will be displayed, click to highlight the location, ctrl-click to add waypoint to Voxelmap
xaero_minimap bool true If it is true a text ([+X]) will be displayed, click to add waypoint to Xaero's Minimap
Keys oflocation_protection Value type Default value Introduction
enable_whitelist bool false Enable querying whitelist, which blocks the player NOT in this list being queried
enable_blacklist bool true Enable querying whitelist, which blocks the player in this list being queried
whitelist list empty list whitelist, which blocks the player NOT in this list being queried
blacklist list empty list Enable querying whitelist, which blocks the player in this list being queried
protected_text dict 'en_us': 'He/She\'s in your heart!', 'zh_cn': 'Ta在你心里!' Text replied when querying blocked, supports language preference of MCDReforged

Example