PlayerParticles/src/main/java/dev/esophose/playerparticles/api/PlayerParticlesAPI.java

310 lines
12 KiB
Java
Raw Normal View History

package dev.esophose.playerparticles.api;
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;
import dev.esophose.playerparticles.manager.ParticleStyleManager;
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;
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;
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.
*/
public final class PlayerParticlesAPI {
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
@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
//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);
}
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);
return particleGroup;
}
//endregion
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
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
}