sItemLore is a lightweight and intuitive Minecraft plugin designed to give server owners and players precise control over item lore. Whether you want to add descriptive text, secret messages, or just stylize your items, sItemLore makes it easy with simple commands and powerful features. It's built to be user-friendly for players and highly configurable for server administrators.
Features:
- Full Lore Control:
- Add: /slore add <text...> - Add new lines of lore.
- Set: /slore set <line_number> <text...> - Modify existing lore lines.
- Remove: /slore remove <line_number> - Delete specific lore lines.
- Clear: /slore clear [confirm] - Wipe all lore from an item (with optional confirmation).
- Color Code Support: Full support for Minecraft color codes (&c, &l, etc.) to make your lore vibrant and stylish.
- Multi-Language Support:
- Messages can be translated! Comes with English (en) by default.
- Easily add your own translations for Spanish (sp), Chinese (ch), Hindi (hindi), or any other language by creating simple .yml files.
- Default language configurable in config.yml.
- Highly Configurable (
- Customize the plugin message prefix.
- Set maximum lore lines per item.
- Set maximum characters per lore line.
- Implement a lore blacklist to prevent unwanted words/phrases.
- Toggle case-sensitivity for the blacklist.
- Enable/disable confirmation for clearing lore.
- Set command cooldowns for lore modification actions.
- Enable debug mode for developers.
- Permissions: Granular permissions for each command (sitemlore.add, sitemlore.set, etc.) allowing fine-tuned access control. (Default: OP)
- Lightweight: Designed to be efficient and not bog down your server.
- Tab Completion: Smart tab completion for commands and line numbers.
- Reload Command: /slore reload to apply configuration changes without a server restart.
Why sItemLore?
- Simplicity: Easy-to-understand commands and configuration.
- Flexibility: From basic lore editing to advanced restrictions, sItemLore adapts to your needs.
- Localization: Perfect for international servers with its built-in language system.
- Admin-Friendly: Robust configuration options give you full control.
Commands:
- /slore add <text...> - Adds a new lore line to the held item.
- /slore set <line_number> <text...> - Sets the lore for a specific line.
- /slore remove <line_number> - Removes a specific lore line.
- /slore clear [confirm] - Clears all lore from the held item. (Confirmation step if enabled)
- /slore help - Displays the help message.
- /slore reload - Reloads the plugin's configuration and language files.
Permissions:
- sitemlore.use - Allows basic use of /slore help. (Default: true)
- sitemlore.add - Allows using /slore add. (Default: op)
- sitemlore.set - Allows using /slore set. (Default: op)
- sitemlore.remove - Allows using /slore remove. (Default: op)
- sitemlore.clear - Allows using /slore clear. (Default: op)
- sitemlore.reload - Allows using /slore reload. (Default: op)
- (Optional: You might add permissions like
Installation:
- Download the sItemLore.jar file.
- Place the sItemLore.jar into your server's plugins folder.
- Restart or reload your server.
- The plugin will generate a sItemLore folder in your plugins directory containing config.yml and a lang folder with en.yml.
- Customize config.yml to your liking.
- Add other language files (e.g., sp.yml, ch.yml) to the lang folder if needed, and set the default-language in config.yml.
- Use /slore reload to apply config changes or restart the server.
Configuration (
Code (Text):
# sItemLore Configuration File
# Version: 1.1 (If you track config versions)
# ---- Language Settings ----
# Default language to use for plugin messages.
# This should match a filename (without .yml) in the 'lang' folder.
# e.g., "en", "sp", "ch", "hindi"
default-language: "en"
# ---- Messaging ----
# The prefix that will appear before most plugin messages.
# Use '&' for Minecraft color codes.
message-prefix: "&6[sItemLore] &r"
# ---- Lore Restrictions ----
# Maximum number of lore lines an item can have.
# Set to -1 for no limit.
max-lore-lines: 25
# Maximum character length for a single line of lore.
# Minecraft itself might have display limits, but this can be a plugin-enforced limit.
# Set to -1 for no limit.
max-lore-line-length: 60 # Common vanilla-like limit is around 50-70 for readability
# Words or phrases that are not allowed in item lore.
# These are case-insensitive by default (see 'lore-blacklist-case-sensitive').
lore-blacklist:
- "badword1"
- "example_curse"
- "spam_phrase_here"
# - "&k" # Example: disallow obfuscated text if you want
# If true, the 'lore-blacklist' will be case-sensitive.
# If false, "BadWord1" will be blocked if "badword1" is in the list.
lore-blacklist-case-sensitive: false
# Message to show when a blacklisted word is detected.
# This message key should be added to your language files.
# Example placeholder in lang files: {word}
blacklisted-word-message-key: "lore.blacklisted-word"
# Example in en.yml:
# lore:
# blacklisted-word: "&cThe word/phrase '{word}' is not allowed in lore."
# ---- Command Behavior ----
# If true, players will need to confirm before clearing all lore from an item.
# They would run `/slore clear` then `/slore clear confirm` or similar.
# This requires adding a confirmation mechanism to the command.
require-confirmation-for-clear: true
# Cooldown in seconds for using lore modification commands (add, set, remove, clear).
# Set to 0 to disable cooldowns.
# This requires implementing a cooldown manager.
command-cooldown:
add: 0
set: 0
remove: 0
clear: 0 # Could be higher, e.g., 5 seconds for clear if desired
# ---- Developer & Debug ----
# For developers: Enable more detailed console logging if true.
debug-mode: false
AUTHOR --> sayamdev , spacexstudio
Discord -->
https://discord.gg/x3pHYtQ9kJ