描述
此 API 旨在让插件开发人员轻松添加自定义粒子投射物,这也是其命名的由来。ParticleProjectileApi 自带其专属的事件类,为开发者提供了一种在粒子命中时取消效果的方法这在迷你游戏中非常有用,可用于防止友军伤害。完全有可能创建多个投射物类,且官方鼓励这样做。在扩展 ParticleProjectile 类时,开发者将面临五个方法:OnHit、OnHitBlock、OnHitEntity、OnPenetrateBlock、OnPenetrateEntity 和 OnMove。这些方法允许在投射物命中、穿透某物或移动时运行代码。
功能特性
- 发射粒子的方法(不使用数据包)
- 可取消的自定义事件
- 为不同效果创建多个投射物类
- 更多功能即将推出!
用法
MyProjectile.class
package com.aim.coltonjgriswold.projectiles;
import org.bukkit.Location;
import org.bukkit.block.Block;
import org.bukkit.entity.Damageable;
import org.bukkit.entity.Entity;
import org.bukkit.entity.Player;
import com.aim.coltonjgriswold.api.ParticleProjectile;
public class MyProjectile extends ParticleProjectile {
public MyProjectile() {
super(Particle.REDSTONE, 0.1, 7.5, 20.0 , 128.0);
setColor(ParticleColor.fromRGB(255, 0, 0));
//使用红色颜色、大小为 0.1 立方体的碰撞箱、7.5 克的质量、20.0 米/秒的速度和 128 米的最大距离初始化投射物
}
@Override
public void OnLaunch(LivingEntity who, Location start) {
//发射时执行某些操作
}
@Override
public void OnHit(LivingEntity who, Location end) {
//达到最大距离时执行某些操作
}
@Override
public void OnHitBlock(LivingEntity who, Location end, Block what) {
//命中方块时执行某些操作
}
@Override
public void OnHitEntity(LivingEntity who, Location end, Entity what) {
//命中实体时执行某些操作
}
@Override
public void OnPenetrateBlock(LivingEntity who, Location where, Block what) {
//穿透方块时执行某些操作
}
@Override
public void OnPenetrateEntity(LivingEntity who, Location where, Entity what) {
//穿透实体时执行某些操作
}
public void OnMove(Location previous, Location current, double step) {
//粒子移动时执行某些操作
}
}
package com.aim.coltonjgriswold;
import org.bukkit.Material;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerInteractEvent;
import org.bukkit.plugin.java.JavaPlugin;
import org.bukkit.util.Vector;
import com.aim.coltonjgriswold.api.utilities.ParticleColor;
import com.aim.coltonjgriswold.projectiles.MyProjectile;
public class MyPlugin extends JavaPlugin implements Listener {
MyProjectile projectile;
public void onEnable() {
getServer().getPluginManager().registerEvents(this, this);
projectile = new MyProjectile();
}
public void onDisable() {
}
@EventHandler
public void oninteract(PlayerInteractEvent event) {
Material item = event.getPlayer().getInventory().getItemInMainHand().getType();
if (item == Material.STICK) {
//开启物理效果发射 MyProjectile
projectile.launch(event.getPlayer(), true);
}
}
}
利用 ParticleProjectileApi & Javadocs 的示例插件
Javadocs: ParticleProjectileApi
合作方
正在考虑购买专用服务器?试试 Kinetic hosting!
结账时使用代码 'UberDiscount',首月可享 15% 折扣!
点击下方链接立即开始!
Description
This API is designed to allow plugin developers to easily add customized particle projectiles, hence the name. ParticleProjectileApi comes with its own event classes giving the developer a way to cancel an effect when a particle hits, this is quite useful in say mini-games to prevent friendly-fire. It is completely possible to create multiple projectile classes and is encouraged too. When extending the ParticleProjectile class, the developer will be met with five methods: OnHit, OnHitBlock, OnHitEntity, OnPenetrateBlock, OnPenetrateEntity, and OnMove. These methods allow for adding code to run when a projectile hits, passes through something, or moves.
Features
- method to launch particles (No packets used)
- Custom events that can be canceled
- Create multiple projectile classes for different effects
- More to come!
Usage
MyProjectile.class
package com.aim.coltonjgriswold.projectiles;
import org.bukkit.Location;
import org.bukkit.block.Block;
import org.bukkit.entity.Damageable;
import org.bukkit.entity.Entity;
import org.bukkit.entity.Player;
import com.aim.coltonjgriswold.api.ParticleProjectile;
public class MyProjectile extends ParticleProjectile {
public MyProjectile() {
super(Particle.REDSTONE, 0.1, 7.5, 20.0 , 128.0);
setColor(ParticleColor.fromRGB(255, 0, 0));
//Initialize a projectile with a color of red, a hitbox with size 0.1 cubed, Mass of 7.5 grams, speed of 20.0 meters/second, max distance of 128 meters
}
@Override
public void OnLaunch(LivingEntity who, Location start) {
//Do something when launch
}
@Override
public void OnHit(LivingEntity who, Location end) {
//Do something when reach max distance
}
@Override
public void OnHitBlock(LivingEntity who, Location end, Block what) {
//Do something when hit block
}
@Override
public void OnHitEntity(LivingEntity who, Location end, Entity what) {
//Do something when hit entity
}
@Override
public void OnPenetrateBlock(LivingEntity who, Location where, Block what) {
//Do something when passing through a block
}
@Override
public void OnPenetrateEntity(LivingEntity who, Location where, Entity what) {
//Do something when passing through an entity
}
public void OnMove(Location previous, Location current, double step) {
//Do something when the the particle moves
}
}
package com.aim.coltonjgriswold;
import org.bukkit.Material;
import org.bukkit.event.EventHandler;
import org.bukkit.event.Listener;
import org.bukkit.event.player.PlayerInteractEvent;
import org.bukkit.plugin.java.JavaPlugin;
import org.bukkit.util.Vector;
import com.aim.coltonjgriswold.api.utilities.ParticleColor;
import com.aim.coltonjgriswold.projectiles.MyProjectile;
public class MyPlugin extends JavaPlugin implements Listener {
MyProjectile projectile;
public void onEnable() {
getServer().getPluginManager().registerEvents(this, this);
projectile = new MyProjectile();
}
public void onDisable() {
}
@EventHandler
public void oninteract(PlayerInteractEvent event) {
Material item = event.getPlayer().getInventory().getItemInMainHand().getType();
if (item == Material.STICK) {
//launch MyProjectile with physics turned on
projectile.launch(event.getPlayer(), true);
}
}
}
Example Plugin Utilizing ParticleProjectileApi & Javadocs
Javadocs: ParticleProjectileApi
Affiliates
Thinking about getting a dedicated server? Try Kinetic hosting!
Save 15% on your first month by using code 'UberDiscount' at checkout!
Click the link below to get started now!
评论 0
登录后参与评分
还没有评论,来抢沙发吧