CharsApi 字符API

CharsApi 插件允许玩家/开发者通过方块快速构建彩色消息。您可以使用默认字体（如 Mineplex），或使用安装在操作系统上或位于插件文件夹的 fonts 文件夹中的系统字体来构建字符。您还可以构建带有动画效果的字符，通过非即时设置更大的字符块来获得良好的效果并减少延迟。

🎉关于

CharsApi 可用于选择我们必须去的地方，例如在大厅中，在传送门上方显示服务器类型（“生存服务器”），也可用于小游戏中，通知玩家游戏何时开始、游戏类型、游戏中的玩家等。通常，您可以使用方块告知玩家您想告知的一切信息。

🛠️配置

• 插件支持多语言。
• 当前翻译：
  • 英语
  • 波兰语
• 其余配置信息可以在文件中找到。

🔤安装字体

示例网站：http://www.dafont.com/

1. 字体
   1. 在服务器上：打开 plugins > CharsApi > Fonts > 将您的字体放在那里
   2. 在本地系统（Windows）上：打开控制面板 > 字体 > 将您的字体拖到那里
2. 启动服务器

⌨️命令

权限：chars

别名：chars, char, ch

参数：

• build <string format> - 构建字符
• clear <ID> - 清除具有该 ID 的字符
• clear all - 清除地图上的所有字符
• list <page_number> - 显示检测到的字体
• font default - 设置默认构建器字体
• font <size> <type_font> <name_font> - 设置构建器字体
  • type_font:
    • 0 - Normal
    • 1 - Bolded
    • 2 - Italic
  • name_font - 您可以从 /ch list 获取的字体名称。例如 "Agency FB"
• animations <in / out> - 显示构建器 <building/clearing> 动画
• vars - 显示变量列表
• updater <updater_subcommand> - 自动更新字符的管理工具

💡使用示例：

• /ch build &2Welcome &fthere's &4Merbio
• /ch clear 1
• /ch font 38 1 Agency FB
• /ch list 1
• /ch updater create chars_spawn 9

✨格式

默认构建器方块是白色羊毛，就像聊天中的字幕一样。要在 <format> 中更改它，您以相同的方式编写文本。&(0-9 and a-f)

• /ch build &aGreen

  文本 "green" 来自绿色羊毛

或者插件可以选择随机颜色

• /ch build &XWelcome

  文本 "Welcome" 来自随机颜色羊毛

如果您想让 updater 每次都选择不同的颜色，您可以这样破解：在任何地方写入 %riuet%，它将被替换为空字符串 ("")，并且会重新加载随机颜色。

• 例如：/ch u add &Xrandomed%riuet%

您也可以更改构建的方块，可以使用字符 "#" 对其进行着色。

• /ch build #c&1I am #p&5player

  文本 "I am" (来自蓝色粘土) "player" (来自紫色玻璃板)

  参数：

  • C - clay
  • W - wool
  • G - glass
  • P - glass pane

插件有一些替代方块。&(g-m)

• /ch build #cclay &gBlock

  文本 "clay" (来自白色粘土) "Block" (来自基岩)

插件中实现了变量系统，您可以通过 %var_name% 使用变量。% - 您可以在 config 中配置的变量字符。

• /ch build Online: %online% / %maxplayers%

  示例生成的文本："Online: 4 / 20"

您还可以使用效果（输入动画）构建字符。您可以使用字符 "@" 更改此设置。

• /ch build @4#g&aGreen Dragon

  来自绿色玻璃的动画文本 "green dragon"

您可以使用效果（输出动画）清除动画。您可以使用字符 "!" 更改此设置。

• /ch build !1#c&8Drop Blocks
• /ch clear <id_of_this_chars>

  掉落字符清除动画效果 ;]

您可以使用字符 "\n" 创建多个字符（文本“在新行中开始”）。

• /ch build @6#g&aFirst Line\n@5#c&5Second Line
  • Line 1: 来自绿色玻璃的动画文本 "First Line"
  • Line 2: 来自紫色粘土的动画文本 "Second Line"

您可以使用字符 "$" 将上划线添加到您的字符中。

• /ch build $w#c&4Car

  来自红色粘土且带有黑色羊毛上划线的文本 "Car"

  参数：(类似于颜色块)

  • C - Black Clay
  • W - Black Wool
  • G - Black Glass
  • P - Black Glass Pane
  • L - LightBlock - Glowstone

🔄Updater：

主要参数：/ch u <subcommand>

📑子命令：

• create <updater_name> <updated_time> - 创建 updater
• remove <updater_name> - 移除 updater
• tpto <updater_name> - 将玩家传送到 updater
• setloc - 设置 updater 位置和朝向
• settime <updated_time> - 设置 updater 更新时间
• add <text> - 添加要更新的文本
• del <id_text> - 从 updater 中移除文本
• info - 关于实际 updater 的信息（带有文本 ID）
• list - updater 列表
• select <updater_name> - 选择要编辑的 updater
• flush - 清除空气中的所有 updater 文本
• start - 启动 updater
• stop - 停止 updater
• save - 保存 updater

📝使用示例：

Updater 允许您在服务器上创建自动更改的字符。

因此，我们想要创建 3 个字符，在 12 秒内在一个地方更改。首先，您必须设置构建器的设置，如 /ch font，因为 updater 会记住这些设置。您可以在 updater 中组合字体。

/ch u create n_spawn 12
#When you create updater that he is auto-targeting /ch u select
#so in next commands you musn't use updater_name in commands like /ch u add
/ch u add @3#c&1Welcome
/ch u add @3#c&2on
/ch font 30 1 Agency FB
/ch u add @3#c&3SPAWN&4!
/ch u save 

从管理器中移除 updater。

/ch u remove n_spawn

将 updater 的位置和朝向更改为玩家位置，并将更新时间更改为 15。

/ch u select n_spawn
/ch u select n_spawn
#second time to agree updater selection
/ch u stop
#Stop to plugin allows change updater settings
/ch u setloc
/ch u settime 15
/ch u save
#When we saving updater will be save + automatic starting ;] (/ch u start) 

⚙️Api Section：

Blocks builder class.

CharsBuilder builder = new CharsBuilder();

创建和移除 chars。

CharsString textCS = builder.replace("#cYour Text");

textCS = builder.build(buildLocation, spawnLocation, textCS);

textCS = builder.build(player, textCS);

textCS.clearChars();

更改 builder 设置。

BlockSettings settings = new BlockSettings();

BlockSettings settings = builder.getBlockSettings();

settings.setWordSpacing(int);

settings.setLetterSpacing(int);

settings.setPlayerSpacing(int);

settings.setColorChar(char);

settings.setColoredBlockChar(char);

settings.setInputAnimationChar(char);

settings.setOutputAnimationChar(char);

settings.addMaterialReplacement(char, Material);

settings.setMaterialReplacementList(HashMap<Character, Material>;

settings.clearMaterialReplacementList();

settings.setOnlyAirBlocade(boolean);

settings.setFont(java.awt.Font);

builder.setBlockSettings(settings);

builder.setBlockSettings(new BlockSettings().setColorChar('$').setFont(new Font("Arial", 0, 20)).setPlayerSpacing(8).addMaterialReplacement('N', Material.SPONGE));

创建自动更改的 chars。

CharsUpdater updater = new CharsUpdater(int, org.bukkit.Location, org.bukkit.block.BlockFace);

int ID = updater.addCharsString(builder, String format);

updater.removeCharsString(ID);

updater.setSeconds(int);

updater.setLocation(Location);

updater.setFacing(BlockFace);

updater.isRunning();

updater.start();

updater.cancel();

我建议每次您在 updater 中添加/更改内容时都停止它，并在更改后启动它。

➕向 CharsAPI 构建器添加变量。

public CharsVariable(String result, String... varNames)

CharsBuilder.addCharsVariables(
                new CharsVariable("Hello World!", "hi world", "h w", "hw")
        );

public CharsVariable(onVarCheck varCheck, String... varNames)

CharsBuilder.addCharsVariables(
                new CharsVariable(new CharsVariable.onVarCheck() {
                    @Override
                    public String on() {
                        return getServer().getOnlinePlayers().length + " / " + getServer().getMaxPlayers();
                    }
                }, "fullOnline", "fon")
        );