Interface PlaceholderService

public interface PlaceholderService
占位符服务接口 - 提供完整的占位符管理和替换功能
Since:
1.0.0
Version:
1.0.0
Author:
Berry_so
See Also:

  • Method Details

    • initialize

      void initialize()
      初始化服务

    • shutdown

      void shutdown()
      关闭服务

    • register

      boolean register(@NotNull @NotNull PlaceholderProcessor processor)
      注册占位符处理器
      Parameters:
      processor - 占位符处理器
      Returns:
      true表示注册成功，false表示注册失败

    • register

      boolean register(@NotNull @NotNull String identifier, @NotNull @NotNull BiFunction<org.bukkit.entity.Player,String,String> handler)
      注册占位符处理器（使用函数式接口）
      Parameters:
      identifier - 变量标识符
      handler - 处理函数，接收玩家和参数返回结果
      Returns:
      true表示注册成功，false表示注册失败

    • unregister

      boolean unregister(@NotNull @NotNull String identifier)
      注销占位符处理器
      Parameters:
      identifier - 变量标识符
      Returns:
      true表示注销成功，false表示注销失败

    • setPlaceholders

      @NotNull @NotNull String setPlaceholders(@NotNull @NotNull String text, @Nullable @Nullable org.bukkit.entity.Player player)
      替换字符串中的变量
      Parameters:
      text - 原始文本
      player - 玩家对象，可能为null
      Returns:
      替换后的文本

    • setPlaceholders

      @NotNull @NotNull List<String> setPlaceholders(@NotNull @NotNull List<String> texts, @Nullable @Nullable org.bukkit.entity.Player player)
      替换字符串列表中的变量
      Parameters:
      texts - 原始文本列表
      player - 玩家对象，可能为null
      Returns:
      替换后的文本列表

    • containsPlaceholders

      boolean containsPlaceholders(@NotNull @NotNull String text)
      检查文本是否包含变量
      Parameters:
      text - 文本
      Returns:
      true表示包含变量，false表示不包含

    • getPlaceholders

      @NotNull @NotNull Set<String> getPlaceholders(@NotNull @NotNull String text)
      获取文本中的所有变量
      Parameters:
      text - 文本
      Returns:
      变量标识符集合

    • getStatus

      @NotNull @NotNull String getStatus()
      获取服务状态
      Returns:
      服务状态描述

    • getRegistry

      @NotNull @NotNull PlaceholderRegistry getRegistry()
      获取注册表
      Returns:
      占位符注册表实例

    • getReplacer

      @NotNull @NotNull PlaceholderReplacer getReplacer()
      获取替换器
      Returns:
      占位符替换器实例