Lore is a simple and lightweight plugin that is aimed to give your server a more diverse and informative experience by allowing administrators to easily create, manage and hand-out books to players either on their first login or upon respawning. This is a must have plugin for any RPG server out there!
Please consider passing me a token of your appreciation for creating and maintaining this plugin by donating.
Features
Ability to save books to a YAML file for use with Lore.
Ability to set one or multiple saved books that players will receive when first logging in to the server.
Ability to set one or multiple saved books that players will receive when respawning after death.
Ability to set one or multiple saved books that players cannot remove from their inventory.
Ability to set the messages used by Lore in the config.yml.
Ability to give a copy of a saved book to players at any time.
Ability to update an existing book in Lore.
Ability to turn a signed book into an unsigned book.
If upgrading from Lore 1.x.x to Lore 2.x.x, delete your config.yml!
Install Lore to your plugins directory and start your server.
Join your server.
Hold a signed book in your hand and type `/lore create [book]`, replace [book] with whatever you want to refer to that book as when using Lore commands.
Follow the command reference chart below, make sure you have permissions setup as well!
How it Works
If a book in Lore's book library has the "join" flag set to true, it will give that book to a player who has never played on that server before.
If a book in Lore's book library has the "respawn" flag set to true, it will give that book to a player when they respawn after death.
If a book in Lore's book library has the "sticky" flag set to true, it will not let them take it out of their hotbar or inventory.
If you want to modify an existing book, just hold the book in your hand and do '/lore unsign'!
If you want to update an existing book configuration in Lore, just hold the book in your hand and do '/lore update [book]'.
If the "allow-villager-trades" option is set to true, it will allow players to trade Lore books to villagers.
All of the above requires proper permission setup.
If a message in the config.yml is empty, no message is sent to the player.
Planned
Nothing at this time.
Command
Description
Console Support
/lore give [player] [book]
Gives the specified player a copy of the specified book from Lore's book library.
Yes
/lore create [name]
Adds the held book to Lore's book library with the specified name.
No
/lore join [book] <true/false>
Sets the "join" flag for the specified book as either true or false.
Yes
/lore list
Displays the list of registered books to the command sender.
Yes
/lore remove [book]
Removes the specified book from Lore's book library.
Yes
/lore respawn [book] <true/false>
Sets the "respawn" flag for the specified book as either true or false.
Yes
/lore sticky [book] <true/false>
Sets the "sticky" flag for the specified book as either true or false.
Yes
/lore unsign
Sets the currently held book as an unsigned book to allow editing.
No
/lore update [book]
Updates an existing Lore book with the currently held books' information.
No
Permission
Description
lore.command.*
Combines all 'command' permissions under one wildcard.
lore.command.create
Allows the player to add a new book to the book library.
lore.command.give
Allows the player to give any book to another player.
lore.command.join
Allows the player to set the flag for "join" on Lore books.
lore.command.list
Allows the player to use the list command.
lore.command.remove
Allows the player to remove a book from Lore's book library.
lore.command.respawn
Allows the player to set the flag for "respawn" on Lore books.
lore.command.sticky
Allows the player to set the flag for "sticky" on Lore books.
lore.command.unsign
Allows the player to turn a signed book into an unsigned book
lore.command.update
Allows the player to update an existing book in the book library.
lore.join.obtain
Allows the player to obtain all books with the "join" flag set as true.
lore.respawn.obtain
Allows the player to obtain all books with the "respawn" flag set as true.
lore.sticky.bypass
Allows the player to not be bound by the sticky status of a book.
I went ahead and fixed the issue with the join command as well as added a list command as you requested. If you wish not to wait for the DBO staff to approve the upload then feel free to grab it here: http://dev.bukkit.org/bukkit-plugins/lore/files/14-lore-2-1-0/
[20:47:50 ERROR]: Could not load 'plugins/Lore.jar' in folder 'plugins'
org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: com/almuradev/lore/LorePlugin : Unsupported major.minor version 51.0
Awesome update! One thing though, could you please add an option so that when nothing is entered in the message field, then no message is shown. I'd like my players to get the book on respawn "silently" without any message. :)
I can not seem for the life of me to get my default group to get my lore books upon respawning. It works for me as owner but all groups below that seem to not work. :I
@thernztrom I'll look into doing that. Sounds like a neat idea.
@EmberC I can't imagine it'd be too hard to add an option to disable trades for villagers for any of Lore's books. I'll look into it sometime later this week.
Feature request: Add an option for each book "sticky: false|true". If false, you can throw it away, if true you can't throw it away. When you try to, it reappears in the inventory bar.
When you spawn these books are they able to be traded to villagers? If so is there a way to block it or even add a cool down to prevent users from spawning infinite books?
It now works like a charm and thanks for being so quick about it =^-^= its going to be a major Role on my server once I finish Typing everything out! Thanks again and great work!
@Gamerfyre
I've submitted version 1.2.1 which hopefully will resolve your issue. Thank you for pointing it out! Must have missed it when doing the 1.2 update.
Currently I am having an issue with the /lore create command. When I use it it does not create a book it just repeats the options that I have at my disposal. Even as op all of the other commands work but it just won't create the book. I have followed the instructions to the "T" and I can't seem to figure it out as well, there is nothing in the Console that shows there is anything going on.
@My_Name_Was_Stolen
I went ahead and fixed the issue with the join command as well as added a list command as you requested. If you wish not to wait for the DBO staff to approve the upload then feel free to grab it here: http://dev.bukkit.org/bukkit-plugins/lore/files/14-lore-2-1-0/
Might I suggest a /lore list command that lists all the books in the library?
EDIT
Upon further inspection, it does not appear that the /lore join command is working.
@niels241
Make sure you are using Java 7, as Lore requires that version or higher.
[20:47:50 ERROR]: Could not load 'plugins/Lore.jar' in folder 'plugins' org.bukkit.plugin.InvalidPluginException: java.lang.UnsupportedClassVersionError: com/almuradev/lore/LorePlugin : Unsupported major.minor version 51.0
1.7.2 version 0.2
@NinjaGrinch
Awesome! :)
@thernztrom Lore 2.0.1 is waiting for approval, this should address your request. :)
@NinjaGrinch
Awesome update! One thing though, could you please add an option so that when nothing is entered in the message field, then no message is shown. I'd like my players to get the book on respawn "silently" without any message. :)
Thank you for the update. It is working great :)
@thernztrom Both features have been added to Lore 2.0. :)
I can not seem for the life of me to get my default group to get my lore books upon respawning. It works for me as owner but all groups below that seem to not work. :I
These are my globalgroups permissions: http://pastebin.com/ug6zHjHn These are my world groups permissions: http://pastebin.com/yb1PAiMD
Sidenote: It's 5:10AM here and I have not slept yet so sorry if the problem is really obvious.
@thernztrom I'll look into doing that. Sounds like a neat idea.
@EmberC I can't imagine it'd be too hard to add an option to disable trades for villagers for any of Lore's books. I'll look into it sometime later this week.
@NinjaGrinch
Awesome lightweight plugin! :)
Feature request: Add an option for each book "sticky: false|true". If false, you can throw it away, if true you can't throw it away. When you try to, it reappears in the inventory bar.
When you spawn these books are they able to be traded to villagers? If so is there a way to block it or even add a cool down to prevent users from spawning infinite books?
@NinjaGrinch
It now works like a charm and thanks for being so quick about it =^-^= its going to be a major Role on my server once I finish Typing everything out! Thanks again and great work!
LOVE this plugin!
Super easy to use, A+ Performance.
@Gamerfyre I've submitted version 1.2.1 which hopefully will resolve your issue. Thank you for pointing it out! Must have missed it when doing the 1.2 update.
Currently I am having an issue with the /lore create command. When I use it it does not create a book it just repeats the options that I have at my disposal. Even as op all of the other commands work but it just won't create the book. I have followed the instructions to the "T" and I can't seem to figure it out as well, there is nothing in the Console that shows there is anything going on.
@Lakuspakus As of version 1.1 multiple book support is a feature.
@Lakuspakus I'll consider it. Right now I'm not 100% certain if I want to add said feature.
I'm using this plugin on my server, It's really helpful since my server is semi - vanilla! this plugin is one I'd defiantly recommend!:)