52 lines
2.4 KiB
Markdown
52 lines
2.4 KiB
Markdown
# Books Without Borders
|
|
|
|
This is an attempt at a rewrite of the Books Without Borders plugin. This rewrite uses the source code given
|
|
at [the original bukkit page](https://dev.bukkit.org/projects/books-without-borders). I'm not planning any new features
|
|
at this time. The only goal is to make it 1.17.1 compliant, but I'll make the code more maintainable along the way.
|
|
While the original version still works, it's using a lot of depreciated function calls which will most likely break in
|
|
the future.
|
|
|
|
## Books without Borders!
|
|
|
|
Ever wanted to export your book to a text file? Ever want to import it back in? Accidentally sign it too soon? If so,
|
|
Books without Borders has got your back!
|
|
|
|
### Features
|
|
|
|
* Export written books and book and quills to .txt or .yml files
|
|
* Import books from files as written books or unsigned books
|
|
* Text files can be any length, and the import process fits the content to the correct page length
|
|
* Books can be saved privately, or to a directory visible server wide
|
|
* Encrypt books to prevent other players from reading them
|
|
* Give, encrypt, or decrypt held books with signs
|
|
* Give players books via command blocks
|
|
* Unsign or copy held books with a simple command
|
|
* Give first time players a single book or a set of books when they join
|
|
* Configurable option to require certain items or pay via Vault compatible economy to create books via command
|
|
* Add lore to any item with a simple command
|
|
* Supports adding and saving color to title, lore, and book contents
|
|
|
|
#### Group encryption
|
|
|
|
* Group encryption allows every player with the bookswithoutborders.decrypt.\<group> permission to decrypt the encrypted
|
|
book without using a password.
|
|
|
|
### Signs
|
|
|
|
This plugin supports several custom signs with special functionality. Each plugin sign must have [BwB] on its first
|
|
line.
|
|
|
|
#### Give sign
|
|
|
|
The **_give_** sign must have **[Give]** on its second line. The third and fourth line contains the book to be loaded.
|
|
This can either be a numerical id pointing to a publicly saved book, or the full text identifier of the book (book name,
|
|
author).
|
|
|
|
#### Encrypt sign
|
|
|
|
The **_encrypt_** sign must have **[Encrypt]** on its second line. The third line must contain the encryption key The
|
|
fourth line can be empty or contain "dna" for dna-based encryption.
|
|
|
|
#### Decrypt sign
|
|
|
|
The **_decrypt_** sign must have **[Decrypt]** on its second line. The third line must contain the decryption key |