AmethystTools - Documentation
Installation
- Download the plugin jar file
- Drop it into your server's plugins/ folder
- Restart your server
- Config file will be generated automatically at plugins/AmethystTools/config.yml
Commands
/amethyst <pickaxe|axe|shovel> <player>
Gives the specified tool to the player.
- Example: /amethyst pickaxe Notch
- Permission: amethyst.give
/amethyst reload
Reloads the config.yml without restarting the server.
- Permission: amethyst.reload
Configuration
Each tool (pickaxe, axe, shovel) has its own section in config.yml. They all share the same options listed below.
name
Display name of the tool. Supports hex colors (
#RRGGBB) and Bukkit color codes (
&a &b &l etc).
Code (Text):
name: "#BF40BF&lᴀᴍᴇᴛʜʏѕᴛ ᴘɪᴄᴋᴀхᴇ"
unbreakable
Makes the tool unbreakable. Set to
true or
false.
Code (Text):
unbreakable: false
multi-break-size
How many blocks the tool breaks at once. Accepts 1 to 5 (1x1 to 5x5). Set to 1 to disable multi-break.
Code (Text):
multi-break-size: 3
enchantments
List of enchantments applied to the tool. Format:
ENCHANTMENT_NAME:LEVEL
Code (Text):
enchantments:
- "SILK_TOUCH:1"
- "DIG_SPEED:5"
- "DURABILITY:3"
duration
How long the tool lasts before it self-destructs.
Code (Text):
duration:
days: 2
hours: 23
minutes: 59
seconds: 0
sounds
Sounds played randomly when breaking blocks. Format:
minecraft:sound.name
Code (Text):
sounds:
- "minecraft:block.amethyst_block.break"
- "minecraft:block.amethyst_cluster.break"
sound-volume: 1.0
sound-pitch-min: 0.8
sound-pitch-max: 1.2
particle
Particle effect shown when breaking blocks. Set to
NONE to disable.
DUST type supports custom color and size. Other types ignore those options.
Code (Text):
particle: "DUST"
particle-color: "AA00FF"
particle-size: 1.5
breakable-blocks
Which blocks the tool can multi-break. Leave the list empty to allow all blocks.
If you add blocks here, only those blocks will be affected by multi-break.
Code (Text):
breakable-blocks:
- "STONE"
- "DEEPSLATE"
- "COAL_ORE"
- "DIAMOND_ORE"
Particle Types
- DUST - Colored dust particle (supports particle-color and particle-size)
- FLAME - Small flame
- END_ROD - White sparkle
- CRIT - Critical hit stars
- ENCHANT - Enchantment table letters
- PORTAL - Nether portal particles
- HAPPY_VILLAGER - Green sparkles
- NONE - Disables particles
Sound Format
Sounds must be written in
minecraft:category.block.action format (all lowercase).
- minecraft:block.amethyst_block.break
- minecraft:block.amethyst_block.hit
- minecraft:block.amethyst_block.chime
- minecraft:block.stone.break
- minecraft:block.wood.break
- minecraft:block.gravel.break
- minecraft:block.sand.break
Questions? Contact me on Discord: @Azad1337