Tesuto's AuraSkills Lore
PluginApache-2.0

Tesuto's AuraSkills Lore

A plugin that adds descriptions for all items with level requirements.

25
Downloads
3
Followers
2 months ago
Updated
📦
3
Versions

📖About Tesuto's AuraSkills Lore

TesutoAuraLore

TesutoAuraLore is a lightweight addon for AuraSkills that automatically shows skill level requirements directly in item lore.

It reads requirements from AuraSkills (global config + per-item requirements) and renders them in a clean format like:

Requires Mining: 6
Требуется Шахтёрство: 6

Lore updates dynamically — no server restart required.


✨ Features

  • 📜 Adds skill requirement lore to items (tools, weapons, armor)
  • ⚙️ Supports global requirements from plugins/AuraSkills/config.yml
  • 🛠 Supports per-item requirements added via AuraSkills commands
  • 🔄 Hot reload with /tesu reload
  • 🧼 Automatically replaces outdated requirement lines (no duplication)
  • 🧩 Supports multiple requirements per item
  • 🧱 Updates correctly in crafting/anvil/smithing previews and after taking the result
  • 🗂 Uses AuraSkills messages_xx.yml for skill names (e.g. messages_ru.yml)

📦 Requirements

  • Minecraft 1.21.x (tested up to 1.21.11)
  • Java 21
  • AuraSkills 2.x

🔧 Installation

  1. Install AuraSkills

  2. Install TesutoAuraLore

  3. Start the server once

  4. Configure requirements in:

    plugins/AuraSkills/config.yml
    
  5. Configure plugin language in:

    plugins/TesutoAuraLore/config.yml
    

🌍 Localization

1) Plugin language setting

In:

plugins/TesutoAuraLore/config.yml

Set the language code (default is English):

language: en_US

2) Plugin language files

Plugin translations are stored here:

plugins/TesutoAuraLore/lang/

Example:

  • en_US.yml
  • ru_RU.yml

These files control phrases like:

  • Requires
  • formatting template (e.g. Requires {skill}: {level})

3) Skill names come from AuraSkills

{skill} is localized using AuraSkills message files:

plugins/AuraSkills/messages/messages_xx.yml

Example:

  • messages_en.yml
  • messages_ru.yml

So if your plugin language is ru_RU, TesutoAuraLore will try to use AuraSkills messages_ru.yml skill names.


⚙️ Configuration (AuraSkills)

TesutoAuraLore reads requirements directly from AuraSkills.

Example: Global item requirements

requirement:
  enabled: true
  override_global: true
  item:
    global:
      - STONE_PICKAXE MINING:6
      - IRON_PICKAXE MINING:14
      - DIAMOND_PICKAXE MINING:25

Supported formats:

  • MATERIAL SKILL:LEVEL
  • MATERIAL <custom colored text> SKILL:LEVEL

If custom text is provided, it will be shown as-is, and {skill} localization may not apply (because you override the phrase manually).


🧾 Commands

/tesu reload

Reloads requirements and language files and updates item lore without restarting the server.

Permission:

tesu.reload

(Default: OP)


🔁 How Lore Updates Work

  • Old requirement lore added by TesutoAuraLore is removed
  • New requirements are re-applied
  • Prevents duplicates and outdated lines
  • Can update items already in player inventories

🎯 What This Plugin Does NOT Do

  • ❌ Does not block item usage
  • ❌ Does not change AuraSkills mechanics
  • ❌ Does not enforce restrictions

TesutoAuraLore is visual-only — it improves clarity without affecting gameplay logic.


🧩 Intended Use Case

Use TesutoAuraLore if you want players to:

  • immediately see why an item requires a certain skill level
  • have consistent requirement info on items
  • support a server language (RU/EN/etc.) regardless of client settings