Modelos y Enums

`IPlot`

Interfaz que representa una única parcela. Es el objeto central con el que interactúa casi todos los métodos 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();
}

`PlotId`

Identificador único de una parcela dentro de su mundo, basado en las coordenadas de la cuadrícula (no en las coordenadas del mundo).

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

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

`PlotFlag`

Enum de los flags disponibles para cada parcela. Consulta la página Flags de las parcelas para la lista completa con descripción, o usa PlotFlag.fromString(String name) para convertir una cadena (por ejemplo, proveniente de un comando) en el valor enum correspondiente.

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`

Devuelto por claimPlot(player), describe el resultado de un intento de reclamo.

Valor	Significado
`SUCCESS`	Reclamo exitoso
`MAX_PLOTS_REACHED`	El jugador ya posee el número máximo de parcelas permitido
`NO_PLOTS_AVAILABLE`	No hay parcelas libres disponibles para reclamar
`NOT_ENOUGHT_MONEY`	El jugador no tiene fondos suficientes para pagar `claim_cost`
`CANCELLED`	El reclamo fue cancelado (por ejemplo, por un `PlotClaimEvent` cancelado)

`PlotResetResult`

Devuelto por resetPlot/deletePlot, describe el resultado de la operación.

Valor	Significado
`SUCCESS`	Operación completada con éxito
`PLOT_NOT_FOUND`	La parcela indicada no existe
`PHYSICAL_RESET_ERROR`	Error durante la restauración física de los bloques de la parcela

`ReportStatus`

Representa el estado de reporte de una parcela (función Premium).

Valor	Significado
`NO_REPORT`	La parcela nunca ha sido reportada
`REPORTED`	La parcela ha sido reportada y está pendiente de revisión
`REPORTED_AND_REVIEWED_AS_SAFE`	Reportada pero revisada por el staff y considerada correcta
`RESETTED`	La parcela fue restaurada tras un reporte confirmado
`MANUALLY_CLEANED`	Limpiada manualmente por el staff
`FALSE_REPORT`	El reporte fue considerado infundado