diff --git a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator.java b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator.java index 70ad50db4..a3a98e827 100644 --- a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator.java +++ b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator.java @@ -45,6 +45,9 @@ final class BlockStatePopulator extends BlockPopulator { private final IndependentPlotGenerator plotGenerator; + /** + * @since TODO + */ public BlockStatePopulator( final @NonNull IndependentPlotGenerator plotGenerator ) { diff --git a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator116.java b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator116.java index 8b9cc51a4..ca249a4f7 100644 --- a/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator116.java +++ b/Bukkit/src/main/java/com/plotsquared/bukkit/generator/BlockStatePopulator116.java @@ -48,6 +48,9 @@ final class BlockStatePopulator116 extends BlockPopulator { private final IndependentPlotGenerator plotGenerator; + /** + * @since TODO + */ public BlockStatePopulator116( final @NonNull IndependentPlotGenerator plotGenerator ) { diff --git a/Bukkit/src/main/java/com/plotsquared/bukkit/queue/LimitedRegionWrapperQueue.java b/Bukkit/src/main/java/com/plotsquared/bukkit/queue/LimitedRegionWrapperQueue.java index 75141de28..e2bb00574 100644 --- a/Bukkit/src/main/java/com/plotsquared/bukkit/queue/LimitedRegionWrapperQueue.java +++ b/Bukkit/src/main/java/com/plotsquared/bukkit/queue/LimitedRegionWrapperQueue.java @@ -39,10 +39,18 @@ import org.bukkit.entity.EntityType; import org.bukkit.generator.LimitedRegion; import org.checkerframework.checker.nullness.qual.NonNull; +/** + * Wraps a {@link LimitedRegion} inside a P2 {@link com.plotsquared.core.queue.QueueCoordinator} so it can be written to. + * + * @since TODO + */ public class LimitedRegionWrapperQueue extends DelegateQueueCoordinator { private final LimitedRegion limitedRegion; + /** + * @since TODO + */ public LimitedRegionWrapperQueue(LimitedRegion limitedRegion) { super(null); this.limitedRegion = limitedRegion; diff --git a/Core/src/main/java/com/plotsquared/core/generator/HybridGen.java b/Core/src/main/java/com/plotsquared/core/generator/HybridGen.java index 74ab035f2..f2a570ba4 100644 --- a/Core/src/main/java/com/plotsquared/core/generator/HybridGen.java +++ b/Core/src/main/java/com/plotsquared/core/generator/HybridGen.java @@ -396,11 +396,20 @@ public class HybridGen extends IndependentPlotGenerator { // All initialization is done in the PlotArea class } + /** + * Wrapper to allow a WE {@link Entity} to effectively have a mutable location as the location in its NBT should be changed + * when set to the world. + * + * @since TODO + */ private static final class PopulatingEntity implements Entity { private final Entity parent; private com.sk89q.worldedit.util.Location location; + /** + * @since TODO + */ private PopulatingEntity(Entity parent, com.sk89q.worldedit.util.Location location) { this.parent = parent; this.location = location; diff --git a/Core/src/main/java/com/plotsquared/core/generator/HybridPlotWorld.java b/Core/src/main/java/com/plotsquared/core/generator/HybridPlotWorld.java index cab012611..2a5999bde 100644 --- a/Core/src/main/java/com/plotsquared/core/generator/HybridPlotWorld.java +++ b/Core/src/main/java/com/plotsquared/core/generator/HybridPlotWorld.java @@ -492,6 +492,8 @@ public class HybridPlotWorld extends ClassicPlotWorld { /** * Get the entities contained within the plot schematic for generation. Intended for internal use only. + * + * @since TODO */ @AnnotationHelper.ApiDescription(info = "Internal use only. Subject to changes at any time.") public @Nullable List getPlotSchematicEntities() { @@ -500,6 +502,8 @@ public class HybridPlotWorld extends ClassicPlotWorld { /** * Get the minimum point of the plot schematic for generation. Intended for internal use only. + * + * @since TODO */ @AnnotationHelper.ApiDescription(info = "Internal use only. Subject to changes at any time.") public @Nullable BlockVector3 getPlotSchematicMinPoint() { @@ -508,6 +512,8 @@ public class HybridPlotWorld extends ClassicPlotWorld { /** * Get if post-generation population of chunks with tiles/entities is needed for this world. Not for public API use. + * + * @since TODO */ @AnnotationHelper.ApiDescription(info = "Internal use only. Subject to changes at any time.") public boolean populationNeeded() { diff --git a/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java b/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java index a917e52a6..4a753255a 100644 --- a/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java +++ b/Core/src/main/java/com/plotsquared/core/generator/IndependentPlotGenerator.java @@ -62,7 +62,9 @@ public abstract class IndependentPlotGenerator { * @param result Queue to write to * @param settings PlotArea (settings) * @return True if any population occured + * @deprecated {@link ScopedQueueCoordinator} will be renamed in v7. */ + @Deprecated(forRemoval = true, since = "TODO") public boolean populateChunk(ScopedQueueCoordinator result, PlotArea settings) { return false; } diff --git a/Core/src/main/java/com/plotsquared/core/location/Location.java b/Core/src/main/java/com/plotsquared/core/location/Location.java index 7737e806c..24f3e43d5 100644 --- a/Core/src/main/java/com/plotsquared/core/location/Location.java +++ b/Core/src/main/java/com/plotsquared/core/location/Location.java @@ -48,6 +48,9 @@ public class Location extends BlockLoc implements Comparable { private final BlockVector3 blockVector3; private final World world; + /** + * @since TODO + */ protected Location( final @NonNull World world, final @NonNull BlockVector3 blockVector3, final float yaw, final float pitch diff --git a/Core/src/main/java/com/plotsquared/core/location/UncheckedWorldLocation.java b/Core/src/main/java/com/plotsquared/core/location/UncheckedWorldLocation.java index e193c34a0..aab412cb6 100644 --- a/Core/src/main/java/com/plotsquared/core/location/UncheckedWorldLocation.java +++ b/Core/src/main/java/com/plotsquared/core/location/UncheckedWorldLocation.java @@ -32,12 +32,17 @@ import org.checkerframework.checker.nullness.qual.NonNull; /** * Used internally for generation to reference locations in worlds that "don't exist yet". There is no guarantee that the world * name provided by {@link UncheckedWorldLocation#getWorldName()} exists on the server. + * + * @since TODO */ @AnnotationHelper.ApiDescription(info = "Internal use only. Subject to changes at any time.") public class UncheckedWorldLocation extends Location { private final String worldName; + /** + * @since TODO + */ private UncheckedWorldLocation( final @NonNull String worldName, final int x, final int y, final int z ) { @@ -53,6 +58,8 @@ public class UncheckedWorldLocation extends Location { * @param y Y coordinate * @param z Z coordinate * @return New location + * + * @since TODO */ public static @NonNull UncheckedWorldLocation at( final @NonNull String world, final int x, final int y, final int z