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.

 

hmm ive never had a problem with my permissions file before...

plugin:

Code:

plugin:
    permissions:
        system: default
        copies: null
groups:
    Citizen:
        default: true
        info:
            prefix: 'Citizen'
            suffix: ''
            build: true
        inheritance: null
        permissions:
        - commandbook.spawn
        - commandbook.say.me
        - commandbook.whereami
        - commandbook.whereami.compass
        - commandbook.whois
        - lwc.protect
        - iConomy.payment
        - iConomy.access
        - iConomy.rank
        - iConomy.list
        - myhome.home.basic.*
        - localshops.buysell
        - localshops.manage
        - localshops.manage.owner
        - localshops.create
        - localshops.destroy
        - localshops.move
        - wormhole.use.sign
        - wormhole.use.compass
        - wormhole.list
        - wormhole.network.use.city
        - wormhole.network.use.world
        - bonuses.*
        - supplysign.access
        - craftbook.mech.*
        - craftbook.ic.safe
        - mobRider.command.goto
        - mobRider.command.go
        - mobRider.command.stop
        - mobRider.command.follow
        - mobRider.animals
        - monstertamer.player.catch
        - monstertamer.player.check
        - monstertamer.player.befriend
        - monstertamer.player.target
        - monstertamer.player.release
        - monstertamer.player.whistle
        - monstertamer.player.follow
        - monstertamer.player.wait
        - monstertamer.player.select
        - measuringtape.measure
    Benefactor:
        default: false
        info:
            prefix: '&3Benefactor'
            suffix: ''
            build: true
        inheritance:
        - Citizen
        permissions:
        - sprint.allow
        - mobRider.monsters
    Moderator:
        default: false
        info:
            prefix: '&aModerator'
            suffix: ''
            build: true
        inheritance:
        - Benefactor
        permissions:
        - lwc.mod
        - logblock.lookup
        - logblock.area
        - logblock.tool
        - logblock.toolblock
        - commandbook.kick
        - commandbook.bans.ban
        - commandbook.bans.unban
        - commandbook.bans.isbanned
    Admin:
        default: false
        info:
            prefix: '&9Overseer'
            suffix: ''
            build: true
            warp:
                timers:
                    warmup:
                        public: -1
                    cooldown:
                        public: -1
        inheritance: null
        permissions:
        - '*'
users:
    Mentioum:
        group: Admin
        permissions: null
        info:
            prefix: ''
            suffix: ''
        permissions:
            - ''
    _Nicholas_:
        group: Moderator
        info:
            prefix: ''
            suffix: ''
        permissions:
        - multiverse.tp

Is it really this that I need to change? I love it's current layout....

 

fyi - seems to be working with CB699

 

I don't know if this has been requested yet or not, but it would be wonderful if I could have two level deep navigation.

So "/help" will bring up a file.
"/help section" will bring up a different one.

I'd imagine it could be set up with folders. You could still keep the group control this way. For example, my folder structure could look like:

/help.txt
/help/section.txt
/help/another-default.txt
/help/another-admins.txt
/help/third.txt
/rules.txt

Thoughts?

 

Hm I'm getting this spam
00:26:44 [INFO] [MCDocs] ERROR! One of the following is not found: %group %prefix %suffix for player
#709

Is that a Permission problem?

 

The error tells you exactly what the issue is...... Either the player has not been assigned a group due to a lack in a default group or the group they're in does not have a prefix or suffix. Perhaps you have it as null in your world.yml change it to ''

 

@Tazzernator When is it going to be updated? <3

 

Either I'm missing something, or the plugin can't seem to find the txt files I placed in /plugins/MCdocs/.

Does it need to be somewhere else? I've not touched the default config.yml, but here it is:

Code:

header-format: '&c%commandname - Page %current of %count &f| &7%command <page>'
motd-enabled: true
commands-list:
- /motd:motd.txt
- /rules:rules.txt
- /news:news.txt
- /register:register.txt
online-players-format: '%prefix%name '\

What am I missing?

Also, I named the txt files exactly like that,
motd.txt
rules.txt
news.txt
register.txt

 

Idk how to use this XD I have it and I have Permissions, but..... I just don't know XD its says /motd: motd.txt.. Where is that at? Do I have to create it my self? I'll edit if I figure this out ok

EDIT: I got it XD Btw how do I get them to see who is online?

 

When I have the time. Work/Uni etc eats it away like mice do at my walls.

Should me /MCDocs/ (capital D)

If that fails, let the program create the folder by first deleting the folder, and then restarting the server. It will not add the txt files for you however,

Otherwise, use the zip.

A wiki is where you can find any answer on how to use MCDocs. http://atajsic.com/wiki/

 

Ah ok I'll look into that! Thanks

 

working fine for us on 709 bud. New setup is awesome to taz, big ups!

 

Yeah, after looking at the zip I figured out what the problem was.. I named the files like "rules.txt" while it was already a txt file, so I removed the ".txt" extension and magically it worked

 

Just installed on #714 for testing purposes, looks like what I'm after =)

I got a suggestion, maybe I'm not the first and maybe it's already in a todo I've missed.. But conditionals would be nice!

For example: I want to make a /help command which lists all the commands the user has access to (with help texts), but this is of course dependand on the users permission group.

 

I use MCDocs for that on my server, however, I've manually put the commands into the file.

There are other plugins out there that scrape available commands for a help menu.

 

I just did some RTFM and it seems that what I want already exists =)

http://atajsic.com/wiki/index.php/MCDocs/Permissions
"You should only use this structure if you wish for the same command to display a different file when run by various groups"

<3

 

Indeed.

 

@Tazzernator Ok

 

@Tazzernator
What mail plugin are you using I cant seem to find any plugins on these forums that have offline messaging capabilities. Can you point me in the right direction . Or anyone else on these forums for that matter.

 

essentials has /mail option we use it its great

 

Ok. Dont use Essential maybe I should start .

 

Speaking of mail, is there any way to incorporate the notification of Essentials to notify a user of any unread mail into the MOTD?

 

when user logs in it says if there is mail or not (with essentials).

Might pay to find out if essentials has a code you can implement.

 

I have all the features of essentials and more with other plugins by sk89q and others I just want mail . I am not a plugin developer but am willing to learn if someone is willing to teach

 

@Tazzernator

I am also getting the error "[INFO] [MCDocs] ERROR! One of the following is not found: %group %prefix %suffix for player", but only one on of our servers, the others run just fine. It only came with the 7.0/7.1 update, and I cannot figure out why, as my groups do have what is needed:

Permissions example of default group (all groups have a prefix like below)

Code:

Visitor:
    default: true
    info: {prefix: '&f[Visitor&f] ', suffix: null, build: false}
    inheritance: []

And every user that is out of default also has a group:

Code:

  GmK:
    permissions: []
    group: superdupertestgroupdude

Any ideas?

 

@GmK your suffix is null in the example you posted. Replace that with two single quotes.

 

I saw that, but according to the error it seemed like it was just looking for one of them to exist to be happy, and not that it needs all three. Thank you!

 

the term null means it does not exist.

 

Yeah, I know essentials has it. Our production server has it, but I'm looking at seeing if MCDocs is a viable alternative to the MOTD w/ mail notification function Essentials has (with all the other documentation stuff this plugin has, which is amazing)

 

Oh no, now with the text wrapping... are you going to configure it to paginate after a certain number of lines? Otherwise, I'll have to make my documents with shorter and more lines to avoid the text wrapping.

 

Well, looks like I got the mail function in the motd by removing the MOTD function from Essentials (it somehow overrides the MCDocs MOTD in v2.1, not so much in v2.2), only to discover I don't get any MOTD whatsoever combined with v2.1 of Essentials, though the /motd does show the MCDocs-defined MOTD.

Any chance of adding something like an override toggle to have MCDocs override any other on_login MOTD plugin?