Aller au contenu

Modèles & Enums

Interface représentant une parcelle. C’est l’objet central avec lequel interagit presque toutes les méthodes de la PublicAPI.

public interface IPlot {
PlotId getId();
String getName();
void setName(String name);
UUID getOwner();
boolean setOwner(UUID owner);
void setOwnerSilent(UUID owner);
boolean hasOwner();
boolean isOwner(UUID player);
Set<UUID> getMembers();
void addMember(UUID player);
void removeMember(UUID player);
boolean isMember(UUID player);
Set<UUID> getBanned();
void addBanned(UUID player);
void removeBanned(UUID player);
boolean isBanned(UUID player);
boolean canBuild(UUID player);
void setFlag(PlotFlag flag, boolean value);
boolean getFlag(PlotFlag flag);
Map<PlotFlag, Boolean> getFlags();
Set<PlotId> getConnectedPlots();
void addConnectedPlot(PlotId plotId);
void removeConnectedPlot(PlotId plotId);
double getAverageRating();
int getRatingCount();
void addRating(UUID player, int rating);
Integer getPlayerRating(UUID player);
ReportStatus getStatus();
void setStatus(ReportStatus status);
UUID getReporterUUID();
void setReporterUUID(UUID reporterUUID);
boolean reset();
CompletableFuture<PlotResetResult> deletePlot(Player player, IPlot plot);
Location getCenter();
String getWorldName();
void setPlotWeather(WeatherType weatherType);
WeatherType getPlotWeather();
}

Identifiant unique d’une parcelle au sein de son monde, basé sur les coordonnées de la grille (et non les coordonnées du monde).

public class PlotId {
public PlotId(int x, int z);
public int getX();
public int getZ();
// Format chaîne : "x;z" — ex. "3;-2"
public String toString();
public static PlotId fromString(String str);
}

Enum des flags disponibles pour chaque parcelle. Voir la page Flags des parcelles pour la liste complète avec description, ou utilisez PlotFlag.fromString(String name) pour convertir une chaîne (par ex. provenant d’une commande) en la valeur enum correspondante.

public enum PlotFlag {
BREAK, PLACE, PVP, PVE, EXPLOSIONS, FIRE_SPREAD, VEICHLE_USE,
TNT_PLACING, ICE_FORM, SNOW_FORM, DIRT_GROW, CROP_GROW, VINE_GROW,
WATER_FLOW, LAVA_FLOW, REDSTONE, PRESSURE_PLATE, DOOR, LEVER,
BUTTON, ITEM_DROP, ITEM_PICKUP;
public String getName();
public String getDescription();
public static PlotFlag fromString(String name);
}

Renvoyé par claimPlot(player), décrit le résultat d’une tentative de claim.

Valeur Signification
SUCCESS Claim réussi
MAX_PLOTS_REACHED Le joueur possède déjà le nombre maximal de parcelles autorisé
NO_PLOTS_AVAILABLE Aucune parcelle libre disponible à réclamer
NOT_ENOUGHT_MONEY Le joueur n’a pas assez de fonds pour payer claim_cost
CANCELLED Le claim a été annulé (par ex. par un PlotClaimEvent annulé)

Renvoyé par resetPlot/deletePlot, décrit le résultat de l’opération.

Valeur Signification
SUCCESS Opération réussie
PLOT_NOT_FOUND La parcelle indiquée n’existe pas
PHYSICAL_RESET_ERROR Erreur lors de la réinitialisation physique des blocs de la parcelle

Représente le statut de signalement d’une parcelle (fonctionnalité Premium).

Valeur Signification
NO_REPORT La parcelle n’a jamais été signalée
REPORTED La parcelle a été signalée et est en attente de révision
REPORTED_AND_REVIEWED_AS_SAFE Signalée mais révisée par le staff et jugée correcte
RESETTED La parcelle a été réinitialisée suite à un signalement confirmé
MANUALLY_CLEANED Nettoyée manuellement par le staff
FALSE_REPORT Le signalement a été jugé non fondé