[MECH] Annotate 1.2.4 - Write on anything [953]

Discussion in 'Inactive/Unsupported Plugins' started by Fluff, May 21, 2011.

  1. Offline


    Annotate v1.2.4

    A fork of Milton's excellent SignReadMore plugin, this allows you to put messages practically anywhere!

    Feature Summary
    • Put an annotation on almost any block.
    • View annotations just by right-clicking on them.
    • Annotations now support color!
    • Annotations can be text entered in-game or files that exist in the Annotate folder.
    • Restrict annotations from being seen to only certain users or Permission groups.
    • Restrict annotations from being edited to only certain users or Permission groups.
    • Remove annotations without destroying blocks.
    • Annotations on a button can be viewed by pressing the button.
    • Annotations on a pressure plate can be viewed by stepping on the pressure plate.
    • Easily migrate from SignReadMore to Annotate.
    • Developer API available for easy integration into other plugins.
    • Permissions-friendly

    User's Guide

    About The Developers

    Want to ensure your bug or suggestion isn't lost in the thread? Post it on our issue tracker.

    Command Summary (open)

    • /ann file <filename> - Associates the next block you right-click on with the file.
    • /ann line[1-10] <text> - Associates the next block you right-click on with the text. For example, use /ann line1 Hello! to add Hello! to the first line of an annotation. To add something to the second line, use /ann line2 <text>.
    • /ann remove - Removes the annotation from the next block you right-click on.
    • /ann addeditor <player> [<player2> ...] - Adds editors to the next annotation you right-click on.
    • /ann addviewer <player> [<player2> ...] - Adds viewers to the next annotation you right-click on.
    • /ann removeeditor <player> [<player2> ...] - Removes editors from the next annotation you right-click on.
    • /ann removeviewer <player> [<player2> ...] - Removes viewers from the next annotation you right-click on.
    • /ann users - Views the editors and viewers allowed to use the next annotation you right-click on.
    • /ann view - Views the contents of the current wand. For example, it will show you what text is currently in your line buffer if you haven't right-clicked on a block yet.
    • /ann cancel - Cancels the currently selected wand.
    Permission Nodes (open)

    • annotate.view - Allows the player to view annotations.
    • annotate.ann - Allows the player to create and edit annotations.
    • annotate.override - Allows the player to view/edit any annotation, regardless of in-annotation permissions.
    Color Codes (open)

    Color codes must be in lowercase.
    • &0; or &black; - Black
    • &1; or &darkblue; - Dark Blue
    • &2; or &darkgreen; - Dark Green
    • &3; or &darkaqua; - Dark Aqua
    • &4; or &darkred; - Dark Red
    • &5; or &darkpurple; - Dark Purple
    • &6; or &gold; - Gold
    • &7; or &gray; - Gray
    • &8; or &darkgray; - Dark Gray
    • &9; or &blue; - Blue
    • &10; or &a; or &green; - Green
    • &11; or &b; or &aqua; - Aqua
    • &12; or &c; or &red; - Red
    • &13; or &d; or &lightpurple; - Light Purple
    • &14; or &e; or &yellow; - Yellow
    • &15; or &f; or &white; - White

    Recommended Plugins
    • With CommandSigns, you can have your annotations do more than just display text to the player!


    Migrating from SignReadMore
    1. Copy the contents of the SignReadMore directory into the Annotate directory.
    2. Optionally, delete plugin.yml from the Annotate directory if it exists.
    3. Change the name of "SaveCustomSigns.dat" to "Annotations.dat".
    4. You're done!

    Change Log
    version 1.2.4
    • Color support for annotations.
    • Fixed multi-world migration bug.
    version 1.2.3
    • Fixed setting lines to associated files.
    • Fixed zero-arg bug.
    • Fixed error when directory structure did not exist.
    Older Entries (open)

    version 1.2.2
    • Multi-world support added.
    version 1.2.1
    • Updated to allow files in subfolders of Annotate.
    version 1.2
    • Fixed line deletion syntax.
    version 1.1
    • Fixed security issue.
    • Prevents placing of blocks when right-clicking on an annotated block.
    • Annotated blocks can only be destroyed by their editors.
    version 1.0
    • Initial release.
    c_dric likes this.
  2. Offline


    Well, first you'll have to have both CommandSigns and Annotate. Then read through CommandSigns's User Guide. It includes a section on how to use Annotate with CommandSigns.
  3. Offline



    Okay, this plugin is awesome now that I've got it all working. You should consider adding color codes- e.g., &f, &5, et cetera- I would love to be able to use them in my annotations. My current workaround is to make a command like /asdfhlasgdfilwsqg8erg in MCDocs and route the annotation to force that command.

    Oh, also, is there a way for the annotation to both display a message to the player and perform a CommandSign action?
  4. Offline


    I'm sorry, but I am completely unable to get a pressureplate/button to execute any commands with commandsigns. I love commandsigns, and it works very well. I was hoping that I could use plates tp players around the world, but alas it doesn't appear to be working? I do what the wiki says...
    I place a pressure plate down
    do /ann file leavespawn
    *Right clicks on pressureplate*
    /ann line1 [command]
    *RIght clicks on pressureplate*
    /ann line2 /tp (Cords...)
    *right clicks on pressureplate*
    /ann line3 \(text)
    *Right clicks on pressureplate*

    *Steps on pressureplate* just reads it back to me -_-, no execution

    Thanks Fluff for being so supportive and such =D
  5. Offline


    @Clem either:
    1a. Use "/ann file "file"" and right click the pressure plate, for this to work you must first create the text file it should read the commands from in the Annotate folder, without the file there nothing will happen.
    1b. If you don't want to use text files then you use the "/ann line1-10 "command"" you can right click after each line but just write all the lines, i.e. "/ann line1 test" then "/ann line2 test" and when the lines are done, you right click.
    2. Then you use the "/commandsign enable" and right click the pressure plate for it to activate.

    @cholo71796 for colors use the plugin: SignColours.
    To both do commands and show a message, use the "/ann line1-10 "command"" and write the commands you want to execute, leave a line free. For the last line you do "/ann lineX \message" where "message" is what you want shown.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 15, 2016
  6. Offline


    I'm pretty sure he meant colors inside annotations, not on signs. I'll add this in the next version.
  7. Offline


    This is the Annotate thread. SignColours puts colors on signs, not on annotations- thanks though.
    Good to hear- keep up the nice work!
  8. Offline


    After doing a bit of testing, the current version appears to work with 818. Let me know if you have any difficulties.
  9. Offline


    Colors appear broken even when using SignColors tho Signcolor works fine.

    scratch that some reading proved otherwise it was a moot post.
  10. Offline


    1.2.4 released

    There was a migration bug in the multi-world code that would happen if you updated to the multi-world version and didn't create a new annotation before shutting down the server. This has now been fixed.

    In addition, you can now add colors to your annotations when creating them through the /ann line command. I'll be updated the OP with more information on how to do this.
  11. Offline


    You bloody ripper :D
    You sir out do your self once again...

    *All stations ready to accept his next work on the "mobrider" for easier rod control! < Ya I stalk you!
  12. Offline


    Can you add the color support for text files?
  13. Offline


    Annotate doesn't pre-parse text files. In my opinion, Annotate shouldn't even change text files unless someone uses a command. If you want to add color to text files, put § and the single-character code for the color in the file.
  14. Offline


    §bFaction Changes and Selections:
     §6Any transaction made within the confines of this room is
    §6completely nonrefundable- press the button only once, or
    §6more money will be deducted.
     §6Press any of the buttons to select your new faction.
       - §6Wild: §a0§f coins
       - §6Archer: §a100§f coins
       - §6Trader: §a100§f coins
       - §6Knight: §a100§f coins
    My file looks like this now, but it prints in all white without the §s.
  15. Offline


    A nice idea for a plugin!

    When I type only /ann line1 and no string, the plugin causes an exception.
    There's more in the stack trace before this, but this is the important part for you:
    Caused by: java.lang.NullPointerException
            at com.omggamingonline.minecraft.Annotate.CommonMethods.FixColorPlaceholders(CommonMethods.java:51)
            at com.omggamingonline.minecraft.Annotate.AnnotateCommand.prepareStringBasedWand(AnnotateCommand.java:270)
            at com.omggamingonline.minecraft.Annotate.AnnotateCommand.onCommand(AnnotateCommand.java:82)
            at org.bukkit.command.PluginCommand.execute(PluginCommand.java:35)
            ... 12 more
    I added a feature request to support this plugin in MinecartMania. But I think it would really need to be able to register to a 'AnnotationChange' event for it to be able to cache the annotations/commands effectively, as it does now with signs already, somewhat.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: May 15, 2016
  16. Offline


    ok...how do I use commandsigns with that? If I write on a button or anything it just echoes the [command] etc etc part in the chat box.
  17. Offline


    The CommandSigns documentation may be a bit behind, but it does include a small section on how to use it with Annotate.
  18. Offline


    ok, works now. thanks : D
  19. Offline


    It would be extremely awesome if you could annotate NPC's or even regular players.
  20. Offline


    holy crap

    just typed "/ann" alone and it crashed my server.
  21. Offline


    After a quick check, Annotate appears to continue to work with RB 928. Let me know if you find differently.
    This was fixed in v1.2.3.
  22. Offline


    After a quick check, Annotate appears to continue to work with RB 953. Let me know if you find differently.
  23. Offline


    i'm using it for a long time now but i just miss 1 thing!
    plz make it so you can use 2 commands on 1 item~!
  24. Offline


    I cant use it for command signs
  25. Offline


    Can this be updated for Superperms and RB 1000? (Note: I don't use it much, but I didn't notice any problems with it. Thanks!)
  26. Offline


    works fine on cb 1000

    my server would be so ugly without this mod, thanks so much :)
  27. Offline


    I'm sure it does, it works on my CB1000 as well. However, it doesn't support native Superperms.
  28. Offline


    Ahh true that, would love to see SQL integration to :D
  29. Offline


    Oh, SQL (or Bukkit Persistence?) would allow me to set up web integration, that'd be awesome.
  30. Offline


    Im about to change all my /ann line1 stuff to txt files because the database seems to use a lot of memory when you have over 100 annotations hehe.

    Hoping .txt files frees up more memory, anyone tested this?
  31. Offline


    @Fluff: Another feature that would be great: redstone triggers which cause the Annotation to display to nearby players; using /ann redstone <radius> (set to 0 to disable)

Share This Page