Made for your next RPG Project.
Designs Heavily Inspired by Project Spellforged
Go check them out and show some love!
https://spellforged.github.io
Note:
This is the first version of the plugin. I'm open to ideas and suggestions for future updates! Feel free to leave feedback to help improve the plugin.
What’s changed to v1.0.2:
- Create item templates directly via commands.
What’s Planned:
- Implement support for resource managers (Oraxen, etc.)
What the Plugin Does:
With this plugin, you can create customizable labels for items, including various rarity tiers, and automatically generate a resource pack. The labels provide additional metadata for your items, offering more options for customization in your gameplay.
Features:
- Create item labels with custom text, colors, and rarity styles.
- Generate a resource pack that updates the labels automatically.
- Fully configurable item lore boxes (hex color codes supported).
- Support for custom item templates.
- Easily create new tiers and modify existing ones.
Performance:
I’ve thoroughly tested this plugin, and creating 1000 labels took only 50ms! Meaning performance won't be an issue for mid to high-tier systems from the last 10 years.
RelicLabels Setup
Commands:
- /reliclabels or /rls - Access main plugin commands.
- /rls addtier <name> <hexcode> - Add a new tier with a name and hex color.
- /rls compile - Compile the resource pack.
- /rls addtemplate <material> <tier> - Add a new template with a material and tier.
- /rls listtemplates - Shows all tiers – just click on one to configure them.
- reliclabels.command - Permission to use all /rls commands.
Developer API
For information and usage instructions, please refer to the GitHub repository.
https://github.com/Waifjyux/RelicLabels
Recommended tiers.yml Configuration
For the recommended tiers, you can use the following YAML format to set up different item rarities. Here’s a sample configuration for the tiers:
Code (Text):
tiers:
- - common
- '#c4c4c4'
- - uncommon
- '#3d943d'
- - rare
- '#3493c9'
- - epic
- '#ba36ab'
- - legendary
- '#eba709'
- - common
- '#c4c4c4'
- - uncommon
- '#3d943d'
- - rare
- '#3493c9'
- - epic
- '#ba36ab'
- - legendary
- '#eba709'
- The player joins.
- The server reloads.
- The item is picked up.
- The item is used in Anvils, Grindstones, or Enchanting Tables.
Configuring templates.yml
Currently, you can only create item templates directly through the YAML configuration. The /rls addtemplate command is not yet available, but will be included in a future update. For now, you’ll need to manually add the templates to the YAML file, specifying the properties like size, rarity, and other settings.
Once the command is available, applying templates to items will be much easier. For now, edit the YAML file directly to configure your templates. Feel free to share your test YAML, and I’ll help you in the comments!
Code (Text):
templates:
- material: "STONE" # The material of the desired item (in this case, Stone)
itemName: "test item" # The name for the item (can be removed if you want to apply to all items of this material)
customModelData: 1 # Custom Model Data for resource packs (can be removed if not needed)
tier: "epic" # The tier you previously added (e.g., epic, legendary)
labelName: "Thornbane" # The top name for the item label
labelDescription: "Epic weapon" # A brief description that will be shown beneath the name
labelWidth: 6 # The width of the relic label, adjust based on content
content: # Everything that will be listed below the name plaque
- "#bd8a44+ 14 physical damage" # Text with color codes; automatically wraps when full
- "#7abdc4+ 1.1 attack speed" # Another line of text with a color code
- "/s" # /s adds a strikethrough line for separation
- "§7Applies §cBleed II §7for 2 seconds to the target when hit." # Custom item effects with color codes
- "/es" # If the item has enchantments, a strikethrough line is added before enchantments
- "/e§4+ %ENCHANT_NAME%" # /e shows enchantments, %ENCHANT_NAME% will be replaced with the enchantment's name
- material: "STONE" # The material of the desired item (in this case, Stone)
itemName: "test item" # The name for the item (can be removed if you want to apply to all items of this material)
customModelData: 1 # Custom Model Data for resource packs (can be removed if not needed)
tier: "epic" # The tier you previously added (e.g., epic, legendary)
labelName: "Thornbane" # The top name for the item label
labelDescription: "Epic weapon" # A brief description that will be shown beneath the name
labelWidth: 6 # The width of the relic label, adjust based on content
content: # Everything that will be listed below the name plaque
- "#bd8a44+ 14 physical damage" # Text with color codes; automatically wraps when full
- "#7abdc4+ 1.1 attack speed" # Another line of text with a color code
- "/s" # /s adds a strikethrough line for separation
- "§7Applies §cBleed II §7for 2 seconds to the target when hit." # Custom item effects with color codes
- "/es" # If the item has enchantments, a strikethrough line is added before enchantments
- "/e§4+ %ENCHANT_NAME%" # /e shows enchantments, %ENCHANT_NAME% will be replaced with the enchantment's name
Code (Text):
templates:
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 1
tier: "epic"
labelName: "Thornbane"
labelDescription: "Epic weapon"
labelWidth: 6
content:
- "#bd8a44+ 14 physical damage"
- "#7abdc4+ 1.1 attack speed"
- "/s"
- "§7Applies §cBleed II §7for 2 seconds to the target when hit."
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 2
tier: "uncommon"
labelName: "Cast Iron Hammer"
labelDescription: "Uncommon weapon"
labelWidth: 5
content:
- "#bd8a44+ 8 physical damage"
- "#7abdc4+ 0.9 attack speed"
- "/es"
- "/e§d+ %ENCHANT_NAME%"
- "/s"
- "§7An old worn down blacksmith's hammer, might work well as a doorstopper."
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 3
tier: "rare"
labelName: "Azurebloom Staff"
labelDescription: "Rare wand"
labelWidth: 5
content:
- "#a69de0+ 11 magical damage"
- "#7abdc4+ 0.8 cast speed"
- "/s"
- "§7Has a §320% §7chance to slow enemies."
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 1
tier: "epic"
labelName: "Thornbane"
labelDescription: "Epic weapon"
labelWidth: 6
content:
- "#bd8a44+ 14 physical damage"
- "#7abdc4+ 1.1 attack speed"
- "/s"
- "§7Applies §cBleed II §7for 2 seconds to the target when hit."
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 2
tier: "uncommon"
labelName: "Cast Iron Hammer"
labelDescription: "Uncommon weapon"
labelWidth: 5
content:
- "#bd8a44+ 8 physical damage"
- "#7abdc4+ 0.9 attack speed"
- "/es"
- "/e§d+ %ENCHANT_NAME%"
- "/s"
- "§7An old worn down blacksmith's hammer, might work well as a doorstopper."
- material: "WARPED_FUNGUS_ON_A_STICK"
customModelData: 3
tier: "rare"
labelName: "Azurebloom Staff"
labelDescription: "Rare wand"
labelWidth: 5
content:
- "#a69de0+ 11 magical damage"
- "#7abdc4+ 0.8 cast speed"
- "/s"
- "§7Has a §320% §7chance to slow enemies."
Resource Information
Author:
----------
Total Downloads:
36
First Release:
Mar 30, 2025
Last Update:
Apr 1, 2025
Category:
---------------
All-Time Rating:
0 ratings
Version
-----
Released:
--------------------
Downloads:
------
Version Rating:
----------------------
-- ratings