2019-12-09 12:04:06 -07:00
|
|
|
package dev.esophose.playerparticles.api;
|
|
|
|
|
2020-01-05 04:39:27 -07:00
|
|
|
import dev.esophose.playerparticles.PlayerParticles;
|
|
|
|
import dev.esophose.playerparticles.manager.DataManager;
|
2020-01-05 17:58:19 -07:00
|
|
|
import dev.esophose.playerparticles.manager.GuiManager;
|
2020-01-07 21:32:35 -07:00
|
|
|
import dev.esophose.playerparticles.manager.ParticleStyleManager;
|
2020-01-05 04:39:27 -07:00
|
|
|
import dev.esophose.playerparticles.particles.PPlayer;
|
|
|
|
import dev.esophose.playerparticles.particles.ParticleEffect;
|
|
|
|
import dev.esophose.playerparticles.particles.ParticleEffect.NoteColor;
|
2020-01-05 17:26:45 -07:00
|
|
|
import dev.esophose.playerparticles.particles.ParticleEffect.OrdinaryColor;
|
2020-01-05 04:39:27 -07:00
|
|
|
import dev.esophose.playerparticles.particles.ParticleGroup;
|
|
|
|
import dev.esophose.playerparticles.particles.ParticlePair;
|
|
|
|
import dev.esophose.playerparticles.styles.ParticleStyle;
|
2020-01-05 17:58:19 -07:00
|
|
|
import java.util.ArrayList;
|
|
|
|
import java.util.Collection;
|
|
|
|
import java.util.HashMap;
|
|
|
|
import java.util.Map;
|
2020-01-05 04:39:27 -07:00
|
|
|
import java.util.Objects;
|
|
|
|
import java.util.UUID;
|
|
|
|
import org.bukkit.Material;
|
|
|
|
import org.bukkit.entity.Player;
|
|
|
|
import org.jetbrains.annotations.NotNull;
|
|
|
|
import org.jetbrains.annotations.Nullable;
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
/**
|
|
|
|
* The API for the PlayerParticles plugin.
|
|
|
|
* Used to manipulate a player's particles and data.
|
|
|
|
*
|
|
|
|
* Note: This API will bypass all permissions and does not send any messages.
|
|
|
|
* Any changes made through the API will be saved to the database automatically.
|
|
|
|
*/
|
2019-12-09 12:04:06 -07:00
|
|
|
public final class PlayerParticlesAPI {
|
|
|
|
|
2020-01-05 04:39:27 -07:00
|
|
|
private static PlayerParticlesAPI INSTANCE;
|
|
|
|
|
|
|
|
private PlayerParticles playerParticles;
|
|
|
|
|
|
|
|
private PlayerParticlesAPI() {
|
|
|
|
this.playerParticles = PlayerParticles.getInstance();
|
|
|
|
}
|
|
|
|
|
|
|
|
public static PlayerParticlesAPI getInstance() {
|
|
|
|
if (INSTANCE == null)
|
|
|
|
INSTANCE = new PlayerParticlesAPI();
|
|
|
|
return INSTANCE;
|
|
|
|
}
|
|
|
|
|
2020-01-05 17:58:19 -07:00
|
|
|
//region Get PPlayer
|
2020-01-05 04:39:27 -07:00
|
|
|
@Nullable
|
|
|
|
public PPlayer getPPlayer(@NotNull UUID uuid) {
|
|
|
|
Objects.requireNonNull(uuid);
|
|
|
|
|
|
|
|
return this.playerParticles.getManager(DataManager.class).getPPlayer(uuid);
|
|
|
|
}
|
|
|
|
|
|
|
|
@Nullable
|
|
|
|
public PPlayer getPPlayer(@NotNull Player player) {
|
|
|
|
return this.getPPlayer(player.getUniqueId());
|
|
|
|
}
|
2020-01-05 17:58:19 -07:00
|
|
|
//endregion
|
2020-01-05 04:39:27 -07:00
|
|
|
|
|
|
|
//region Manage Active Player Particles
|
|
|
|
public void addActivePlayerParticle(@NotNull Player player, @NotNull ParticlePair particle) {
|
|
|
|
Objects.requireNonNull(particle);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
ParticleGroup particleGroup = pplayer.getActiveParticleGroup();
|
|
|
|
if (particleGroup.getParticles().containsKey(particle.getId()))
|
|
|
|
throw new IllegalArgumentException("A particle with the id " + particle.getId() + " already exists");
|
|
|
|
|
|
|
|
pplayer.getActiveParticleGroup().getParticles().put(particle.getId(), particle);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), pplayer.getActiveParticleGroup());
|
|
|
|
}
|
|
|
|
|
|
|
|
public void editActivePlayerParticle(@NotNull Player player, int id, @NotNull ParticleEffect effect) {
|
|
|
|
Objects.requireNonNull(effect);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
group.getParticles().get(id).setEffect(effect);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void editActivePlayerParticle(@NotNull Player player, int id, @NotNull ParticleStyle style) {
|
|
|
|
Objects.requireNonNull(style);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
group.getParticles().get(id).setStyle(style);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void editActivePlayerParticle(@NotNull Player player, int id, @NotNull OrdinaryColor color) {
|
|
|
|
Objects.requireNonNull(color);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
group.getParticles().get(id).setColor(color);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void editActivePlayerParticle(@NotNull Player player, int id, @NotNull NoteColor noteColor) {
|
|
|
|
Objects.requireNonNull(noteColor);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
group.getParticles().get(id).setNoteColor(noteColor);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void editActivePlayerParticle(@NotNull Player player, int id, @NotNull Material material) {
|
|
|
|
Objects.requireNonNull(material);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
if (material.isBlock()) {
|
|
|
|
group.getParticles().get(id).setBlockMaterial(material);
|
|
|
|
} else {
|
|
|
|
group.getParticles().get(id).setItemMaterial(material);
|
|
|
|
}
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removeActivePlayerParticle(@NotNull Player player, int id) {
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
ParticleGroup group = this.validateActivePlayerParticle(player, id);
|
|
|
|
if (group != null) {
|
|
|
|
group.getParticles().remove(id);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removeActivePlayerParticle(@NotNull Player player, @NotNull ParticleEffect effect) {
|
|
|
|
Objects.requireNonNull(effect);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
ParticleGroup group = pplayer.getActiveParticleGroup();
|
|
|
|
group.getParticles().values().removeIf(x -> x.getEffect().equals(effect));
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removeActivePlayerParticle(@NotNull Player player, @NotNull ParticleStyle style) {
|
|
|
|
Objects.requireNonNull(style);
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
ParticleGroup group = pplayer.getActiveParticleGroup();
|
|
|
|
group.getParticles().values().removeIf(x -> x.getStyle().equals(style));
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), group);
|
|
|
|
}
|
|
|
|
|
2020-01-05 17:58:19 -07:00
|
|
|
public void resetActivePlayerParticles(@NotNull Player player) {
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pplayer.getActiveParticleGroup().getParticles().clear();
|
|
|
|
dataManager.saveParticleGroup(pplayer.getUniqueId(), pplayer.getActiveParticleGroup());
|
|
|
|
}
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
@NotNull
|
2020-01-05 17:58:19 -07:00
|
|
|
public Collection<ParticlePair> getActivePlayerParticles(@NotNull Player player) {
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return new ArrayList<>();
|
|
|
|
|
|
|
|
return pplayer.getActiveParticles();
|
|
|
|
}
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
@Nullable
|
|
|
|
public ParticlePair getActivePlayerParticle(@NotNull Player player, int id) {
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return null;
|
|
|
|
|
|
|
|
return pplayer.getActiveParticle(id);
|
|
|
|
}
|
|
|
|
|
2020-01-05 04:39:27 -07:00
|
|
|
private ParticleGroup validateActivePlayerParticle(Player player, int id) {
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return null;
|
|
|
|
|
|
|
|
ParticleGroup particleGroup = pplayer.getActiveParticleGroup();
|
|
|
|
if (!particleGroup.getParticles().containsKey(id))
|
|
|
|
throw new IllegalArgumentException("No particle exists with the id " + id);
|
2019-12-09 12:04:06 -07:00
|
|
|
|
2020-01-05 04:39:27 -07:00
|
|
|
return particleGroup;
|
|
|
|
}
|
|
|
|
//endregion
|
2019-12-09 12:04:06 -07:00
|
|
|
|
2020-01-05 17:58:19 -07:00
|
|
|
//region Manage Player Particle Groups
|
|
|
|
public void savePlayerParticleGroup(@NotNull Player player, @NotNull ParticleGroup particleGroup) {
|
|
|
|
Objects.requireNonNull(particleGroup);
|
|
|
|
|
|
|
|
if (particleGroup.getParticles().isEmpty())
|
|
|
|
throw new IllegalArgumentException("Cannot save an empty ParticleGroup");
|
|
|
|
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pplayer.getParticleGroups().put(particleGroup.getName().toLowerCase(), particleGroup);
|
|
|
|
dataManager.saveParticleGroup(player.getUniqueId(), particleGroup);
|
|
|
|
}
|
|
|
|
|
|
|
|
public void savePlayerParticleGroup(@NotNull Player player, @NotNull String groupName, @NotNull Collection<ParticlePair> particles) {
|
|
|
|
Objects.requireNonNull(groupName);
|
|
|
|
Objects.requireNonNull(particles);
|
|
|
|
|
|
|
|
Map<Integer, ParticlePair> mappedParticles = new HashMap<>();
|
|
|
|
particles.forEach(x -> mappedParticles.put(x.getId(), x));
|
|
|
|
ParticleGroup particleGroup = new ParticleGroup(groupName.toLowerCase(), mappedParticles);
|
|
|
|
this.savePlayerParticleGroup(player, particleGroup);
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removePlayerParticleGroup(@NotNull Player player, @NotNull String groupName) {
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pplayer.getParticleGroups().remove(groupName.toLowerCase());
|
|
|
|
dataManager.removeParticleGroup(player.getUniqueId(), groupName);
|
|
|
|
}
|
|
|
|
|
|
|
|
public void removePlayerParticleGroup(@NotNull Player player, @NotNull ParticleGroup particleGroup) {
|
|
|
|
Objects.requireNonNull(particleGroup);
|
|
|
|
|
|
|
|
this.removePlayerParticleGroup(player, particleGroup.getName());
|
|
|
|
}
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
@NotNull
|
2020-01-05 17:58:19 -07:00
|
|
|
public Collection<ParticleGroup> getPlayerParticleGroups(@NotNull Player player) {
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return new ArrayList<>();
|
|
|
|
|
|
|
|
return pplayer.getParticleGroups().values();
|
|
|
|
}
|
|
|
|
//endregion
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
//region Fixed Effect Management
|
|
|
|
// TODO - Create fixed effect
|
|
|
|
// TODO - Edit fixed effect
|
|
|
|
// TODO - Remove fixed effect
|
|
|
|
// TODO - Get fixed effect(s)
|
|
|
|
//endregion
|
|
|
|
|
2020-01-05 17:58:19 -07:00
|
|
|
//region GUI Management
|
|
|
|
public void openParticlesGui(@NotNull Player player) {
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
this.playerParticles.getManager(GuiManager.class).openDefault(pplayer);
|
|
|
|
}
|
|
|
|
//endregion
|
|
|
|
|
|
|
|
//region Player Settings
|
|
|
|
public void togglePlayerParticleVisibility(@NotNull Player player, boolean particlesHidden) {
|
|
|
|
DataManager dataManager = this.playerParticles.getManager(DataManager.class);
|
|
|
|
PPlayer pplayer = this.getPPlayer(player);
|
|
|
|
if (pplayer == null)
|
|
|
|
return;
|
|
|
|
|
|
|
|
pplayer.setParticlesHidden(particlesHidden);
|
|
|
|
dataManager.updateSettingParticlesHidden(player.getUniqueId(), particlesHidden);
|
|
|
|
}
|
|
|
|
//endregion
|
|
|
|
|
2020-01-05 18:15:32 -07:00
|
|
|
//region Registering Custom Styles
|
2020-01-07 21:32:35 -07:00
|
|
|
public void registerParticleStyle(@NotNull ParticleStyle particleStyle) {
|
|
|
|
Objects.requireNonNull(particleStyle);
|
|
|
|
|
|
|
|
this.playerParticles.getManager(ParticleStyleManager.class).registerStyle(particleStyle);
|
|
|
|
}
|
|
|
|
|
|
|
|
public void registerEventParticleStyle(@NotNull ParticleStyle particleStyle) {
|
|
|
|
Objects.requireNonNull(particleStyle);
|
|
|
|
|
|
|
|
this.playerParticles.getManager(ParticleStyleManager.class).registerEventStyle(particleStyle);
|
|
|
|
}
|
2020-01-05 18:15:32 -07:00
|
|
|
//endregion
|
|
|
|
|
2019-12-09 12:04:06 -07:00
|
|
|
}
|