Modelli & Enum

`IPlot`

Interfaccia che rappresenta un singolo plot. È l’oggetto centrale con cui interagisce quasi ogni metodo della 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();
}

`PlotId`

Identificatore univoco di un plot all’interno del suo mondo, basato sulle coordinate della griglia (non sulle coordinate del mondo).

public class PlotId {
    public PlotId(int x, int z);
    public int getX();
    public int getZ();

    // Formato stringa: "x;z" — es. "3;-2"
    public String toString();
    public static PlotId fromString(String str);
}

`PlotFlag`

Enum dei flag disponibili per ogni plot. Vedi la pagina Flag dei plot per l’elenco completo con descrizione, oppure usa PlotFlag.fromString(String name) per convertire una stringa (es. proveniente da un comando) nel valore enum corrispondente.

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`

Restituito da claimPlot(player), descrive l’esito di un tentativo di claim.

Valore	Significato
`SUCCESS`	Claim riuscito
`MAX_PLOTS_REACHED`	Il giocatore possiede già il numero massimo di plot consentiti
`NO_PLOTS_AVAILABLE`	Nessun plot libero disponibile da rivendicare
`NOT_ENOUGHT_MONEY`	Il giocatore non ha fondi sufficienti per pagare `claim_cost`
`CANCELLED`	Il claim è stato annullato (es. da un `PlotClaimEvent` cancellato)

`PlotResetResult`

Restituito da resetPlot/deletePlot, descrive l’esito dell’operazione.

Valore	Significato
`SUCCESS`	Operazione completata con successo
`PLOT_NOT_FOUND`	Il plot indicato non esiste
`PHYSICAL_RESET_ERROR`	Errore durante il ripristino fisico dei blocchi del plot

`ReportStatus`

Rappresenta lo stato di segnalazione di un plot (funzione Premium).

Valore	Significato
`NO_REPORT`	Il plot non è mai stato segnalato
`REPORTED`	Il plot è stato segnalato ed è in attesa di revisione
`REPORTED_AND_REVIEWED_AS_SAFE`	Segnalato ma revisionato dallo staff e giudicato regolare
`RESETTED`	Il plot è stato ripristinato in seguito a una segnalazione confermata
`MANUALLY_CLEANED`	Ripulito manualmente dallo staff
`FALSE_REPORT`	La segnalazione è stata giudicata infondata