Lore

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.

Requirements

  • Java 7+
  • Lore is Glowstone compatible

How to Use

  1. If upgrading from Lore 1.x.x to Lore 2.x.x, delete your config.yml!
  2. Install Lore to your plugins directory and start your server.
  3. Join your server.
  4. 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.
  5. 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.

CommandDescriptionConsole 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 listDisplays 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 unsignSets 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
PermissionDescription
lore.command.*Combines all 'command' permissions under one wildcard.
lore.command.createAllows the player to add a new book to the book library.
lore.command.giveAllows the player to give any book to another player.
lore.command.joinAllows the player to set the flag for "join" on Lore books.
lore.command.listAllows the player to use the list command.
lore.command.removeAllows the player to remove a book from Lore's book library.
lore.command.respawnAllows the player to set the flag for "respawn" on Lore books.
lore.command.stickyAllows the player to set the flag for "sticky" on Lore books.
lore.command.unsignAllows the player to turn a signed book into an unsigned book
lore.command.updateAllows the player to update an existing book in the book library.
lore.join.obtainAllows the player to obtain all books with the "join" flag set as true.
lore.respawn.obtainAllows the player to obtain all books with the "respawn" flag set as true.
lore.sticky.bypassAllows the player to not be bound by the sticky status of a book.

Comments

Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files

Bukkit