⚔️ 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
💡 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.
💡 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")
🤙Talk to me
Discord: vipertrick
mail: yag.fvt@gmail.com
📌 License & Code Usage
This project is published under GNU General Public License v3.
Contact me for any further requests.
How to Install PVP Tweaks (Mod)
PVP Tweaks by ViperT is verified for Fabric across Minecraft versions 1.21.1, 1.21.10, 1.21.11, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.9 (latest release: 1.9.4-mc1.21.11, file size: 413 KB). Follow the steps below to install it safely from ModCraft.tv:
- Click the Download button above and select your Minecraft version (1.21.1, 1.21.10, 1.21.11, 1.21.4, 1.21.5, 1.21.6, 1.21.8, 1.21.9) and platform (Fabric).
- Make sure you have the compatible loader or environment installed for Fabric.
- Move the downloaded PVP Tweaks file into your Minecraft
.minecraft/modsfolder and launch the game.
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 24d ago | 1 | ||||
| 24d ago | 1 | ||||
| 25d ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 |
### Added
- Shield Adjuster: sample shield** - "Show Sample Shield" toggle displays a shield in the off-hand while the adjuster is open, so scale/position changes are visible in real time
- Shield Adjuster: Active Pose** - "Active Pose" toggle shows the sample shield in the blocking pose
### Changed
- Removed the "Full" fire block height preset (presets are now vanilla/mid/low/flat/none)
- Updated mod version to 1.9.4 across all supported Minecraft versions
### Added
- Fire Block Height controls** — presets (vanilla/full/mid/low/flat/none) now directly control fire block height; renamed from "Entity Fire Height" to "Fire Block Height"
- Disabled widget styling** — buttons and sliders render grayed out when inactive
- Flash hint on disabled crosshair settings** — clicking a disabled crosshair control briefly highlights the "Custom" toggle
### Changed
- Fire block height preset changes now only apply via "Save Fire" button or "Done" (no auto-reload on preset cycle)
- "Save Fire" button now only triggers chunk rebuild (no resource pack reload)
- Auto-reload tick handler removed (was causing unwanted reloads on preset change)
- Updated mod version to 1.9.3 across all supported Minecraft versions
### Fixed
- GUI buttons no longer visible above the title bar when scrolling
- Crosshair Adjuster: removed the center vertical divider bar
- Crosshair Adjuster: all settings are locked when Custom is toggled OFF
(experimental)
(experimental)
### Added
- Modern GUI** — rounded corners (radius 8) across all buttons, sliders, and tabs with proper circular-arc rendering
- Explosion particle controls** — per-type sliders for TNT, Creeper, Bed, Ghast, and Wind Charge particles
- Pitch control in sound picker** — pitch/tempo slider moved to the top of the sound picker screen
### Changed
- Updated mod version to 1.9.1 across all supported Minecraft versions (1.21.4–1.21.11)
### Added
- Crosshair Tweak** (HUD tab) — custom crosshair with color, size, and transparency adjustments; supports importing crosshair codes from other games (e.g. CS2)
- Info tab** — new tab with mod description, version, author, clickable links (GitHub, Issues, Modrinth), and contact information
- Global "Item Size" slider** — global item scaling control
### Fixed
- Hotbar labels not displaying correctly
- Item background rendering
- Scrolling behavior in menus
- Various crosshair tweak issues
### Changed
- Updated mod version to 1.9.0 across all supported Minecraft versions (1.21.4–1.21.11)
- Bug fixes.