🧚 AdventureElf

一、简介

AdventureElf（原 AdventureSoulPets）—— 悬浮精灵宠物系统，玩家可收集、召唤精灵伙伴，获得各种技能增益。精灵以 ArmorStand 实体形式跟随玩家，支持骑乘、自定义名称、等级升级和跨服同步。

核心特性

  • 精灵收集 > 多种精灵，不同稀有度和技能
  • 技能系统 > 精灵提供战斗/生存/经济增益
  • 骑乘系统 > 骑乘精灵飞行/移动
  • 升级系统 > 1-10 级升级，+10%/级技能加成
  • 自定义名称 > 花费金币为精灵改名
  • 收藏 GUI > 可视化精灵收藏面板
  • 商店系统 > 精灵购买商店
  • PAPI 变量 > 11 个 PlaceholderAPI 占位符

二、插件前置

  • Vault — 可选，经济系统（升级/改名/商店）
  • PlaceholderAPI — 可选，PAPI 变量
  • PlayerPoints — 可选，点券经济
  • AdventureSkills — 可选，技能联动
下一篇安装与配置 →

📥 安装与配置

环境要求

项目要求
服务端Spigot / Paper 1.21+
Java21+

安装步骤

  1. 放入 AdventureElf-1.0.0.jar 到 plugins 目录
  2. 启动服务器自动生成配置
  3. 编辑 config.yml 配置精灵和商店
  4. /elf reload

架构 (23 类)

模块说明
AdventureElf主类
SoulPetEntity精灵实体（ArmorStand）
PetManager精灵召唤/召回/增益管理
DataManager数据持久化（YAML）
PlayerData玩家数据（拥有/等级/名称）
Settings配置管理
CollectionGui收藏面板 GUI
SoulPetCommand命令处理
PetListener事件监听
hook/PAPI/MCPlaceholders 集成
上一篇← 概览
下一篇精灵与技能 →

🧚 精灵与技能

精灵属性

  • 稀有度 — 不同颜色标识
  • 技能 — 每种精灵有独特技能
  • 技能等级 — 影响增益强度
  • ArmorStand — 悬浮跟随玩家的实体

骑乘系统

玩家可以骑乘精灵，获得飞行/移动能力。

  • 权限：elf.mount.bypass 绕过骑乘限制

收藏面板

CollectionGui 提供可视化精灵收藏面板，展示所有已拥有的精灵，支持快速召唤。

上一篇← 安装与配置
下一篇升级与改名 →

⬆️ 升级与改名

升级系统

参数说明默认
最大等级精灵最大可升级等级10
基础费用1 级升级所需金币500
费用倍率每级费用递增系数1.5x
技能加成每级增加技能效果+10%
upgrade:
  max-level: 10
  base-cost: 500
  cost-multiplier: 1.5
  skill-bonus-percent: 10

费用公式：base-cost × multiplier^(level-1)

有效技能等级：baseLevel + round(baseLevel × (level-1) × bonusPct / 100)

改名系统

参数说明默认
费用改名所需金币200
最大长度名称最大字符数8
  • 仅支持中文/英文/数字，不允许符号和颜色码
  • 显示格式：自定义名§7(原名)

PAPI 占位符

占位符说明
%soulpet_name%当前精灵名称
%soulpet_custom_name%自定义名称
%soulpet_rarity%稀有度
%soulpet_skill%技能名称
%soulpet_level%精灵等级
%soulpet_owned%拥有精灵数量
%soulpet_has_active%是否有活跃精灵
上一篇← 精灵与技能
下一篇命令列表 →

⌨️ 命令列表

主命令 /elf

别名：/elfs

命令说明权限
/elf summon <精灵>召唤精灵elf.use
/elf recall召回精灵elf.use
/elf list列出拥有的精灵elf.use
/elf info查看当前精灵信息elf.use
/elf rename <名称>为精灵改名elf.use
/elf upgrade升级精灵elf.use
/elf shop精灵商店elf.shop
/elf collection收藏面板elf.use
/elf help帮助信息elf.use
/elf reload重载配置elf.admin
/elf give <玩家> <精灵>给予精灵elf.admin
上一篇← 升级与改名
下一篇权限与集成 →

🔑 权限与集成

权限节点

权限说明默认
elf.use基础使用true
elf.shop使用商店true
elf.admin管理员权限OP
elf.mount.bypass绕过骑乘限制OP
上一篇← 命令列表
© 2024-2026 Feiiy · AdventureElf 精灵宠物系统 · QQ: 823959438