Support disabling PlaceholderAPI features

Author: Rothes

src/main/java/me/rothes/protocolstringreplacer/ConfigManager.java

@@ -1,5 +1,7 @@
 package me.rothes.protocolstringreplacer;
 
+import org.bukkit.Bukkit;
+
 import java.util.Locale;
 
 public class ConfigManager {
@@ -8,8 +10,10 @@ public class ConfigManager {
 
     public final boolean cmdTypingSound;
 
+    public final boolean placeholderEnabled;
     public final char placeholderHead;
     public final char placeholderTail;
+    public final boolean consolePlaceholder;
 
     public final long cleanTaskInterval;
     public final long cleanAccessInterval;
@@ -18,7 +22,6 @@ public class ConfigManager {
 
     public final String listenerPriority;
     public final boolean forceReplace;
-    public final boolean consolePlaceholder;
 
     public final boolean convertPlayerChat;
     public final boolean removeCacheWhenMerchantTrade;
@@ -40,6 +43,16 @@ public ConfigManager(ProtocolStringReplacer instance) {
             this.placeholderHead = placeholderHead.charAt(0);
         }
 
+        if (instance.getConfig().getBoolean("Options.Features.Placeholder.Placeholder-Enabled", true)) {
+            if (Bukkit.getPluginManager().getPlugin("PlaceholderAPI") != null) {
+                placeholderEnabled = true;
+            } else {
+                ProtocolStringReplacer.warn(PsrLocalization.getLocaledMessage("Console-Sender.Messages.Initialize.Missing-PAPI"));
+                placeholderEnabled = false;
+            }
+        } else {
+            placeholderEnabled = false;
+        }
         String placeholderTail = instance.getConfig().getString("Options.Features.Placeholder.Placeholder-Tail");
         if (placeholderTail == null || placeholderTail.isEmpty()) {
             ProtocolStringReplacer.error(PsrLocalization.getLocaledMessage("Console-Sender.Messages.Config.Invalid-Placeholder-Tail"));

src/main/java/me/rothes/protocolstringreplacer/ProtocolStringReplacer.java

@@ -185,7 +185,7 @@ public void onEnable() {
                 warn("\033[0;31m" + PsrLocalization.getLocaledMessage("Console-Sender.Messages.Initialize.Recommend-Paper") + "\033[0m");
             }
         }
-        if (!checkDepends("PlaceholderAPI", "ProtocolLib")) {
+        if (!checkDepends("ProtocolLib")) {
             initialize();
             new Updater(this).start();
         }

src/main/java/me/rothes/protocolstringreplacer/commands/subcommands/Parse.java

@@ -98,7 +98,8 @@ private void startParse(@NotNull PsrUser user, @NotNull String originalText, Pla
         }
 
         ComponentBuilder placeholderMessage = new ComponentBuilder(PsrLocalization.getLocaledMessage("Sender.Commands.Parse.Result.PAPI-Replace.Start-Prefix"));
-        if (ProtocolStringReplacer.getInstance().getReplacerManager().hasPlaceholder(text)) {
+        if (ProtocolStringReplacer.getInstance().getConfigManager().placeholderEnabled
+                && ProtocolStringReplacer.getInstance().getReplacerManager().hasPlaceholder(text)) {
             String original1 = text;
             PsrUser placeholderTarget = player == null ? ProtocolStringReplacer.getInstance().getUserManager().getConsoleUser() :
                     ProtocolStringReplacer.getInstance().getUserManager().getUser(player);

src/main/java/me/rothes/protocolstringreplacer/replacer/ReplacerManager.java

@@ -23,6 +23,7 @@
 import java.io.File;
 import java.io.IOException;
 import java.util.ArrayList;
+import java.util.Collections;
 import java.util.HashMap;
 import java.util.LinkedList;
 import java.util.List;
@@ -138,9 +139,11 @@ public void registerTask() {
     }
 
     public void initialize() {
-        this.papiReplacer = new PAPIReplacer();
-        papiHead = papiReplacer.getHead();
-        papiTail = papiReplacer.getTail();
+        if (ProtocolStringReplacer.getInstance().getConfigManager().placeholderEnabled) {
+            this.papiReplacer = new PAPIReplacer();
+            papiHead = papiReplacer.getHead();
+            papiTail = papiReplacer.getTail();
+        }
 
         File path = new File(ProtocolStringReplacer.getInstance().getDataFolder() + "/Replacers");
         long startTime = System.nanoTime();
@@ -396,14 +399,10 @@ public String replaceDirect(@Nonnull String string, @Nonnull List<ReplacerConfig
     }
 
     public void setPapi(@Nonnull PsrUser user, @Nonnull List<Replaceable> replaceables) {
-        setPapi(user, replaceables, getPapiIndexes(replaceables));
-    }
-
-    public void setPapi(@Nonnull PsrUser user, @Nonnull List<Replaceable> replaceables, List<Integer> indexes) {
         Validate.notNull(user, "PsrUser cannot be null");
         Validate.notNull(replaceables, "List cannot be null");
-        Validate.notNull(indexes, "List cannot be null");
 
+        List<Integer> indexes = getPapiIndexes(replaceables);
         if (indexes.isEmpty()) {
             return;
         }
@@ -427,6 +426,10 @@ public void setPapi(@Nonnull PsrUser user, @Nonnull List<Replaceable> replaceabl
     public List<Integer> getPapiIndexes(@Nonnull List<Replaceable> replaceables) {
         Validate.notNull(replaceables, "List cannot be null");
 
+        if (!ProtocolStringReplacer.getInstance().getConfigManager().placeholderEnabled) {
+            return Collections.emptyList();
+        }
+
         List<Integer> result = new ArrayList<>();
         for (int i = 0; i < replaceables.size(); i++) {
             Replaceable replaceable = replaceables.get(i);

src/main/resources/Languages/en-US/Configs/Config.yml

@@ -31,6 +31,8 @@ Options:
     # By default, you can use the format with ｛player_name｝(Chinese character) to use the placeholder.
     # You may need to edit them for convenient usage.
     Placeholder:
+      # Enable PlaceholderAPI features. Disable if you don't need placeholder parsing.
+      Placeholder-Enabled: true
       # The prefix of a placeholder. Only one character allowed.
       Placeholder-Head: ｛
       # The suffix of a placeholder. Only one character allowed.

src/main/resources/Languages/en-US/Locales/Locale.yml

@@ -7,6 +7,7 @@ Console-Sender:
       Recommend-Paper: 'You are not running Paper server or its fork. It''s recommended to switch to Paper for full supports.'
       Out-Dated-Server: 'Your server version is too outdated, and may not enjoy some features normally...'
       Missing-Dependency: '&cDependency plugin ''%0%'' is not detected，please install it before using this plugin.'
+      Missing-PAPI: '&cPlaceholderAPI is not installed, Placeholder features is disabled though you enabled it in global config.'
       Created-Example-Replacers: '&aGenerated example replacer configs.'
       Added-Missing-Config-Key: '&cAutomatically added missing configuration key in Config.yml %0%'
       Backing-Up-Configs: '&aBacking up configurations to folder: %0%'

src/main/resources/Languages/zh-CN/Configs/Config.yml

@@ -30,6 +30,8 @@ Options:
     # 以防止玩家通过占位符获取到不该获取的信息.
     # 在默认值下, 使用如｛player_name｝的格式来获取占位符的变量.
     Placeholder:
+      # 启用 PlaceholderAPI 功能. 如果您不需要解析占位符, 可以关闭此功能.
+      Placeholder-Enabled: true
       # 使用占位符的前缀. 仅允许一个字符.
       Placeholder-Head: ｛
       # 使用占位符的后缀. 仅允许一个字符.

src/main/resources/Languages/zh-CN/Locales/Locale.yml

@@ -7,6 +7,7 @@ Console-Sender:
       Recommend-Paper: '您未使用 Paper 或其衍生服务端核心. 建议使用 Paper 以获得完整功能.'
       Out-Dated-Server: '您使用的服务端过旧, 可能无法正常享受一些功能..'
       Missing-Dependency: '&c未检测到前置插件 %0%，请安装后再使用本插件.'
+      Missing-PAPI: '&c未安装 PlaceholderAPI, 尽管您在全局配置中启用了占位符功能, 此功能已被禁用.'
       Created-Example-Replacers: '&a已生成示例配置.'
       Added-Missing-Config-Key: '&c自动补充了 Config.yml 缺失的配置键 %0%'
       Backing-Up-Configs: '&a正在备份配置文件到文件夹: %0%'