{"id":29128959,"url":"https://github.com/zetaplugins/timberz","last_synced_at":"2026-03-09T19:12:31.316Z","repository":{"id":299223887,"uuid":"975288778","full_name":"ZetaPlugins/TimberZ","owner":"ZetaPlugins","description":"The best Lumberjack Axe (Treecapitator) plugin for Minecraft","archived":false,"fork":false,"pushed_at":"2025-11-28T19:31:49.000Z","size":401,"stargazers_count":2,"open_issues_count":0,"forks_count":4,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-11-30T21:13:13.964Z","etag":null,"topics":["lumberjack","minecraft","minecraft-plugin","paper-plugin","timberz","treecapitator"],"latest_commit_sha":null,"homepage":"https://modrinth.com/project/timberz","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ZetaPlugins.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-30T04:43:27.000Z","updated_at":"2025-11-28T19:29:23.000Z","dependencies_parsed_at":"2025-06-15T12:59:07.629Z","dependency_job_id":"98f7ea75-990a-48f7-b98d-a2a835ed5880","html_url":"https://github.com/ZetaPlugins/TimberZ","commit_stats":null,"previous_names":["zetaplugins/timberz"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/ZetaPlugins/TimberZ","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZetaPlugins%2FTimberZ","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZetaPlugins%2FTimberZ/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZetaPlugins%2FTimberZ/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZetaPlugins%2FTimberZ/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ZetaPlugins","download_url":"https://codeload.github.com/ZetaPlugins/TimberZ/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ZetaPlugins%2FTimberZ/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30308867,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-09T17:35:44.120Z","status":"ssl_error","status_checked_at":"2026-03-09T17:35:43.707Z","response_time":61,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["lumberjack","minecraft","minecraft-plugin","paper-plugin","timberz","treecapitator"],"created_at":"2025-06-30T02:37:29.877Z","updated_at":"2026-03-09T19:12:31.310Z","avatar_url":"https://github.com/ZetaPlugins.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"![Banner](https://cdn.modrinth.com/data/hjNMOOnF/images/e8fb857eda4377a96bcc794f13835ea85c83c126.png)\n\n---\n\n![paper](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/paper_vector.svg)\n![purpur](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/supported/purpur_vector.svg)\n[![github](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/github_vector.svg)](https://github.com/ZetaPlugins/TimberZ)\n[![modrinth](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/available/modrinth_vector.svg)](https://modrinth.com/project/timberz)\n[![discord-plural](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/social/discord-plural_vector.svg)](https://strassburger.org/discord)\n[![gitbook](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/documentation/gitbook_vector.svg)](https://docs.zetaplugins.com/timberz)\n[![generic-plural](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/translate/generic-plural_vector.svg)](https://gitlocalize.com/repo/10274)\n\nTimberZ is a Minecraft plugin that let's you cut down trees in an instant. You can either have it always active, toggleable, make special lumberjack axes or have a custom enchantment.\n\n## Features\n- ✅ Advanced Tree Detection\n- ✅ Custom Enchantment\n- ✅ Customizable Tree Types\n- ✅ Cutting down animation\n- ✅ Instant Leaf Decay\n- ✅ Toggleable Timber mode\n- ✅ Custom item support\n- ✅ HEX Colors\n- ✅ Highly customizable\n- ✅ Customizable messages\n- ✅ Easy setup\n- ✅ Multiple languages\n\n## Permissions\n\n- `timberz.usetimber` - Allows the player to use TimberZ. (true by default)\n- `timberz.admin` - Allows the player to use admin commands. (Only for OPs by default)\n\n## Compatability\n\n### ✅ PlaceholderAPI\n\nTimberZ supports PlaceholderAPI, allowing you to use placeholders in your messages and configurations:\n\n- `%timberz_can_timber%` - Returns true if the player can use TimberZ. This takes permissions, regions and other restrictions into account.\n\n### ✅ WorldGuard\n\nTimberZ supports WorldGuard, allowing you to restrict TimberZ usage in certain regions. You can use the `timber` flag to allow or disallow TimberZ usage in a region.\n\n### ✅ AuraSkills\n\nUsing TimberZ with AuraSkills, gives players the correct amount of experience when cutting down trees. You can also add a custom XP multiplier to the TimberZ configuration file.\n\n## Configuration\n\nYou can find the configuration files in the `plugins/TimberZ` folder. The main configuration file is `config.yml`, and you can also find a `blocks.yml` file that contains the block mappings for logs, leaves, and saplings.\n\n\u003cdetails\u003e\n\u003csummary\u003econfig.yml\u003c/summary\u003e\n\n```yml\n#   _______ _           _                 ______\n#  |__   __(_)         | |               |___  /\n#     | |   _ _ __ ___ | |__   ___ _ __     / /\n#     | |  | | '_ ` _ \\| '_ \\ / _ \\ '__|   / /\n#     | |  | | | | | | | |_) |  __/ |     / /__\n#     |_|  |_|_| |_| |_|_.__/ \\___|_|    /_____|\n\n# === COLOR CODES ===\n# This plugin supports old color codes like: \u0026c, \u0026l, \u0026o, etc.\n# It also supports MiniMessage, a more advanced way to format messages:\n# https://docs.advntr.dev/minimessage/format.html\n# With MiniMessage, you can add HEX colors, gradients, hover and click events, etc.\n\n\n# === GENERAL SETTINGS ===\n\n# If set to true, TimberZ will check for updates and let you know if there's a newer version\ncheckForUpdates: true\n\n# Set the language to any code found in the \"lang\" folder (don't add the .yml extension)\n# You can add your own language files. Use https://github.com/ZetaPlugins/TimberZ/tree/main/src/main/resources/lang/en-US.yml as a template\n# If you want to help translating the plugin, please refer to this article: https://docs.zetaplugins.com/#contributing\n#  | en-US | de-DE | pl-PL | ru-RU |\nlang: \"en-US\"\n\n# The accent color of the plugin. This color replaces %ac% in the lang files.\naccentColor: \"\u003c#00D26A\u003e\"\n\n\n# === TIMBER SETTINGS ===\n\n# Regardless of the settings below, you can disallow TimberZ for a specific player by disallowing them the \"timberz.usetimber\" permission.\n\n# If set to true, players can enable or disable timber mode by pressing F with a qualifying axe in hand\ntoggleTimber: true\n\n# If set to true, you can only use axes that have the \"Timber\" enchantment which can be applied like a normal Enchantment.\nrequireCustomEnchant: true\n\n# If set to true, you can only use axes with a customModelData value in the list below\nrestrictAxeModelData: false\n\n# If restrictAxeModelData is set to true, you can only use axes with a customModelData value in this list\nallowedModelData:\n  - 100\n\n# If set to true, Leaves will decay instantly when cutting down a tree\ninstantLeafDecay: true\n\n# If set to true, TimberZ will replant the tree after cutting it down\nreplant: true\n\n# Modify how much durability is removed from the axe when cutting down a tree\n# Formula: logCount * durabilityMultiplier\ndurabilityMultiplier: 1.0\n\n# The minimum durability the axe must have after cutting down a tree\nminDurability: 10\n\n# If set to true, Players will need to use an axe (defined in the blocks.yml file) to use TimberZ\n# When this is set to false, you can no longer toggle TimberZ by pressing F\nrequireAxeMaterial: true\n\n# If set to true, you can insta mine leaves when the TimberZ conditions are met\ninstaBreakLeavesWithTimber: false\n\n# Send a message to the player when they try to use timber mode in a WorldGuard region that does not allow it\nmessageOnRegionViolation: false\n\n# If using AuraSkills, you can have a custom XP multiplier for the Foraging skill\n# Example: If you set this to 2.0, players will receive double the XP for using TimberZ\n# Example2: If you set this to 0.5, players will receive half the XP for using TimberZ\nauraSkillsXPMultiplier: 1.0\n\n\n# === TREE DETECTION ===\n\n# Only change these settings if you know what you are doing!\n# These are used to detect trees and their leaves and are already fine tuned.\n\nleavesSearchRadius: 4\nmaxTreeSize: 500\nmaxSearchRadius: 1\ndiagonalSearchRange: 2\nminLeavesRequired: 5\nminLogsRequired: 3\n```\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eblocks.yml\u003c/summary\u003e\n\n```yml\nlogToLeafMap:\n  - \"OAK_LOG:OAK_LEAVES\"\n  - \"BIRCH_LOG:BIRCH_LEAVES\"\n  - \"SPRUCE_LOG:SPRUCE_LEAVES\"\n  - \"JUNGLE_LOG:JUNGLE_LEAVES\"\n  - \"ACACIA_LOG:ACACIA_LEAVES\"\n  - \"DARK_OAK_LOG:DARK_OAK_LEAVES\"\n  - \"MANGROVE_LOG:MANGROVE_LEAVES\"\n  - \"CHERRY_LOG:CHERRY_LEAVES\"\n  - \"STRIPPED_OAK_LOG:OAK_LEAVES\"\n  - \"STRIPPED_BIRCH_LOG:BIRCH_LEAVES\"\n  - \"STRIPPED_SPRUCE_LOG:SPRUCE_LEAVES\"\n  - \"STRIPPED_JUNGLE_LOG:JUNGLE_LEAVES\"\n  - \"STRIPPED_ACACIA_LOG:ACACIA_LEAVES\"\n  - \"STRIPPED_DARK_OAK_LOG:DARK_OAK_LEAVES\"\n  - \"STRIPPED_MANGROVE_LOG:MANGROVE_LEAVES\"\n  - \"STRIPPED_CHERRY_LOG:CHERRY_LEAVES\"\n  - \"PALE_OAK_LOG:PALE_OAK_LEAVES\"\n\nlogToSaplingMap:\n  - \"OAK_LOG:OAK_SAPLING\"\n  - \"BIRCH_LOG:BIRCH_SAPLING\"\n  - \"SPRUCE_LOG:SPRUCE_SAPLING\"\n  - \"JUNGLE_LOG:JUNGLE_SAPLING\"\n  - \"ACACIA_LOG:ACACIA_SAPLING\"\n  - \"DARK_OAK_LOG:DARK_OAK_SAPLING\"\n  - \"MANGROVE_LOG:MANGROVE_PROPAGULE\"\n  - \"CHERRY_LOG:CHERRY_SAPLING\"\n  - \"STRIPPED_OAK_LOG:OAK_SAPLING\"\n  - \"STRIPPED_BIRCH_LOG:BIRCH_SAPLING\"\n  - \"STRIPPED_SPRUCE_LOG:SPRUCE_SAPLING\"\n  - \"STRIPPED_JUNGLE_LOG:JUNGLE_SAPLING\"\n  - \"STRIPPED_ACACIA_LOG:ACACIA_SAPLING\"\n  - \"STRIPPED_DARK_OAK_LOG:DARK_OAK_SAPLING\"\n  - \"STRIPPED_MANGROVE_LOG:MANGROVE_PROPAGULE\"\n  - \"STRIPPED_CHERRY_LOG:CHERRY_SAPLING\"\n  - \"PALE_OAK_LOG:PALE_OAK_SAPLING\"\n\naxes:\n  - \"WOODEN_AXE\"\n  - \"STONE_AXE\"\n  - \"GOLDEN_AXE\"\n  - \"IRON_AXE\"\n  - \"DIAMOND_AXE\"\n  - \"NETHERITE_AXE\"\n```\n\n\u003c/details\u003e\n\n## Support\n\nIf you need help with the setup of the plugin, or found a bug, you can join our discord [here](https://strassburger.org/discord).\n\n[![discord-plural](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/social/discord-plural_vector.svg)](https://strassburger.org/discord)\n[![gitbook](https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/compact/documentation/gitbook_vector.svg)](https://docs.zetaplugins.com/timberz)\n\n---\n\n[![Usage](https://bstats.org/signatures/bukkit/TimberZ.svg)](https://bstats.org/plugin/bukkit/TimberZ/25743)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzetaplugins%2Ftimberz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzetaplugins%2Ftimberz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzetaplugins%2Ftimberz/lists"}