Inactive [INFO] MCDocs v14.3 ~ Documentation Plugin || MOTD, Local or Online Files, Your Commands [1.3.1]

​

​

​

NEWS (open) NEWS (close)

Version 11.2 released (22nd October 2011)


Version 11.2

• Added permissions wildcard support (mcdocs.*) works for all commands.
  • Note: this only allows all commands. mcdocs.reload does not fall under this wildcard. This needs to be set separately.
• Added some try catch around the motd: configs.
• Fixed motd-enabled

Version 11.1

• Removed the spacing that occurs when you only have 1 page.
• New variable: %time (Shows what time it is in the player's world in 12 hour format.
  • Sun rises @ 5am, Sets @ 7pm

Version 11

• Updated to work with PermissionsBukkit (Tested, nodes work)
• Updated to work with Register for %balance, you will need to download the Register plugin for this to work with iConomy and various other economy plugins.
• Optimised much of the code.
• Updated the commands config structure, much simpler now than before.
• You can now use %name, %size, %world, %group, %ip, %world, %prefix, %suffix in your file paths in the config.yml
  • Example: file: http://example.com/script.php?name=%name
• Redefined the MOTD process.
  • Is now all defined within configuration
  • You can now use online files
• Changed how logging occurs, you can toggle if you want to be informed about errors or not in the config now.
• Group support now uses an in house permission system, where you define the groups players are in manually.
• New permissions-enabled variable, Do you have any permissions system installed? Yes: true | No: false

• If a page is now less than the viewing area, it adds a buffer to the bottom so the header is flush with the top.

 

Ey. I wanted to create this from scratch as my first plugin.

 

I hate to ask this and im sure it is somewhere obvious but where can i find the list of colours for the writing?

 

http://www.minecraftwiki.net/wiki/Classic_server_protocol

 

thanks man

 

Any chance of you adding this to the bukget repository?
http://bukget.org/

 

With the new permissionsbukkit and superperms I get the following on each line in the text file

2011-08-20 01:54:34 [INFO] [MCDocs] Warning, One of the following is not found: %group %prefix %suffix for player Nipper4369

 

Use this.

 

@Ninja Grinch I tried using it. But it errors out in 1060

 

The configuration has changed between Tazz's version and SwearWord's version. Please make certain the configuration is proper. It works fine for me even with build 1063.

 

The convention seems to be to assign group,<name_of_group> to identify groups in SuperPerms - at least it is the way WorldEdit is currently implementing it.

 

i'm not sure if someone else brought this up but is there a way like lets say i have a folder inside mcdocs called "pc" short for "plugins commands" and in side that folder i have lots of txt named something like
Voxel Sniper.txt
TimeShift.txt
WorldEdit.txt

and when i type in like
/pc it bring up a list of folders
then type in like
/pc Voxel Sniper
to get all the commands inside the txt something like this plguin
http://forums.bukkit.org/threads/ad...our-own-tutorials-for-your-players-953.13347/
would be great if can i dont like using outdated plugins and your would help out alot

 

Short Answer: Yes.

Learn to use MCDocs.

 

how i have looked for a tutorial that would show me how but came up empty

 

Nice looking plugin!! Also, why can't we use notepad to edit the files? (I have a provisionhost server) I have to upload files via FTP. files from notepad and files from notepad++ are both defaulted to save as .txt files. What's the difference (It's not a big deal, i have notepad++. I was just wondering....

 

Seeing this plugin is dead, I'm hijacking the thread and pointing to:
http://dev.bukkit.org/server-mods/cbdocmand/pages/main/

 

How is this plugin dead?

 

That comment, and that it hasn't been updated for long. Has lots of problems, doesn't support BukkitPerms(SuperPerms).

 

Ahh... well... that sucks. I looked at your plugin and it has more features than I initially thought. Nice job.

 

Thank you, it's currently missing Permission support, so yeah, some features are still missing. But it's my first release, and I'll see if I get a chance in the weekend to add some the future features I have planned. Such as permission.

 

Can you guys please list all the exceptions, and scenarios that cause said errors?

Also can you please list any other errors you may be having?

I'll give this a bash again for the community's sake.

from supporting many users, it appears that notepad leaves hidden icons and what not in the text documents.

 

Hi Tazzernator, I'm not here to discourage you to discontinue working with your plugin. However I would like to point out my plugin Docmand(@Bukkit) / Docmand(@BukkitDev) which basically does what MCDocs does, just MUCH MORE flexible and customizable without being too advanced (And at the same time allowing advanced users to do way more). It is not hardcoded to support news, or motd, but users can customize to a high degree what they want. The basic examples created by the plugin upon installation is basically providing the same features as MCDocs, and from there the users can expand as they see fit.
I think you should take a look at it, and tell me what you think of it? If you don't have much time on your hands, you might be able to use the time you have on something else, or if you would like to cooperate with me. My plugin is highly inspired by yours but I created it from scratch, building the entire core differently. It heavily relies on Reflection in order to allow creation of advanced custom tags (Drawing inspiration from JSONAPI)
Currently only permission support is missing, but I will be adding that as soon as I get some time on hands.
Take a look at it, if you have additional ideas or want to cooperate you are very welcome to contact me.

 

Off the top i can see a few features you're missing

Nested files. That is files linked from inside files

Also you're missing permissions support yes, but ontop of that, showing different files based on group for the exact same command.

At this point in time, I'll continue working on my plugin.

 

Your call.
Two of the points will be added along side permission support within a day or two, maybe even tonight.

The first part I'll be implementing using Multiple actions per event.
So you can trigger a Text, a File and then an url, or whichever order you want.

Otherwise I could add the functinoality with just add 1 method in my code
private String nest(String cmd)
{
return DocmandUtil.join(processCmd(cmd),"\r\n");
}

add then one line in the parse file:
include: nest($1);

that's it, and then I will have included the include funtionality.
The code in Docmand is way more flexible and dynamic, whereas your code is written to only support a few things. Your code is very low on reusing, you write the same code for reading a file or url several times. Copy/paste all over the place.

Code:

FileInputStream fis = new FileInputStream(folderName + xxxx);
            Scanner scanner = new Scanner(fis, "UTF-8");
                while (scanner.hasNextLine()) {
                	try{
                		lines.add(scanner.nextLine() + " ");
                	}
                	catch(Exception ex){
                		lines.add(" ");
                	}
                }
            scanner.close();
            fis.close();

7 Places does this code occur in MCDocs source code, where only xxxx is different.
It's not consistent. 1 thing that annoyed me about MCDocs which basically lead me to create Docmand was that the commands, e.g /news supports fetching from a URL, while the %news% tag does not. Also no way to customize how many news should be written when showing the %news%. I needed much more flexibility and customization. All servers are different.
The code is way too large for the litle use. I've implemented a much larger range of functionality that can be expanded easily within less code than MCDocs currently use.

This is why I recommend may way of doing it, there might be a lot of things can get better, but currently my plugin is not limited to a set of ideas. Basically the above implements your include method into my plugin. So in any text, url or whatever you can write "include some thing %include("xxxx")%

Also soon I will add ability to load .class files from a folder, which extends the functionality. So you can write a function compile it into a class file, put it in folder, and add a line in the parser.yml file. This gives a very high possibility to extend and customize as users see fit, users could share their extensions and parse files which can interact with other plugins.

But it's entirely your call. You just seemed like you didn't have the time to keep this plugin running, it's not been updated for 2 months, and no response from you in a long time. So I just wanted to give you a heads up.
I'm not bashing you or anything, I appreciate your work, I just needed more functionality than MCDocs provided, and when I saw the code for MCDocs I could easily see that it could be done way easier and more flexible.

 

@Tazzernator Just loading it up would cause the command. Also using new permissionsbukkit not longer using 2.7 or 3.x as they are no longer updated. Using Build 1060 as well. It was tossing the error due to new permissionsbukkit and not using old permissions.

 

The errors were wholly related to a lack of some of the variables and group related information not being available in the various SuperPerms bridges.. They are only providing the permissions part of the Permissions Plugin. I was able to resolve the issue by reinstalling my legacy permissions system so that MCDocs could find the extra info there.

If you implememented a configuration option like this...

Code:

#If your permissions system does not support all MCDocs variables you may have to disable this.
legacy-permissions-enabled: true

Then you could either take a wait and see stance if these features are re-added to some point to the various SuperPerms bridge plugins. Or even come up with a config file to set some of these variables for users based upon permissions nodes, similar to the way you display different text files based upon group membership.

Just an idea.. I don't know if its feasible but it sounds logical to me.

Rich

 

I get this error:

Code:

20:43:52 [SEVERE] Could not pass event PLAYER_JOIN to MCDocs
java.lang.NullPointerException
        at com.tazzernator.bukkit.mcdocs.MCDocsListener.groupMotd(MCDocsListener.java:891)
        at com.tazzernator.bukkit.mcdocs.MCDocsListener.onPlayerJoin(MCDocsListener.java:877)
        at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:244)
        at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:58)
        at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:338)
        at net.minecraft.server.ServerConfigurationManager.c(ServerConfigurationManager.java:124)
        at net.minecraft.server.NetLoginHandler.b(NetLoginHandler.java:97)
        at net.minecraft.server.NetLoginHandler.a(NetLoginHandler.java:33)
        at net.minecraft.server.NetworkListenThread.a(SourceFile:91)
        at net.minecraft.server.MinecraftServer.h(MinecraftServer.java:454)
        at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:363)
        at net.minecraft.server.ThreadServerApplication.run(SourceFile:422)
>

I thought Essentials or CommandBook might mess with it so I took those plugins out and it still gives this error.

Config file was hardly altered at all

 

If you look closely at the first line it says "groupMotd" this is due to the fact that the group memberships are passed by legacy permissions... if you install legacy permissions, and just configure groups this error will go away.

The SuperPerms bridge doesn't pass anything like that.. so its not so much a conflict, as it is a lack of info.

EDIT: Maybe someone should just create a plugin that does this, or enhance the current bridge. Poof.. no more issue. I converted as many plugins as I could to the new permissions but have left my old permissions just to support incompatible plugins. I haven't experienced any issues.

 

Ah, I'm using PermissionsBukkit with Superperms Bridge. Is legacy perms a different permissions plugin and where can I get it if it is?

 

The "Legacy" Permissions plugins are not going to be a very long lived solution.. it looks like Niji is pushing PEX, or bPerms.. So I'm not sure I can recommend that its worth your time learning the legacy permissions... You may get a brain hemmorage and end up in the emergency room... I would't want that.

Oh Yeah.. Let me also clarify "Legacy Permissions"...It isn't the name of a plugin. In computer jargon, you can think of the word "Old" to understand it. But the definition here may help more.

http://www.webopedia.com/TERM/L/legacy.html

Niji originally designed the Legacy Permissions that is widely used today.. he's a talented and smart guy... I'm guessing he uses PEX and is making his recommendation from his experience of how well it implements his original system and the new SuperPerms system.

http://forums.bukkit.org/threads/public-announcement-for-permissions.33651/

As of this writing I am using PermissionsBukkit, SuperPerms Bridge, and TheYeti's Permissions 2.7.4 (One of the "Legacy Permissions" implementations)... It's more difficult to maintain multiple permissions systems, and only worked for me because I had experience with the Legacy stuff.

Go here... The feature set for PEX seems to encompass all of the features that MCDocs requires.

http://forums.bukkit.org/threads/admn-dev-permissionsex-pex-v1-13-tomorrow-is-today-1000.18140/

The thing that you need to know about the new permissions system it that SuperPerms is built into Bukkit itself, not a standalone plugin as before. So all of these "New Permissions Plugins" are more like administration interfaces into the new SuperPerms system. It would be a great world if all of the devs could get away from the old permissions system and reintegrate with the new Bukkit standard... it would make all of this a non-issue. Fact is SuperPerms is new, and Niji's original permissions system is still heavily used in many of the popular plugins.

As far as I'm concerned.. I'm in your same boat, even though I currently have a workable solution. But I'd much rather have a modern and supported solution.. so I guess I'm off to REDO my permissions again, and convert into PEX, hoping for the best... Such is the life of a Minecraft Server admin ...

What ever happened to PermissionsBukkit being the "Official Permissions Plugin?!" Its too bad that the SuperPerms bridge is crippled down to only very basic Legacy Permissions support. In its current iteration its not a 100% solution due to all of the plugins which still use "Legacy Permissions".

Show Spoiler Hide Spoiler

"Official" does not mean "Best".

The moral... Running any kind of Minecraft server takes reading comprehension skills, patience, and a ton of work to get a stable, secure and fun server up and going 100%, and a lot of regular maintenance to keep it that way.

Hope this helps you!

Rich

 

Ah, well I've been messing with these things all weekend and I'm afraid I may be getting said hemorrhage. There's just so many different plugins that do so many of the same things, it can get very confusing/frustrating/FUCK. This plugin for instance does a motd (which I'd prefer) but then so does Essentials, AdminCmd, CommandBook. The real issue is there are no standards or unity between the developers. I'm starting to like Essentials because of this...has everything.