Tesuto's AuraSkills Lore
A plugin that adds descriptions for all items with level requirements.
📖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
Install AuraSkills
Install TesutoAuraLore
Start the server once
Configure requirements in:
plugins/AuraSkills/config.ymlConfigure 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.ymlru_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.ymlmessages_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:LEVELMATERIAL <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