Updated Augmented Plot Worlds (markdown)

Jesse Boyd 2016-03-30 11:49:00 +11:00
parent fc79a78bfc
commit abc8343ac8

@ -1,99 +1,2 @@
####For full world augmentation, see [Here](https://github.com/IntellectualCrafters/PlotSquared/wiki/TerrainControl)
#Description
Augmented plot worlds is a new feature introduced in PlotSquared 2.6, it allows for clusters of plots to be generated within an otherwise normal world. The idea is that PlotSquared should only manage what is within these plot clusters.
#Image example:
![A cluster of plots surrounded by a normally generated world](http://i.imgur.com/nQHDoED.png)
#Installation
*Please enable clusters on your PlotSquared config.
### Step 1: World creation.
Create a new world using whatever generator you would like. If a world already exists, that is also fine.
### Step 2: Customization
You will now choose how a plot cluster will look (size, blocks used etc). If you are fine with the size and appearance of the plots in the above image, you can skip this step.
Below is a sample configuration for a world. The default settings try to accommodate everyone however you may want a more personalized cluster appearance. Once done, open the `settings.yml` file within your `plugins/PlotSquared/config` folder and paste you world in.
Remember to change the worldname from `clusterworld` to whatever your world is called!
```
worlds:
# !!! Change 'clusterworld' to what your world will be called !!!
clusterworld:
cluster:
# Will ores be generated within a plot cluster?
generate-ores: true
plot:
height: 64
floor:
- '2:0'
biome: FOREST
size: 32
filling:
- '1:0'
auto_merge: false
wall:
height: 64
filling: '1:0'
block: '44:0'
block_claimed: '44:1'
road:
block: '155:0'
height: 64
width: 7
economy:
use: false
prices:
claim: 100.0
sell: 75.0
merge: 100.0
schematic:
file: 'null'
on_claim: false
specify_on_claim: false
chat:
enabled: false
flags: {}
natural_mob_spawning: false
event:
spawn:
breeding: false
egg: false
custom: true
pvp: false
pve: false
```
# Step 3: Creating a cluster
Cluster creation can be somewhat tricky to understand the first time. The clusters work by a co-ordinate system much like a normal plotworld, and each cluster will be created between two points in this co-ordinate system.
Please login and travel to your new cluster world. The following command will be used to create a cluster:
`/plot cluster create <name> <plot id 1> <plot id 2>`
`name`: what you want to call the cluster
`plot id 1`: Is the first co-ordinate and must be smaller than `plot id 2`
The id comes in the form `X;Z` e.g. `5;3`
To calculate what the plot id would be for a location use the following formula:
big `X'` and `Z'` represents the plot X and Z value respectively
small `x` and `z` represents the minecraft x and z value respectively
```
`X' = 1 + (x / <plot_width + road_width>)`
`Z' = 1 + (z / <plot_width + road_width>)`
```
- You can find your plot width and road width within the `settings.yml`
#### Notes
Just entering `/plot cluster create` will display an estimate for your current plot id.
# Step 4: Generating a cluster
Teleport to your new cluster with `/plot cluster tp <name>`
If you created your cluster in land that has already been generated, you will need to regenerate the land. You can either do this manually, or using the `/plot cluster regenerate` command.
# You're done!
Now you can do what you want with the newly created cluster, you can also create as many clusters within that world as you would like.
To let a specific user claim within the cluster use `/plot cluster invite <player>`. You can substitute `*` for the player name if you want to allow anyone to join.
For more cluster commands, please see the command documentation.
-Needs updating-