Particles & Sounds are now obtained using NamespacedKey's instead of enum values.
This unfortunately means all current cosmetics will not work, and needs to be updated.
You now get notified occasionally when starting drills that do not support patterns, if you have a pattern selected.
Added a {list} placeholder to the Cosmetic.InvalidType message, listing all available cosmetics.
Code (YAML):
Placement: # If you have a pattern selected, and start a non-placement drill, you will get a notification in chat. # This is the delay between those notifications, in milliseconds. NotificationDelayMs: 60000
Cosmetics: # The name that will be used to select this cosmetic. Lava: # Particles & Sounds are fetched using a NamespacedKey from their respective registries. # I don't know where to got a convenient list of them. # I'll leave the old links here though, as they kinda contain what you need to figure out some / most of the vanilla sounds & particles. # https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html Particle: "minecraft:lava" ParticleAmount: 4
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound: "minecraft:block.lava.pop" Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
# If you want the cosmetic to require a specific permission, you'd specify that here. #Permission: rampen.drills.cosmetic.lava # By default, particles will spawn in the center of the block. # If you set Type to randoffset it will spawn each particle with a random offset, which by default is up to .4 #Type: randoffset # If you want to change the random offset, you'd change these values. Does nothing if Type is not set to randoffset. #OffsetX: .4 #OffsetY: .4 #OffsetZ: .4 Explosion:
Particle: "minecraft:explosion" ParticleAmount: 1
Sound: "minecraft:entity.generic.explode" Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: "minecraft:portal" ParticleAmount: 25
Sound: "minecraft:entity.enderman.teleport" Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: "minecraft:crit" ParticleAmount: 15
Sound: "minecraft:entity.player.attack.crit" Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: "minecraft:item_snowball" ParticleAmount: 20
Sound: "minecraft:entity.snow_golem.hurt" Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Happy:
Particle: "minecraft:happy_villager" ParticleAmount: 12
Sound: "minecraft:entity.experience_orb.pickup" Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Type: randoffset
Spell:
Particle: "minecraft:witch" ParticleAmount: 12
Sound: "minecraft:entity.witch.throw" Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Messages:
Drill:
NonPlacementDrill: '&8
[&3RampenDrills&8
] &7You have a pattern selected, but started a drill does not make use of it. Use gold blocks instead of iron on the sides if you want the drill to make use of your selected pattern.'
Command:
Cosmetic:
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Available cosmetics
: {list
}.'
Pattern:
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected. If you have
any running drills, you need to restart them for them to make use of it.'
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Fix for items in the chest disappearing when the drill moved, on paper 1.17.1
this was only a problem on paper 1.17.1 (130 and below?), if you are running regular spigot, or the most recent paper build, this update does nothing except increase the version number.
Added a rampen.drills.basic permission,
which is given to everyone by default. Giving someone this permission is the same as giving them:
rampen.drills.use, rampen.drills.tool & rampen.drills.limit.1
Added rampen.drills.unlimited, which lets you have an unlimited amount of drills.
And the limit permissions no longer require the previous ones!
so you can now just give someone rampen.drills.limit.100 and they will have a limit of 100.
for now there's an option to disable this just in case it doesn't work as it should.
New drill:
Added a larger drill which uses a double chest.
If you are updating from an older version, you may have to either delete the DrillShapes: section for the drillheads, or add the large and largeplacement shapes to the list for it to work.
Misc:
the /drill tool command now disables itself if you turn off the drill tool requirement in the configuration.
To modify the message, look for "OnToolDisabled" under the Messages section.
The DrillShapes: section for the drillheads now allows "all" in place of specific names, and is what it defaults to when the section is not there.
Bugfix:
Fix for items in the furnace disappearing when the drill moves on paper 1.17.1
Code (YAML):
DrillHeads:
EMERALD_BLOCK: # This (DrillShapes) section has been removed from the iron & diamond block drillheads. # The different drill shapes that this drill head works with. Defaults to allow all drill shapes. #DrillShapes: #- 'default' #- 'placement' #- 'ender' #- 'enderplacement' #- 'large' #- 'largeplacement'
# in ms, how long to consider the last max limit check valid. DrillLimitCacheDuration: 5000
# Just in case the new system doesn't quite work as intended, I'm adding an option to disable it for now. # With this enabled, the limit permissions does not require the previous ones. UseNewLimitPermissionCheck: true
Messages:
Command:
OnToolDisabled: '&8
[&3RampenDrills&8
] &7You do not require a drill tool to start your drill.'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.5.0
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# Lets you use a shulker box instead of a chest. AllowShulkerBoxes: true
# If the drill should be allowed to move through lava. AllowMovingThroughLava: false
# Amount of ticks to wait after mining, before it checks that there's no more blocks left to mine before moving. GravelWaitDelay: 6
# How long it takes the drill to move, in ticks MoveDelay: 34
# If the drill should need fuel to do things. RequireFuel: true
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If solid blocks can be placed into the air, instead of only with a block under it. # You may have to set CheckExtraBlocks to false, and KeepMovingIfOutOfItems to true for this to be any useful. AllowAirPlacementForSolidBlocks: false
# If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. Defaults to allow all drill shapes. #DrillShapes: #- 'default' #- 'placement' #- 'ender' #- 'enderplacement' #- 'large' #- 'largeplacement' IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# in ms, how long to consider the last max limit check valid. DrillLimitCacheDuration: 5000
# Just in case the new system doesn't quite work as intended, I'm adding an option to disable it for now. # With this enabled, the limit permissions does not require the previous ones. UseNewLimitPermissionCheck: true
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics: # The name that will be used to select this cosmetic. Lava: # List of available particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html Particle: LAVA
ParticleAmount: 4
# List of available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
# If you want the cosmetic to require a specific permission, you'd specify that here. #Permission: rampen.drills.cosmetic.lava
# By default, particles will spawn in the center of the block. # If you set Type to randoffset it will spawn each particle with a random offset, which by default is up to .4 #Type: randoffset # If you want to change the random offset, you'd change these values. Does nothing if Type is not set to randoffset. #OffsetX: .4 #OffsetY: .4 #OffsetZ: .4 Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 12
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Type: randoffset
Spell:
Particle: SPELL_WITCH
ParticleAmount: 12
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
OnToolDisabled: '&8
[&3RampenDrills&8
] &7You do not require a drill tool to start your drill.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill filter &7- Stop your drill from picking up certain blocks. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill stop [player] &7- Stop your own drills, or a target players drills. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
NoPermission: '&8
[&3RampenDrills&8
] &7You do not have permission to use that cosmetic.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
ItemFilter:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill filter
[add/remove/list/clear
]'
HoldItem: '&8
[&3RampenDrills&8
] &7You need to hold the item you want add or remove to your filter.'
Added: '&8
[&3RampenDrills&8
] &e
{type
} &7has been added to your item filter.'
Cleared: '&8
[&3RampenDrills&8
] &7Your item filter has been cleared.'
List: '&8
[&3RampenDrills&8
] &7Your current item filter is
: &e{list}' Empty: '&8
[&3RampenDrills&8
] &7Your drills are not filtering
any items currently.'
Removed: '&8
[&3RampenDrills&8
] &e
{type
} &7has been removed from your item filter.'
NotFiltered: '&8
[&3RampenDrills&8
] &e
{type
} &7is not in your item filter'
Stop:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill stop
[player
]'
Error: '&8
[&3RampenDrills&8
] &cUnable to find drill player.'
TargetOffline: '&8
[&3RampenDrills&8
] &cTarget player is not online'
NoDrills: '&8
[&3RampenDrills&8
] &7You do not have
any running drills '
Stopped: '&8
[&3RampenDrills&8
] &7Your drills have been stopped'
StoppedAdmin: '&8
[&3RampenDrills&8
] &e
%player%''s &7drills have been stopped.' # Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.5.0
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Fixed a small bug with the offset for vertical drills
Code (YAML):
Messages:
Command:
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill filter &7- Stop your drill from picking up certain blocks. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill stop [player] &7- Stop your own drills, or a target players drills. &3/Drill reload &7- Attempts to reload the configuration. Stop:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill stop
[player
]'
Error: '&8
[&3RampenDrills&8
] &cUnable to find drill player.'
TargetOffline: '&8
[&3RampenDrills&8
] &cTarget player is not online'
NoDrills: '&8
[&3RampenDrills&8
] &7You do not have
any running drills '
Stopped: '&8
[&3RampenDrills&8
] &7Your drills have been stopped'
StoppedAdmin: '&8
[&3RampenDrills&8
] &e
%player%''s &7drills have been stopped.' ConfigVersion: 4.4.4
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Added an option for placement drill patterns to not require a solid block under them.
Code (YAML):
Placement: # If solid blocks can be placed into the air, instead of only with a block under it. # You may have to set CheckExtraBlocks to false, and KeepMovingIfOutOfItems to true for this to be any useful. AllowAirPlacementForSolidBlocks: false
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.4.2
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Fix for the drill sometimes moving before it should when mining gravel/sand.
/drill pattern should now send the usage message when used incorrectly, instead of nothing happening.
You can now specify the permission for each cosmetic.
You can also set the cosmetic to spawn the particles with randomized offsets.
Code (YAML):
Drill: # Amount of ticks to wait after mining, before it checks that there's no more blocks left to mine before moving. GravelWaitDelay: 6
# How long it takes the drill to move, in ticks MoveDelay: 34
# All the cosmetics Cosmetics: # The name that will be used to select this cosmetic. Lava: # List of available particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html Particle: LAVA
ParticleAmount: 4
# List of available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
# If you want the cosmetic to require a specific permission, you'd specify that here. #Permission: rampen.drills.cosmetic.lava
# By default, particles will spawn in the center of the block. # If you set Type to randoffset it will spawn each particle with a random offset, which by default is up to .4 #Type: randoffset # If you want to change the random offset, you'd change these values. Does nothing if Type is not set to randoffset. #OffsetX: .4 #OffsetY: .4 #OffsetZ: .4 Snow:
Type: randoffset
Happy:
ParticleAmount: 12
Type: randoffset
Spell:
ParticleAmount: 12
Type: randoffset
Messages:
Cosmetic:
NoPermission: '&8
[&3RampenDrills&8
] &7You do not have permission to use that cosmetic.'
ConfigVersion: 4.4.1
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# Lets you use a shulker box instead of a chest. AllowShulkerBoxes: true
# Amount of ticks to wait after mining, before it checks that there's no more blocks left to mine before moving. GravelWaitDelay: 6
# How long it takes the drill to move, in ticks MoveDelay: 34
# If the drill should need fuel to do things. RequireFuel: true
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics: # The name that will be used to select this cosmetic. Lava: # List of available particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html Particle: LAVA
ParticleAmount: 4
# List of available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
# If you want the cosmetic to require a specific permission, you'd specify that here. #Permission: rampen.drills.cosmetic.lava
# By default, particles will spawn in the center of the block. # If you set Type to randoffset it will spawn each particle with a random offset, which by default is up to .4 #Type: randoffset # If you want to change the random offset, you'd change these values. Does nothing if Type is not set to randoffset. #OffsetX: .4 #OffsetY: .4 #OffsetZ: .4 Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 12
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Type: randoffset
Spell:
Particle: SPELL_WITCH
ParticleAmount: 12
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Type: randoffset
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill filter &7- Stop your drill from picking up certain blocks. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
NoPermission: '&8
[&3RampenDrills&8
] &7You do not have permission to use that cosmetic.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
ItemFilter:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill filter
[add/remove/list/clear
]'
HoldItem: '&8
[&3RampenDrills&8
] &7You need to hold the item you want add or remove to your filter.'
Added: '&8
[&3RampenDrills&8
] &e
{type
} &7has been added to your item filter.'
Cleared: '&8
[&3RampenDrills&8
] &7Your item filter has been cleared.'
List: '&8
[&3RampenDrills&8
] &7Your current item filter is
: &e{list}' Empty: '&8
[&3RampenDrills&8
] &7Your drills are not filtering
any items currently.'
Removed: '&8
[&3RampenDrills&8
] &e
{type
} &7has been removed from your item filter.'
NotFiltered: '&8
[&3RampenDrills&8
] &e
{type
} &7is not in your item filter'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.4.1
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Added an option to the config to allow using Shulker Boxes instead of a chest.
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# Lets you use a shulker box instead of a chest. AllowShulkerBoxes: true
# How long it takes the drill to move, in ticks MoveDelay: 40
# If the drill should need fuel to do things. RequireFuel: true
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics:
Lava:
Particle: LAVA
ParticleAmount: 4
Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 1
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Spell:
Particle: SPELL_WITCH
ParticleAmount: 1
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill filter &7- Stop your drill from picking up certain blocks. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
ItemFilter:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill filter
[add/remove/list/clear
]'
HoldItem: '&8
[&3RampenDrills&8
] &7You need to hold the item you want add or remove to your filter.'
Added: '&8
[&3RampenDrills&8
] &e
{type
} &7has been added to your item filter.'
Cleared: '&8
[&3RampenDrills&8
] &7Your item filter has been cleared.'
List: '&8
[&3RampenDrills&8
] &7Your current item filter is
: &e{list}' Empty: '&8
[&3RampenDrills&8
] &7Your drills are not filtering
any items currently.'
Removed: '&8
[&3RampenDrills&8
] &e
{type
} &7has been removed from your item filter.'
NotFiltered: '&8
[&3RampenDrills&8
] &e
{type
} &7is not in your item filter'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.4
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Added option to use ender chests instead of normal chests.
Added a way to filter the blocks that your drill picks up.
Updated the default blacklist in the config.
Ender Drills:
If you're updating from a previous version, in the config you'll have to add them to the DrillShapes part of the drill heads you want them to work with.
Names are 'ender' and 'enderplacement' for the different versions.
Item Filter:
You can now stop the drill from picking up certain items!
The command is /drill filter
Just hold the item you don't want the drill to pick up, and do /drill filter add
Now your drill will just destroy those blocks instead of adding them to their inventory.
/drill filter remove will remove it from the filter, and /drill filter clear will clear all blocks from the filter.
If you want to view what items are currently being filtered, do /drill filter list
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# How long it takes the drill to move, in ticks MoveDelay: 40
# If the drill should need fuel to do things. RequireFuel: true
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillShapes: - 'default'
- 'placement'
- 'ender'
- 'enderplacement'
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics:
Lava:
Particle: LAVA
ParticleAmount: 4
Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 1
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Spell:
Particle: SPELL_WITCH
ParticleAmount: 1
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill filter &7- Stop your drill from picking up certain blocks. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
ItemFilter:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill filter
[add/remove/list/clear
]'
HoldItem: '&8
[&3RampenDrills&8
] &7You need to hold the item you want add or remove to your filter.'
Added: '&8
[&3RampenDrills&8
] &e
{type
} &7has been added to your item filter.'
Cleared: '&8
[&3RampenDrills&8
] &7Your item filter has been cleared.'
List: '&8
[&3RampenDrills&8
] &7Your current item filter is
: &e{list}' Empty: '&8
[&3RampenDrills&8
] &7Your drills are not filtering
any items currently.'
Removed: '&8
[&3RampenDrills&8
] &e
{type
} &7has been removed from your item filter.'
NotFiltered: '&8
[&3RampenDrills&8
] &e
{type
} &7is not in your item filter'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.3
If you have any questions or need help with the plugin, the best way to contact me is
discord.
Added a config option for the drill not to require fuel
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# How long it takes the drill to move, in ticks MoveDelay: 40
# If the drill should need fuel to do things. RequireFuel: true
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. DrillShapes: - 'default'
- 'placement'
IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DrillShapes: - 'default'
- 'placement'
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillShapes: - 'default'
- 'placement'
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics:
Lava:
Particle: LAVA
ParticleAmount: 4
Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 1
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Spell:
Particle: SPELL_WITCH
ParticleAmount: 1
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.2
If you have any questions or need help with the plugin, the best way to contact me is
discord.
If you're updating from a previous version I recommend letting the plugin generate a new config.
Added a new drill that can place a few blocks.
Uses gold blocks at the side instead of iron blocks.
If you're having issues with anti-cheat blocking the placement, try adding DrillPlaceEvent to ignored events if possible.
The permission for /drill pattern is rampen.drills.pattern.select
Most of the details are explained in the config.
Code (YAML):
# RampenDrills configuration. Drill: # Require the player to be close to the drill for it to run. if set to false, it only needs the chunk(s) to be loaded. # Warning: Disabling this may lead to issues, I would highly recommend testing it before disabling it. NeedPlayerClose: true
# If NeedPlayerClose is true, this is the distance that the player needs to be within the drill, otherwise it stops. NeedPlayerCloseRange: 32
# If the player needs a drill tool to start the drill, if set to false it requires an empty hand. RequireDrillTool: true
# If the drill should check the extra blocks under the drill. Makes it so the drill can't 'fly'. CheckExtraBlocks: true
# If CheckExtraBlocks is true, only check the blocks if drill is horizontal. CheckExtraBlocksHorizontalOnly: true
# How long it takes the drill to move, in ticks MoveDelay: 40
# The amount of fuel the drills requires. FuelCost:
OnMove: 600
# Settings for the placement drills shape. (gold blocks instead of iron blocks on the side) Placement: # If the drill should keep moving when it's out of items KeepMovingIfOutOfItems: false
# Blocks that can be used to place blocks in front/under the drill so that it can move. # The blocks get placed in the spot where the CheckExtraBlocks setting checks for blocks. # The drill will get these blocks from its chest. FillerBlocks: - 'COBBLESTONE'
- 'STONE'
- 'DIRT'
# Blocks that the drill is allowed to place blocks "into". AllowedOverride: - 'AIR'
- 'WATER'
- 'LAVA'
# The different patterns players can select for the placement drill to place blocks behind it. Patterns:
Rail:
Pattern: - 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'RAIL'
- 'POWERED_RAIL'
# This can be removed if you don't want it to require a permission. Permission: "rampen.drills.rail" Torches:
Pattern: - 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'AIR'
- 'TORCH'
Permission: "rampen.drills.torches" # DrillHeads: # Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html # Make sure the material you use is a block and not an item, otherwise it may cause issues or not work. EMERALD_BLOCK: # If its silktouch or not. SilkTouch: true
# The fuel modifier for moving. FuelModifier: 1.2
# How much fuel digging 1 block costs. DigFuelCost: 12
# All permissions will look like rampen.drills.<whatever you put> # Remove to make it not require any permissions. Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default. Size: Default
# Normal delay is used for most blocks, LongDelay is for the materials in SlowBlocks. NormalDelay: 8
LongDelay: 45
# Materials of blocks where the drill will use the long delay instead of short delay. Remove to use the default, which is only obsidian. SlowBlocks: - 'OBSIDIAN'
# The different drill shapes that this drill head works with. DrillShapes: - 'default'
- 'placement'
IRON_BLOCK:
SilkTouch: false
FuelModifier: 0.5
DigFuelCost: 2
NormalDelay: 16
LongDelay: 70
DrillShapes: - 'default'
- 'placement'
DIAMOND_BLOCK:
SilkTouch: false
FuelModifier: 1
DigFuelCost: 10
NormalDelay: 10
LongDelay: 50
DrillShapes: - 'default'
- 'placement'
DrillSizes: # Add as many different sizes as you want. Default:
Height: 3
Width: 3
WidthOffset: Auto
# Prevents players from crafting with the drill tool. PreventCraftingWithDrillTool: true
# Customize the drill tool DrillTool:
Material: 'WOOD_HOE'
Name: '&rDrill Tool'
Lore: - '&5Right click on the drill head'
- '&5&o
(Iron/Diamond/Emerald block
)'
- '&5from your drill to make it start / stop.'
# Set to false to disable all cosmetics. Players will still be able to select them, but they won't do anything. EnableCosmetics: true
# All the cosmetics Cosmetics:
Lava:
Particle: LAVA
ParticleAmount: 4
Sound: BLOCK_LAVA_POP
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Explosion:
Particle: EXPLOSION_LARGE
ParticleAmount: 1
Sound: ENTITY_GENERIC_EXPLODE
Volume: 1
PitchMin: 3
RandomAdditionalPitch: 1
Ender:
Particle: PORTAL
ParticleAmount: 25
Sound: ENTITY_ENDERMAN_TELEPORT
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Crit:
Particle: CRIT_MAGIC
ParticleAmount: 15
Sound: ENTITY_PLAYER_ATTACK_CRIT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Snow:
Particle: SNOWBALL
ParticleAmount: 20
Sound: ENTITY_SNOW_GOLEM_HURT
Volume: 1.5
PitchMin: 1
RandomAdditionalPitch: 1
Happy:
Particle: VILLAGER_HAPPY
ParticleAmount: 1
Sound: ENTITY_EXPERIENCE_ORB_PICKUP
Volume: 1
PitchMin: 2
RandomAdditionalPitch: 1
Spell:
Particle: SPELL_WITCH
ParticleAmount: 1
Sound: ENTITY_WITCH_THROW
Volume: 1
PitchMin: 1
RandomAdditionalPitch: 1
Messages:
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to do that!'
Drill:
SomeoneElse: '&8
[&3RampenDrills&8
] &7Someone else is using that drill.'
StartMoving: '&8
[&3RampenDrills&8
] &7Your drill will start moving now.'
StoppedMoving: '&8
[&3RampenDrills&8
] &7Your drill has stopped moving.'
TooManyDrills: '&8
[&3RampenDrills&8
] &7You are not allowed to have another drill.'
DrillCantMine: '&8
[&3RampenDrills&8
] &7Your drill is not allowed to mine there, so it stopped.'
CantMine: '&8
[&3RampenDrills&8
] &7Your drill cannot mine that block.'
CantMove: '&8
[&3RampenDrills&8
] &7Your drill was unable to move and stopped.'
NoFuel: '&8
[&3RampenDrills&8
] &7Your drill does not have enough fuel.'
NoStorage: '&8
[&3RampenDrills&8
] &7Your drill does not have enough free storage.'
SomethingWentWrong: '&8
[&3RampenDrills&8
] &7Something went wrong with the drill, it stopped.'
OutOfBlocks: '&8
[&3RampenDrills&8
] &7Your drill is out of blocks.'
CantPlace: '&8
[&3RampenDrills&8
] &cYour drill was not allowed to place a block.'
Command:
Unknown: '&8
[&3RampenDrills&8
] &7Unknown command. try /drill help'
OnToolGive: '&8
[&3RampenDrills&8
] &7Added the drill tool to your inventory.'
Help: | &8===== &3RampenDrills Help &8===== &3/Drill tool &7- Gives you the drill tool. &3/Drill help &7- Shows this. &3/Drill pattern [name] &7- Select a pattern for the placement drill. &3/Drill cosmetic [name/off] &7- Cosmetic stuff. &3/Drill reload &7- Attempts to reload the configuration. Reload: '&8
[&3RampenDrills&8
] &7&cAttempted to reload configuration. This may cause problems, restart is recommended.'
Cosmetic:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill cosmetic
[name/off
]'
InvalidType: '&8
[&3RampenDrills&8
] &7Invalid cosmetic type. Try
: Explosion, Ender, Lava, Crit, Snow, Happy or Spell.'
Enabled: '&8
[&3RampenDrills&8
] &7Turned on
{type
} drill effects.'
Disabled: '&8
[&3RampenDrills&8
] &7Turned off cosmetic drill effects.'
Pattern:
Usage: '&8
[&3RampenDrills&8
] &7Usage
: /drill pattern
[pattern name
]'
NotAPattern: '&8
[&3RampenDrills&8
] &cThat''s not a valid pattern'
Selected: '&8
[&3RampenDrills&8
] &7
{pattern
} has been selected.'
NoPermission: '&8
[&3RampenDrills&8
] &cYou do not have permission to selected that pattern.'
Removed: '&8
[&3RampenDrills&8
] &7Your selected pattern has been removed.'
# Used for making sure the config is up to date. Updating the config removes all comments, and adds back missing default values for various things. ConfigVersion: 4.1
If you have any questions or need help with the plugin, the best way to contact me is
discord.
The option to not require the drill tool is called "RequireDrillTool"
If set to false, you will need to right click with an empty hand instead of the drill tool.
Cosmetics:
You can now add your own in the config, or modify the existing ones.
Options should for the most part be self-explanatory.
found under "Cosmetics:" in the config.
Your selected cosmetic now resets upon reloading(/drill reload) the plugin.
If you have any questions or need help with the plugin, the best way to contact me is
discord.
This build is somewhat experimental, but I've yet to run into any issues on my test server.
By default, everything should for the most part be as the previous version.
Sizes:
In the config look for the option called 'DrillSizes'
By default it will contain:
Code (Text):
DrillSizes:
Default:
Height: 3
Width: 3
WidthOffset: Auto
You can add as many different sizes as you want, as long as the names are different.
Code (Text):
DrillSizes:
Default:
Height: 3
Width: 3
WidthOffset: Auto
NotDefault:
Height: 5
Width: 5
WidthOffset: Auto
Height and width is pretty self-explanatory.
WidthOffset: If you dont want to bother with this, keep it at auto.
I left it as an option for people that want to use 4x4 etc. and want to control which direction it goes 1 extra block.
for 3x3 its -1, for 5x5 its -2 etc.
Feel free to play around with it, but auto should work in most cases.
Drillheads:
By default, the section will look like
Code (Text):
DrillHeads:
# Material of the drill head. materials: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Material.html
# Make sure the material you use is a block and not an item, otherwise it may cause issues or not work.
EMERALD_BLOCK:
# If its silktouch or not.
SilkTouch: true
# Speed and Fuel modifiers for the values you set in the config earlier.
# Fuel: (Base Value * Fuel Modifier) Speed: (Base Value / Speed Modifier)
SpeedModifier: 1
FuelModifier: 1.2
# All permissions will look like rampen.drills.<whatever you put>
# Remove to make it not require any permissions.
Permission: silk
# Which size preset the drillhead will use. If removed or invalid, it will use Default.
Size: Default
IRON_BLOCK:
SilkTouch: false
SpeedModifier: 0.6
FuelModifier: 0.5
DIAMOND_BLOCK:
SilkTouch: false
SpeedModifier: 1
FuelModifier: 1
Added option to prevent people from crafting with the drill tool. Default: true
Cleaned up some code.
Added option to only require chunk to be loaded, instead of needing the player to be close.
The option to only require chunks to be loaded is called 'NeedPlayerClose' and is by default true, meaning it requires the player to be close.
Warning: Setting this to false may lead to some issues, so I highly suggest testing this before disabling it.
If you need any help with the plugin, the best way to contact me is
discord.
Added all shulker box materials to the default blacklist.
You can now customize the drill tool.
Cleaned up a little bit of code.
Previous versions seem to work fine on 1.11, but if you are updating I would recommend either deleting your config or adding the shulker box materials to the blacklist yourself.
Removed some debug code which triggered if player quit while having drills running.
Some more on the 1.8 support:
After the major recode I did a while back, The plugin seems to work fine on 1.8, except for the cosmetics.
So as of now, if you're running 1.7 or 1.8 the cosmetics will just disable itself.
I was unable to find a 1.7 jar to test it with, but it seems to work without problem on 1.8.8 from my initial testing.
All suggestions are appreciated.
If you need any help with the plugin, the fastest way to get a response from me will probably be
discord.
/Drill effect [On/off] is now /Drill effect [Type/Off]
Types: Explosion, Ender and Lava.
Config changes:
One of these days I'll make a overview explaning the config.
But for you could either delete the config and let it generate a new one as I also made some changes last update.
But its mainly a {type} placeholder for CosmeticOn aswell as some messages related to cosmetics changed.
Small Note:
As of right now, if a player activates a cosmetic it will stay on until the player either removes it, or the server restarts. even if the player loses the permission for that specific cosmetic. if you remove rampen.drills.cosmetic the cosmetics effect will no longer play, even if the player has it activated.
If you need any help with how this works, or the plugin in general, the fastest way to get a response from me will probably be
discord.
Rewrote most of the core mechanics. Everything should still function the same, but I hope this will improve performace. If not, it alteast makes it easier for me to work with.
Drill heads! You can now replace the diamond block with an iron block, but the drill will only be 0.5 the speed.
You no longer need a negative permission node for the earlier limit permissions.
Limit permissions are now in a list in the config, and does no longer require you to input how many of them there is.
Coal block is now worth coal x9 instead of coal x10's worth of fuel.
Cosmetic stuff:
New command! /drill effect [on/off]
Permissions:
rampen.drills.cosmetic - is needed for all cosmetic effects.
rampen.drills.cosmetic.toggle - lets you toggle cosmetic effects on /off
rampen.drills.cosmetic.blockbreak - cosmetic effect on block break.
Its off by default, and will need to be toggled on every time you log in.