GeoLoc

插件

· 作者 TSERATO

一个用于获取玩家地理位置的简单插件。

0 本站下载 0 关注 更新于 1 年前

最新 1.0 · 1.21.4 · Folia / Paper

一键开服(送7天)

GeoLoc

Paper 服务器的先进地理定位插件

描述

GeoLoc 是一款功能强大的 Paper 服务器地理定位插件,允许管理员查看玩家的近似地理位置。通过 GeoLoc,服务器管理员可以轻松了解社区成员从世界各地连接的来源地,从而增强社区建设和管理功能。

特性

  • 快速且可靠: 使用多个地理定位 API 以确保位置数据的准确性
  • 灵活的命令: 查看完整的地理定位数据或仅查看特定信息(城市、地区、国家、当地时间)
  • PlaceholderAPI 支持: 使用我们的 PAPI 扩展将地理定位数据集成到其他插件中
  • 自定义消息: 通过 messages.yml 配置文件完全自定义消息
  • 加入消息: 玩家加入服务器时可选的位置公告
  • Tab 补全: 为在线玩家提供有用的 Tab 补全功能
  • 轻量级: 对服务器性能的影响极小

命令

/geoloc reload - 重载插件配置
/geoloc geolocation <player> - 查看完整地理定位数据
/geoloc geolocation full <player> - 带有玩家建议的查看完整地理定位数据
/geoloc geolocation city <player> - 仅查看城市信息并带有玩家建议
/geoloc geolocation region <player> - 仅查看地区信息并带有玩家建议
/geoloc geolocation country <player> - 仅查看国家信息并带有玩家建议
/geoloc geolocation localTime <player> - 仅查看当地时间信息并带有玩家建议

权限

  • geoloc.admin - 访问所有 GeoLoc 命令
  • geoloc.see - 允许玩家查看加入消息

PlaceholderAPI 集成

安装 PlaceholderAPI 后,GeoLoc 提供以下占位符:

%geoloc_full% - 完整的地理定位信息
%geoloc_city% - 玩家所在城市
%geoloc_region% - 玩家所在地区/州
%geoloc_country% - 玩家所在国家
%geoloc_localtime% - 玩家当地时间

配置

GeoLoc 包含两个配置文件:

  • config.yml - 主插件设置
  • messages.yml - 所有插件功能的可自定义消息
config.yml
# GeoLoc 插件配置

# 设置为 true 以向玩家显示带有其位置的欢迎消息
# 设置为 false 以禁用欢迎消息
# 实际消息内容位于 messages.yml 中
join-message-enabled: true

# 权限:
# geoloc.admin - 允许重载配置
# geoloc.see - 允许查看加入消息(如果启用)
messages.yml
# GeoLoc 插件消息
# 您可以使用 & 颜色代码(例如 &a 表示绿色,&c 表示红色)
# join-message 可用的占位符:
# {player} - 玩家名称
# {city} - 城市
# {region} - 地区/州
# {country} - 国家
# {localTime} - HH:mm:ss 格式的当地时间

# 每条消息可用的占位符由全部大写定义

# 消息前缀
# NONE
prefix: "&c&lGeoLoc &7&l→ &r"

# 当玩家地理定位返回 null 时的默认值(当他们处于本地网络时)
# NONE
default-location-value: "Unknown"

# 加入消息(向所有玩家广播)
# PLAYER, CITY, REGION, COUNTRY, LOCALTIME
join-message: "&a玩家 &e{player} &a来自 &6{city}, {region}, {country}&a!当地时间为 &b{localTime}&a。"

# 命令消息
command:
  # NONE
  reload-success: "&aGeoLoc 配置已成功重载!"
  # NONE
  no-permission: "&c您没有权限使用此命令。"
  # PLAYER, CITY, REGION, COUNTRY, LOCALTIME
  location: "&a玩家 &e{player} &a来自 &6{city}, {region}, {country}&a!当地时间:&b{localTime}"

# 日志消息(仅限控制台)
log:
  # PLAYER, CITY, REGION, COUNTRY, LOCALTIME
  player-connected: "{player} 连接自:{city}, {region}, {country}(当地时间:{localTime})"
  # PLAYER
  no-ip: "无法获取玩家 IP 地址:{player}"
  # PLAYER
  no-geolocation: "无法获取玩家地理定位数据:{player}"

error:
  # PLAYER
  player-not-found: "&c找不到 {player} 或该玩家不在线。"
  # PLAYER
  ip-not-found: "&c无法从 {player} 获取 IP。"
  # PLAYER
  geolocation-not-found: "&c无法从 {player} 获取地理定位数据。"

# 可能的占位符:
#  - %geoloc_full% -> 返回玩家的所有地理定位信息
#  - %geoloc_city% -> 返回玩家的城市
#  - %geoloc_region% -> 返回玩家的地区
#  - %geoloc_country% -> 返回玩家的国家
#  - %geoloc_localTime% -> 返回玩家的当地时间(按地区计算)

# 所有占位符的返回格式可在下方定义

# PlaceholderAPI 返回格式
placeholder:
  full: "{city}, {region}, {country}, {localTime}"
  city: "{city}"
  region: "{region}"
  country: "{country}"
  localTime: "{localTime}"

支持

如需支持,请访问我们的 Discord 服务器或在我们的 GitHub 仓库中创建问题。

免责声明

本插件基于 IP 地址提供近似的地理定位数据,不应被视为 100% 准确。提供的数据仅用于一般信息目的,不应用于任何关键决策。本插件依赖于第三方地理定位服务,这些服务的准确性可能因地区而异。

GeoLoc 尊重玩家隐私,仅提供一般位置信息(城市、地区、国家、当地时间),而不是精确坐标。服务器管理员应告知玩家,这些信息可能对服务器工作人员可见。

GeoLoc 与本插件中使用的任何地理定位服务提供商均无关联。我们不对这些服务提供的任何数据不准确负责。

© 2025 TSERATO | 版本 1.0

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源