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);}PlotFlag
Section intitulée « PlotFlag »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);}ClaimResult
Section intitulée « ClaimResult »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é) |
PlotResetResult
Section intitulée « PlotResetResult »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 |
ReportStatus
Section intitulée « ReportStatus »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é |