>[danger] 接入道具需要让你的模块依赖`ItemModule`模块
物品组件顶层接口为 `com.pxpmc.pxrpg.api.item.piece.common.BuildPiece`
pr同时也封装了一些基本类型的抽象类 `com.pxpmc.pxrpg.api.item.piece.common.BasicItemBuildPiece`
![](https://img.kancloud.cn/23/f2/23f23f9b53f16ea5bcb03255d8bc5003_1109x371.png)
>[danger]写一个自定义`MyItemStrPrice`组件,继承`StringPiece<ItemInter>` 泛型填入 `ItemInter` -> 道具中间件
这个组件只支持道具(Item)
![](https://img.kancloud.cn/b3/5a/b35a1ddeb2a9c1c25defd6d3af047c38_873x736.png)
>[danger]然后在自身的模块中维护并注册这个组件
![](https://img.kancloud.cn/7d/2b/7d2b04e7279f5252a6f512855bbb386e_774x1054.png)
>[danger] 在某些操作的时候获取到自定义组件值
![](https://img.kancloud.cn/36/f2/36f24d168584aa7430def5b87d9253dd_1006x413.png)
>[danger] 接入装备(Equip)或宝石(Gem)也是同理
![](https://img.kancloud.cn/5f/5d/5f5dc5b886c4a539721e57c2c734bd03_564x485.png)
>[danger]完整代码 `MyItemModule`
```
/**
* 道具组建示例
*/
public class MyItemModule extends AbstractModule {
private MyItemStrPrice myItemStrPrice;
public MyItemModule(Plugin plugin) {
//这里需要传入pxrpg的代理插件类
super(MAPI.getBukkitPxRpgAPI().toPxRpgPlugin(plugin));
}
@Override
public String getModuleName() {
return "MyItemPrice";
}
@Override
public String[] getDepends() {
return new String[]{
//ItemModule强依赖道具模块
"ItemModule"
};
}
/**
* 通过返回方法让其他模块可以调用这个组件
*/
public MyItemStrPrice getMyItemStrPrice() {
return myItemStrPrice;
}
@Override
public void onInitialization() {
//在初始化方法中先new一个组件对象
myItemStrPrice = new MyItemStrPrice();
}
@Override
public void onLoad() {
//在初始化完成后注册道具组件
//获取到道具模块
ItemModule module = Module.getModule(ItemModule.class);
//获取道具管理器注册道具组件
module.getItemManager().registerItemBuildPiece(myItemStrPrice, super.getPlugin());
}
}
```
>[danger]完整代码 `MyItemPrice`
```
public class MyItemStrPrice extends StringPiece<ItemInter> {
public MyItemStrPrice() {
//传入道具配置的根节点路径
//如: name
// type
// equip-exp
super("my-item-str");
//让组件能够读取到配置内容
autoLoad(false);
//注册道具变量
//在道具模板内, 可以使用 {item.my-item-str} 来解析成道具配置的文本
autoVariable();
//注册元数据序列化
//会自动把值写入道具NBT,方便后面做操作,如: 强化后更改这个数值,绑定后修改为玩家名字做为绑定对象
//参数为NBT的key,不可为null,不可重复
//autoMetaSerialize("myitemstr");
//Tip: 一般这种是不需要从配置读取,根据玩家操作进行更改(如强化等级,宝石镶嵌等),或者从创建参数中传递的参数进行设置值
// 如果要使用这种, 就不需要 autoLoad(false);
}
@Override
protected String getDefaultValue() {
return "my-item-str-默认值";
}
}
```
- 通用配置(使用px之前先看这里)
- 1分钟搭建数据库
- 1分钟搭建Redis环境教程
- 常见问题与报错
- [技能驱动]PxSkilldrive
- 介绍
- config配置
- 所有指令
- 单个技能完整配置
- MythisMobs技能配置
- 自带的技能系统[1.1.4+]
- 打开技能组
- PlaceHolderAPI变量
- 更新日志
- [商会]PxMerchant
- 介绍
- 配置文件
- 更新日志
- [帮派]PxGangs
- 介绍
- 用前必看
- 指令一览
- 职位/权限
- 帮派数据/建筑
- PlaceHolderAPI变量
- 兼容插件
- 更新日志
- [商店]PxShop
- 介绍
- 完整商店配置
- 货币/商品
- 更新日志
- [在线/成就奖励]PxLoginRewards
- 介绍
- 安装使用
- 完整配置
- 要求/奖励
- 更新日志
- [属性]PxRpg
- 介绍
- 安装使用
- 模块文件夹
- 指令
- 属性
- 属性是什么
- 如何创建属性
- 属性组
- 如何利用属性打出伤害(已过时)
- 词条
- 介绍
- 随机词条组列表[4.4.2+]
- 职业
- config[已过时]
- 创建一个职业[已过时]
- 职业[4.3.0+]
- config[4.3.0+]
- 怪物
- 天生属性[4.5.4+]
- 装备
- 装备配置文件
- 让装备获得属性
- 装备变量[已过时]
- 装备类型
- 手持武器[4.5.3+]
- 切换装备[4.5.3+]
- 物品显示模板(lore内容)
- 装备模板的使用
- 物品
- 普通物品
- 消耗品
- 回血道具[旧版]
- 代码回血/回蓝(4.3.0+)
- code代码执行(4.3.0+)
- 介绍
- 例子
- Buff相关
- 传送相关
- 执行3种指令
- 洗炼道具
- 强化类
- 强化道具
- 强化保护券
- 强化券
- 强化转移道具
- 解绑道具
- 宝石相关
- 打孔道具
- 摘除宝石
- 绑定系统
- 绑定类型
- 战斗系统
- 战斗公式变量(已弃用)
- 配置战斗公式[4.3.0+]
- 攻击类型列表
- 自定义伤害类型
- 伤害机制
- 伤害显示
- 掉落
- 掉落类型(已弃用)
- 配置怪物掉落包
- 掉落包[4.3.0+]
- Buff
- 介绍
- buff支持的词条
- 给予buff的方法
- 显示相关
- 萌芽显示
- 龙核相关
- 套装
- 介绍
- 技能[4.5.1+]
- 介绍
- 配置技能
- 技能词条介绍
- 钩子模块[4.5.1+]
- 介绍
- 监听器API
- [自身]Monitor.yml
- [装备容器]Equip Container.yml
- [鉴定]Appraisal.yml
- [绑定]Bind.yml
- [怪物]Mob.yml
- [Buff]Buff.yml
- [分解]Decompose.yml
- [战斗]Fight.yml
- [职业]Occupation.yml
- [玩家]Player Data.yml
- Mythicmobs
- 兼容mm技能(不推荐)
- 如何让MM打出伤害
- MM技能Buff(4.1.1新增)
- MM技能触发Pr伤害(4.2.1+)
- SkillAPI(4.3.0)
- 同步SkillAPI职业
- 战斗公式变量(已弃用)
- 个人变量(已弃用)
- 覆盖技能伤害
- Buff(4.1.1新增)
- 给Mob添加Buff(4.1.1新增)
- 治疗/回蓝组件(4.3.0+)
- PlaceholderAPI变量
- 统计(4.1.0更新)
- [附属]装备经验和升级
- 使用教程
- [附属]物品拓展功能
- 介绍
- [ExtendGui]窗口环境的所有方法
- [ExtendData]拓展数据所有方法
- 类方法
- [工具类]QuickTools
- [拓展数据]ExtendData
- [拓展属性]Attr
- [拓展技能]SkillLv
- 物品生成时添加
- 属性拓展
- 技能拓展[1.0.1+]
- 大量例子
- [福利]提交活动
- 作者发布
- 简单强化
- 界面锁定
- 延迟强化
- 菜单例子
- 吞噬物品永久保存
- 安笙
- 作者介绍
- 词条强化[暂无法使用 等待更新]
- 酒桶
- 作者介绍
- 更新日志
- [附属]萌芽装备容器
- 介绍
- 例子
- 常用工具类
- [数据容器]UMap
- [属性对象]Att
- [对象BUFF]BuffContainer
- [技能对象]USKill
- 接入PxRpg插件(开发者)
- 注册模块入口
- 接入属性
- 模块配置读取
- 接入物品
- 道具生成
- 道具数据获取
- 设置数据并渲染
- 自定义道具组件
- 具有生成参数的组件
- 集成模块介绍
- 更新日志
- 视频预览
- 4.3.0+新版公式教程
- 简介(内含旧版公式转换器)
- 教程(战斗公式篇)(必先学)
- 传递参数和类型的常用方法(重要)
- 单例属性教程(含战斗力变量教程)
- 道具消耗品(含属性加成)
- 装备/宝石/怪物的属性词条
- Buff新版词条(内含属性加成)
- Drop掉落物配置(内含属性掉落加成)
- [副本]PxInstance-Pro
- 介绍
- 世界规则
- 指令详解
- 副本规则(rule)
- 触发器(trigger)
- 触发器参数详解
- 条件(condition)
- 事件(event)
- 副本流程详解
- 根据难度初始化怪物
- 判定通关条件,发放通关奖励
- 副本倒计时/超时处理
- 动态创建倒计时
- 结算奖励
- 副本自带变量
- PlaceholderAPI变量
- 更新日志
- [副本]PxInstace(不再更新)
- 介绍
- 安装使用
- 配置教程
- PlaceholderAPI变量
- 流程配置
- [队伍]PxTeam-Pro
- 介绍
- HUD设置教程
- 变量大全
- 配置文件
- config.yml
- 开发者
- 调用API
- 更新日志
- [任务]BookQuest
- 介绍
- 完整任务配置
- 4种状态显示[4.2.1+]
- 要求/奖励
- 更新日志
- [对话]PxDialogue
- 介绍
- 完整的对话配置
- 一个住酒店的例子
- 更新日志
- [采集]PxCollect
- 介绍
- 作物配置
- 区域生成
- 种植配置
- 条件/事件
- 更新日志
- [技能快捷键]PxQuickSkill
- 介绍
- [仓库]PxWarehouse
- 介绍
- 更新日志
- [拍卖行]PxAuction
- 介绍
- [队伍]PxTeam(不再更新)
- 介绍
- [锻造]PxForging
- 介绍
- 材料/产物
- 完整的锻造配置
- 更新日志
- [邮箱]PxEmail
- 介绍
- PlaceHolderAPI变量
- 编辑邮件模板
- 编辑玩家群
- 编辑系统类型
- 编辑定时邮件
- 权限
- 更新日志
- [MM管理]PxMMSpawner
- 介绍
- 更新日志
- [前置]PxTools(通用部分)
- 介绍
- 掉落物显示[1.12.2+]
- 函数[弃用]
- abs
- ceil
- decimals
- floor
- format
- gradual
- if
- max
- min
- pow
- prd
- random
- randomint
- randomweight
- repeat
- round
- sum
- time
- 要求/奖励(1.9.0+)
- 时间要求(1.9.1+)
- 条件/事件
- 指令
- 事件组
- PlaceholderAPI变量
- 更新日志
- 一些通用的工具类
- 介绍[必看]
- [经济]Vault
- [点券]PlayerPoints
- PxTools相关
- [玩家变量]VarAPI
- [玩家标签]TagAPI
- [玩家计数器]CountAPI
- [时间相关]Date
- [数学函数]Math
- [变量API]PlaceholderAPI
- [自定义冷却]CooldownUtil
- [数字千分化]NumFormat
- [萌芽API]GermAPI
- 消息转发[1.12.3+]