🗺️ Maplands 插件可以将 Minecraft 世界渲染到地图上，以等距视角显示世界，连接地图，并创建服务器的巨大概览。该项目仍在开发中，未来将添加更多功能。

🗺️ Maplands

⚙️ 前提条件

• 需要最新版本的 BKCommonLib 才能使此插件正常工作。

🔗 链接

• Discord: https://discord.gg/q9gutsN
• Wiki: https://wiki.traincarts.net/p/Maplands
• 源码: https://github.com/bergerhealer/Maplands

🎮 使用方法

指令

• /map: 给自己一个 Maplands 地图。
  • 权限: maplands.command.map
• /map give [playername]: 给其他人一个 Maplands 地图。
  • 权限: maplands.command.give
• /map render [uuid]: 远程重新渲染一个 Maplands 地图。
  • 权限: maplands.command.render

权限

• maplands.changemap: 允许玩家修改地图方向/移动地图/向地图添加标记。

🕹️ 控制

手持地图时，你的移动会被锁定，可以使用 W/A/S/D 控制用户界面。

• 如果需要快速移动，可以更改所选物品或使用 Q 键将其移动到另一只手。
• 使用 WASD 移动地图或导航菜单。
• 使用 Shift 键（潜行）打开和关闭菜单。
• 使用空格键（跳跃）点击按钮。
• 在菜单外按空格键将重新渲染整个地图。
• 最后一个菜单选项允许启用标记/添加静态标记或其他配置选项。

📍 标记

你可以向地图添加标记。你可以启用显示玩家所在位置的标记，并配置是否显示玩家姓名、坐标或两者都显示。还可以启用标记以仅显示持有地图的玩家的位置。

静态标记可以在地图 UI 中配置。只需在选择“添加静态标记”时按空格键，然后配置标记。它将显示在列表中，然后可以稍后编辑。

🔄 实时更新

默认情况下，当发生方块物理变化时，地图会自动重新绘制部分区域。如果一直发生大量变化，这可能会导致服务器性能问题。你可以在设置菜单（最右边的按钮）中禁用地图的实时更新。然后，也可以通过按计划或手动执行 /map render [uuid] 命令来定期重新渲染地图。

注意: 显示错误会随着项目的成熟而修复。

⚙️ 配置示例

# Configuration file for Maplands

# Whether debug mode is enabled. When enabled, a lot of extra logging is performed.
debug: false

# Sets the tick interval at which the map is updated.
# Lower values mean more updates, but also higher CPU usage.
# Higher values mean less updates, but also a more laggy map.
# If set to -1, updating is disabled entirely. You will have to
# manually render maps using /map render to update them.
updateIntervalTicks: 2

# Whether signs should be rendered on the map
renderSigns: true

# Whether player heads should be rendered on the map
renderPlayerHeads: true

# Whether inventories (chests, etc.) should be rendered on the map
renderInventories: true

# Maximum amount of updates that can occur in a single tick.
# Helps prevent server lag when a large amount of changes occur
# at the same time.
maxUpdatesPerTick: 100

# Default map item material for new maps
defaultMapMaterial: MAP

# If the map item should be glowing when markers are configured
glowingMap: true

# The maximum zoom level players can zoom in/out on the map
maximumZoomLevel: 6

# Default map settings when creating a new map
defaultMapSettings:
  # Player marker configuration
  playerMarkers:
    enabled: true
    showName: true
    showCoordinates: false

  # Static markers configuration
  staticMarkers:
    enabled: true

# Map rendering settings
rendering:
  # Number of background render threads to use. More threads
  # result in faster rendering, but also higher CPU usage.
  backgroundThreads: 2

  # How often to invalidate chunks surrounding a chunk that changed.
  # A larger radius makes sure lighting is updated properly.
  # Setting this to 0 disables lighting updates entirely,
  # which drastically improves performance.
  lightingUpdateRadius: 2

  # The color to use for water. If set to null, the default
  # water color is used.
  waterColor: "#3F76E4"

  # The color to use for foliage. If set to null, the default
  # foliage color is used.
  foliageColor: "#00BE00"

  # The color to use for grass. If set to null, the default
  # grass color is used.
  grassColor: "#89D322"

  # Biome color overrides. Allows overriding the color of certain biomes.
  # If any of the colors are set to null, the default biome colors are used.
  biomeColors:
    minecraft:desert:
      foliageColor: "#F9E79F"
      grassColor: "#F9E79F"
    minecraft:savanna:
      foliageColor: "#F9E79F"
      grassColor: "#F9E79F"
    minecraft:savanna_plateau:
      foliageColor: "#F9E79F"
      grassColor: "#F9E79F"

# Map UI settings
ui:
  # The title of the main menu
  mainMenuTitle: "&6Maplands Menu"

  # The title of the player markers menu
  playerMarkersMenuTitle: "&6Player Markers"

  # The title of the static markers menu
  staticMarkersMenuTitle: "&6Static Markers"

  # The title of the settings menu
  settingsMenuTitle: "&6Settings"

  # The title of the add static marker menu
  addStaticMarkerMenuTitle: "&6Add Static Marker"

  # The title of the edit static marker menu
  editStaticMarkerMenuTitle: "&6Edit Static Marker"

  # The title of the name input menu
  nameInputMenuTitle: "&6Enter Name"

  # The title of the x input menu
  xInputMenuTitle: "&6Enter X Coordinate"

  # The title of the z input menu
  zInputMenuTitle: "&6Enter Z Coordinate"