# 世界信息
**Repository Path**: langle123/WorldInfo
## Basic Information
- **Project Name**: 世界信息
- **Description**: Bukkit世界信息插件
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-14
- **Last Updated**: 2026-01-23
## Categories & Tags
**Categories**: Uncategorized
**Tags**: Java, Minecraft, Bukkit
## README
# 🌍 WorldInfo - 世界信息插件
## 🔧 插件介绍
WorldInfo 是一个轻量级 Minecraft 服务端插件，提供有关当前世界的时间、天气、生物群系、月相等信息查询功能。支持 Spigot/Bukkit 服务器，并兼容 Minecraft 1.13 至最新版本（通过版本适配）。
---
## 📦 功能特性
- ✅ 实时显示当前世界时间（包括格式化输出）
- ✅ 显示当前天气状态（晴天、雨天、雷雨）
- ✅ 显示当前玩家所在位置的生物群系（Biome）
- ✅ 显示月相信息（满月、新月等8种月相）
- ✅ 显示天气持续时间
- ✅ 支持 PlaceholderAPI 集成，便于在其他插件中使用
- ✅ 兼容多个 Minecraft 版本（1.13+）
---
## 📁 命令列表
| 命令 | 权限 | 说明 |
|--------------|-------------------------------------|----------------|
| `/wi` | `WorldInfo.command` | 显示当前世界信息已经当前位置 |
| `/wi reload` | `WorldInfo.command.reload` (默认为 OP) | 重载插件配置文件 |
> 示例：`/wi`
---
## ⚙️ 配置文件说明
配置文件路径：`plugins/WorldInfo/config.yml`
### 天气名称映射：
```yaml
weather:
clear: 晴天
rain: 雨天
thunder: 雷雨天
```
### 时间段映射：
```yaml
time:
day: 白天
noon: 中午
dusk: 黄昏
night: 晚上
midnight: 午夜
dawn: 黎明
```
### 月相映射：
```yaml
moonPhase:
FULL_MOON: 满月
WANING_GIBBOUS: 亏凸月
LAST_QUARTER: 下弦月
CRESCENT: 残月
NEW_MOON: 新月
CRESCENT_WAXING: 蛾眉月
FIRST_QUARTER: 上弦月
WAXING_GIBBOUS: 盈凸月
```
### 生物群系映射（节选）：
```yaml
biome:
ocean: 海洋
plains: 平原
desert: 沙漠
```
你可以自定义这些映射以实现本地化或多语言支持。
---
## 🧩 PlaceholderAPI 支持
插件已集成 PlaceholderAPI 支持，可通过以下占位符获取信息：
| 占位符 | 说明 |
|----------------------------------------|---------------------|
| `%worldinfo_time%` | 当前世界时间（原始 tick 数） |
| `%worldinfo_formatted_time%` | 格式化后的时间（如 `06:12`） |
| `%worldinfo_weather%` | 当前天气类型（中文） |
| `%worldinfo_biome%` | 玩家当前位置的生物群系（中文） |
| `%worldinfo_moon_phase%` | 当前月相索引（0-7） |
| `%worldinfo_moon_phase_name%` | 当前月相名称（中文） |
| `%worldinfo_weather_duration%` | 当前天气持续时间（tick） |
| `%worldinfo_weather_duration_seconds%` | 当前天气持续时间（秒） |
| `%worldinfo_weather_duration_minutes%` | 当前天气持续时间（分钟） |
| `%worldinfo_weather_duration_hours%` | 当前天气持续时间（小时） |
| `%worldinfo_weather_duration_form%` | 当前天气持续时间（格式化 mm:ss） |
> 需要安装 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) 插件才能生效。
---
## 📦 依赖要求
- Java 8（JDK 1.8）
- Spigot/Bukkit 服务器（1.13+）
- 可选依赖：
- [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)（用于占位符支持）
---
## 🧪 开发者说明
- 使用 JetBrains 注解提高开发效率。
- 所有核心逻辑封装在 [WorldInfoUtil.java](https://gitee.com/wolf-music/WorldInfo\src\main\java\me\miencraft\plugin\worldinfo\WorldInfoUtil.java) 中。
- 提供版本判断工具方法以兼容不同 Minecraft 版本（如 1.16.4+）。
- 所有对外 API 方法均声明为 `public static`，方便扩展。
---
## 📥 安装步骤
1. 下载插件 JAR 文件。
2. 将其放入服务器的 `plugins/` 目录下。
3. 启动服务器。
4. （可选）编辑 `plugins/WorldInfo/config.yml` 自定义显示内容。
5. 使用 `/wi` 命令查看信息。
---
### 📦 仓库配置说明
```xml
Gitee-WolfMusic
https://gitee.com/wolf-music/maven-repository/raw/master/repository
```
---
### 🧩 依赖配置说明
```xml
me.miencraft.plugin
WorldInfo
1.0.0
provided
```
---
## 📝 贡献与反馈
欢迎提交 Issue 或 Pull Request！
GitHub 地址：[https://github.com/yourname/WorldInfo](https://github.com/yourname/WorldInfo)
---
## 📜 许可证
Apache-2.0
---
✅ 如需进一步定制、多语言支持或对接其他插件，请联系作者或参考源码中的 [Placeholder.java](https://gitee.com/wolf-music/WorldInfo/blob/master\src\main\java\me\miencraft\plugin\worldinfo\Placeholder.java) 和 [WorldInfoUtil.java](https://gitee.com/wolf-music/WorldInfo/blob/master\src\main\java\me\miencraft\plugin\worldinfo\WorldInfoUtil.java) 文件。
---
> **作者**: langle__
> **创建日期**: 2025年4月
> **版本**: 1.0.0
> **支持平台**: Spigot / Bukkit
> **适用 Minecraft 版本**: 1.13+