hCore [multi-functional developer tool] [Client-side NPC, Hologram and more] (1.8 - 1.20.x) - hCore多功能开发工具

hCore 是一个面向 Spigot 开发者的简化、多功能工具库。它提供了数十种开箱即用的功能，代码完全开源，并支持从 1.8 到 1.20.x 的所有 Minecraft 版本。

💡核心特性

hCore 包含以下功能模块，旨在简化插件开发流程：

• 注解命令 - 基于注解的命令系统，无需在 plugin.yml 中注册命令。
• NPC - 用于创建和管理客户端 NPC 的系统。
• 数据库 - 支持多种数据库的数据库实现系统。
• 全息图 - 用于创建和管理客户端全息文字的系统。
• 记分板 - 创建无闪烁记分板的系统。
• 消息 - 向玩家发送标题、动作栏或 Boss 血条消息的系统。
• 数据包 - 监听和向玩家发送数据包的系统。
• 事件订阅 - 无需创建监听器类即可注册事件监听的系统。
• 粒子 - 为任意玩家播放客户端粒子效果的系统。
• 渲染器 - 渲染并向最近玩家发送数据包的系统。
• 调度器 - 轻松创建新调度任务的系统。
• 库存 - 为玩家创建和打开特殊库存界面的系统。
• 铁砧 - 通过铁砧界面接收玩家输入的系统。
• 告示牌 - 通过告示牌界面接收玩家输入的系统。
• 世界边界 - 在客户端显示世界边界的系统。
• 物品构建器 - 用于轻松创建和管理物品堆的 HItemBuilder 类。
• Yaml - 用于轻松创建和管理 Yaml 配置文件的基础系统。
• 垃圾信息检测 - 检测指定 ID 是否在刷屏的系统。

🎮API 文档

所有 API 的使用方法均可从以下链接找到

• 主 API: https://hakan-krgn.github.io/hCore/api/
• 代理客户端 API: https://hakan-krgn.github.io/hCore/proxy-client/
• 代理服务端 API: https://hakan-krgn.github.io/hCore/proxy-server/

🔧项目依赖

通过 Maven 添加

在 `pom.xml` 中添加以下仓库和依赖

<repository>
    <id>jitpack.io</id>
    <url>https://jitpack.io</url>
</repository>

<dependency>
    <groupId>com.github.hakan-krgn.hCore</groupId>
    <artifactId>hCore-bukkit</artifactId>
    <version>0.7.2.0</version>
</dependency>

<dependency>
    <groupId>com.github.hakan-krgn.hCore</groupId>
    <artifactId>hCore-bungee</artifactId>
    <version>0.7.2.0</version>
</dependency>

通过 Gradle 添加

在 build.gradle 中添加以下仓库和依赖：

repositories {
    maven { url 'https://jitpack.io' }
}

dependencies {
    implementation 'com.github.hakan-krgn.hCore:hCore-bukkit:0.7.2.0'
    annotationProcessor 'com.github.hakan-krgn.hCore:hCore-bukkit:0.7.2.0'
    implementation 'com.github.hakan-krgn.hCore:hCore-bungee:0.7.2.0'
    annotationProcessor 'com.github.hakan-krgn.hCore:hCore-bungee:0.7.2.0'
}

hCore 插件文档

hCore 是一款功能丰富的 Minecraft 服务器核心插件，旨在为服务器管理员提供一系列强大的工具，用于管理玩家、物品、世界、经济等各个方面。它集成了多种实用功能，帮助简化日常管理任务并增强游戏体验。

💡功能特性

hCore 提供了广泛的管理和实用功能，主要包括：

玩家管理

• 查看与编辑玩家数据：检查并修改玩家的背包、末影箱、生命值、饥饿值、经验值、游戏模式、位置等信息。
• 高级封禁系统：支持临时/永久封禁、IP封禁、封禁原因记录及封禁列表查看。
• 历史记录查询：查看玩家的聊天、命令执行及登录历史。
• 传送管理：将玩家传送至指定位置或其他玩家处，或召唤玩家至自己身边。

物品与库存管理

• 物品生成：使用简单的命令生成任何物品，支持自定义数量、附魔、名称和描述。
• 物品修复：修复玩家手中或背包内所有物品的耐久度。
• 物品查看/编辑：查看其他玩家的背包和末影箱，并直接进行修改。
• 经验管理：给予或设置玩家的经验等级。

世界与服务器工具

• 时间与天气控制：设置特定世界的时间或天气。
• 服务器维护模式：开启后，只有拥有权限的玩家可以加入服务器。
• 世界管理：加载、卸载、创建、删除世界，并管理世界属性（如游戏规则）。
• 性能监控：查看服务器当前的 TPS（每秒刻数）和内存使用情况。

经济与虚拟货币（Vault 集成）

• 经济系统：如果服务器安装了 Vault 和经济插件，hCore 可以给予、设置或查看玩家的余额。
• 支付功能：允许玩家之间转账货币。

其他实用工具

• 清除实体：清除指定世界或所有世界中的掉落物、箭矢、经验球等实体。
• 玩家模拟：以其他玩家的身份执行命令或发送聊天消息。
• 死亡回溯：将玩家传送回上一次死亡的地点。
• 自定义广播：向全服发送格式化的公告消息。

🎮命令列表

hCore 拥有大量命令，主要命令为 /hcore 或简写 /hc。以下是一些常用命令示例：

核心与帮助

• /hcore - 显示插件信息。
• /hcore help - 显示详细的帮助页面。

玩家管理

• /hcore check <玩家名> - 检查玩家的游戏状态（生命值、饥饿值、位置等）。
• /hcore inventory see <玩家名> - 查看并编辑玩家的背包。
• /hcore enderchest see <玩家名> - 查看并编辑玩家的末影箱。
• /hcore ban <玩家名> [原因] - 封禁一名玩家。
• /hcore tempban <玩家名> <时长> [原因] - 临时封禁一名玩家（时长示例：1d2h30m）。
• /hcore banlist - 查看封禁列表。
• /hcore history chat <玩家名> - 查看玩家的聊天历史。
• /hcore tp <玩家名> - 传送到玩家身边。
• /hcore tphere <玩家名> - 将玩家召唤到自己身边。

物品与经验

• /hcore give <物品ID/名称> [数量] [玩家名] - 生成物品。若不指定玩家，则给予自己。
• /hcore repair hand - 修复手中的物品。
• /hcore repair all - 修复背包中所有物品。
• /hcore exp give <数量> <玩家名> - 给予玩家经验值。
• /hcore exp set <数量> <玩家名> - 设置玩家的经验等级。

世界与服务器

• /hcore time set <day/night/数值> [世界名] - 设置时间。
• /hcore weather set <sun/rain/thunder> [世界名] - 设置天气。
• /hcore maintenance <on/off> - 开启或关闭维护模式。
• /hcore tps - 查看服务器 TPS。
• /hcore clearentities <实体类型> [世界名] - 清除实体（如 item, arrow, all）。

经济（需 Vault）

• /hcore money give <数量> <玩家名> - 给予玩家金钱。
• /hcore money set <数量> <玩家名> - 设置玩家金钱。
• /hcore pay <玩家名> <数量> - 向其他玩家支付金钱。

🔧权限节点

hCore 的权限基于其命令结构，主要格式为 hcore.command.<子命令>。例如：

• hcore.command.give - 允许使用 /hcore give 命令。
• hcore.command.ban - 允许使用封禁命令。
• hcore.command.tp - 允许使用传送命令。
• hcore.command.maintenance - 允许切换维护模式。
• hcore.command.* - 授予所有 hCore 命令的权限（管理员推荐）。

您可以在权限管理插件（如 LuckPerms）中将这些权限分配给特定的组或玩家。

✨安装与依赖

要求

• 服务器软件：Spigot、Paper 或基于它们的衍生服务端（推荐 Paper 以获得最佳性能）。
• Java 版本：Java 8 或更高版本。
• Minecraft 版本：请使用与您的服务器版本兼容的 hCore 构建版本。

安装步骤

• 确保您的服务器正在运行受支持的服务端（如 Paper）。
• 从官方来源下载与您服务器版本兼容的 hCore.jar 文件。
• 将 hCore.jar 文件放入服务器的 plugins 文件夹中。
• 重启服务器。
• 启动后，插件会自动生成配置文件和数据文件夹。

可选依赖

• Vault：若要使用经济相关命令（如 /hcore money），必须安装 Vault 及一个兼容的经济插件（如 EssentialsX Econ、CMI、或单独的经济插件）。
• 其他依赖（如用于世界管理的 Multiverse-Core）是可选的，hCore 内置了基础的世界管理功能。

❓常见问题

• 问：安装后插件无法正常工作？
• 答：请确保您使用了正确的 jar 文件版本以匹配您的服务器版本。检查服务器启动日志中是否有错误信息，并确认您拥有必要的权限节点。

• 问：经济命令不起作用？
• 答：请确认您已安装 Vault 和一个支持的经济插件，并且它们都正常运行。使用 /hcore money 命令测试。

• 问：如何配置维护模式的消息？
• 答：维护模式的消息可以在插件生成的配置文件中进行自定义。首次运行后，在 plugins/hCore 文件夹中找到并编辑 config.yml 文件。

• 问：我可以翻译插件消息吗？
• 答：可以。hCore 支持多语言。您可以在配置文件夹中创建或编辑语言文件（如 messages_en.yml）来自定义消息。

• 问：如何备份玩家数据？
• 答：hCore 的数据通常存储在 plugins/hCore/data 目录中。定期备份整个 plugins/hCore 文件夹即可。

⭐支持与资源

• Wiki 与文档：本页内容基于 GitHub Wiki。请访问该链接获取最新、最详细的文档。
• 问题与反馈：如果您遇到漏洞或有功能建议，请在插件的 GitHub 仓库提交 Issue。
• 下载：请从官方发布页面或可信的插件平台下载 hCore，以确保文件安全。

注意：本插件功能强大，请谨慎使用管理员命令，尤其是在生产服务器上。建议先在测试环境中熟悉各项功能。