# Tree Feller by ThizThizzyDizzy # Version 1.12 # If set to false, the tree feller will not list all its settings in the console on startup startup-logs: true # How far should the plugin scan for logs? (If a tree is larger, only the part within this distance will be felled) scan-distance: 256 # How far away from logs should leaf blocks be destroyed? (set to 0 to prevent leaves from being destroyed) (Values over 6 are useless for vanilla trees, as these leaves would naturally decay anyway) leaf-range: 4 # How many logs should be required for logs to be counted as a tree? required-logs: 1 # How many leaves should be required for logs to be counted as a tree? required-leaves: 1 # How many logs may be felled at with one stroke? max-logs: 250 # How far from the bottom can you cut down a tree? (Prevents you from cutting it down from the top) 1 = bottom block max-height: 5 # Should trees be able to be partially cut down if the tool has insufficient durability? It cannot be guaranteed what part of the tree will be cut down! allow-partial: false # Should leaves placed by players be cut down also? (Only works with _LEAVES materials) player-leaves: true # If set to true, leaves will be detected diagonally; May require ignore-leaf-data to work properly diagonal-leaves: true # If set to true, leaves' blockdata will be ignored. This should only be set if custom trees' leaves are not being destroyed when they should. ignore-leaf-data: true # Should trees larger than 1x1 require an entire horizontal cross-section to be mined before the tree fells? (Works for up to 2x2 trees) require-cross-section: false # Should the tree cut down with an animation? cutting-animation: false # Animation delay, in ticks anim-delay: 1 # Should saplings be replanted? replant-saplings: false # Should saplings be spawned? # 0 = No, only replant if the leaves drop saplings # 1 = Yes, but only if the leaves do not drop enough # 2 = Yes, always spawn new saplings spawn-saplings: 0 # What blocks can saplings be planted on? grass: - DIRT - PODZOL - GRASS_BLOCK # What felling behavior should logs have? # Valid options: # BREAK (default) The logs will break and fall as items # FALL The logs will fall as falling blocks # FALL_HURT The logs will fall as falling blocks and hurt any entity they land on # FALL_BREAK The logs will fall as falling blocks and break when they reach the ground # FALL_HURT_BREAK The logs will fall as falling brocks, hurt entities they land on, and break when they reach the ground # INVENTORY The logs will appear in the player's inventory as items # FALL_INVENTORY The logs will fall as falling blocks, break, and appear in the player's inventory upon reaching the ground # FALL_HURT_INVENTORY The logs will fall as falling blocks, break, hurt entities they land on, and appear in the player's inventory upon reaching the ground # NATURAL The logs will instantly fall in a more natural way (May not work with cutting-animation) # Note that falling blocks occasionally drop as items if they land wrong log-behavior: BREAK # What felling behavior should leaves have? # Valid options: # BREAK (default) The leaves will break and fall as items # FALL The leaves will fall as falling blocks # FALL_HURT The leaves will fall as falling blocks and hurt any entity they land on # FALL_BREAK The leaves will fall as falling blocks and break when they reach the ground (Leaf blocks will be dropped) # FALL_HURT_BREAK The leaves will fall as falling brocks, hurt entities they land on, and break when they reach the ground. (Leaf blocks will be dropped) # INVENTORY The leaves will appear in the player's inventory as items # FALL_INVENTORY The leaves will fall as falling blocks, break, and appear in the player's inventory upon reaching the ground # FALL_HURT_INVENTORY The leaves will fall as falling blocks, break, hurt entities they land on, and appear in the player's inventory upon reaching the ground # NATURAL The leaves will instantly fall in a more natural way (May not work with cutting-animation) # Note that falling blocks occasionally drop as items if they land wrong, and falling leaves will drop leaf blocks if they do leaf-behavior: BREAK # Which direction should the tree fall in? # (Only used when log or leaf behavior is set to FALL or similar) # Valid options: # RANDOM The tree will fall in a random direction # TOWARD The tree will fall towards the player # AWAY The tree will fall away from the player # LEFT The tree will fall to the player's left # RIGHT The tree will fall to the player's right # NORTH The tree will fall to the north # SOUTH The tree will fall to the south # EAST The tree will fall to the east # WEST The tree will fall to the west # NORTH_WEST The tree fill fall to the northwest # NORTH_EAST The tree fill fall to the northeast # SOUTH_WEST The tree fill fall to the southwest # SOUTH_EAST The tree fill fall to the southeast directional-fall-behavior: RANDOM # This is the list of blocks that may be overridden when a tree falls onto them (e.g air, grass, water) # (Only used for NATURAL fell behavior) overridables: - CAVE_AIR - WATER - TALL_GRASS - FERN - LARGE_FERN - SEAGRASS - GRASS - AIR - TALL_SEAGRASS # If set to true, trees can only fall in one of the cardinal directions (N/S/E/W) lock-fall-cardinal: false # How much horizontal velocity should falling trees get? # (Only used when log or leaf behavior is set to FALL or similar) # All of the blocks in the tree will fall in the same direction with this velocity. directional-fall-velocity: 0.35 # How much upwards velocity should falling trees get? # (Only used when log or leaf behavior is set to FALL or similar) vertical-fall-velocity: 0.05 # How much random sideways velocity should falling blocks get? # (Only used when log or leaf behavior is set to FALL or similar) random-fall-velocity: 0.0 # If a tool has unbreaking, should it take less damage from cutting trees? respect-unbreaking: true # How much damage should tools take per log? (Multiplier) damage-mult: 1.0 # Should Fortune on an axe be applied to leaves? leaf-fortune: true # Should Silk Touch on an axe be applied to leaves? leaf-silk-touch: false # Should Fortune on an axe be applied to logs? log-fortune: true # Should Silk Touch on an axe be applied to leaves? log-silk-touch: true # When a tree is felled, should a stump be left? (The stump consists of any log blocks below the point at which the tree was felled) # This may cause issues with custom trees that have multiple trunks or branches that extend very low leave-stump: false # When trees fall, should the logs rotate as they fall? (This makes it look more realistic, with logs landing horizontally) # (Only used when log or leaf behavior is set to FALL or similar) rotate-logs: true # Should _WOOD blocks in trees be converted to _LOG when they drop as items? convert-wood-to-log: true # How often should leaves drop items? Set this to 0.0 to stop leaves from dropping items altogether (Only works with BREAK behavior) leaf-drop-chance: 1.0 # How often should logs drop items? Set this to 0.0 to stop logs from dropping items altogether (Only works with BREAK behavior) log-drop-chance: 1.0 # Global effects are applied every time a tree is felled, regardless of tree type or tool # use ALL for all effects # ex: # - ghost sound # - smoke global-effects: - ALL # Tools must have these enchantments at this level or higher to fell trees # ex: # - unbreaking: 2 # - efficiency: 5 required-enchantments: # Tools must not have these enchantments or have them lower than this level to fell trees # ex: # - silk_touch: 1 # - unbreaking: 3 banned-enchantments: # Tools with less than this much durability will be unable to fell trees min-durability: # Tools with more than this much durability will be unable to fell trees max-durability: # Tools with less than this percentage of durability will be unable to fell trees min-durability-percent: # Tools with more than this percentage of durability will be unable to fell trees max-durability-percent: # If set to true, tools will not be able to fell a tree if doing so would break the tool. prevent-breakage: false # Tools must have all literal strings in this list in order to fell trees # ex: # - Can fell trees required-lore: # A tool's name must match exactly in order to fell trees (colors can be designated with &) required-name: # Trees can only be cut down by players who have all permissons listed here # ex: # - treefeller.example required-permissions: # What should the minimum time be for felling trees? (0-24000) min-time: # What should the maximum time be for felling trees? (0-24000) max-time: # What should the maximum phase be for felling trees? (0-7) # Phases: # 0 = full moon # 1 = waning gibbous # 2 = first quarter # 3 = waning crescent # 4 = new moon # 5 = waxing crescent # 6 = third quarter # 7 = waxing gibbous min-phase: # What should the minimum phase be for felling trees? (0-7) # Phases: # 0 = full moon # 1 = waning gibbous # 2 = first quarter # 3 = waning crescent # 4 = new moon # 5 = waxing crescent # 6 = third quarter # 7 = waxing gibbous max-phase: # Should the tree feller work in adventure mode? enable-adventure: false # Should the tree feller work in survival mode? enable-survival: true # Should the tree feller work in creative mode? enable-creative: false # Should the tree feller work when sneaking? with-sneak: false # Should the tree feller work when not sneaking? without-sneak: true # In what worlds should the tree feller work? (Inverted if world-blacklist is set to true) worlds: world-blacklist: false # How long (in ticks) should players have to wait before felling another tree? cooldown: # What tools can be used to cut down trees? # Format: # - {type: AXE_MATERIAL, } # Any of the following variables may be used: (See above for descriptions) # scan-distance # leaf-range # required-logs # required-leaves # max-logs # max-height # allow-partial # player-leaves # require-cross-section # cutting-animation # anim-delay # replant-saplings # spawn-saplings # log-behavior # leaf-behavior # directional-fall-behavior # overridables # lock-fall-cardinal # directional-fall-velocity # vertical-fall-velocity # random-fall-velocity # respect-unbreaking # damage-mult # leaf-fortune # leaf-silk-touch # log-fortune # log-silk-touch # leave-stump # rotate-logs # convert-wood-to-log # leaf-drop-chance # log-drop-chance # global-effects # required-enchantments # banned-enchantments # min-durability # max-durability # min-durability-percent # max-durability-percent # prevent-breakage # required-lore # required-name # required-permissions # min-time # max-time # min-phase # max-phase # allowed-trees The tool can only fell specific trees. is a list of tree indexes, starting at 0 (the first tree defined is 0, the second is 1, etc.) # enable-adventure # enable-survival # enable-creative # with-sneak # without-sneak # worlds # world-blacklist # cooldown # AIR can be used instead of an item name if you want every item, including an empty hand, to fell a tree # Examples of valid tools: # - {type: WOODEN_AXE, required-enchantments: {efficiency: 4, unbreaking: 1}, banned-enchantments: {unbreaking: 2}, min-durability: 4, max-durability-percent: 0.9} # - {type: DIAMOND_AXE, required-enchantments: {efficiency: 4}, banned-enchantments: {unbreaking: 2}, required-lore: [A line of lore, Another line of lore]} # - {type: GOLDEN_AXE, required-permissions: [treefeller.example,treefeller.anotherexample]} # - STONE_AXE # - {type: IRON_AXE, allowed-trees: [0,1,3]} <-this tool can only cut down the first, second, and fourth trees defined. # - {type: AIR, damage-mult: 0} tools: - WOODEN_AXE - STONE_AXE - IRON_AXE - GOLDEN_AXE - DIAMOND_AXE # What materials count as trees? # Format: # - [[TRUNK_MATERIALS], [LEAF_MATERIALS], {}] # Any of the following variables may be used: (See above for descriptions) # leaf-range: # required-logs: # required-leaves: # max-logs: # max-height: # allow-partial: # player-leaves: # diagonal-leaves: # ignore-leaf-data: # require-cross-section: # cutting-animation: # anim-delay: # replant-saplings: # spawn-saplings: # sapling: If replant-saplings is enabled, this will replant the tree with this type of sapling # max-saplings: If replant-saplings is enabled, this will limit the number of saplings that can be replanted # grass: # log-behavior: # leaf-behavior: # directional-fall-behavior: # overridables: # lock-fall-cardinal: # directional-fall-velocity: # vertical-fall-velocity: # random-fall-velocity: # respect-unbreaking: # damage-mult: # leaf-fortune: # leaf-silk-touch: # log-fortune: # log-silk-touch: # leave-stump: # rotate-logs: # convert-wood-to-log: # leaf-drop-chance: # log-drop-chance: # global-effects: # required-enchantments: # banned-enchantments: # min-durability: # max-durability: # min-durability-percent: # max-durability-percent: # prevent-breakage: # required-lore: # required-name: # required-permissions: # min-time: # max-time: # min-phase: # max-phase: # enable-adventure: # enable-survival: # enable-creative: # with-sneak: # without-sneak: # worlds: # world-blacklist: # cooldown: # Examples of valid trees: # - [[OAK_LOG, OAK_WOOD], OAK_LEAVES] # - [BIRCH_LOG, BIRCH_LEAVES] # - [STONE, NETHERRACK, {damage-mult: 50, allow-partial: false, sapling: OAK_SAPLING}] # - SPRUCE_LOG <-This will attempt to automatically detect the leaf material. trees: - [[OAK_LOG, OAK_WOOD], OAK_LEAVES, {sapling: OAK_SAPLING, max-saplings: 1}] - [[BIRCH_LOG, BIRCH_WOOD], BIRCH_LEAVES, {sapling: BIRCH_SAPLING, max-saplings: 1}] - [[SPRUCE_LOG, SPRUCE_WOOD], SPRUCE_LEAVES, {sapling: SPRUCE_SAPLING, max-saplings: 1}] - [[JUNGLE_LOG, JUNGLE_WOOD], JUNGLE_LEAVES, {sapling: JUNGLE_SAPLING, max-saplings: 4}] - [[DARK_OAK_LOG, DARK_OAK_WOOD], DARK_OAK_LEAVES, {sapling: DARK_OAK_SAPLING, max-saplings: 4}] - [[ACACIA_LOG, ACACIA_WOOD], ACACIA_LEAVES, {sapling: ACACIA_SAPLING, max-saplings: 1}] # Here, you can create custom effects for trees or tools # Fields: # name: This is the effect's name. It is used to assign the effect to a tree or tool # chance: This is the chance of the effect happening (0-1, default 1) # location: This is where the effect will occur. valid options: # logs The effect will occur at every log in the tree # leaves The effect will occur at every block of leaves in the tree # tree The effect will occur at every block in the tree # tool The effect will occur at the block that was cut down # type: This is what type of effect should occur. Valid options: # particle A particle effect, such as flame, block, etc. particles # sound Any sound # explosion An explosion that Will destroy blocks and items- This will occur after the block is destroyed # Particle settings: # particle: The particle to display # x: The X offset from the center of the block to display the particle (default 0) # y: The Y offset from the center of the block to display the particle (default 0) # z: The Z offset from the center of the block to display the particle (default 0) # dx: The delta X of the particle field (default 0) # dy: The delta Y of the particle field (default 0) # dz: The delta Z of the particle field (default 0) # speed: The speed of the particles (default 0) # count: The number of particles to display (default 1) # Extra information is required for some particles # For Dust particles: # r: The Red color channel for this particle, 0-255 # g: The Green color channel for this particle, 0-255 # b: The Blue color channel for this particle, 0-255 # size: The size of the particle # for Item particles: # item: The item to be used for this particle # for Block or Falling Dust particles: # block: The block to be used for this particle # Sound settings: # sound: The sound to play # volume: The volume at which to play the sound (Default 1) # pitch: The pitch at which to play the sound (0.5-2, Default 1) # Explosion settings: # power: The explosion power, where creepers are 3, tnt 4, charged creepers 5 # fire: (true|false) Weather or not to light fires with the explosion (Default false) # Examples of valid effects: # - {name: smoke, chance: 1, location: logs, type: particle, particle: smoke, dx: 0.5, dy: 0.5, dz: 0.5, speed: .01, count: 10} # - {name: explosion, chance: .01, location: tool, type: explosion, power: 4} # - {name: ghost sound, chance: .1, location: tree, type: sound, sound: ambient.cave, volume: 10, pitch: 0.5} effects: # Here, you can customize what messages are sent the tree feller is unable to cut down a tree. Most options are customizable; The debug messages are provided for reference # Format: prefix-