MinePermit
MinePermit 2.0
It is NOT YET RELEASED. Look for it by the 10th!
The original iconic MinePermit! Now completely rebuilt and updated, some of the new features:
- Multi-World support!
- Custom Permit Areas (charge differently for different areas in the world? Nest an infinite number of customizable areas inside each other? Done!)
- Greater customization for admins
- Make permits only necessary below a certain point
- Make un-tracked Blocks un/minable
- New types of permits!
- Universal Permits!
1.7.2 Support!
Installation
First, install MineCore. It is a required dependency of MinePermit, as it manages all its economy and permissions settings, and is used to store player data. Go get it at http:dev.bukkit.org/bukkit-plugins/minecore
Next, copy MinePermit.jar into your plugins directory. If you used any version of MinePermit before V 2.0, please delete the /plugins/minepermit/ folder in order to allow it to regenerate. Everything will be generated and then you can proceed to customizing to your hearts content. The plugin starts with some basic settings, and though it will work out-of-the-box, you WILL want to customize the configuration.
Old versions are NOT SUPPORTED
Usage
For Admins
Commands
No admin/console commands yet! Need one? Ask, and ill add it to the ToDo list.
CONFIGURATION
This is where all the customization of MinePermit comes from. There do not consist any commands currently to edit these features in-game, so they must be managed directly in the configuration file, and the server must be re-loaded for the changes to propagate. The configuration file is located at /plugins/minepermit/config.yml
The default file:
allowDataCollection: true #If set to false, will disable stat reporting for this plugin. See "Notes" WorldPermitAreas: #All world configs go under here. world: #The name of the world allowMiningUnspecifiedBlocks: false #Whether blocks not specified under 'prices' can be mined effectiveDepth: 65 #Below what depth should permits be required? prices: #Prices for the permits in this permit area. Does not cascade to children. UNIVERSAL: #The material type. If the name is 'UNIVERSAL', then the price information is used for the UniversalPermit types: #The different types of permits to use COUNTED: #The type of permit price: 1000 #The price to buy the permit amount: 50 #How much time/blocks the player gets to use/mine for the permit. TIMED: price: 10000 amount: 3600 GOLD_ORE: types: COUNTED: price: 100 amount: 30 TIMED: price: 300 amount: 1000 IRON_ORE: types: COUNTED: price: 50 amount: 40 LAPIS_ORE: #If its empty, it cannot be mined. types: #Just make sure to have the 'types' section COAL: types: COUNTED: price: 30 amount: 70 STONE: types: TIMED: price: 10 amount: 60000 children: #PermitAreas that are contained by this Permit Area DasMine: #The name (doesnt really do anything) x1: 123 #Coordinates within the world. NOT respective to parent permit area z1: 2 x2: 321 z2: 56 allowMiningUnspecifiedBlocks: true effectiveDepth: 70 prices: STONE: types: COUNTED: price: 600 amount: 60
There can be an indefinite number of children areas inside any one area, as long as they do not intersect in any way. The configuration options for the worlds and the children permit areas is identical, except for where noted above.
Currently, there are 2 types of permits, COUNTED and TIMED. Counted counts the number of blocks a player mines, and expires when the limit is reached, as defined by the config. Timed goes purely by time, so number of blocks does not matter, and it is counted in seconds in the Configuration and in commands.
When blocks are broken, MinePermit First uses specific permits (like for iron or coal), then uses Universal permits. The Universal permit can have the exact same types and works the exact same way as a normal permit, except that it allows the player to mine any SPECIFIED blocks. Thus, if allowMiningUnspecifiedBlocks is false, you would still not be able to mine anything not defined in the config.
Permissions
- minepermit.exempt - Permits are not required
- minepermit.buy - Core permission for using buying permits
- minepermit.admin - Necessary to use admin commands (there arent any yet though)
For Players
Commands
- /permit - List of commands
- /permit buy [id/"universal"] - Buys permit
- /permit cost [id] - Display cost of certain permit. No param displays price for universal permit
- /permit time {id} - Displays remaining time for permit. No param displays all owned permits
- /permit view {id} - Returns if a permit is required for this block. No param returns all required permits
ToDo List
- Permanent Permit
Notes:
MineCore has now moved to http:dev.bukkit.org/bukkit-plugins/minecore and MinePlot has moved to http:dev.bukkit.org/bukkit-plugins/mineplot. Both are now fully implemented and updated to 1.7.2, so give them a try! ~~~~~~~~~~~~~~~~~~ This plugin uses Metrics to record data about the plugin's use. All this does is record simple anonymous data about how the plugin is used, including server specs like architecture, number of cores, OS, general location (country), java version, game version, and players online. All the recorded data can be retrieved at http:mcstats.org/plugin/MinePlot. If you would like to opt-out, change the property in the configuration file "allowDataCollection" to false and restart the server. This will not impact the plugin's execution in any way. By using this plugin, you are agreeing to the collection of data about your server as defined on this page. This page will only reflect the latest release version, and doesn't reflect versions available on Github or elsewhere.
This plugin does not auto-update or check for updates.
@maxlehot1234
Working on it! I'm afraid that real life is marginally more important to me right now, so it could be a month or two before I can get it out fully.
However, the new Beta download should be compatible with all the new versions, so if you can try them out you might be able to get something running sooner.
Is it possible to update it for 1.6.4 please? i really want this plugin....
@XenonFilms
Definitely, I will add both to the todo list
Yeah maybe add a way to have a permit last for ever, and also maybe instead of time for a permit, it could be on how many bloks they break before they need a new permit.
@UnUltima23
Not at the moment, ill add it to the todo list for the next version.
@Numenorean95
great, i'll start up the test server and let you know how it goes.
Is there a way to buy a permit and you get it forever, not just a certain amount of time?
@dutchy1001
Ok, I have been working hard and made most of the new version, it includes per world support and plots, which you can buy and allow you to mine everything in the area. The capabilities of the current release version of MinePermit will eventually be added back into the new version. Whatever problems that may end up occurring with other plugins I will fix. I am uploading an alpha version now, use the help to figure out how it works if you want to try it, it should NOT be used on a production server (it generates diamond blocks as markers :P ). If you find any bugs just tell me.
@Numenorean95
the idea that benjaminkayeight "miningpermit" has was great, unfortunaly his plugin conflicts with "griefprevention"(permit needed from level/layer 50, for example). To have that option would be nice(in conjunction with the per block permit), special if it's per world configurable.
In your current plugin you could add "groups" of blocks(defined by config) and a per world config.
As for now your plugin does the job, inplementing it soon in my server(tested on my test server before).
@dutchy1001
Good to hear it still works! Im looking into making something like what @TheMikeness suggested, toying with several different ideas. No idea of an eta at the moment, I do not have very much time these days. If you have any ideas feel free to tell me, they would be appreciated.
@Numenorean95
thx for the reply, i'll try it on my server later today then.
What can we expext in the new version and what is the eta??
Edit: Tested on my server working fine with CB 1.5.2
@dutchy1001
I see no reason why it shouldn't, but I haven't looked at it in a while since I started working on a new version.
does this plugin still work with 1.5.2?
greetz dutchy
What I would like to see is a mod that instead of giving permits for materials, instead allows people to buy a permit to mine a specified chunk, and calculates the cost to stake off and mine this chunk where the rent to mine a chunk is calculated based on user-configurable prices for each of the block types.
it would be sort of how mining companies work in the real world. You'd set the values such that your cost to retrieve a given block type is far lower than the value of the block in the main world, so that people have an incentive to mine in the mining world. You'd use TerrainControl to generate a resource-rich world for using this on, so that people would want to do their mining there and be willing to pay to rent land to mine. You'd probably want to use some sort of plugin like Towny where you can set it so that claims cannot be adjacent to other players' claims incase they mine the whole damn chunk out and you have a huge cliff and no way to get around the mining world.
@kylexdd
Thank you :) However, im afraid i have not yet added the functionality that you want, namely regions within worlds, sign to buy permits, and ore respawn. They are all however on the To-Do list, so i will try to get them added as soon as possible.
@benjaminkayeight
Sure, that sounds great! Lets try to talk soon, i have plans for my plugin and want to get started.
Hi i have a similar plugin out an i was wondering if maybe u wanted to have a chat and possibly work together. Im new to plugin development and would love a chance to work with / learn with others. Thanks. Ben
Great Plugin =]
I install this in my server already :D
I want make a public mine in my server , can you help me ?
I wanna have ores respawn in specified area ... and a sign for buy permit to enter this area..........
Additionally , some sign for showing who have already buy the permit.....
Thank you !
@Qwahchees
Hmm, good idea. Added to the todo list.
You should consider adding a way to change localization.
For example I'd like to change the "You need to buy a permit" message.