⚔️ PVP Tweaks (in development, beta)
PVP Tweaks consolidates essential combat, HUD, and visual utilities into one high-performance, client-side mod for Minecraft 1.21.4–26.X.
Clicking the in-game "PVP Tweaks" button opens a dedicated hub screen with intuitive tabs for Item Sizes, Visuals, HUD, Sounds, Optimization, Profiles, and Info. Fine-tune totems, shield positioning, fire overlays, crystals, respawn anchors, animations, particles, sounds, custom crosshairs, and more-all from one clean interface.
⚠️ Note to Players & Server Admins: This mod is designed purely for Quality-of-Life (QoL). It does not provide any cheats, automation, or unfair advantages. It simply allows you to fine-tune your client's visuals and responsiveness to ensure your game runs smoothly in competitive environments.
🕹️ How to Use
- Accessing the Config:
- In-Game: Press the configured keybind to open the PVP Tweaks hub screen.
- Mod Menu: Select PVP Tweaks from your mods list and click Configure.
- HUD Adjuster: Click Adjuster buttons inside the config to drag and reposition HUD elements freely on your screen.
- Sound Picker: Open the Sound Picker in any category, preview or search for sounds (or import your own), adjust pitch, and save.
- Profiles: Save your entire setup and easily share it using clipboard import/export strings.
✨ Core Features
📊 HUD Utilities
Fully customizable HUD elements with real-time editing:
- CPS HUD: Left/Right CPS tracker with custom scale, position, color, text shadow, and a "Smart Rainbow" mode.
- Armor Durability HUD: Tracks worn armor and held items. Includes low-durability blink alerts and custom sound triggers.
- Coordinates & Potion Effects: Displays current position and active status effects with full scale/position adjustments.
- Crosshair Editor: Custom crosshairs with color, size, opacity, outlines, and crosshair code import support (e.g., CS2 codes).
- Item Background: Toggle and customize background rendering in inventory slots.
- Hotbar Slot Labels: Display keybind hints or numbers directly on hotbar slots.
- Live Adjusters: Drag and drop HUD elements anywhere on screen with interactive visual editors.
🔊 Audio & Visual Control
- Sound Profiles: Profile-based sound replacement system with an integrated picker and per-profile sound packs.
- Sound Picker: In-game browser for all vanilla sound events with live previewing and pitch adjustments (Explosions, Combat, Misc, and Custom).
- Custom Sounds: Directly import
.mp3,.ogg,.wav, or.flacaudio files without creating a resource pack. (Note: Legacy versions ≤1.4.8 require ffmpeg installed). - Durability Alerts: Set custom sound warnings for low-durability armor and tools.
- Per-Event Volume Sliders: Independent volume controls for End Crystals, Respawn Anchors, TNT, hits, and other actions.
- Explosion Particles: Fine-tune particle opacity/count for TNT, Creepers, Beds, Ghasts, and Wind Charges.
👁️ Visual Adjustments
-
Fire Block Height: Preset heights (Vanilla, Mid, Low, Flat, or None).
-
Fire Overlay: Adjust the screen fire overlay scale from
0%to200%. -
Fullbright: Integrated gamma customization screen for clear visibility in dark areas.
-
Pumpkin Blur: Toggle the carved pumpkin screen overlay.
-
Shield Adjuster: Real-time positioning and rotation tweaking for held shields.
-
Plants Control: Client-side rendering controls for tall grass and plants.
-
Entity & Animation Scaling:
-
Totem pop animation scale (
0–200%). -
End Crystal entity scale (
25–300%). -
Potion Color Override: Change indicator colors for active potion effects.
-
GUI Tweaks: Toggle background blur and enable smooth scrolling in menus.
🛡️ Item Sizes & Custom Scaling
- Global Scale: Master scale slider for all held items (
25-300%). - Per-Item Sliders: Individual scaling for Swords, Axes, Maces, Tridents, Shields, Armor, Bows, Crossbows, Totems, Golden Apples, Respawn Anchors, and Misc items.
- Flexible Scaling Modes:
- Listed Mode: Only scales items explicitly configured.
- Unlisted Mode: Scales everything except configured exceptions.
- Custom Mode: Interactive per-item search and configuration screen.
🎨 Modern UI & Experience
- Hub Screen: Sleek, tabbed interface with clean rounded panels and controls (8px border radius).
- Zoom Utility: Configurable smooth or instant zoom with customizable FOV and scroll sensitivity.
- Profile System: Save, load, import, and export entire configurations via system clipboard or the dedicated profiles folder.
🚀 Performance Optimizers (Experimental feature)
Designed to mitigate ping and latency effects for a smoother combat experience:
- Crystal Optimizer: Client-side immediate removal of End Crystal entities upon attack, allowing for zero-delay re-placement.
- Anchor Optimizer: Instantly replaces exploded Respawn Anchors with a client-side placeholder (Fern) to keep the coordinate clear for immediate placement before server confirmation.
- Fairness Guarantee: Strictly visual and client-side collision tweaks that do not interfere with server-side logic.
📥 Installation & Dependencies
- Download and install Fabric Loader.
- Download and place Fabric API into your
.minecraft/modsfolder. - Place
pvp-tweaks.jarinto your.minecraft/modsfolder.
| Dependency | Required / Optional | Notes |
|---|---|---|
| Fabric Loader | Required | Version ≥0.18.4 |
| Fabric API | Required | All supported MC versions |
| Mod Menu | Optional | Adds a "Configure" button directly in your Mods list |
| Cloth Config | Optional | Additional configuration backend support |
🛠️ Issues, Support & Development
-
Issue Tracker:
-
Direct Contact: Reach out via email at
[email protected]
💡 Notes on AI Development
AI assistance was utilized during development to optimize workflow; all code has been line-by-line reviewed, tested, and verified for security and stability by a human developer.
I decided to pause the development of this project, so that I could have time to acquire real coding skills, instead of just using AI every time I get a little stuck. I fully support the platform's new AI policy.
💡 Notes on Compatibility & Testing
Primary testing is conducted on Minecraft 26.2-1.21.11 (Linux Mint, GNOME, X11). All other supported versions are currently in Beta - while core features should function normally, minor version-specific variations may occur. I need beta testers please contact me on Discord: vipertrick
Note on Development & Release The mod hasn't really been officially released yet, it's still in development. It will only be called "Release" after version 2.0.0 (it will probably be reset to "R1.0.0")
📌 License & Code Usage
This project is published under GNU General Public License v3.
Contact me for any further requests.
Custom for all item sizes in the game
You can choose custom sounds for things related to PVP, you can choose a sound that exists in Minecraft vanilla or import your own.
The mod adds a feature that allows you to share its settings, profiles and Minecraft keybinds with Import and Export.
You can fully customize the height of the fire overlay.
You can fully customize the size of the crystals, particles, and sound.
You can adjust sounds, animation size, and particles, according to your personal preference.
You can completely customize the fire height.
Launch the game → Join a server or single player → click ESC → click PVP Tweaks
You can fully customize anchors, particles, and sound.
Special, fully custom Armor HUD, with break and flicker alert
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
pvp tweaks 1.9.4-mc1.21.11 1.9.4-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.9.4-mc26.1.x 1.9.4-mc26.1.x |
26.1, 26.1.1, 26.1.2
|
fabric
|
Download |
|
pvp tweaks 1.9.4-mc26.2 1.9.4-mc26.2 |
26.2
|
fabric
|
Download |
|
pvp tweaks 1.9.3-mc26.1.x-beta-XP 1.9.3-mc26.1.x-beta |
26.1, 26.1.1, 26.1.2
|
fabric
|
Download |
|
pvp tweaks 1.9.3-mc1.21.11 1.9.3-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.9.3-mc26.2-beta 1.9.3-mc26.2 |
26.2
|
fabric
|
Download |
|
pvp tweaks 1.9.1-mc1.21.9 1.9.1-mc1.21.9 |
1.21.9
|
fabric
|
Download |
|
pvp tweaks 1.9.1-mc1.21.10 experimental 1.9.1-mc1.21.10 |
1.21.10
|
fabric
|
Download |
|
pvp tweaks 1.9.1-mc1.21.11 1.9.1-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.9.0-mc1.21.11 1.9.0-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.8.9-mc1.21.11 1.8.9-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.8.7-1.21.9 1.8.7-1.21.9 |
1.21.9
|
fabric
|
Download |
|
pvp tweaks 1.8.7-1.21.10 1.8.7-1.21.10 |
1.21.10
|
fabric
|
Download |
|
pvp tweaks 1.8.7-beta-mc1.21.11 1.8.7-release-mc1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp-tweaks-1.8.0-forMC-1.21.8 1.8.0-1.21.8-Beta |
1.21.8
|
fabric
|
Download |
|
pvp-tweaks-1.8.0-forNC-1.21.9 1.8.0-1.21.9-Beta |
1.21.9
|
fabric
|
Download |
|
pvp tweaks-1.8.0-forMC-1.21.10 1.8.0-1.21.10-Beta |
1.21.10
|
fabric
|
Download |
|
pvp tweaks 1.8.0-forMC-1.21.11 1.8.0-1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.7.7-1.21.11 1.7.7-1.21.11-beta |
1.21.11
|
fabric
|
Download |
|
pvp-tweaks-1.4.8-forMC-1.21.1 1.4.8-1.21.1 |
1.21.1
|
fabric
|
Download |
|
pvp tweaks 1.4.8 1.4.8-1.21.6 |
1.21.6
|
fabric
|
Download |
|
pvp tweaks 1.4.8 1.4.8-1.21.5 |
1.21.5
|
fabric
|
Download |
|
pvp tweaks 1.4.8 1.4.8-1.21.4 |
1.21.4
|
fabric
|
Download |
|
pvp tweaks 1.4.8 1.4.8-1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.4.0 1.4.0-1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.2.0-beta 1.2.0-beta-1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.0.0 1.0.0-1.21.11 |
1.21.11
|
fabric
|
Download |
|
pvp tweaks 1.0.0 1.0.0-1.21.11 |
1.21.11
|
fabric
|
Download |