Examples with BukkitTagContext com.denizenscript.denizen.tags.BukkitTagContext used on opensource projects

Example 16 with BukkitTagContext

use of com.denizenscript.denizen.tags.BukkitTagContext in project Denizen-For-Bukkit by DenizenScript.

the class FormatScriptContainer method getFormatText.

public String getFormatText(NPCTag npc, PlayerTag player) {
    String text = getFormat();
    if (text.contains("<text") || text.contains("<name")) {
        Deprecations.pseudoTagBases.warn(this);
        text = text.replace("<text>", String.valueOf((char) 0x00)).replace("<name>", String.valueOf((char) 0x04));
    }
    text = text.replace("<[text]>", String.valueOf((char) 0x00)).replace("<[name]>", String.valueOf((char) 0x04));
    return TagManager.tag(text, new BukkitTagContext(player, npc, new ScriptTag(this))).replace("%", "%%").replace(String.valueOf((char) 0x00), "%2$s").replace(String.valueOf((char) 0x04), "%1$s");
}

Example 17 with BukkitTagContext

use of com.denizenscript.denizen.tags.BukkitTagContext in project Denizen-For-Bukkit by DenizenScript.

the class ItemScriptHelper method onItemSmithing.

@EventHandler(priority = EventPriority.LOW)
public void onItemSmithing(PrepareSmithingEvent event) {
    if (!isItemscript(event.getInventory().getItem(0))) {
        return;
    }
    Recipe recipe = event.getInventory().getRecipe();
    SmithingRecipe smithRecipe = (SmithingRecipe) recipe;
    if (smithRecipe == null || !(smithRecipe.getKey().getNamespace().equals("denizen"))) {
        if (!isAllowedToCraftWith(event.getInventory().getItem(0))) {
            event.setResult(new ItemStack(Material.AIR));
        }
        return;
    }
    ItemScriptContainer realResult = recipeIdToItemScript.get(smithRecipe.getKey().toString());
    if (realResult == null) {
        if (!isAllowedToCraftWith(event.getInventory().getItem(0))) {
            event.setResult(new ItemStack(Material.AIR));
        }
        return;
    }
    String[] retain = smithingRetain.get(smithRecipe.getKey().getKey());
    if (retain == null) {
        Debug.echoError("Smithing recipe mis-registered for script item: " + realResult.getName());
        if (!isAllowedToCraftWith(event.getInventory().getItem(0))) {
            event.setResult(new ItemStack(Material.AIR));
        }
        return;
    }
    PlayerTag player = null;
    if (!event.getInventory().getViewers().isEmpty()) {
        HumanEntity human = event.getInventory().getViewers().get(0);
        if (!EntityTag.isNPC(human) && human instanceof Player) {
            player = new PlayerTag((Player) human);
        }
    }
    ItemTag got = realResult.getItemFrom(new BukkitTagContext(player, null, new ScriptTag(realResult)));
    if (got == null) {
        return;
    }
    if (retain.length > 0) {
        ItemMeta originalMeta = event.getInventory().getItem(0).getItemMeta();
        ItemMeta newMeta = got.getItemMeta();
        for (String retainable : retain) {
            switch(retainable) {
                case "display":
                    newMeta.setDisplayName(originalMeta.hasDisplayName() ? originalMeta.getDisplayName() : null);
                    break;
                case "enchantments":
                    if (newMeta.hasEnchants()) {
                        for (Enchantment enchant : new ArrayList<>(newMeta.getEnchants().keySet())) {
                            newMeta.removeEnchant(enchant);
                        }
                    }
                    if (originalMeta.hasEnchants()) {
                        for (Map.Entry<Enchantment, Integer> enchant : originalMeta.getEnchants().entrySet()) {
                            newMeta.addEnchant(enchant.getKey(), enchant.getValue(), true);
                        }
                    }
                    break;
            }
        }
        got.setItemMeta(newMeta);
    }
    event.setResult(got.getItemStack());
}

Example 18 with BukkitTagContext

use of com.denizenscript.denizen.tags.BukkitTagContext in project Denizen-For-Bukkit by DenizenScript.

the class ItemScriptHelper method registerShapelessRecipe.

public void registerShapelessRecipe(ItemScriptContainer container, ItemStack item, String shapelessString, String internalId, String group) {
    TagContext context = new BukkitTagContext(null, null, new ScriptTag(container));
    String list = TagManager.tag(shapelessString, context);
    List<ItemStack[]> ingredients = new ArrayList<>();
    List<Boolean> exacts = new ArrayList<>();
    for (String element : ListTag.valueOf(list, context)) {
        String itemText = element;
        boolean isExact = !itemText.startsWith("material:");
        if (!isExact) {
            itemText = itemText.substring("material:".length());
        }
        exacts.add(isExact);
        ItemStack[] items = textToItemArray(container, itemText, isExact);
        if (items == null) {
            return;
        }
        ingredients.add(items);
    }
    boolean[] bools = new boolean[exacts.size()];
    for (int i = 0; i < exacts.size(); i++) {
        bools[i] = exacts.get(i);
    }
    NMSHandler.getItemHelper().registerShapelessRecipe(internalId, group, item, ingredients, bools);
}

Example 19 with BukkitTagContext

use of com.denizenscript.denizen.tags.BukkitTagContext in project Denizen-For-Bukkit by DenizenScript.

the class ClickTrigger method clickTrigger.

// <--[language]
// @name Click Triggers
// @group NPC Interact Scripts
// @description
// Click Triggers are triggered when a player right clicks the NPC.
// 
// These are very basic with no extraneous complexity.
// 
// <code>
// click trigger:
// script:
// - narrate "hi <player.name>"
// </code>
// 
// They can optionally have an item matcher with multiple triggers, for the item in the player's hand. For example:
// <code>
// click trigger:
// 1:
// trigger: my_item_script
// script:
// - narrate "Nice item script"
// 2:
// trigger: stone
// script:
// - narrate "Nice vanilla item"
// 3:
// script:
// - narrate "I don't recognize your held item"
// </code>
// 
// -->
// <--[action]
// @Actions
// no click trigger
// 
// @Triggers when the NPC is clicked but no click trigger fires.
// 
// @Context
// None
// 
// -->
// Technically defined in TriggerTrait, but placing here instead.
// <--[action]
// @Actions
// click
// 
// @Triggers when the NPC is clicked by a player.
// 
// @Context
// None
// 
// @Determine
// "cancelled" to cancel the click event completely.
// 
// -->
@EventHandler
public void clickTrigger(NPCRightClickEvent event) {
    if (!event.getNPC().hasTrait(TriggerTrait.class)) {
        return;
    }
    NPCTag npc = new NPCTag(event.getNPC());
    if (!npc.getTriggerTrait().isEnabled(name)) {
        return;
    }
    PlayerTag player = PlayerTag.mirrorBukkitPlayer(event.getClicker());
    TriggerTrait.TriggerContext trigger = npc.getTriggerTrait().trigger(this, player);
    if (!trigger.wasTriggered()) {
        return;
    }
    if (trigger.hasDetermination() && trigger.getDeterminations().containsCaseInsensitive("cancelled")) {
        event.setCancelled(true);
        return;
    }
    List<InteractScriptContainer> scripts = npc.getInteractScripts(player, ClickTrigger.class);
    boolean any = false;
    if (scripts != null) {
        for (InteractScriptContainer script : scripts) {
            String id = null;
            Map<String, String> idMap = script.getIdMapFor(ClickTrigger.class, player);
            if (!idMap.isEmpty()) {
                ItemTag heldItem = new ItemTag(player.getPlayerEntity().getEquipment().getItemInMainHand());
                for (Map.Entry<String, String> entry : idMap.entrySet()) {
                    String entry_value = TagManager.tag(entry.getValue(), new BukkitTagContext(player, npc, null, false, null));
                    boolean isMatch = entry_value.isEmpty() || BukkitScriptEvent.tryItem(heldItem, entry_value);
                    if (script.shouldDebug()) {
                        Debug.echoDebug(script, "Comparing click trigger '<A>" + entry_value + "<W>' with item '<A>" + heldItem.debuggable() + "<W>': " + (isMatch ? "<GR>Match!" : "<Y>Not a match"));
                    }
                    if (isMatch) {
                        id = entry.getKey();
                        break;
                    }
                }
            }
            if (parse(npc, player, script, id)) {
                any = true;
            }
        }
    }
    if (!any) {
        npc.action("no click trigger", player);
    }
}

Example 20 with BukkitTagContext

use of com.denizenscript.denizen.tags.BukkitTagContext in project Denizen-For-Bukkit by DenizenScript.

the class BukkitElementProperties method registerTags.

public static void registerTags() {
    // <--[tag]
    // @attribute <ElementTag.as_biome>
    // @returns BiomeTag
    // @group conversion
    // @description
    // Returns the element as a BiomeTag. Note: the value must be a valid biome.
    // -->
    PropertyParser.<BukkitElementProperties, BiomeTag>registerStaticTag(BiomeTag.class, "as_biome", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), BiomeTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "BiomeTag", attribute.hasAlternative());
    });
    // <--[tag]
    // @attribute <ElementTag.as_chunk>
    // @returns ChunkTag
    // @group conversion
    // @description
    // Returns the element as a chunk. Note: the value must be a valid chunk.
    // -->
    PropertyParser.<BukkitElementProperties, ChunkTag>registerTag(ChunkTag.class, "as_chunk", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), ChunkTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "ChunkTag", attribute.hasAlternative());
    }, "aschunk");
    // <--[tag]
    // @attribute <ElementTag.as_color>
    // @returns ColorTag
    // @group conversion
    // @description
    // Returns the element as a ColorTag. Note: the value must be a valid color.
    // -->
    PropertyParser.<BukkitElementProperties, ColorTag>registerStaticTag(ColorTag.class, "as_color", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), ColorTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "ColorTag", attribute.hasAlternative());
    }, "ascolor");
    // <--[tag]
    // @attribute <ElementTag.as_cuboid>
    // @returns CuboidTag
    // @group conversion
    // @description
    // Returns the element as a cuboid. Note: the value must be a valid cuboid.
    // -->
    PropertyParser.<BukkitElementProperties, CuboidTag>registerTag(CuboidTag.class, "as_cuboid", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), CuboidTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "CuboidTag", attribute.hasAlternative());
    }, "ascuboid");
    // <--[tag]
    // @attribute <ElementTag.as_ellipsoid>
    // @returns EllipsoidTag
    // @group conversion
    // @description
    // Returns the element as an EllipsoidTag. Note: the value must be a valid ellipsoid.
    // -->
    PropertyParser.<BukkitElementProperties, EllipsoidTag>registerTag(EllipsoidTag.class, "as_ellipsoid", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), EllipsoidTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "EllipsoidTag", attribute.hasAlternative());
    });
    // <--[tag]
    // @attribute <ElementTag.as_enchantment>
    // @returns EnchantmentTag
    // @group conversion
    // @description
    // Returns the element as an EnchantmentTag. Note: the value must be a valid enchantment.
    // -->
    PropertyParser.<BukkitElementProperties, EnchantmentTag>registerStaticTag(EnchantmentTag.class, "as_enchantment", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), EnchantmentTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "EnchantmentTag", attribute.hasAlternative());
    });
    // <--[tag]
    // @attribute <ElementTag.as_entity>
    // @returns EntityTag
    // @group conversion
    // @description
    // Returns the element as an entity. Note: the value must be a valid entity.
    // -->
    PropertyParser.<BukkitElementProperties, EntityTag>registerTag(EntityTag.class, "as_entity", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), EntityTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "EntityTag", attribute.hasAlternative());
    }, "asentity");
    // <--[tag]
    // @attribute <ElementTag.as_inventory>
    // @returns InventoryTag
    // @group conversion
    // @description
    // Returns the element as an inventory. Note: the value must be a valid inventory.
    // -->
    PropertyParser.<BukkitElementProperties, InventoryTag>registerTag(InventoryTag.class, "as_inventory", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), InventoryTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "InventoryTag", attribute.hasAlternative());
    }, "asinventory");
    // <--[tag]
    // @attribute <ElementTag.as_item>
    // @returns ItemTag
    // @group conversion
    // @description
    // Returns the element as an item. Note: the value must be a valid item.
    // -->
    PropertyParser.<BukkitElementProperties, ItemTag>registerTag(ItemTag.class, "as_item", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), ItemTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "ItemTag", attribute.hasAlternative());
    }, "asitem");
    // <--[tag]
    // @attribute <ElementTag.as_location>
    // @returns LocationTag
    // @group conversion
    // @description
    // Returns the element as a location. Note: the value must be a valid location.
    // -->
    PropertyParser.<BukkitElementProperties, LocationTag>registerTag(LocationTag.class, "as_location", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), LocationTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "LocationTag", attribute.hasAlternative());
    }, "aslocation");
    // <--[tag]
    // @attribute <ElementTag.as_material>
    // @returns MaterialTag
    // @group conversion
    // @description
    // Returns the element as a material. Note: the value must be a valid material.
    // -->
    PropertyParser.<BukkitElementProperties, MaterialTag>registerStaticTag(MaterialTag.class, "as_material", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), MaterialTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "MaterialTag", attribute.hasAlternative());
    }, "asmaterial");
    // <--[tag]
    // @attribute <ElementTag.as_npc>
    // @returns NPCTag
    // @group conversion
    // @description
    // Returns the element as an NPC. Note: the value must be a valid NPC.
    // -->
    PropertyParser.<BukkitElementProperties, NPCTag>registerTag(NPCTag.class, "as_npc", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), NPCTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "NPCTag", attribute.hasAlternative());
    }, "asnpc");
    // <--[tag]
    // @attribute <ElementTag.as_player>
    // @returns PlayerTag
    // @group conversion
    // @description
    // Returns the element as a player. Note: the value must be a valid player. Can be online or offline.
    // -->
    PropertyParser.<BukkitElementProperties, PlayerTag>registerTag(PlayerTag.class, "as_player", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), PlayerTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "PlayerTag", attribute.hasAlternative());
    }, "asplayer");
    // <--[tag]
    // @attribute <ElementTag.as_plugin>
    // @returns PluginTag
    // @group conversion
    // @description
    // Returns the element as a plugin. Note: the value must be a valid plugin.
    // -->
    PropertyParser.<BukkitElementProperties, PluginTag>registerStaticTag(PluginTag.class, "as_plugin", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), PluginTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "PluginTag", attribute.hasAlternative());
    }, "asplugin");
    // <--[tag]
    // @attribute <ElementTag.as_polygon>
    // @returns PolygonTag
    // @group conversion
    // @description
    // Returns the element as a PolygonTag. Note: the value must be a valid polygon.
    // -->
    PropertyParser.<BukkitElementProperties, PolygonTag>registerTag(PolygonTag.class, "as_polygon", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), PolygonTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "PolygonTag", attribute.hasAlternative());
    });
    // <--[tag]
    // @attribute <ElementTag.as_trade>
    // @returns TradeTag
    // @group conversion
    // @description
    // Returns the element as a TradeTag. Note: the value must be a valid trade.
    // -->
    PropertyParser.<BukkitElementProperties, TradeTag>registerStaticTag(TradeTag.class, "as_trade", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), TradeTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "TradeTag", attribute.hasAlternative());
    });
    // <--[tag]
    // @attribute <ElementTag.as_world>
    // @returns WorldTag
    // @group conversion
    // @description
    // Returns the element as a world. Note: the value must be a valid world.
    // -->
    PropertyParser.<BukkitElementProperties, WorldTag>registerTag(WorldTag.class, "as_world", (attribute, object) -> {
        return ElementTag.handleNull(object.asString(), WorldTag.valueOf(object.asString(), new BukkitTagContext(attribute.getScriptEntry())), "WorldTag", attribute.hasAlternative());
    }, "asworld");
    // <--[tag]
    // @attribute <ElementTag.format[<script>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the text re-formatted according to a format script.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerTag(ElementTag.class, "format", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        FormatScriptContainer format = ScriptRegistry.getScriptContainer(attribute.getParam());
        if (format == null) {
            attribute.echoError("Could not find format script matching '" + attribute.getParam() + "'");
            return null;
        } else {
            return new ElementTag(format.getFormattedText(object.asString(), attribute.getScriptEntry() != null ? ((BukkitScriptEntryData) attribute.getScriptEntry().entryData).getNPC() : null, attribute.getScriptEntry() != null ? ((BukkitScriptEntryData) attribute.getScriptEntry().entryData).getPlayer() : null));
        }
    });
    // <--[tag]
    // @attribute <ElementTag.split_lines_by_width[<#>]>
    // @returns ElementTag
    // @group element manipulation
    // @description
    // Returns the element split into separate lines based on a maximum width in pixels per line.
    // This uses character width, so for example 20 "W"s and 20 "i"s will be treated differently.
    // The width used is based on the vanilla minecraft font. This will not be accurate for other fonts.
    // This only currently supports ASCII symbols properly. Unicode symbols will be estimated as 6 pixels.
    // Spaces will be preferred to become newlines, unless a line does not contain any spaces.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "split_lines_by_width", (attribute, object) -> {
        int width = attribute.getIntParam();
        return new ElementTag(TextWidthHelper.splitLines(object.asString(), width));
    });
    // <--[tag]
    // @attribute <ElementTag.text_width>
    // @returns ElementTag(Number)
    // @group element manipulation
    // @description
    // Returns the width, in pixels, of the text.
    // The width used is based on the vanilla minecraft font. This will not be accurate for other fonts.
    // This only currently supports ASCII symbols properly. Unicode symbols will be estimated as 6 pixels.
    // If the element contains newlines, will return the widest line width.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "text_width", (attribute, object) -> {
        return new ElementTag(TextWidthHelper.getWidth(object.asString()));
    });
    // <--[tag]
    // @attribute <ElementTag.lines_to_colored_list>
    // @returns ListTag
    // @group element manipulation
    // @description
    // Returns a list of lines in the element, with colors spread over the lines manually.
    // Useful for things like item lore.
    // -->
    PropertyParser.<BukkitElementProperties, ListTag>registerStaticTag(ListTag.class, "lines_to_colored_list", (attribute, object) -> {
        ListTag output = new ListTag();
        String colors = "";
        for (String line : CoreUtilities.split(object.asString(), '\n')) {
            output.add(colors + line);
            colors = org.bukkit.ChatColor.getLastColors(colors + line);
        }
        return output;
    });
    // <--[tag]
    // @attribute <ElementTag.last_color>
    // @returns ElementTag
    // @group text checking
    // @description
    // Returns the ChatColors used last in an element.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "last_color", (attribute, object) -> {
        return new ElementTag(org.bukkit.ChatColor.getLastColors(object.asString()));
    });
    // <--[tag]
    // @attribute <ElementTag.strip_color>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with all color encoding stripped.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "strip_color", (attribute, object) -> {
        return new ElementTag(FormattedTextHelper.parse(object.asString(), ChatColor.WHITE)[0].toPlainText());
    });
    // <--[tag]
    // @attribute <ElementTag.parse_color[(<prefix>)]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with all color codes parsed.
    // Optionally, specify a character to prefix the color ids. Defaults to '&' if not specified.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "parse_color", (attribute, object) -> {
        char prefix = '&';
        if (attribute.hasParam()) {
            prefix = attribute.getParam().charAt(0);
        }
        String parsed = ChatColor.translateAlternateColorCodes(prefix, object.asString());
        parsed = replaceEssentialsHexColors(prefix, parsed);
        return new ElementTag(parsed);
    });
    // <--[tag]
    // @attribute <ElementTag.to_itemscript_hash>
    // @returns ElementTag
    // @group conversion
    // @description
    // Shortens the element down to an itemscript hash ID, made of invisible color codes.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerTag(ElementTag.class, "to_itemscript_hash", (attribute, object) -> {
        return new ElementTag(ItemScriptHelper.createItemScriptID(object.asString()));
    });
    // <--[tag]
    // @attribute <ElementTag.to_secret_colors>
    // @returns ElementTag
    // @group conversion
    // @description
    // Hides the element's text in invisible color codes.
    // Inverts <@link tag ElementTag.from_secret_colors>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "to_secret_colors", (attribute, object) -> {
        String text = object.asString();
        byte[] bytes = text.getBytes(StandardCharsets.UTF_8);
        String hex = CoreUtilities.hexEncode(bytes);
        StringBuilder colors = new StringBuilder(text.length() * 2);
        for (int i = 0; i < hex.length(); i++) {
            colors.append(ChatColor.COLOR_CHAR).append(hex.charAt(i));
        }
        return new ElementTag(colors.toString());
    });
    // <--[tag]
    // @attribute <ElementTag.from_secret_colors>
    // @returns ElementTag
    // @group conversion
    // @description
    // Un-hides the element's text from invisible color codes back to normal text.
    // Inverts <@link tag ElementTag.to_secret_colors>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "from_secret_colors", (attribute, object) -> {
        String text = object.asString().replace(String.valueOf(ChatColor.COLOR_CHAR), "");
        byte[] bytes = CoreUtilities.hexDecode(text);
        return new ElementTag(new String(bytes, StandardCharsets.UTF_8));
    });
    // <--[tag]
    // @attribute <ElementTag.to_raw_json>
    // @returns ElementTag
    // @group conversion
    // @description
    // Converts normal colored text to Minecraft-style "raw JSON" format.
    // Inverts <@link tag ElementTag.from_raw_json>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "to_raw_json", (attribute, object) -> {
        return new ElementTag(ComponentSerializer.toString(FormattedTextHelper.parse(object.asString(), ChatColor.WHITE)));
    });
    // <--[tag]
    // @attribute <ElementTag.from_raw_json>
    // @returns ElementTag
    // @group conversion
    // @description
    // Un-hides the element's text from invisible color codes back to normal text.
    // Inverts <@link tag ElementTag.to_raw_json>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "from_raw_json", (attribute, object) -> {
        return new ElementTag(FormattedTextHelper.stringify(ComponentSerializer.parse(object.asString()), ChatColor.WHITE));
    });
    // <--[tag]
    // @attribute <ElementTag.on_hover[<message>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Adds a hover message to the element, which makes the element display the input hover text when the mouse is left over it.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerTag(ElementTag.class, "on_hover", (attribute, object) -> {
        // non-static due to hacked sub-tag
        if (!attribute.hasParam()) {
            return null;
        }
        String hoverText = attribute.getParam();
        String type = "SHOW_TEXT";
        // -->
        if (attribute.startsWith("type", 2)) {
            type = attribute.getContext(2);
            attribute.fulfill(1);
        }
        return new ElementTag(ChatColor.COLOR_CHAR + "[hover=" + type + ";" + FormattedTextHelper.escape(hoverText) + "]" + object.asString() + ChatColor.COLOR_CHAR + "[/hover]");
    });
    // <--[tag]
    // @attribute <ElementTag.on_click[<command>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Adds a click command to the element, which makes the element execute the input command when clicked.
    // To execute a command "/" should be used at the start. Otherwise, it will display as chat.
    // For example: - narrate "You can <element[click here].on_click[wow]> to say wow!"
    // For example: - narrate "You can <element[click here].on_click[/help]> for help!"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerTag(ElementTag.class, "on_click", (attribute, object) -> {
        // non-static due to hacked sub-tag
        if (!attribute.hasParam()) {
            return null;
        }
        String clickText = attribute.getParam();
        String type = "RUN_COMMAND";
        // -->
        if (attribute.startsWith("type", 2)) {
            type = attribute.getContext(2);
            attribute.fulfill(1);
        }
        return new ElementTag(ChatColor.COLOR_CHAR + "[click=" + type + ";" + FormattedTextHelper.escape(clickText) + "]" + object.asString() + ChatColor.COLOR_CHAR + "[/click]");
    });
    // <--[tag]
    // @attribute <ElementTag.with_insertion[<message>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Adds an insertion message to the element, which makes the element insert the input message to chat when shift-clicked.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "with_insertion", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        String insertionText = attribute.getParam();
        return new ElementTag(ChatColor.COLOR_CHAR + "[insertion=" + FormattedTextHelper.escape(insertionText) + "]" + object.asString() + ChatColor.COLOR_CHAR + "[/insertion]");
    });
    // <--[tag]
    // @attribute <ElementTag.no_reset>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes a color code (&0123456789abcdef) not reset other formatting details.
    // Use like '<&c.no_reset>' or '<red.no_reset>'.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "no_reset", (attribute, object) -> {
        if (object.asString().length() == 2 && object.asString().charAt(0) == ChatColor.COLOR_CHAR) {
            return new ElementTag(ChatColor.COLOR_CHAR + "[color=" + object.asString().charAt(1) + "]");
        }
        return null;
    });
    // <--[tag]
    // @attribute <ElementTag.end_format>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes a chat format code (&klmno, or &[font=...]) be the end of a format, as opposed to the start.
    // Use like '<&o.end_format>' or '<italic.end_format>'.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "end_format", (attribute, object) -> {
        if (object.asString().length() == 2 && object.asString().charAt(0) == ChatColor.COLOR_CHAR) {
            return new ElementTag(ChatColor.COLOR_CHAR + "[reset=" + object.asString().charAt(1) + "]");
        } else if (object.asString().startsWith(ChatColor.COLOR_CHAR + "[font=") && object.asString().endsWith("]")) {
            return new ElementTag(ChatColor.COLOR_CHAR + "[reset=font]");
        }
        return null;
    });
    // <--[tag]
    // @attribute <ElementTag.italicize>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text italic. Equivalent to "<&o><ELEMENT_HERE><&o.end_format>"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "italicize", (attribute, object) -> {
        return new ElementTag(ChatColor.ITALIC + object.asString() + ChatColor.COLOR_CHAR + "[reset=o]");
    });
    // <--[tag]
    // @attribute <ElementTag.bold>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text bold. Equivalent to "<&l><ELEMENT_HERE><&l.end_format>"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "bold", (attribute, object) -> {
        return new ElementTag(ChatColor.BOLD + object.asString() + ChatColor.COLOR_CHAR + "[reset=l]");
    });
    // <--[tag]
    // @attribute <ElementTag.underline>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text underlined. Equivalent to "<&n><ELEMENT_HERE><&n.end_format>"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "underline", (attribute, object) -> {
        return new ElementTag(ChatColor.UNDERLINE + object.asString() + ChatColor.COLOR_CHAR + "[reset=n]");
    });
    // <--[tag]
    // @attribute <ElementTag.strikethrough>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text struck-through. Equivalent to "<&m><ELEMENT_HERE><&m.end_format>"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "strikethrough", (attribute, object) -> {
        return new ElementTag(ChatColor.STRIKETHROUGH + object.asString() + ChatColor.COLOR_CHAR + "[reset=m]");
    });
    // <--[tag]
    // @attribute <ElementTag.obfuscate>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text obfuscated. Equivalent to "<&k><ELEMENT_HERE><&k.end_format>"
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "obfuscate", (attribute, object) -> {
        return new ElementTag(ChatColor.MAGIC + object.asString() + ChatColor.COLOR_CHAR + "[reset=k]");
    });
    // <--[tag]
    // @attribute <ElementTag.custom_color[<name>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text colored by the custom color value based on the common base color names defined in the Denizen config file.
    // If the color name is unrecognized, returns the value of color named 'default'.
    // Default color names are 'base', 'emphasis', 'warning', 'error'.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "custom_color", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        return new ElementTag(ChatColor.COLOR_CHAR + "[color=f]" + CustomColorTagBase.getColor(attribute.getParam(), attribute.context) + object.asString() + ChatColor.COLOR_CHAR + "[reset=color]");
    });
    // <--[tag]
    // @attribute <ElementTag.color[<color>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text colored by the input color. Equivalent to "<COLOR><ELEMENT_HERE><COLOR.end_format>"
    // Color can be a color name, color code, hex, or ColorTag... that is: ".color[gold]", ".color[6]", and ".color[#AABB00]" are all valid.
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "color", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        String colorName = attribute.getParam();
        String colorOut = null;
        if (colorName.length() == 1) {
            ChatColor color = ChatColor.getByChar(colorName.charAt(0));
            if (color != null) {
                colorOut = color.toString();
            }
        } else if (colorName.length() == 7 && colorName.startsWith("#")) {
            return new ElementTag(ChatColor.COLOR_CHAR + "[color=" + colorName + "]" + object.asString() + ChatColor.COLOR_CHAR + "[reset=color]");
        } else if (colorName.length() == 14 && colorName.startsWith(ChatColor.COLOR_CHAR + "x")) {
            return new ElementTag(ChatColor.COLOR_CHAR + "[color=#" + CoreUtilities.replace(colorName.substring(2), String.valueOf(ChatColor.COLOR_CHAR), "") + "]" + object.asString() + ChatColor.COLOR_CHAR + "[reset=color]");
        } else if (colorName.startsWith("co@")) {
            ColorTag color = ColorTag.valueOf(colorName, attribute.context);
            StringBuilder hex = new StringBuilder(Integer.toHexString(color.getColor().asRGB()));
            while (hex.length() < 6) {
                hex.insert(0, "0");
            }
            return new ElementTag(ChatColor.COLOR_CHAR + "[color=#" + hex + "]" + object.asString() + ChatColor.COLOR_CHAR + "[reset=color]");
        }
        if (colorOut == null) {
            try {
                ChatColor color = ChatColor.of(colorName.toUpperCase());
                String colorStr = color.toString().replace(String.valueOf(ChatColor.COLOR_CHAR), "").replace("x", "#");
                colorOut = ChatColor.COLOR_CHAR + "[color=" + colorStr + "]";
            } catch (IllegalArgumentException ex) {
                attribute.echoError("Color '" + colorName + "' doesn't exist (for ElementTag.color[...]).");
                return null;
            }
        }
        return new ElementTag(colorOut + object.asString() + ChatColor.COLOR_CHAR + "[reset=color]");
    });
    // <--[tag]
    // @attribute <ElementTag.font[<font>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Makes the input text display with the input font name. Equivalent to "<&font[new-font]><ELEMENT_HERE><&font[new-font].end_format>"
    // The default font is "minecraft:default".
    // Note that this is a magic Denizen tool - refer to <@link language Denizen Text Formatting>.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "font", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        String fontName = attribute.getParam();
        return new ElementTag(ChatColor.COLOR_CHAR + "[font=" + fontName + "]" + object.asString() + ChatColor.COLOR_CHAR + "[reset=font]");
    });
    // <--[tag]
    // @attribute <ElementTag.rainbow[(<pattern>)]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with rainbow colors applied.
    // Optionally, specify a color pattern to follow. By default, this is "4c6e2ab319d5".
    // That is, a repeating color of: Red, Orange, Yellow, Green, Cyan, Blue, Purple.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "rainbow", (attribute, object) -> {
        String str = object.asString();
        String pattern = "4c6e2ab319d5";
        if (attribute.hasParam()) {
            pattern = attribute.getParam();
        }
        StringBuilder output = new StringBuilder(str.length() * 3);
        for (int i = 0; i < str.length(); i++) {
            output.append(ChatColor.COLOR_CHAR).append(pattern.charAt(i % pattern.length())).append(str.charAt(i));
        }
        return new ElementTag(output.toString());
    });
    // <--[tag]
    // @attribute <ElementTag.hex_rainbow[(<length>)]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with RGB rainbow colors applied.
    // Optionally, specify a length (how many characters before the colors repeat). If unspecified, will use the input element length.
    // If the element starts with a hex color code, that will be used as the starting color of the rainbow.
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "hex_rainbow", (attribute, object) -> {
        String str = object.asString();
        int[] HSB = new int[] { 0, 255, 255 };
        if (str.startsWith(ChatColor.COLOR_CHAR + "x") && str.length() > 14) {
            char[] colors = new char[6];
            for (int i = 0; i < 6; i++) {
                colors[i] = str.charAt(3 + (i * 2));
            }
            int rgb = Integer.parseInt(new String(colors), 16);
            HSB = new ColorTag(Color.fromRGB(rgb)).toHSB();
            str = str.substring(14);
        }
        float hue = HSB[0] / 255f;
        int length = ChatColor.stripColor(str).length();
        if (length == 0) {
            return new ElementTag("");
        }
        if (attribute.hasParam()) {
            length = attribute.getIntParam();
        }
        float increment = 1.0f / length;
        String addedFormat = "";
        StringBuilder output = new StringBuilder(str.length() * 8);
        for (int i = 0; i < str.length(); i++) {
            char c = str.charAt(i);
            if (c == ChatColor.COLOR_CHAR && i + 1 < str.length()) {
                char c2 = str.charAt(i + 1);
                if (FORMAT_CODES_MATCHER.isMatch(c2)) {
                    addedFormat += String.valueOf(ChatColor.COLOR_CHAR) + c2;
                } else {
                    addedFormat = "";
                }
                i++;
                continue;
            }
            String hex = Integer.toHexString(ColorTag.fromHSB(HSB).getColor().asRGB());
            output.append(FormattedTextHelper.stringifyRGBSpigot(hex)).append(addedFormat).append(c);
            hue += increment;
            HSB[0] = Math.round(hue * 255f);
        }
        return new ElementTag(output.toString());
    });
    // <--[tag]
    // @attribute <ElementTag.color_gradient[from=<color>;to=<color>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with an RGB color gradient applied - tends to produce smooth gradients, as opposed to <@link tag ElementTag.hsb_color_gradient>,
    // with a unique color per character.
    // Specify the input as a map with keys 'from' and 'to' both set to hex colors (or any valid ColorTag).
    // For example: <element[these are the shades of gray].color_gradient[from=white;to=black]>
    // Or: <element[this looks kinda like fire doesn't it].color_gradient[from=#FF0000;to=#FFFF00]>
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "color_gradient", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        String str = object.asString();
        int length = ChatColor.stripColor(str).length();
        if (length == 0) {
            return new ElementTag("");
        }
        MapTag inputMap = attribute.paramAsType(MapTag.class);
        if (inputMap == null) {
            return null;
        }
        ObjectTag fromObj = inputMap.getObject("from");
        ObjectTag toObj = inputMap.getObject("to");
        if (fromObj == null || toObj == null) {
            return null;
        }
        ColorTag fromColor = fromObj.asType(ColorTag.class, attribute.context);
        ColorTag toColor = toObj.asType(ColorTag.class, attribute.context);
        if (fromColor == null || toColor == null) {
            return null;
        }
        float red = ColorTag.fromSRGB(fromColor.getColor().getRed());
        float green = ColorTag.fromSRGB(fromColor.getColor().getGreen());
        float blue = ColorTag.fromSRGB(fromColor.getColor().getBlue());
        float targetRed = ColorTag.fromSRGB(toColor.getColor().getRed());
        float targetGreen = ColorTag.fromSRGB(toColor.getColor().getGreen());
        float targetBlue = ColorTag.fromSRGB(toColor.getColor().getBlue());
        float brightness = (float) Math.pow(red + green + blue, 0.43);
        float toBrightness = (float) Math.pow(targetRed + targetGreen + targetBlue, 0.43);
        float brightnessMove = (toBrightness - brightness) / length;
        float redMove = (targetRed - red) / length;
        float greenMove = (targetGreen - green) / length;
        float blueMove = (targetBlue - blue) / length;
        String addedFormat = "";
        StringBuilder output = new StringBuilder(str.length() * 15);
        for (int i = 0; i < str.length(); i++) {
            char c = str.charAt(i);
            if (c == ChatColor.COLOR_CHAR && i + 1 < str.length()) {
                char c2 = str.charAt(i + 1);
                if (FORMAT_CODES_MATCHER.isMatch(c2)) {
                    addedFormat += String.valueOf(ChatColor.COLOR_CHAR) + c2;
                } else {
                    addedFormat = "";
                }
                i++;
                continue;
            }
            // Based on https://stackoverflow.com/questions/22607043/color-gradient-algorithm/49321304#49321304
            float newRed = red, newGreen = green, newBlue = blue;
            float sum = newRed + newGreen + newBlue;
            if (sum > 0) {
                float multiplier = (float) Math.pow(brightness, 1f / 0.43f) / sum;
                newRed *= multiplier;
                newGreen *= multiplier;
                newBlue *= multiplier;
            }
            newRed = ColorTag.toSRGB(newRed);
            newGreen = ColorTag.toSRGB(newGreen);
            newBlue = ColorTag.toSRGB(newBlue);
            String hex = Integer.toHexString((((int) newRed) << 16) | (((int) newGreen) << 8) | ((int) newBlue));
            output.append(FormattedTextHelper.stringifyRGBSpigot(hex)).append(addedFormat).append(str.charAt(i));
            brightness += brightnessMove;
            red += redMove;
            green += greenMove;
            blue += blueMove;
        }
        return new ElementTag(output.toString());
    });
    // <--[tag]
    // @attribute <ElementTag.hsb_color_gradient[from=<color>;to=<color>]>
    // @returns ElementTag
    // @group text manipulation
    // @description
    // Returns the element with an HSB color gradient applied - tends to produce bright rainbow-like color patterns, as opposed to <@link tag ElementTag.color_gradient>,
    // with a unique color per character.
    // Specify the input as a map with keys 'from' and 'to' both set to hex colors (or any valid ColorTag).
    // -->
    PropertyParser.<BukkitElementProperties, ElementTag>registerStaticTag(ElementTag.class, "hsb_color_gradient", (attribute, object) -> {
        if (!attribute.hasParam()) {
            return null;
        }
        String str = object.asString();
        int length = ChatColor.stripColor(str).length();
        if (length == 0) {
            return new ElementTag("");
        }
        MapTag inputMap = attribute.paramAsType(MapTag.class);
        if (inputMap == null) {
            return null;
        }
        ObjectTag fromObj = inputMap.getObject("from");
        ObjectTag toObj = inputMap.getObject("to");
        if (fromObj == null || toObj == null) {
            return null;
        }
        ColorTag fromColor = fromObj.asType(ColorTag.class, attribute.context);
        ColorTag toColor = toObj.asType(ColorTag.class, attribute.context);
        if (fromColor == null || toColor == null) {
            return null;
        }
        int[] fromHSB = fromColor.toHSB();
        int[] toHSB = toColor.toHSB();
        float hue = fromHSB[0];
        float saturation = fromHSB[1];
        float brightness = fromHSB[2];
        float targetHue = toHSB[0];
        float targetSaturation = toHSB[1];
        float targetBrightness = toHSB[2];
        float hueMove = (targetHue - hue) / length;
        float saturationMove = (targetSaturation - saturation) / length;
        float brightnessMove = (targetBrightness - brightness) / length;
        String addedFormat = "";
        StringBuilder output = new StringBuilder(str.length() * 15);
        for (int i = 0; i < str.length(); i++) {
            char c = str.charAt(i);
            if (c == ChatColor.COLOR_CHAR && i + 1 < str.length()) {
                char c2 = str.charAt(i + 1);
                if (FORMAT_CODES_MATCHER.isMatch(c2)) {
                    addedFormat += String.valueOf(ChatColor.COLOR_CHAR) + c2;
                } else {
                    addedFormat = "";
                }
                i++;
                continue;
            }
            fromHSB[0] = (int) hue;
            fromHSB[1] = (int) saturation;
            fromHSB[2] = (int) brightness;
            ColorTag currentColor = ColorTag.fromHSB(fromHSB);
            String hex = Integer.toHexString(currentColor.getColor().asRGB());
            output.append(FormattedTextHelper.stringifyRGBSpigot(hex)).append(addedFormat).append(c);
            hue += hueMove;
            saturation += saturationMove;
            brightness += brightnessMove;
        }
        return new ElementTag(output.toString());
    });
}