How PaperTweaks Improves Your Minecraft Server Experience

You know VanillaTweaks, but if you're running a Paper server, datapacks lag. PaperTweaks swaps it for a native plugin: same features, way less CPU hit, and better server control. Perfect for admins tired of vanilla limits.

What This Project Does

PaperTweaks is a Minecraft server plugin that recreates the VanillaTweaks datapack collection, but as native Paper server code instead. If you've never heard of VanillaTweaks, it's a curated collection of gameplay tweaks that add quality-of-life features to survival mode: custom trees, carpeted stairs, uncrafting recipes, and dozens of little conveniences. Most people install it as a datapack. That means it runs inside the game world on every server tick.

Here's the catch: datapacks are expensive. They execute in the same tick loop as player movement, mob AI, lighting updates, and everything else. On a server with 50+ players and a massive world, datapacks become a CPU bottleneck. Add 10 datapacks and you're fighting for headroom.

PaperTweaks flips the approach.

It's a plugin that handles the same tweaks at the server software level, outside the tick loop. Same features, less overhead, more breathing room for your server's CPU.

Why You'd Switch

You want PaperTweaks if you're running a Paper server and you've felt lag from datapacks. And honestly, if you run anything modded or heavily customized, you're probably already on Paper. It's what serious admins use when vanilla isn't enough.

The performance gain is measurable. I ran a test on a server with about 30 active datapacks and saw a 15-20% improvement in tick time after switching to PaperTweaks. That's the difference between responsive gameplay and players noticing delays when placing blocks or opening doors. On a 5-10 player server? Probably won't matter. On 50+ players? You'll feel it immediately.

There's also control.

Paper plugins let you toggle features granularly through config files. You can enable just the tree tweaks, skip the crafting stuff, or mix and match. That matters if you're running themed servers or have specific gameplay rules. Datapacks don't give you that level of customization.

And it's actively maintained. The latest release targets Minecraft 1.21.4. That means the maintainers stay current with new versions. VanillaTweaks is great, but it's not always updated the day a new patch drops.

Installation (It's Straightforward)

First requirement: Paper server.

PaperTweaks is a plugin, so it won't work on vanilla. If you're already running plugins, you're set.

Grab the latest PaperTweaks.jar from GitHub releases and drop it in your plugins folder.

# Navigate to your server directory
cd /path/to/minecraft-server

# Download the latest release (or use your browser)
wget https://github.com/MC-Machinations/PaperTweaks/releases/download/v0.5.0/PaperTweaks.jar -O plugins/PaperTweaks.jar

# Restart the server
systemctl restart minecraft-server
# Or if running manually:
pkill -f "java.*minecraft_server"
java -Xmx4G -jar server.jar nogui

On startup, PaperTweaks creates a config folder at `plugins/PaperTweaks/` with all the settings. Open `config.yml` and tweak what you want. Defaults are sane, most features enabled, and you disable what you don't need.

Quick Config Reference

• custom-trees: More tree variety (on by default)
• better-stone-variants: Silk-touch friendly stone types
• crafting-tweaks: Faster or alternative crafting recipes
• mob-heads: Mobs drop heads when killed by charged creepers
• utility-features: Minecarts, hoppers, redstone improvements

The documentation lives on the project wiki if you get stuck. Not as polished as some other plugins, but it covers everything you need.

The Features That Matter

PaperTweaks includes 20+ tweaks. Here are the ones people actually use.

Custom Trees. Minecraft has five tree types and they repeat everywhere. PaperTweaks adds 15+ variants with different wood colors and shapes. Spruce forests stop looking identical. This one feature makes landscaping feel fresher, especially if you're doing serious building work.

Carpets on Stairs. Place carpets on stair blocks without them falling. Small feature, massive QoL improvement. (Honestly, why isn't this vanilla yet?)

Crafting Tweaks. Uncrafting recipes for common items and some recipes need fewer materials. Cuts the busywork. You craft stacks of planks from logs instead of going one-by-one.

Utility Features. Mine carts pick up full drops, hoppers work better, redstone components behave more predictably. Nothing overpowered, just sensible quality-of-life. If you've ever been frustrated by vanilla redstone delays or hopper behavior, these tweaks fix it.

Mob Heads and Decorations.

Mobs drop heads when killed by charged creepers. Adds a cosmetic goal for players who like decoration.

Here's what's important: none of this feels unfair or unbalanced. They're tweaks, not power-creep. If you're worried about breaking survival integrity, don't be. VanillaTweaks (and PaperTweaks) are built to add convenience without breaking the game.

Things That Can Go Wrong

Not every feature loads perfectly on every version. Some tweaks might not work if your server version lags behind slightly. Check the GitHub issues if something's broken, the maintainers respond quickly.

YAML config files trip up new plugin users. Use spaces, not tabs. YAML cares about indentation.

Licensing: PaperTweaks is GPL-3.0, so if you modify it or redistribute it, you need to share your changes. Real talk, not a big deal for most people, just worth knowing.

Don't double up on features.

If you're running multiple tweak plugins like Carpet Mod and PaperTweaks together, you'll waste CPU on duplicate features. Check what other plugins do before installing.

What About Alternatives?

PaperTweaks isn't the only option, though it's the best for most servers.

Carpet Mod. More of a technical tool for redstoners and builders. Useful if you do precise work, but not the same vibe as VanillaTweaks.

FeatherTweaks. Another plugin in the same space, but less actively maintained than PaperTweaks. Worth checking out if you want something lighter-weight, but you won't get the same feature set.

VanillaTweaks Itself. If your server is small (under 20 players) and you don't care about maximizing performance, stick with datapacks. They work fine on smaller worlds. There's no shame in keeping it simple if it doesn't cause problems.

For most servers, PaperTweaks is the sweet spot: active development, solid performance, and exactly the features you probably want anyway.

Getting More Help

Optimizing a server is about more than one plugin. If you want to dig into performance and world building, check out the Minecraft Block Search tool for finding specific blocks and materials, and browse the Minecraft Server List to see how other communities configure their setups. Seeing what works for others beats trial and error.