Code Monkey home page Code Monkey logo

tree-feller's Introduction

Thizzy'z Tree Feller

A Bukkit plugin for Minecraft 1.16+ (Older versions are available for 1.13-1.15)

Full customization

  • Configure custom trees with any combination of blocks for its leaves and logs
  • Configure custom tools with custom name, durability, enchantments, and more
  • Almost any configuration option can be customized for each tree or tool
  • Tools or trees can be configured to only work in specific worlds, times of day, gamemodes, and more!

Plug-and-play

The default configuration will reliably cut down all vanilla trees, while not disturbing player-made structures.

Many user-requested features:

  • Customizable permissions for each tree or tool
  • Global and tool or tree-based cooldowns
  • Tree felling animation
  • Advanced falling trees
  • Effects (particles, sounds, and explosions)
  • /treefeller reload
  • And more!

Compatibility with the following plugins:

  • McMMO
  • MMOCore
  • EcoSkills
  • Zrip’s Jobs Reborn
  • CoreProtect
  • GriefPrevention
  • WorldGuard
  • Towny
  • Ore Regenerator
  • Drop2Inventory
  • And more!

FAQ

Does it work with custom trees?

Yes

The tree feller is fully capable of detecting and cutting down trees of any shape and size, provided that the logs are connected.

The default config is configured for vanilla trees. If you have very large trees or trees with multiple or mismatched wood or leaf types, you may have to add your own trees to the config.

Many custom trees are generated improperly, containing diagonally connected or persistent leaves.

If this is the case, you may have to enable ignore-leaf-data, diagonal-leaves, and player-leaves.

My Tool/Tree settings aren't working!

In version 1.11, the config was overhauled with more options.

As a result of this overhaul, tool and tree-specific options no longer override global values.

For example, if you want a single tree to require no leaves:

  1. Set required-leaves for every other tree to some value (Default 10)
  2. Set the global required-leaves to 0
  3. Set required-leaves for the target tree to 0 (For readability)

Troubleshooting

If you can't get something to work:

  • Make sure you’re using the latest version
  • Run /treefeller debug and try to cut down a tree.
  • Check the startup logs in the server console

If you are unable to pinpoint the problem, I’m happy to help on discord or GitHub. Make sure to provide the config, startup logs, and the debug information from /treefeller debug

Tips/Fun Facts

You can use the tree feller for ores

Add trees using ore for the trunk and with leaves disabled:

[COAL_ORE, STONE, {required-leaves: 0, leaf-detect-range: 0, leaf-break-range: 0, max-height: 256}]

Add tools for each pickaxe with allowed-trees set to ORE

{type: IRON_PICKAXE, allowed-trees: ORE}

Set allowed-trees for the axes to LOG

{type: IRON_AXE, allowed-trees: LOG}

For more specific configuration, allowed-trees should be set to a list of tree indexes, such as [0, 1, 2, 3, 4, 5] for the first 6 trees defined

(you may need to set max-height higher as well)

You can define more than one tool or tree of the same type

This is useful if you want OR behavior. In this example, a golden axe must have either unbreaking 1 or efficiency 2:

tools:

  • {type: GOLDEN_AXE, required-enchantments: {unbreaking: 1}}
  • {type: GOLDEN_AXE, required-enchantments: {efficiency: 2}}

Tools and trees are checked in order

If you have an item that matches two tools, the first one will always be used.

For example:

  • {type: IRON_AXE, required-enchantments: {unbreaking: 1}}
  • {type: IRON_AXE, required-enchantments: {unbreaking: 2}, effects: [explosion]}

An explosion will never occur, as an iron axe with unbreaking 2 also matches the first tool.

Commands

/treefeller reload
Permission: treefeller.reload
Reloads the tree feller configuration

/treefeller help
Permission: treefeller.help
Displays help for tree feller commands

/treefeller on
Permission: treefeller.on
Toggles on the tree feller for the player who ran the command

/treefeller off
Permission: treefeller.off
Toggles off the tree feller for the player who ran the command

/treefeller toggle
Permission: treefeller.toggle
Toggles the tree feller for the player who ran the command

/treefeller debug [on|off]
Permission: treefeller.debug
Toggles debug mode on or off globally

/treefeller config
Permission: treefeller.config
Opens the ingame configuration

Configuration

When you update the tree feller, make sure to add any missing configuration options, as they will not be automatically added

(See config.yml)

Discord https://discord.gg/dhcPSMt

tree-feller's People

Contributors

thizthizzydizzy avatar nimanode avatar alfieongit avatar bob-the-bobothy avatar nyancat-hu avatar

Stargazers

Nestu avatar Bornato avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.