diff --git a/paper-api/src/main/java/org/bukkit/Nameable.java b/paper-api/src/main/java/org/bukkit/Nameable.java index fee814e01a..b79daa857f 100644 --- a/paper-api/src/main/java/org/bukkit/Nameable.java +++ b/paper-api/src/main/java/org/bukkit/Nameable.java @@ -2,6 +2,9 @@ package org.bukkit; import org.jetbrains.annotations.Nullable; +/** + * Represents a block, entity, or other object that may receive a custom name. + */ public interface Nameable { /** diff --git a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java index c5eed3234a..5acb0d36a0 100644 --- a/paper-api/src/main/java/org/bukkit/OfflinePlayer.java +++ b/paper-api/src/main/java/org/bukkit/OfflinePlayer.java @@ -10,6 +10,11 @@ import org.bukkit.profile.PlayerProfile; import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; +/** + * Represents a reference to a player identity and the data belonging to a + * player that is stored on the disk and can, thus, be retrieved without the + * player needing to be online. + */ public interface OfflinePlayer extends ServerOperator, AnimalTamer, ConfigurationSerializable { /** diff --git a/paper-api/src/main/java/org/bukkit/event/Cancellable.java b/paper-api/src/main/java/org/bukkit/event/Cancellable.java index 799b0b0f3c..9e836d3087 100644 --- a/paper-api/src/main/java/org/bukkit/event/Cancellable.java +++ b/paper-api/src/main/java/org/bukkit/event/Cancellable.java @@ -1,5 +1,8 @@ package org.bukkit.event; +/** + * A type characterizing events that may be cancelled by a plugin or the server. + */ public interface Cancellable { /** diff --git a/paper-api/src/main/java/org/bukkit/plugin/java/JavaPlugin.java b/paper-api/src/main/java/org/bukkit/plugin/java/JavaPlugin.java index 669a70faa9..ee100b7ad8 100644 --- a/paper-api/src/main/java/org/bukkit/plugin/java/JavaPlugin.java +++ b/paper-api/src/main/java/org/bukkit/plugin/java/JavaPlugin.java @@ -30,7 +30,9 @@ import org.jetbrains.annotations.NotNull; import org.jetbrains.annotations.Nullable; /** - * Represents a Java plugin + * Represents a Java plugin and its main class. It contains fundamental methods + * and fields for a plugin to be loaded and work properly. This is an indirect + * implementation of {@link org.bukkit.plugin.Plugin}. */ public abstract class JavaPlugin extends PluginBase { private boolean isEnabled = false;