... | ... | @@ -15,8 +15,9 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
],
|
|
|
"spawnDistance": 10.0,
|
|
|
"randMultiplier": 0.5,
|
|
|
"minY": 80,
|
|
|
"maxY": 100,
|
|
|
"relativePlayerPosition": false,
|
|
|
"minY": 80.0,
|
|
|
"maxY": 100.0,
|
|
|
"shuffleLocations": true
|
|
|
},
|
|
|
"particle": {
|
... | ... | @@ -35,11 +36,12 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
- `enabled` - Boolean to toggle whether your particle is enabled<br>
|
|
|
- `spawning.biomes` - Array of Spigot [biomes](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/block/Biome.html) your particle will be shown in<br>
|
|
|
- [Biome presents](https://gitlab.com/Zenya4/aurora/-/wikis/Biome-Presents) are supported in Aurora 1.2.0 and above
|
|
|
- `spawning.spawnDistance` - Float for the minimum distance between shapes Aurora will spawn from the same config<br>
|
|
|
- `spawning.randMultiplier` - Float for how far the location calculation of `spawning.spawnDistance` should deviate from its actual value
|
|
|
- `spawning.spawnDistance` - Double for the minimum distance between shapes Aurora will spawn from the same config<br>
|
|
|
- `spawning.randMultiplier` - Double for how far the location calculation of `spawning.spawnDistance` should deviate from its actual value
|
|
|
- Should be between `0` (0%) and `1.0` (100%)<br>
|
|
|
- `spawning.minY` - Integer for the minimum y-coordinate the particle will spawn at<br>
|
|
|
- `spawning.maxY` - Integer for the maximum y-coordinate the particle will spawn at<br>
|
|
|
- `spawning.relativePlayerPosition` - Boolean to toggle whether `spawning.minY` and `spawning.maxY` should be heights relative to the current player or fixed values
|
|
|
- `spawning.minY` - Double for the minimum y-coordinate the particle will spawn at<br>
|
|
|
- `spawning.maxY` - Double for the maximum y-coordinate the particle will spawn at<br>
|
|
|
- `spawning.shuffleLocations` - Boolean to toggle whether calculated particle-spawn locations in the internal list should be randomised<br>
|
|
|
`particle.particleName` - Spigot [particle](https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html) the shape should be made of<br>
|
|
|
- `particle.particleType` - Aurora particle shape
|
... | ... | @@ -76,7 +78,7 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
"duration": 1
|
|
|
}
|
|
|
```
|
|
|
- `properties.rate` - Float for the distance between each individual particle inside a shape
|
|
|
- `properties.rate` - Double for the distance between each individual particle inside a shape
|
|
|
- It is **recommended to set this value between 0.2 and 0.5** for optimal performance and nice-looking shapes
|
|
|
- For larger shapes like `SPHERE`s with a large radius, it is recommended to keep this value **large** to avoid server lag by spawning fewer particles in the shape
|
|
|
- For moving particles with `LINE` or `WAVE` particle types, this value determines how fast the shape travels (larger = faster)
|
... | ... | @@ -92,8 +94,8 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
"rotationAxis": "x"
|
|
|
}
|
|
|
```
|
|
|
- `properties.length` - Float for length of a cuboid object<br>
|
|
|
- `properties.rotationAngle` - Float for angle the object should be rotated by<br>
|
|
|
- `properties.length` - Double for length of a cuboid object<br>
|
|
|
- `properties.rotationAngle` - Double for angle the object should be rotated by<br>
|
|
|
- `properties.rotationAxis` - Character for axis the object should be rotated in. Can be `x`, `y` or `z`
|
|
|
#### Ring particle type
|
|
|
```json
|
... | ... | @@ -106,7 +108,7 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
"rotationAxis": "x"
|
|
|
}
|
|
|
```
|
|
|
- `properties.radius` - Float for radius of a circular object<br>
|
|
|
- `properties.radius` - Double for radius of a circular object<br>
|
|
|
#### Circle particle type
|
|
|
```json
|
|
|
"properties": {
|
... | ... | @@ -139,8 +141,8 @@ NOTE: All particle configs will have different required values in `properties` d |
|
|
"rotationAxis": "x"
|
|
|
}
|
|
|
```
|
|
|
- `properties.waveCycles` - Float for how many complete cycles the wave should consist of<br>
|
|
|
- `properties.waveAmplitude` - Float for the maximum height in blocks of each wave relative to its midpoint
|
|
|
- `properties.waveCycles` - Double for how many complete cycles the wave should consist of<br>
|
|
|
- `properties.waveAmplitude` - Double for the maximum height in blocks of each wave relative to its midpoint
|
|
|
|
|
|
## Value randomisation
|
|
|
As of Aurora 1.2.0, value randomisation is supported in all subnodes of the `properties` node. What this means is that all values under `properties` will support the array datatype in addition to their original types. Using the [cube particle type](https://gitlab.com/Zenya4/aurora/-/wikis/Particle-Configuration/#cube-particle-type) as example,
|
... | ... | |