更好的指南针方位角

更好的指南针方位角

🧭 更好的指南针 更好的指南针是一个轻量且完全可配置的Minecraft模组,在屏幕顶部添加现代化的指南针HUD。它显示基本方向(N • E • S • W)以及精确的朝向角度(以度为单位)

冒险

🧭 Better Compass

Better Compass 是一个轻量级且完全可配置的 Minecraft 模组,添加了一个带有方向指示器、坐标显示、生物群系信息和维度追踪的现代指南针 HUD。它具有完整的主题系统,包含多个预设主题和完整的服务端-客户端配置管理。

⚠️ 默认情况下,玩家物品栏中必须存在一个指南针,HUD 才会工作(可通过服务端或客户端设置进行配置)。

✨ 特性

📍 方向指示器 - 显示 8 个基本方位(N、NE、E、SE、S、SW、W、NW)
🎯 朝向角度 - 以度数显示精确的朝向方向,并带有平滑动画
📐 坐标显示 - 实时 X、Y、Z 坐标,位置和缩放可自定义
🌍 维度信息 - 显示当前维度(主世界/下界/末地)
🗺️ 生物群系显示 - 显示当前生物群系名称
🎨 主题系统 - 4 个预置主题(default、compact、colorful、immersive),完全可自定义
⚙️ 自定义主题 - 使用 50+ 个可配置参数创建无限数量的自定义主题
🔧 热重载 - 使用 /bettercompass theme reload 无需重启即可重载主题
🌐 完全自定义 - 通过 TOML 文件配置颜色、位置、大小和动画
📡 服务端覆盖 - 服务器可以强制所有连接的客户端使用指定的主题和设置
🧭 指南针需求 - 在服务端或客户端级别切换指南针需求
🚀 轻量级 - 针对最低性能影响进行了优化
💻 多平台 - 同时支持 Forge 和 Fabric

⚙️ 配置

该模组使用 TOML 配置文件进行完全自定义:

客户端配置(config/bettercompass/compass.toml):

requireCompass = false
currentTheme = "default"
  • requireCompass:如果为 true,则只有物品栏中有指南针时才会显示 HUD
  • currentTheme:选定的主题(default、compact、colorful、immersive 或自定义)

服务端配置(server_config.toml):

serverForceTheme = false
serverTheme = "default"
requireCompass = "client"
  • serverForceTheme:如果为 true,强制所有客户端使用指定主题
  • serverTheme:强制所有玩家使用的主题(如果 serverForceTheme = false 则忽略)
  • requireCompass:"client"(玩家选择)、"true"(必需)、"false"(可选)

🎨 主题系统

主题以 TOML 文件形式存储在 config/bettercompass/themes/ 中。每个主题包含:

  • 颜色:主色、副色、背景、文本、边框(ARGB 格式)
  • 尺寸:指南针大小、文本缩放、内边距、边框宽度
  • 位置:每个 HUD 元素的 X、Y 坐标
  • 坐标显示:位置、缩放和可见性
  • 维度显示:位置、缩放和可见性
  • 生物群系显示:位置、缩放和可见性
  • 动画:平滑旋转速度和其他效果
  • 元数据:主题名称、作者和描述

支持的颜色格式:

  • ARGB:0xAARRGGBB(例如,0xFF00FF00 表示不透明绿色)
  • Hex:#RRGGBB(例如,#00FF00)
  • RGB:rgb(255, 0, 0)
  • RGBA:rgba(255, 0, 0, 128)

示例主题(config/bettercompass/themes/custom.toml):

# Better Compass Theme: default
# Classic Better Compass theme

[metadata]
name = "default"
description = "Classic Better Compass theme"
author = "Better Compass"
version = "1.0"

[position]
hudPosition = "top-center"
hudOffsetX = 0
hudOffsetY = 0

[compass]
width = 400
height = 20
spacing = 90
scale = 1.0

[colors]
background = 0x80000000
border = 0xFFFFFFFF
text = 0xFFFFFFFF
direction = 0xFFAAAAAA
north = 0xFFFF0000
east = 0xFFFFFFFF
south = 0xFFFFFFFF
west = 0xFFFFFFFF
playerDirection = 0xFFFFFFFF
coordinates = 0xFFFFFFFF
dimension = 0xFFFFFFFF
biome = 0xFFFFFFFF

[playerDirection]
position = "center"
offsetX = 0
offsetY = 0

[coordinates]
show = true
position = "bottom-center"
offsetX = 0
offsetY = -15
format = "X: %d Y: %d Z: %d"

[dimension]
show = false
position = "below-coordinates"
offsetX = 0
offsetY = 12

[biome]
show = false
position = "below-dimension"
offsetX = 0
offsetY = 12

[appearance]
showBorder = false
borderWidth = 1
borderRadius = 3
showBackground = false
backgroundPadding = 4
textScale = 1.0
textShadow = false

[animation]
smoothRotation = false
rotationSpeed = 0.3

只需在 config/bettercompass/themes/ 中创建一个新的 TOML 文件,填入你自己的主题配置即可。该主题将自动加载并可通过命令使用。

所有命令均支持主题名称的 Tab 补全。

  • /bettercompass theme list - 显示所有可用主题,并标记当前主题
  • /bettercompass theme set <name> - 切换到指定主题(保存到配置)
  • /bettercompass theme current - 显示当前活动主题及其属性
  • /bettercompass theme reload - 从磁盘热重载所有主题(对开发者有用)

🌐 服务端兼容性

Better Compass 具有完整的服务端-客户端集成:

  • 仅客户端模式:在单人游戏中无缝运行
  • 服务端模式:管理员可以强制所有玩家使用指定主题和设置
  • 实时同步:玩家加入时配置更改立即同步
  • 覆盖系统:服务端主题强制优先于客户端偏好
  • 灵活性:单项设置可留给客户端选择,或在服务端范围内强制

🎯 默认主题

  1. default - 均衡、简洁的设计,适合大多数玩法
  2. compact - 针对较小屏幕和最小 HUD 占位进行优化
  3. colorful - 鲜艳的色彩,提供更好的可见性和视觉吸引力
  4. immersive - 微妙而优雅的设计,保留氛围感

💡 创建自定义主题

只需在 config/bettercompass/themes/ 中创建一个任意名称的新 TOML 文件即可。主题会自动加载并可通过命令使用。主题系统提供 50+ 个可自定义参数,以匹配任何玩家偏好或服务器美学。

🎯 模组目标

Better Compass 通过现代、高度可自定义的界面增强导航,同时保持与原版友好的平衡。无论你偏好简约的指南针还是功能丰富的 HUD,丰富的主题系统都能在单人游戏和多人游戏环境中满足每种玩法需求。