AgarthaLib - 核心库

💡Agartha 插件

Agartha 是一个为 Minecraft 服务器设计的综合性插件，旨在为玩家提供独特的传送、探索和社交体验。它允许玩家创建和管理个人传送点，探索由其他玩家建立的公共传送网络，并参与服务器社区活动。

🎮核心功能

传送系统

• 个人传送点：玩家可以设置和管理自己的私人传送点。
• 公共传送网络：探索并传送到其他玩家设立的公共传送点。
• 传送请求：向其他玩家发送传送请求，或邀请他们传送到你身边。
• 传送冷却与成本：可配置的传送冷却时间和经济成本（若服务器支持经济插件）。

社交与探索

• 传送点目录：浏览所有可用的公共传送点，附带描述和评级。
• 传送点收藏：将常用的传送点加入收藏夹以便快速访问。
• 社区活动：服务器可组织基于传送点的探索活动或寻宝游戏。

管理与配置

• 权限管理：细致的权限节点，控制谁可以使用各种功能。
• 多世界支持：可以在多个世界内设置和使用传送点。
• 高度可配置：通过配置文件调整消息、冷却时间、成本等。
• 数据存储：玩家数据安全存储，支持 MySQL 和 SQLite。

🔧基础命令与权限

玩家常用命令

• /warp [名称] - 传送到指定的公共传送点。
• /setwarp <名称> [描述] - 在当前位置创建一个公共传送点。
• /delwarp <名称> - 删除你创建的公共传送点。
• /tpa <玩家名> - 请求传送到目标玩家。
• /tpahere <玩家名> - 请求目标玩家传送到你身边。
• /tpaccept - 接受一个传送请求。
• /tpdeny - 拒绝一个传送请求。
• /home - 传送到你的家。
• /sethome - 设置你的家。
• /delhome - 删除你的家。

管理员命令

• /agartha reload - 重载插件配置。
• /warp admin <名称> <玩家> - 管理其他玩家的传送点。
• /agartha list - 列出所有公共传送点。

主要权限节点

• agartha.use - 允许使用基础传送功能。
• agartha.warp - 允许使用 /warp 命令。
• agartha.setwarp - 允许设置公共传送点。
• agartha.delwarp - 允许删除公共传送点。
• agartha.tpa - 允许使用传送请求。
• agartha.home - 允许设置和使用家。
• agartha.admin - 授予所有管理员权限。

✨安装与设置

安装步骤

• 确保服务器运行 Spigot、Paper 或兼容的衍生服务端（版本 1.16.5+ 推荐）。
• 将下载的 Agartha.jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 首次运行后，插件会在 plugins/Agartha 目录下生成配置文件和数据文件。

基础配置

编辑 config.yml 文件以自定义插件：

• 调整 cooldown-seconds 设置传送冷却时间。
• 在 economy-settings 部分设置传送成本（需要 Vault 和经济插件）。
• 修改 messages 部分自定义插件发送的提示信息。

数据库设置

插件默认使用 SQLite。如需使用 MySQL，请在 config.yml 中配置：

database:
  type: mysql
  host: localhost
  port: 3306
  name: minecraft
  username: user
  password: pass

❓常见问题

插件兼容性

• Q: Agartha 需要其他插件才能运行吗？
• A: 核心功能不需要。但若需经济功能（传送收费），则需要安装 Vault 和一个兼容的经济插件（如 EssentialsX Econ）。

• Q: Agartha 支持哪些 Minecraft 版本？
• A: 支持 1.13 及以上的版本。对于最佳体验，推荐使用 1.16.5 或更高版本。

功能使用

• Q: 为什么我无法设置传送点？
• A: 请检查：1) 你是否拥有 agartha.setwarp 权限；2) 当前位置是否允许设置（如是否在多世界禁用的世界内）；3) 是否已达到个人传送点数量上限。

• Q: 如何删除其他玩家设置的公共传送点？
• A: 拥有 agartha.admin 权限的玩家可以使用 /warp admin remove <传送点名称> 命令。

• Q: 传送请求没有反应怎么办？
• A: 请确认：1) 目标玩家在线；2) 目标玩家拥有 agartha.tpa 权限以接收请求；3) 你未处于传送冷却状态。

⭐注意事项

• 首次安装后，请务必重启服务器以生成完整的配置和文件夹结构。
• 定期备份 plugins/Agartha 文件夹，以防数据丢失。
• 在更改 config.yml 后，使用 /agartha reload 重载配置，但重大更改建议重启服务器。
• 确保为不同玩家组（如会员、管理员）正确配置权限节点，以管理功能访问权限。