**Require PacketEvents!
This plugin is still in ALPHA test.** [![Discord Support](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/DiscordSupport.png)](https://discord.gg/RZajEybhBw) [![Plugin Docs](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/PluginDocs.png)](https://simple.superiormc.cn/ultimatetweak-wiki?fallback=true) ![UltimateTweak Banner](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/Banner1.png)

# UltimateTweak *A powerful, modular, and highly customizable quality-of-life plugin for modern Minecraft servers.* UltimateTweak is an **advanced gameplay enhancement framework** for Spigot, Paper, and Folia, built to improve everyday survival gameplay without forcing server owners into a fixed setup. Every tweak has its own configuration file and can be **enabled, disabled, and customized independently**. From automatic tool selection and vein mining to animated tree cutting, improved dropped-item displays, dynamic lighting, and custom automation, UltimateTweak gives you full control over how each feature behaves. Unlike basic tweak plugins, UltimateTweak focuses on **deep configuration, custom-item compatibility, protection support, and reusable action and condition systems**, allowing every feature to fit naturally into your server. ## Features ### Animated Tree Cutter * Detect and cut entire trees with one configurable mining process. * Built-in falling-tree animation with configurable direction, duration, glow, and view distance. * Optional falling-tree damage for nearby players and entities. * Configurable mining time based on the number of logs in the tree. * Optionally break leaves when the player uses a matching item. * Run custom actions while damaging the tree or after it is completely cut. * Includes definitions for common Overworld trees, Nether fungi, and custom-tree examples. * Create custom tree definitions with configurable logs, leaves, radius, height, and size limits. * Glow the whole tree while breaking the tree. * Support custom trees from the CraftEngine plugin. * Built-in debug command helps explain why a tree definition passes or fails.

![Animated Tree Cutter](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/TreeCutter.gif)

### Vein Mining * Mine connected ore veins in one operation. * Configure which tools and blocks can trigger each vein-mining rule. * Supports diagonally connected blocks and configurable search limits. * Configurable mining-time scaling keeps large veins balanced. * Use glow effects to preview the blocks being mined. * Supports custom actions, conditions, custom tools, and custom blocks.

![Vein Mining](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/VeinMine.gif)

### Best Tool Selection * Automatically selects the most effective tool for the block being mined. * Choose whether to search the player's hotbar or entire inventory. * Scores tools using destroy speed, Efficiency, preferred-tool status, and Fortune. * Configure detection cooldowns and Fortune scoring behavior. * Supports custom conditions and actions after switching tools.

![Best Tool Selection](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/BestTools.gif)

### Dynamic Light * Creates real-time light near players based on held items. * Checks both the main hand and off hand. * Configure independent item-matching rules and light levels from 0 to 15. * Supports vanilla items, advanced item rules, and many custom-item plugins.

![Dynamic Light](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/DynamicLight.gif)

### Better Drop Display * Transforms settled dropped items into clean `ItemDisplay` visuals while preserving the real item entity and its normal pickup behavior. * Automatically restores vanilla item rendering whenever an item starts moving and reapplies the display after it settles. * Lays dropped items flat on the ground with configurable scale, translation, and X, Y, and Z rotation. * Supports a stable randomized yaw for each dropped item, giving item piles a more natural appearance. * Automatically calculates the correct surface height using collision shapes. * Correctly positions items on snow layers, carpets, slabs, trapdoors, and other non-full blocks. * Optional floating label displays the item's native or custom name and stack amount. * Configure settling delay, movement threshold, full-bright rendering, view range, interpolation, shadow radius, and shadow strength.

![Better Drop Display](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/DropDisplay.gif)

### Double Door * Open and close matching double doors together with one right-click. * Detects paired doors by type, facing direction, and opposite hinge side. * Optional smooth `BlockDisplay` door animation with configurable duration, interval, and view distance. * Can also animate single wooden doors when enabled in the tweak configuration. * Respects configured conditions and supported protection plugins before allowing door interaction.

![Double Door](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/DoubleDoor.gif)

### Biome Announcer * Notify players when they enter a new biome. * Configure which biomes should trigger announcements, or leave the list empty to support all biomes. * Use global or per-biome messages, including ready-to-use Terralith biome examples. * Supports custom conditions and actions when the player's biome changes. * Provides placeholders such as `{biome}`, `{from-biome}`, `{to-biome}`, and translated biome names on Paper.

![Biome Announcer](https://raw.githubusercontent.com/ManyouTeam/UltimateTweak/refs/heads/master/show/BiomeAnnouncer.gif)

### Structure Announcer * Notify players when they enter generated structures such as villages, monuments, mineshafts, trial chambers, and more. * Configure which structures should trigger announcements, or leave the list empty to support all structures. * Supports namespaced IDs such as `minecraft:village_plains` and custom datapack structure IDs. * Use global or per-structure messages, with built-in examples for vanilla and Terralith structures. * Run custom conditions and actions when entering a structure, with placeholders such as `{structure}`, `{from-structure}`, and `{to-structure}`. ### Structure Auto Protection * Automatically creates protection regions for generated structures around online players. * Uses each structure's real bounding box and supports configurable vertical expansion. * Choose the protection hook used to create regions, including supported region protection plugins. * Configure structure filters, scan intervals, generated region ID prefixes, and debug output. * Helps protect villages, dungeons, ruins, and custom datapack structures without manual region setup. ### Automatic Tree Replanting * Automatically plants dropped saplings when they land on valid soil. * Configure sapling items, placed blocks, valid soils, check intervals, and wait times. * Includes ready-to-use rules for common Overworld trees, mangroves, azaleas, and more. * Supports custom saplings and custom blocks for deeply customized servers. ### Entity Vehicle Restriction * Prevent matched living entities from entering boats or minecarts. * Enable restrictions independently for supported vehicle types. * Use advanced entity matching to target only the mobs your server needs. * Supports vanilla entities and integrations such as MythicMobs and LevelledMobs. ### Modular Configuration * Every tweak has its own clean configuration file and independent enabled option. * Enable only the gameplay improvements that fit your server. * Configure cooldowns, triggers, matching rules, limits, animations, effects, and behavior. * Configure independent world whitelists or blacklists for every tweak. * Reload the main config, tweaks, tree definitions, and languages with one command. * Advanced language management system. ### Powerful Item & Block Compatibility * Direct custom-item support for ItemsAdder, Oraxen, Nexo, MMOItems, EcoItems, EcoArmor, MythicMobs, ExecutableItems, CraftEngine, NeigeItems, eco, and more. * Custom-block support for CraftEngine, Oraxen, Nexo, ItemsAdder, and vanilla blocks. * Advanced item matching supports materials, tags, names, lore, enchantments, rarity, NBT, custom-item plugins, and logical rules. ### Protection Plugin Support * Automatically respects supported region and claim protection plugins. * Supports WorldGuard, Residence, Towny, Lands, PlotSquared, GriefPrevention, HuskClaims, HuskTowns, Dominion, SuperiorSkyblock2, and BentoBox. * Includes a dedicated bypass permission for trusted players and administrators. ### Action & Condition Engine * Add custom behavior to supported tweaks without writing code. * Conditions can check biomes, permissions, placeholders, worlds, `ANY` logic, and `NOT` logic. * Actions support messages, titles, action bars, particles, sounds, effects, commands, teleporting, entity spawning, chance, delay, and conditional execution. * Combine reusable rules to make each tweak behave differently for specific players, worlds, or situations.

UltimateTweak

Совместимость

Minecraft: Java Edition

Платформы

Поддерживаемые окружения

Ссылки

Детали