diff --git a/src/main/java/org/bukkit/Nameable.java b/src/main/java/org/bukkit/Nameable.java index fee814e0..b79daa85 100644 --- a/src/main/java/org/bukkit/Nameable.java +++ b/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/src/main/java/org/bukkit/OfflinePlayer.java b/src/main/java/org/bukkit/OfflinePlayer.java index c5eed323..5acb0d36 100644 --- a/src/main/java/org/bukkit/OfflinePlayer.java +++ b/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/src/main/java/org/bukkit/event/Cancellable.java b/src/main/java/org/bukkit/event/Cancellable.java index 799b0b0f..9e836d30 100644 --- a/src/main/java/org/bukkit/event/Cancellable.java +++ b/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/src/main/java/org/bukkit/plugin/java/JavaPlugin.java b/src/main/java/org/bukkit/plugin/java/JavaPlugin.java index 669a70fa..ee100b7a 100644 --- a/src/main/java/org/bukkit/plugin/java/JavaPlugin.java +++ b/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;