[MECH] IOBookcase v1.32 - Allowing users to read/write to bookcases [766]

IOBookcase - Lets users read and write to bookcases.

Version: v1.32

This plugin makes normally useless bookcases somewhat useful! You can write up to 5 lines per bookcase to display to users who walk by and right click them.

Commands:

• No commands, it's all done in game!

Requirements:

• The sqlitejdbc-v056.jar file needs to go where craftbukkit is (one directory above plugins).
• Permissions 2.0 or GroupManager are optional, but it's a good idea to have one.

Quick Links:

• Download v1.32 (JAR)
• Source

Install:

• Upload the directory structure into your root minecraft directory (where craftbukkit is).

Use:

• Place a bookcase where ever you'd like to put it.
• Grab a sign and place it on the bookcase.
• In the top line, write @line # [color].
  • # is the line number, 1-10
  • [color] is optional, it can be black, navy, green, blue, red, purple, gold, gray, rose, yellow, white or the corresponding color number (dark and light color strings are too long).
• Finish writing your text in the last 3 lines and hit enter.
• Right click your bookcase and see your text!

Importing from file:
If you choose to import from a file, you can create or edit the file plugins/IOBookcase/import.txt (The file will be created when you restart your server). The formatting of this file is very important, it's not fully functional XML, but it mirrors it. Keep that in mind. Here is an example of this file properly formatted:

Show Spoiler Hide Spoiler

<case name="case1">
<line num="1" color="red">
this is text for line 1
</line>
<line num="2" color="green">
this is text for line 2
</line>
<line num="3">
this is text for line 3
</line>
<line num="4">
this is text for line 4
</line>
</case>
<case name="case2">
<line num="1">
this is text for line 5
</line>
<line num="2">
this is text for line 6
</line>
<line num="3">
this is text for line 7
</line>
<line num="4">
this is text for line 8
</line>
</case>

Please note in the example, the line breaks. In real XML you can do <line num="1">text</line> all on one line, here you can't. Keep the line breaks. The tabbing is just for readability, it's not required.

The num parameter for <line> is required, color is optional. If your color is coming out white if you specified a color, it doesn't understand your color choice. Please use black, navy, green, blue, red, purple, gold, lightgray, gray, darkpurple, lightgreen, lightblue, rose, lightpurple, yellow or white.

Finally, to import in game place a sign on the bookcase. Line 1 needs to be @import. Line 2 needs to be the case's name specified in the import.txt file (in the above example of import.txt, case1 and case2 are valid names). Lines 1-10 are accepted, any more then you will get an error.

Permissions or GroupManager:

Code:

iobookcase.canread - for groups that can read bookcases
iobookcase.canwrite - for groups that can write to bookcases

Todo:

• Experimenting with opening the sign dialog without having to place a sign.
• If a bookcase is destroyed, drop a bookcase.
• Add noteblock triggering lines.
• Make 'bookcase is empty' message configurable.

Changelog:
Version 1.32

• Fixed the player interact bug causing errors on left click.

Version 1.31

• Replaced depreciated methods to work with CB602.

Version 1.3

• Added option to import cases from a text file

Version 1.2

• Increased bookcase lines to 10
• Fixed color being mandatory, it's now optional as designed.
• Removed spaces between lines.

Version 1.1

• Added optional GroupManager support.
• Added colored text.

Version 1.0

• Public Release

 

well, looks like this plugin is no more support...

Let's try to ask it at the right place guys... (the plugins submitions forum) -->
http://forums.bukkit.org/forums/plugin-submissions.20/

maybe we will be more lucky this time ?

*-*