YMLbook
YMLbook is simple book customizing / writing plugin.
You can easily write books as much you want. Example your server rules, admin and moderator list, donation links, tutorial how to use game/commands and everything what you want. Just write book information to books.yml and players can copy it and read it.
Features
- You can make as many books you want.
- Really easy to use and setup.
- Can make sign which give the book. (picture)
- Admin command, give the book to player.
- Can customize every world own start books.
- Config variable(s) -> {BOOKS} (Show all books name from books.yml)
- Only bookgive and bookreload commands work now in Console.
- http://minecraftwiki.net/wiki/Formatting_codes works. (Dont use alt codes)
- Give permission each book (ymlbook.book.BOOKNAME).
- Automatically make new page (one page can be 255 length).
- You can full customization messages.
- Can add lore text to the book.
- Can see all books with one command.
- Permissions & commands.
Command / Permission
Command | Description | Permission |
---|---|---|
/book <bookname> | Get the book, if have permission | ymlbook.use |
/booklist | Show all book what exist | ymlbook.booklist |
/bookgive <player> <bookname> | Give book to player | ymlbook.bookgive |
/bookreload | Reload config.yml and books.yml | ymlbook.reload |
Other permissions
Permission | Description |
---|---|
ymlbook.book.* | Give access to use/copy all books |
ymlbook.book.NAME (ex. ymlbook.book.readme) | Give access to use/copy one book. |
ymlbook.signbook | Can make sign which gives the book. |
MCStats / Metrics
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
Todo list
- Make "alt code" to work.
- /bookcopy <bookname> (Add book from Minecraft to book.yml file)
- Books variable, new page (Start new page right away)
/booklist See all of the books, which are permission to use.First join books (Get when player join first time)Sign book give. [Book] nameMove from config.yml book: book text to own yml file. (to book.yml)/bookgive <player> <bookname> Command to admin. Admin can give book to player.Color supportLore textGive permission each book (Example: ymlbook.book.rules)Custom messagesReload config commandAdd metrics- Any suggestions?
Known bugs
- YMLBook sign event not working (in Creative mode)
- "Alt codes" break the books.yml file
(If you find any bugs please report it to the manager)
Video(s)
https://youtu.be/WhWrQKHmTs4
(Language: Portuguese - Credits Video: AbsintoJ/YMLbook)
PermissionsEx v1.19.6 http://dev.bukkit.org/bukkit-plugins/permissionsex/ All other permissions work on the server.
@Peda1996
Well try check books.yml and config.yml code in this website -> http://yaml-online-parser.appspot.com/ its should work O.o
@matze135
What permission plugin you use?
the standart config wont reload :(
Sorry for my english. I have a little problem. User have the permissions "ymlbook.use", but they have not permissions for the command "/book <bookname>". Have anywere a idea ?
@Mineraftair
Its automatically make new page. Right now cant start new page right away but added todo list.
@MrMe1003
Well i can add this todo list, thanks for idea ;)
Nice work! But HOW can I add more pages???
Could a permission be added, or a feature with a true/false value be added to the config, so that new players joining the server for the first time will automatically have the book in their inventory?
@Crazdale
Can you send me your book.yml file? i will try fix this issue.
EDIT: I maybe fix it now. Also you can use §r its like new line.
Example: http://puu.sh/3V6cc/abef1d3158.png
I name this project first "bookTXT" so my first idea is write all book inf to .txt file, but i think yml is much easier to use.
Thanks for feedback :)
Love the plugin! Running nicely on 1.6.2. Great job! Has a few issues I've noticed tho. Spacing gets a bit screwed up when you try adding multiple line paragraphs which span pages. Adding a line break character would be great. Also, some of my letters from the end of the page to the beginning of the new page are missing sometimes... so some of the words appear to be getting chopped in half.
One suggestion, if I may. It would be nice to load books from individual files (.txt files) instead of needing them in the books config file. The reason I'd like to see this, is because our users create a lot of our lore. We'd love to have this plugin running while allowing users to upload .txt files via FTP and being able to reload this plugin, so they may import their own books from files they upload.
Basically, something similar to how Text To Book works. http://dev.bukkit.org/bukkit-plugins/text-book/
Well, anyways, besides being a bit more work on the admin end, your plugin works and it works well! Thanks! ;)
@Kero81
You can try use Version 1.5 with 1.5.2 server. Tell me if its working :)
Hi, is there a way to use the Sign in Version 1.4?! Or can i use Version 1.5 with Minecraft 1.5.2?!
Anyway, your Plugin is really Cool! =)
Looks great!
New 1.5 features:
@Si7VdeR Yes, i will. But i need wait Bukkit 1.6.1 jar
Do you think this will be updated for 1.6 ? I would love to have an easy way to write books for my dungeons and tutorials.
@shortybsd Looks like all "alt codes" doesn't work. But all in minecraftwiki codes work. I will try fix this, recommend use this formats
http://minecraftwiki.net/wiki/Formatting_codes
When using formatting codes in book breaks the reload command also they do not work when you /reload the server. alt + 21 on numpad along with color/format code breaks it.
@Faldonboy Thanks for the suggestions :)
I will add lore text to todo list,
Color support is already in todo list.
@ice374 I will add later source code to http://github.com/ website.
Request - Add color and formatting codes for title, author and page-text, possibly add an option to add lore text to the books too
Can i please request the source for this?
I would use the source as a guide for a plugin for a private server. Under no circumstances would i be posting your sourcecode anywhere. And i would not post the plugin i am trying to make on bukkit.org or any other website, as that could hamper your plugins success on here.
If you can help me please can you send the source to [email protected]
If you can I would be sooooo grateful
Many thanks, Strife