Minecraft 1.8.1 کے لیے PreciousStones پلگ ان

The most full featured and flexible self-service protection system in Bukkit. Highly configurable, MCPC+ compatible.

For the latest builds visit my Jenkins

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

These pre-configured fields are just one of the ways you can configure PreciousStones. Use them all, use just the ones you like, or create your own.

You can choose from over 150 flags with varied functionality to configure your own force fields unique to your server that do exactly what you need them to do. From protection to potion effects to confiscation of items to rollback abilities to teleportation, the possibilities are endless.

They come with full permissions and limiting functionality to limit the distribution of the fields, per field type. Use them as a reward for donators, or sell them outright, they are a great way to increase funding for your server. Your players will love them and come back for more!

Wiki

Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.

Donations

Like the plugin? Please consider donating!

Videos

PreciousStones Basics Tutorial

Showcase of the effect of each of the default stones.

Demonstration of various field types (using custom build stones)

Review of PreciousStones that goes through all the default stones.

PreciousStones has two types of protections unbreakable blocks and field blocks:

Unbreakable blocks

These are protection for the block itself, like OwnBlocks. The blocks on the unbreakable-blocks list will not be breakable by anyone but the owner, they will belong to whomever placed them. They can be used as building material i.e. ungriefable city walls, impenetrable vaults, etc. or protect block types from theft i.e. note blocks, fences, or anything that you want to be grief proof. You can right-click on the block with a tool in hand to view who owns it.

Note: The block types you place on this list cannot be added to the fields list.

Force-Field blocks

Fields are blocks that project a force-field outwards onto their surroundings. They can have various different properties which can be added with field flags. The field's radius extends from the cube itself outwards. ( i.e. For a radius of 3 the resulting force field would measure 7x7x7, you can optionally add a custom height to override the height calculated from the radius to whatever height you choose)

Field Flags

These are the different properties that make up a field. A title and a block type are required, the rest can be any number of a variety of different field flags.

Here is an excerpt from the config showing how the City Protection field is defined:

Quote:

• title: City Protection

block: 57 radius: 20 custom-height: 15 prevent-fire: true prevent-place: true prevent-destroy: true prevent-explosions: true prevent-unprotectable: true prevent-flow: true welcome-message: true farewell-message: true visualize-on-rightclick: true mixing-group: 1 cuboid: true

This is how I chose to make the City Protection field, you can ease it, rename it, change the block type, change the size of it, or remove and add on any number of flags. An explanation of what each of these flags mean can be found at the wiki. You can use these to modify the defaults or create your own custom fields.

Field Info

Right clicking on any one of your fields with one of the tools configured in the tool-items list in the config.yml will show you specific information for that field. Right clicking on fields that don't belong to you will only tell you who the owner of the field is. You can configure for all fields to display the full info by toggling the public-block-details setting to true. Right clicking on a block in the ground with one of the tool-items will tell you if the block is protected or not.

Field Visualization

You can visualize what one of your fields looks like by standing inside of it and typing /ps visualize, this will surround the field with glass blocks (placed inside of the field). This visualization is sent to the player's client directly and is not visible by any other player on the server. Once the player moves, the visualization will be removed to prevent people from interacting with it. This will help you visually see what is being protected.

Cuboid Fields

Cuboid fields are the next generation of fields. You can make a field into a cuboid field by giving it the cuboid flag. Cuboid fields behave identical to the normal fields at first sight. Like a normal field they can be placed down to create a field around the radius of the block based on the configured size. But internally they are completely different animals, the shape of cuboid fields can be redefined.

Redefining a Cuboid / Drawing Mode

Cuboid fields can be placed in drawing mode by [sneak-left-click] with a tool. During drawing mode you can [left-click] on blocks around the area to grow the protection cuboid. [right-click] aiming at any direction will expand the cuboid one block in that direction. [sneak-right-click] anywhere will undo your last selection if you made a mistake. And to finish and close the cuboid, [sneak-left-click] again anywhere, or simply click on the field block.

Technically you only required to select two blocks, one from each opposite corner of the cuboid in order to form the cuboid. But we all know that that is almost never how we want to define a cuboid. You have a specific content in mind that you want to protect for example a house with underground area, or a floating platform in mid air, the valley that you can see down below. Traditional methods of cuboid definition require you to dig down into some imagined corner to select the bottom corner block, or pile up blocks to select the top corner block. In cuboid drawing mode, rather than being forced to select opposite corners, you select the actual blocks you want protected from a distance by just left clicking in their direction, and afterwards a cuboid will be created that is the smallest shape that can wrap around all selected blocks.

Cuboid Volume

When you place a field into drawing mode its configured height and radius are converted into volume and given to the player as the available blocks his new field shape can cover. For example field of radius 5 (which is 11x11x11) will be converted into block volume, so 11x11x11 = 1331 blocks. You will then be able to redefine the cuboid using the available volume.

If the cuboid has the custom-volume flag set, then that volume will be used instead overriding the volume calculated from the radius/height. This is good if you want players to be able to place down a small field, with say radius 0, and then be able to redefine it into a much larger field. Good for plots and such that need to be placed next to fields owned by others without causing conflicts.

Cuboid Groups

While in drawing mode you can increase the available volume of a field by placing more of the same type of fields down. Each one you place down will add on its volume to the parent. This way you will be able to create immense fields at any size. When you close the cuboid, all the fields you placed down will turn into a group. Right clicking on any of them will give you the same information and breaking one of the blocks in the group will break them all.

Cuboid Mixing

While in drawing mode you can place down different field types down and their field flags will be imported to the cube being drawn. This way you can mix the effects of several fields into one. What fields can mix with what fields can be configured by putting your fields into "mixing groups" with the mixing-group flag, fields in the same groups will be able to mix with each other. You will want to put fields of similar size and "cost" in the same groups.

Note: Fields without a mixing group will not be mixable Note: Only the field flags are imported, no extra volume is added to the cuboid.

Fields vs Cuboids

Cuboid fields are saved on a separate database table (pstone_cuboids) than fields (pstone_fields). Due to this changing existing fields that people are already using into cuboids or viceversa is a bad idea.

Grief Revert

Grief revert fields are just what they sound like. They are personal BigBrother fields. They will let you roll back any grief that was done within the field. These fields will record all block breaks by players who are not allowed into the field and all block breaks from explosions in the database. The blocks that are broken and recorded will not drop, they will just disappear. There are two modes to these blocks - you can have them rollback the grief on command when right clicking on them, or you can have them roll back the grief at a predefined interval with the grief-revert-interval' flag. You can define a list of blocks that you don't want to be revertible and will be stealable (drop when broken) by adding them to the grief-revert.black-list in the config.

Proximity Snitch

Any block with the snitch flag will create a field which will keep a record of player's activities within the field. It will keep a record of their entry, any block breaks and placements, and any block usage inside the field. You can see this list by right-clicking on the block or typing /ps snitch. You can clear the list at any time by issuing the command /ps snitch clear.

Forester

This will allow your users to place a block and instantly create an entire forest of trees and grass around it. The block must be placed on a fertile block to activate. The types of blocks that are considered fertile can be specified with the the fertile-blocks flag, these blocks will be terraformed into grass where plant-life can grow. Once the forester has accomplished its task, the activator block itself will turn into a tree. The amount of trees that have the potential to grow can be configurable with the tree-count flag, you can choose what kind of trees to grow with the tree-types flag, and what kind of shubs to grow with the shrub-types flag. The amount of time it will take to grow the whole forest can be set with the grow-time flag.

Translocation

This will let you build in one place, and translocate that build somewhere else. It's basically the same functionality as the worldedit commands, but this will not let you duplicate items, and can be handed out to your players in a controlled way.

How it works

You place your translocation field, adjust the cuboid to your liking, and then you name the field with /ps setname. Now it is ready to record.

It will record all changes to the area inside the field. Once you are done building inside the area right click or break the block to store everything inside the field. This will remove all the blocks recorded from the world and copy them to the database, and the translocator will disable itself ready for the move.

Break the field and take it to its destination, place it down, name it the same name you named it before and right click on it to revert everything it had recorded onto the new location. You then use the "/ps translocation unlink" command to unlink the blocks from the translocator (so that when you break it the blocks stay where they are)

Naming

You can have many translocation projects saved with the same block. The projects are recorded by name. So if you name your block "house" and build a house and store it (disable the block). Then you can rename the block "tree", and build a tree. Then you can walk over to your destination and name your block "house" and spawn your house. Then you can name your block "tree" and spawn your tree. In reality you can have an infinite number of stored projects with different names, and pull them up whenever you need them using the same block. There is no limit to how long you can keep something stored. (Note: PS purges all player data belonging to players inactive more than 20 days on the server, this includes saved translocations)

Alternate uses

The translocator can also be used as a toggle for blocks. For example you can place one down and build a false wall, then hook up redstone and a lever to the translocator and you can make that wall appear and disappear with the flip of a switch. You can build toggable bridges, portable houses, etc.

Walkthrough

Quote:

For example say you want to move your base to the edge of the map:

• Place translocator pstone near your base
• Reshape cuboid to fit around you base and close cuboid
• Point at the pstone
• /ps setname base
• /ps translocation import (imports everything inside the field into the databsae)
• /ps translocation delete 2 3 31 37 38 (remove the grass/dirt/flowers from the imported blocks, don't wanna take the ground with us)
• Right click on the field block with a tool to store everything (you will notice everything you had selected is now gone from the world)
• Break the pstone and take it to the new location of your base
• Place translocator pstone
• Point at the pstone
• /ps setname base (It will tell you you have x amount of blocks stored)
• Right click on the pstone to spawn your base in front of your eyes.
• Break the pstone and you're done.

Allowing Others

You can allow people into your fields using the allow, allowall, remove, and removeall commands. The allowall and removeall commands allow or remove the players into all of your fields. While the allow and remove command only work for the fields you are either pointing at or standing in. If your fields are overlapped, then standing in one will allow/remove players from all overlapped fields.

Here is an example of what you can allow:

Command Description

/ps allow [player] allows a player into your field(s)

/ps allow c:[tag] allows a clan into your field(s)

/ps allow g:[group] allowed a group into your field(s)

/ps allow * allows everyone into your field(s)

So for example you set up a launcher field and want to allow several people to use it you can do this:

/ps allow c:toads /ps allow g:admins /ps allow rabbleroost /ps allow willhicks

Or you can do them all in one line as well:

/ps allow c:toads g:admins rabbleroost willhicks

Clans are available through

Selling and Renting

Players can now rent and sell their fields with the new rentable, shareable, and buyable flags!

Sign format

• [tag]
• amount (item/block) or amount currency
• rent period

Examples:

Renting out a city lot _{(30 gold ingots for 6 days use)}

• [Rent]
• 30 (266)
• 6d

Charging for your public GodStone use _{(50 economy money for 20 minutes use, many players can rent it at the same time)}

• [Shared]
• 50 rupees
• 20m

Selling a house _{(costs 15 diamond blocks to take ownership)}

• [Buy]
• 15 (57)

How To:

Renting - The [Rent] tag gives you allow access to the field for the specific amount of time. The player can mine, change blocks and do anything except modify or remove the field. The owner will still have rights to the area, but he will not be able to modify the sign, break the block, disable it, change its name, change its radius, or enter drawing mode. After you rent the field it's [Rent] tag will turn RED signifying that its occupied and a countdown will appear on the last line of the sign. (Renting only works for fields with the rentable flag)

Sharing - The [Shared] tag allows multiple players to rent the same field, used for public areas, mines, pay per use launchers, Miner's haste, godstone and what not. It's tag will turn GOLD when at least one person is renting the field. (Sharing only works for fields with the shareable flag)

Buying - The [Buy] tag changes the owner of the block to a new owner. First the player who wants to purchase the land/block must right-click on the sign to make the payment. The tag will turn RED and his name will be displayed on the last line of the sign. Money will be taken from him and he will be added to the allow list on the field so he can start building on it, the transaction completes when the new owner right clicks on the sign to take his payment. He is removed as owner of the field and the new owner set as the proper owner of the field.(Buying only works for fields with the buyable flag)

Price - Can either be items or economy money. If you want items then you use two numbers, the amount and the item/block id in parenthesis. (i.e. 10 (266) means ten gold ingots). If you want to use economy money, then use a number with any text you want after it without parenthesis (i.e. 10 credits)

Rent period - This can be in weeks, days, hours, minutes, seconds or a combination of up to three (e.g. 5w) (e.g. 5h 30m 5s). This only applies to rent or shared fields.

Collecting rent - The owner of the fields must right click on the sign in order to collect his payment, the payments will accumulate until he does so.

Usage:

Tenant