程序包 org.bukkit.help

# 类 HelpTopic

java.lang.Object
org.bukkit.help.HelpTopic

直接已知子类:
  `GenericCommandHelpTopic`, `IndexHelpTopic`

public abstract class HelpTopic extends Object
HelpTopic implementations are displayed to the user when the user uses the /help command.

Custom implementations of this class can work at two levels. A simple implementation only needs to set the value of `name`, `shortText`, and `fullText` in the constructor. This base class will take care of the rest.

Complex implementations can be created by overriding the behavior of all the methods in this class.

- ## 字段概要

  字段
  修饰符和类型
  字段
  说明
  `protected String`
  `amendedPermission`
  `protected String`
  `fullText`
  `protected String`
  `name`
  `protected String`
  `shortText`

- ## 构造器概要

  构造器
  构造器
  说明
  `HelpTopic()`

- ## 方法概要

  修饰符和类型
  方法
  说明
  `void`
  `amendCanSee(@Nullable String amendedPermission)`
  Allows the server administrator to override the permission required to see a help topic.
  `void`
  `amendTopic(@Nullable String amendedShortText, @Nullable String amendedFullText)`
  Allows the server admin (or another plugin) to add or replace the contents of a help topic.
  `protected @NotNull String`
  `applyAmendment(@NotNull String baseText, @Nullable String amendment)`
  Developers implementing their own custom HelpTopic implementations can use this utility method to ensure their implementations comply with the expected behavior of the `amendTopic(String, String)` method.
  `abstract boolean`
  `canSee(@NotNull CommandSender player)`
  Determines if a `Player` is allowed to see this help topic.
  `@NotNull String`
  `getFullText(@NotNull CommandSender forWho)`
  Returns the full description of this help topic that is displayed when the user requests this topic's details.
  `@NotNull String`
  `getName()`
  Returns the name of this help topic.
  `@NotNull String`
  `getShortText()`
  Returns a brief description that will be displayed in the topic index.

  ### 从类继承的方法 java.lang.Object

  `clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

- ## 字段详细资料

  - ### name

    protected String name

  - ### shortText

    protected String shortText

  - ### fullText

    protected String fullText

  - ### amendedPermission

    protected String amendedPermission

- ## 构造器详细资料

  - ### HelpTopic

    public HelpTopic()

- ## 方法详细资料

  - ### canSee

    public abstract boolean canSee(@NotNull @NotNull CommandSender player)
    Determines if a `Player` is allowed to see this help topic.

    HelpTopic implementations should take server administrator wishes into account as set by the `amendCanSee(String)` function.

    参数:
      `player` - The Player in question.
    返回:
      True of the Player can see this help topic, false otherwise.

  - ### amendCanSee

    public void amendCanSee(@Nullable @Nullable String amendedPermission)
    Allows the server administrator to override the permission required to see a help topic.

    HelpTopic implementations should take this into account when determining topic visibility on the `canSee(org.bukkit.command.CommandSender)` function.

    参数:
      `amendedPermission` - The permission node the server administrator wishes to apply to this topic.

  - ### getName

    @NotNull public @NotNull String getName()
    Returns the name of this help topic.
    返回:
      The topic name.

  - ### getShortText

    @NotNull public @NotNull String getShortText()
    Returns a brief description that will be displayed in the topic index.
    返回:
      A brief topic description.

  - ### getFullText

    @NotNull public @NotNull String getFullText(@NotNull @NotNull CommandSender forWho)
    Returns the full description of this help topic that is displayed when the user requests this topic's details.

    The result will be paginated to properly fit the user's client.

    参数:
      `forWho` - The player or console requesting the full text. Useful for further security trimming the command's full text based on sub-permissions in custom implementations.
    返回:
      A full topic description.

  - ### amendTopic

    public void amendTopic(@Nullable @Nullable String amendedShortText, @Nullable @Nullable String amendedFullText)
    Allows the server admin (or another plugin) to add or replace the contents of a help topic.

    A null in either parameter will leave that part of the topic unchanged. In either amending parameter, the string <text> is replaced with the existing contents in the help topic. Use this to append or prepend additional content into an automatically generated help topic.

    参数:
      `amendedShortText` - The new topic short text to use, or null to leave alone.
      `amendedFullText` - The new topic full text to use, or null to leave alone.

  - ### applyAmendment

    @NotNull protected @NotNull String applyAmendment(@NotNull @NotNull String baseText, @Nullable @Nullable String amendment)
    Developers implementing their own custom HelpTopic implementations can use this utility method to ensure their implementations comply with the expected behavior of the `amendTopic(String, String)` method.
    参数:
      `baseText` - The existing text of the help topic.
      `amendment` - The amending text from the amendTopic() method.
    返回:
      The application of the amending text to the existing text, according to the expected rules of amendTopic().