🧭 SimpleCompass

SimpleCompass 是一款 Minecraft 插件，旨在方便地在动作栏或 Boss 栏区域显示一个或两个指南针。它经过多次演变，如今已成为功能丰富且可高度配置的指南针插件。此外，它还支持通过可选模块进行扩展，以追踪位置、玩家等。

🛠️ 安装

本插件无任何依赖，只需将 jar 文件放入插件目录，然后重启或重载服务器即可。所有配置参数均在 config.yml 文件中进行详细说明。

要使用 /sctrack 命令，你需要至少安装一个追踪器插件。你可以在以下位置找到它们：

• CoordsTracker: 允许追踪特定坐标。
• DeathPosTracker: 允许追踪上次死亡的位置。
• PapiPositionTracker: 允许追踪使用 PlaceholderAPI 占位符定义的位置。
• PlayerTracker: 允许追踪玩家的位置。
• PositionTracker: 允许追踪静态位置。

请注意，你需要单独下载这些追踪器插件，并将它们放入 plugins/SimpleCompass/trackers 文件夹中。

➕ 自定义追踪器插件

如果你具备 Java 技能，可以通过扩展专用 jar 文件中的 AbstractTracker 类来开发自己的追踪器插件。你可以参考现有追踪器的代码作为示例。完成后，请将链接发送给我，我会将你的插件添加到插件页面列表中。

制作自定义追踪器插件非常简单（至少对于开发人员而言）。因此，如果你需要一个，可以向开发人员寻求帮助，他们应该能够免费或以较低的价格快速完成。

🔒 权限

所有权限及其简要说明都列在 plugin.yml 文件中。如果使用追踪器插件，则可以使用其他权限。请查看你的追踪器的 GitHub 页面以了解它们。

⌨️ 命令

• /scompass: 显示书本界面，这是使用该插件的最简单方法。
• /scompass-reload (或 /screload): 重新加载配置。
• /scompass-option (或 /scoption, 或 /scompass option [*]): 显示一个基于文本的菜单，用于选择指南针的显示位置、时间和方式。但如前所述，最简单的方法是使用 /scompass。
• /scompass-track (或 /sctrack, 或 /scompass track [*]): 如果你至少安装了一个追踪器插件，则可以使用此命令管理你的追踪。
• /scompass-toggle (或 /sctoggle): 快速切换指南针的开启/关闭状态。

如果你喜欢，可以直接使用参数运行 /scompass-option 命令 (/scompass-option <option> <type>)。

[*]: "option" 和 "track" 是默认的英语关键词，你可以在本地化文件中更改它们。例如，在法语中，默认值为 "option" 和 "piste"。

⚙️ 配置示例

#Configuration file of SimpleCompass

#Settings :
settings:
  #Use the actionbar for the compass (true) or the bossbar (false)
  use_actionbar: true

  #Display compass only to player with the permission
  permission_needed: false

  #Display the compass only when the player is in a vehicle (boat, horse, minecart, ...)
  only_in_vehicle: false

  #Display the compass only when the player is using elytra
  only_with_elytra: false

  #Choose the mode :
  # ALWAYS: Always display the compass (if not in vehicle and only_in_vehicle is true)
  # NEVER: Never display the compass, except if you force it with a command
  # VEHICLE: Only display the compass if the player is in a vehicle (boat, horse, minecart, ...)
  # ELYTRA: Only display the compass if the player is using elytra
  # BOTH: Only display the compass if the player is in a vehicle OR using elytra
  # VEHICLENOELYTRA: Only display the compass if the player is in a vehicle and NOT using elytra
  # ELYTRANOVEHICLE: Only display the compass if the player is using elytra and NOT in vehicle
  default_mode: "ALWAYS"

  #Use the 360° mode instead of 180°
  use_360_mode: false

  #Each tick, there is a chance of "update_rate" % to refresh the compass
  #For example, if you set it to 50, the compass will be updated 1 time every 2 ticks on average.
  #Values between 1 and 100
  update_rate: 100

#ActionBar settings
actionbar:
  #Text of the compass, use color codes with &
  text: "&e{compass}"

#BossBar settings
bossbar:
  #Text of the compass, use color codes with &
  text: "{compass} &b{distance}"

  #Color of the bossbar (BLUE, GREEN, PINK, PURPLE, RED, WHITE, YELLOW)
  color: "BLUE"

  #Division of the bossbar (SIX, TEN, TWELVE, TWENTY)
  division: "TWELVE"

  #Level of the bossbar
  #If you set a number, it will be a fixed level.
  #If you set "elytra", the level will be the durability of the elytra
  level: "elytra"

#Compass settings
compass:
  #Characters used for each direction
  north: "N"
  south: "S"
  east: "E"
  west: "W"

  #Characters used for intermediate directions
  north_east: "NE"
  south_east: "SE"
  north_west: "NW"
  south_west: "SW"

  #Character used to fill empty space
  space: "."

  #Character used to indicate the current direction
  pointer: "|"

  #Size of the compass
  size: 20

#Locales
locales:
  #Default locale (if the player hasn't chosen one)
  default: "en"

  #Available locales files (without the .yml extension)
  available:
    - "en"
    - "fr"

Minecraft 版本

• Native Minecraft Version: 1.13
• Tested Minecraft Versions: 1.13 1.14 1.15

🌐 支持的语言

全部（编辑 config.yml，默认为 FR 和 EN）