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