package com.phantomarsenal.util; import org.bukkit.Location; import org.bukkit.Particle; import org.bukkit.World; import org.bukkit.entity.Player; import org.bukkit.util.Vector; /** * Epic particle effects utility for stunning visual feedback */ public class ParticleEffect { /** * Create a spiral particle effect rising upward */ public static void spiral(Location center, Particle particle, int rings, double radius, double height) { World world = center.getWorld(); int pointsPerRing = 20; for (int ring = 0; ring < rings; ring++) { double y = (height / rings) * ring; double angle = (2 * Math.PI / pointsPerRing) * ring; for (int point = 0; point < pointsPerRing; point++) { double currentAngle = angle + (2 * Math.PI / pointsPerRing) * point; double x = radius * Math.cos(currentAngle); double z = radius * Math.sin(currentAngle); Location particleLoc = center.clone().add(x, y, z); world.spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } } /** * Create expanding ring of particles */ public static void ring(Location center, Particle particle, double radius, int points) { World world = center.getWorld(); for (int i = 0; i < points; i++) { double angle = (2 * Math.PI / points) * i; double x = radius * Math.cos(angle); double z = radius * Math.sin(angle); Location particleLoc = center.clone().add(x, 0, z); world.spawnParticle(particle, particleLoc, 2, 0.1, 0.1, 0.1, 0); } } /** * Sphere of particles */ public static void sphere(Location center, Particle particle, double radius, int density) { World world = center.getWorld(); int points = density * 10; for (int i = 0; i < points; i++) { double theta = Math.random() * 2 * Math.PI; double phi = Math.random() * Math.PI; double x = radius * Math.sin(phi) * Math.cos(theta); double y = radius * Math.sin(phi) * Math.sin(theta); double z = radius * Math.cos(phi); Location particleLoc = center.clone().add(x, y, z); world.spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } /** * Explosion burst with layered particles */ public static void explosion(Location center, Particle primary, Particle secondary, int density) { World world = center.getWorld(); // Inner explosion world.spawnParticle(primary, center, density * 2, 0.3, 0.3, 0.3, 0.15); // Outer ring ring(center, secondary, 1.5, 30); // Shockwave particles for (int i = 0; i < 8; i++) { double angle = (2 * Math.PI / 8) * i; Vector direction = new Vector(Math.cos(angle), 0.2, Math.sin(angle)).normalize(); Location particleLoc = center.clone().add(direction.multiply(2)); world.spawnParticle(primary, particleLoc, 5, 0.1, 0.1, 0.1, 0.05); } } /** * Slash arc effect */ public static void slashArc(Player player, Particle particle, double radius, int density) { Location eyeLoc = player.getEyeLocation(); Vector direction = eyeLoc.getDirection(); Vector right = direction.clone().rotateAroundY(Math.PI / 2).normalize(); for (int i = 0; i < density; i++) { double angle = Math.PI * (i / (double) density) - Math.PI / 2; Vector offset = right.clone().rotateAroundAxis(direction, angle).multiply(radius); Location particleLoc = eyeLoc.clone().add(offset); player.getWorld().spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } /** * Create a spiral particle effect rising upward (alias) */ public static void createSpiral(Location center, Particle particle, double radius, int rings) { spiral(center, particle, rings, radius, radius * 2); } /** * Create expanding ring of particles (alias) */ public static void createCircle(Location center, Particle particle, double radius, int points) { ring(center, particle, radius, points); } /** * Slash arc effect (alias for Player) */ public static void createSlashArc(Player player, Particle particle, double radius, int arcAngle, int density) { slashArc(player, particle, radius, density); } /** * Slash arc effect (alias for Location) */ public static void createSlashArc(Location location, Particle particle, double radius, int arcAngle, int density) { World world = location.getWorld(); Vector direction = location.getDirection(); Vector right = direction.clone().rotateAroundY(Math.PI / 2).normalize(); for (int i = 0; i < density; i++) { double angle = Math.PI * (i / (double) density) - Math.PI / 2; Vector offset = right.clone().rotateAroundAxis(direction, angle).multiply(radius); Location particleLoc = location.clone().add(offset); world.spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } /** * Impact burst effect */ public static void createImpactBurst(Location center, Particle particle, int density) { World world = center.getWorld(); world.spawnParticle(particle, center, density, 0.5, 0.5, 0.5, 0.2); } /** * Lightning bolt effect with particles */ public static void lightning(Location start, Location end, Particle particle) { World world = start.getWorld(); Vector direction = end.toVector().subtract(start.toVector()); double length = direction.length(); direction.normalize(); int segments = (int) (length * 5); Location current = start.clone(); for (int i = 0; i < segments; i++) { // Add random offset for jagged lightning effect double offsetX = (Math.random() - 0.5) * 0.3; double offsetZ = (Math.random() - 0.5) * 0.3; current.add(direction.clone().multiply(length / segments)); current.add(offsetX, 0, offsetZ); world.spawnParticle(particle, current, 2, 0.05, 0.05, 0.05, 0); } } /** * Helix double spiral */ public static void helix(Location center, Particle particle1, Particle particle2, double height, double radius) { World world = center.getWorld(); int points = 40; for (int i = 0; i < points; i++) { double y = (height / points) * i; double angle = (2 * Math.PI / points) * i * 3; // First spiral double x1 = radius * Math.cos(angle); double z1 = radius * Math.sin(angle); world.spawnParticle(particle1, center.clone().add(x1, y, z1), 1, 0, 0, 0, 0); // Second spiral (opposite) double x2 = radius * Math.cos(angle + Math.PI); double z2 = radius * Math.sin(angle + Math.PI); world.spawnParticle(particle2, center.clone().add(x2, y, z2), 1, 0, 0, 0, 0); } } /** * Vortex pulling effect */ public static void vortex(Location center, Particle particle, double radius, int layers) { World world = center.getWorld(); for (int layer = 0; layer < layers; layer++) { double currentRadius = radius * (1 - (layer / (double) layers)); double y = layer * 0.3; int points = 20 - (layer * 2); for (int i = 0; i < points; i++) { double angle = (2 * Math.PI / points) * i + (layer * 0.5); double x = currentRadius * Math.cos(angle); double z = currentRadius * Math.sin(angle); Location particleLoc = center.clone().add(x, y, z); world.spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } } /** * Blood spray effect */ public static void bloodSpray(Location center, Particle particle, Vector direction) { World world = center.getWorld(); for (int i = 0; i < 15; i++) { Vector randomOffset = direction.clone() .add(new Vector(Math.random() - 0.5, Math.random() - 0.5, Math.random() - 0.5)) .normalize() .multiply(Math.random() * 2); Location particleLoc = center.clone().add(randomOffset); world.spawnParticle(particle, particleLoc, 3, 0.1, 0.1, 0.1, 0); } } /** * Shockwave expanding from point */ public static void shockwave(Location center, Particle particle, double maxRadius, int rings) { World world = center.getWorld(); for (int ring = 0; ring < rings; ring++) { double radius = (maxRadius / rings) * (ring + 1); ring(center, particle, radius, 30 + ring * 5); } } /** * Star burst pattern */ public static void starBurst(Location center, Particle particle, int rays, double length) { World world = center.getWorld(); for (int ray = 0; ray < rays; ray++) { double angle = (2 * Math.PI / rays) * ray; Vector direction = new Vector(Math.cos(angle), 0, Math.sin(angle)); for (double distance = 0; distance < length; distance += 0.2) { Location particleLoc = center.clone().add(direction.clone().multiply(distance)); world.spawnParticle(particle, particleLoc, 1, 0, 0, 0, 0); } } } }