StandardBooks

Table of Contents

StandardBooks

With this Plugin you can hand out a written book on first join (maybe containing the rules) or get other saved books (maybe with admin commands) via command.

Check out the Converter tool for textfiles created by Marcsello ConverterPage

Features

requires Java7

save books ingame. for this you must hold the book
books can contain the &0,&1... color codes
books can contain "§" formatting
define the book given on first join or turn feature off
per book permission so your Builders can't get the admin Commandbook
give a book to an other player
can override /help and /rules so a defined book is inserted instead (needs sb.help or sb.rules permission)
hand out a book at first join (delay possible)

Commands

/sbs save [bookname] | saves the written book in hand with given name
/sbs list | lists all saved books
/sbs give [bookname] | gives you the book with the entered name
/sbs give [bookname] [playername] | gives the book to the player

Permissions

sb.list | allows to get a list of all saved books
sb.save | allows to save a new book
sb.give.bookname | allows to insert the book with the given bookname
sb.give.other | allows to give a book to an other player
sb.help | allows to receive the helpbook when /help is typed
sb.ignorehelp | players with that permission will be ignored when overriding /help
sb.rules | allows to receive the rules book on /rules
sb.ignorerules | players with that permission will be ignored when overriding /rules

Change notes

v1.4.1

fixed incompatibility with bukkits 1.4.5-R1

v1.4

added delay for first join book (if you want to use it you need a new config file)
list and give book to player command can now be performed via console
fixed list command

v1.3

added feature to give the book to an other player
fixed help and rules override and added permission to get normal help and rules
fixed bug writing none as inserted book giving empty book
fixed bug that a book could not be found when starting with capital

v1.2

added "§" formatting support
added possibility to override /help and /rules (needs new config file)
added sending of plugin metrics to mcstats.org can be turned off in config (needs new config file)

v1.1

changed command to sbs
changed the way a book is saved so an enter key will not be a new page (that means you hav to change your books)
fixed wrong spelled example
fixed copying 'title: ' and 'author: '

v1.0

first release

Known Issues

Converter

Marcsello created a tool to convert textfiles into StandardBokk accepted files check it out:

ToolPage

Planned features

check if book already in player inventory
give.all.* permission for all books
message on help and rules
Any ideas? let me know

Thanks

Thanks got to blackbinary for hosting our server where I can develop and test my plugins

Thanks to Marcsello for creating the Converter

mcstats

Comments

helomen2
- Join Date: 6/10/2022
- Posts: 1
- Member Details
#196 helomen2

View User Profile

Send Message

Posted Jun 22, 2022
Is there a better plugin so far? I'm running on 1.18.2 with the following errors:

22.06 15:48:51 [Server] INFO at java.lang.Thread.run(Thread.java:833) ~[?:?]
22.06 15:48:51 [Server] INFO at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) ~[?:?]
22.06 15:48:51 [Server] INFO at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) ~[?:?]
22.06 15:48:51 [Server] INFO at com.destroystokyo.paper.ServerSchedulerReportingWrapper.run(ServerSchedulerReportingWrapper.java:22) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:48:51 [Server] INFO at org.bukkit.craftbukkit.v1_18_R2.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:57) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:48:51 [Server] INFO at org.bukkit.craftbukkit.v1_18_R2.scheduler.CraftTask.run(CraftTask.java:101) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:48:51 [Server] INFO at ch.blackmining.SB.MetricsLite$1.run(MetricsLite.java:165) ~[StandardBooks.jar:?]
22.06 15:48:51 [Server] INFO at ch.blackmining.SB.MetricsLite.access$4(MetricsLite.java:264) ~[StandardBooks.jar:?]
22.06 15:48:51 [Server] INFO at ch.blackmining.SB.MetricsLite.postPlugin(MetricsLite.java:273) ~[StandardBooks.jar:?]
22.06 15:48:51 [Server] INFO java.lang.NoSuchMethodError: 'org.bukkit.entity.Player[] org.bukkit.Server.getOnlinePlayers()'
22.06 15:48:51 [Server] WARN [StandardBooks] Plugin StandardBooks v1.4.1 generated an exception while executing task 18
22.06 15:38:51 [Server] INFO at java.lang.Thread.run(Thread.java:833) ~[?:?]
22.06 15:38:51 [Server] INFO at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:635) ~[?:?]
22.06 15:38:51 [Server] INFO at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1136) ~[?:?]
22.06 15:38:51 [Server] INFO at com.destroystokyo.paper.ServerSchedulerReportingWrapper.run(ServerSchedulerReportingWrapper.java:22) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:38:51 [Server] INFO at org.bukkit.craftbukkit.v1_18_R2.scheduler.CraftAsyncTask.run(CraftAsyncTask.java:57) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:38:51 [Server] INFO at org.bukkit.craftbukkit.v1_18_R2.scheduler.CraftTask.run(CraftTask.java:101) ~[paper-1.18.2.jar:git-Paper-379]
22.06 15:38:51 [Server] INFO at ch.blackmining.SB.MetricsLite$1.run(MetricsLite.java:165) ~[StandardBooks.jar:?]
22.06 15:38:51 [Server] INFO at ch.blackmining.SB.MetricsLite.access$4(MetricsLite.java:264) ~[StandardBooks.jar:?]
22.06 15:38:51 [Server] INFO at ch.blackmining.SB.MetricsLite.postPlugin(MetricsLite.java:273) ~[StandardBooks.jar:?]
22.06 15:38:51 [Server] INFO java.lang.NoSuchMethodError: 'org.bukkit.entity.Player[] org.bukkit.Server.getOnlinePlayers()'
22.06 15:38:51 [Server] WARN [StandardBooks] Plugin StandardBooks v1.4.1 generated an exception while executing task 18

Rollback Post to Revision RollBack
krisdestruction
- Location: Santa Clara
- Join Date: 6/15/2011
- Posts: 396
- Member Details
#195 krisdestruction

View User Profile

Send Message

Posted Jun 28, 2014
Oh dear looks like the dev is inactive

Rollback Post to Revision RollBack
_ForgeUser7746350
- Join Date: 10/22/2011
- Posts: 551
- Member Details
#194 _ForgeUser7746350

View User Profile

Send Message

Posted Feb 19, 2014
Can you add a reload command?

Rollback Post to Revision RollBack
_ForgeUser10016797
- Join Date: 11/22/2012
- Posts: 27
- Member Details
#193 _ForgeUser10016797

View User Profile

Send Message

Posted Aug 4, 2013
When doing /rules I do not get the book. It just says you dont have permission once. (essentials) I have the sb.rules in the permissions.

Rollback Post to Revision RollBack
_ForgeUser9013263
- Join Date: 6/10/2012
- Posts: 64
- Member Details
#192 _ForgeUser9013263

View User Profile

Send Message

Posted Aug 1, 2013
So my conclusion is that only color codes work? Not "bold" fonts and others?

Rollback Post to Revision RollBack
_ForgeUser9013263
- Join Date: 6/10/2012
- Posts: 64
- Member Details
#191 _ForgeUser9013263

View User Profile

Send Message

Posted Aug 1, 2013
Btw, I noticed that I can't combine colorcodes with fonts. Like I want to put this: "&2&lHello" but when I save the book and check it, it only saves the color but it leaves it like this: "&lHello"

Rollback Post to Revision RollBack
_ForgeUser9013263
- Join Date: 6/10/2012
- Posts: 64
- Member Details
#190 _ForgeUser9013263

View User Profile

Send Message

Posted Aug 1, 2013
@welknair

You have to sign the book or it will not work.

Rollback Post to Revision RollBack
_ForgeUser9129830
- Join Date: 7/3/2012
- Posts: 499
- Member Details
#189 _ForgeUser9129830

View User Profile

Send Message

Posted Jul 15, 2013
@CommodoreAlpha

Yes books contains "§" formatting.

In you haven't noticed in the update v1.2 it added support for it through his plugin.

Rollback Post to Revision RollBack
_ForgeUser10299688
- Join Date: 12/30/2012
- Posts: 1,590
- Member Details
#188 _ForgeUser10299688

View User Profile

Send Message

Posted Jul 15, 2013
Quote:
books can contain "§" formatting

That's not a feature unique to this plugin, that's a feature in vanilla Minecraft.

Rollback Post to Revision RollBack
welknair
- Join Date: 6/17/2011
- Posts: 45
- Member Details
#187 welknair

View User Profile

Send Message

Posted Jul 8, 2013
Whenever I try to save a book, all I get is the following message:

"[StandardBooks] An error occurred while saving book"

Rollback Post to Revision RollBack
_ForgeUser8244284
- Join Date: 1/12/2012
- Posts: 58
- Member Details
#186 _ForgeUser8244284

View User Profile

Send Message

Posted Jun 25, 2013
I love this! Thank you!

Two requests:

1) My server log doesn't show when people say /rules. They get a book, but I want the log event. Can this be fixed?

2) Players with a full hotbar might not know when they've been given a book. Can they be shown a message, set in config.yml? "You have received a book called %bookname%" or something?

Thanks again, great plugin!

EDIT: I see #2 is in the plan already. Thanks, can't wait. :-)

Last edited by _ForgeUser8244284: Jun 25, 2013

Rollback Post to Revision RollBack
Forge_User_36145254
- Join Date: 3/11/2012
- Posts: 685
- Member Details
#185 Forge_User_36145254

View User Profile

Send Message

Posted Jun 19, 2013
@bugzero

But 1.4.7 is not 1.5.2. Yes it does work though.

Rollback Post to Revision RollBack
Forge_User_36145254
- Join Date: 3/11/2012
- Posts: 685
- Member Details
#184 Forge_User_36145254

View User Profile

Send Message

Posted Jun 19, 2013
I have all the permissions, and have tried saving a duplicated book&quill, and it says i am not holding a book to save. Why?

Last edited by Forge_User_36145254: Jun 19, 2013

Rollback Post to Revision RollBack
_ForgeUser10366636
- Join Date: 1/10/2013
- Posts: 272
- Member Details
#183 _ForgeUser10366636

View User Profile

Send Message

Posted May 8, 2013
Hello! this plugin is missing: &k &l &m &n &o &r - Color codes sadly, hope something change.

Rollback Post to Revision RollBack
_ForgeUser10366636
- Join Date: 1/10/2013
- Posts: 272
- Member Details
#182 _ForgeUser10366636

View User Profile

Send Message

Posted May 8, 2013
@Marium0505

yes it works fine for 1.5.2

Rollback Post to Revision RollBack
_ForgeUser10366636
- Join Date: 1/10/2013
- Posts: 272
- Member Details
#181 _ForgeUser10366636

View User Profile

Send Message

Posted May 8, 2013
@ChaoticTrack

give they this permission: sb.ignorehelp

Rollback Post to Revision RollBack
_ForgeUser7746350
- Join Date: 10/22/2011
- Posts: 551
- Member Details
#180 _ForgeUser7746350

View User Profile

Send Message

Posted May 5, 2013
Does this work on 1.5.2?

Rollback Post to Revision RollBack
ChaoticTrack
- Join Date: 7/29/2011
- Posts: 19
- Member Details
#179 ChaoticTrack

View User Profile

Send Message

Posted May 4, 2013
About my last post... for Citizens and Guests on my server... it overwrites the /help command and now they can't type /help.

Rollback Post to Revision RollBack
ChaoticTrack
- Join Date: 7/29/2011
- Posts: 19
- Member Details
#178 ChaoticTrack

View User Profile

Send Message

Posted Apr 20, 2013
Thanks for the awesome plugin! It's working perfectly for me on 1.5.1. :D

Rollback Post to Revision RollBack
_ForgeUser10366636
- Join Date: 1/10/2013
- Posts: 272
- Member Details
#175 _ForgeUser10366636

View User Profile

Send Message

Posted Apr 7, 2013
Any update coming? sorry if this questions is annoying but i want know :D

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.