PolyPatcher
A Forge mod full of Vanilla bug fixes, Quality of Life improvements, and performance enhancements.
PolyPatcher
PolyPatcher
<img src="https://wsrv.nl/?url=https%3A%2F%2Fpolyfrost.org%2Fimg%2Fcompact_vector.svg&n=-1&w=1000" width=56 />
PolyPatcher is a Forge mod for 1.8.9 & 1.12.2 created to improve your all-around Minecraft experience, bringing tons of Quality of Life additions, performance improvements, and tons of Vanilla bug fixes.
This work, "PolyPatcher", is adapted from "Patcher" by Sk1erLLC, used under CC BY-NC-SA 4.0. "PolyPatcher" is licensed under CC BY-NC-SA 4.0 by Polyfrost. This is a fork of Sk1erLLC's original mod, adding various changes and improvements as well as using OneConfig instead of Essential. For the original, please go here to download the mod.
Feature List
Bug Fixes
Bug Fixes
- OptiFine Custom Sky Fix - Resolve Vanilla shaders being cleared when changing perspective. *default - OptiFine Custom Sky Fix - Resolve the camera being too far back, seemingly making your eyes be in the back of your head. (Currently makes the F3 crosshair disappear.) OptiFine Custom Sky Fix. - OptiFine Custom Sky Fix - Resolve false negatives in frustum culling, creating invisible chunks in some cases. (Can negatively impact performance.) %%MD1%% & %%MD2%% - OptiFine Custom Sky Fix - Resolve players sometimes not having a hat layer in Tab. *default - OptiFine Custom Sky Fix - Resolve the black box around the player while in the void. *default - OptiFine Custom Sky Fix - Resolve Alex-model arms being shifted down further than Steve-model arms. *default - OptiFine Custom Sky Fix *(not in original)* - Adds the dark background to the book GUI like all other containers/menus. - OptiFine Custom Sky Fix - Resolve an exploit in 1.8 allowing servers to look through directories. *default - OptiFine Custom Sky Fix - Resolve forge changing vanilla chest behavior. *default - OptiFine Custom Sky Fix *(not in original)* - Amends a Forge bug causing item sides to have incorrect lighting compared to Vanilla 1.8. *default - OptiFine Custom Sky Fix *(toggle not in original)* - Resolve OptiFine creating a "black box" effect at the bottom of the sky when using custom skies. Changes the rendering of the normal sky. *default
Experimental
Experimental
- Cache FPS *(not in original)* - Cache Forge mod entry points, improving startup time as Forge no longer needs to walk through every class to find the @Mod annotation. Requires two restarts to take full effect. *default - Cache FPS *(not in original)* - Remove transparent pixels on skins instead of turning them black. - Cache FPS - Reuse frames from the HUD instead of constantly recreating them every frame, as most HUD elements will stay the same for a long amount of time. (This may cause stuff with animations to feel "choppy".) - Cache FPS *(not in original)* - The amount of frames to cache for the HUD.
Miscellaneous
Miscellaneous
- Fix Action Bar Overlap - Stop plants/flower from rendering. - Fix Action Bar Overlap - Replace the selection box for crops with the 1.12 variant. (Only works on Hypixel & Singleplayer) *default - Fix Action Bar Overlap *(not in original)* - Exclude cacti from the 1.12 selection box changes, as it would actually shrink rather than increase in size. *default - Fix Action Bar Overlap *(not in original)* - Remove FOV change when underwater. *default - Fix Action Bar Overlap - Allow for modifying FOV change states. - Fix Action Bar Overlap - Modify your FOV when sprinting. - Fix Action Bar Overlap *(not in original)* - Modify your FOV when flying. - Fix Action Bar Overlap - Modify your FOV when pulling back a bow. - Fix Action Bar Overlap - Modify your FOV when having the speed effect. - Fix Action Bar Overlap - Modify Your FOV when having the slowness effect. - Fix Action Bar Overlap - Makes keys re-register when closing a GUI, like in 1.12+. (Does not work on macOS due to LWJGL issues) *default - Fix Action Bar Overlap - Separate reloading resources into reloading sounds (F3+S) and reloading textures (F3+T). - Fix Action Bar Overlap - Remove the ability to scroll through your hotbar. - Fix Action Bar Overlap *(not in original)* - Change the direction of scrolling in your hotbar. - Fix Action Bar Overlap *(not in original)* - Prevent from directly scrolling between the first and last hotbar slot. - ~~Fix Action Bar Overlap - Remove the crosshair when in third person.~~ (replaced by Fix Action Bar Overlap) - Fix Action Bar Overlap - Change the volume of sounds when you're not tabbed into the window. - Fix Action Bar Overlap - Toggle changing your FPS to whatever Unfocused FPS is set to when not tabbed into the window.Fix Action Bar OverlapUnfocused FPS AmountFix Action Bar OverlapLog OptimizerFix Action Bar OverlapLog Optimizer AmountFix Action Bar OverlapBetter Camera** - Stop tall grass, plants, reeds, etc. from affecting your FOV as done in 1.14+. *default - Fix Action Bar Overlap - Hide nametags when in F1 mode. *default - Fix Action Bar Overlap - While using View Bobbing, only remove the view aspect but have the hand still bounce around. - Fix Action Bar Overlap - While using View Bobbing, remove the hand bobbing when holding a map. - Fix Action Bar Overlap - Stop items from bobbing up and down when dropped on the ground. - Fix Action Bar Overlap - Open a separate GUI allowing you to mute or amplify individual sounds. - Fix Action Bar Overlap *(not in original)* - Changes some physics in capes to fix rotation bugs and look more natural. - Fix Action Bar Overlap *(not in original)* - Smoothly scrolls through vanilla Minecraft GUIs. - Fix Action Bar Overlap - Scroll when using OptiFine's zoom to adjust the zoom level. *default - Fix Action Bar Overlap - Remove the smooth camera effect when using zoom. - Fix Action Bar Overlap - Keep your hand on screen when you zoom in. - Fix Action Bar Overlap - Use a custom mouse sensitivity value when zoomed in. This is a percentage of your normal sensitivity. - Fix Action Bar Overlap - Reduce your mouse sensitivity the more you zoom in. - Fix Action Bar Overlap - Add a smooth animation when you zoom in and out. - Fix Action Bar Overlap - Add a smooth animation when you scroll in and out while zoomed. - Fix Action Bar Overlap - Change the smoothing function used in the smooth zooming animation. - Fix Action Bar Overlap - Make OptiFine's zoom key a toggle instead of requiring you to hold it. - Fix Action Bar Overlap - Remove the additions OptiFine L5 and above makes to the debug screen fps counter. *default - Fix Action Bar Overlap - Replace OptiFine's ALT+F3 metrics renderer with the Vanilla renderer. *default - Fix Action Bar Overlap *(not in original)* - Changes the distortion effects (e.g. Nausea and nether portal distortion). - Fix Action Bar Overlap - Remove achievement notification. - Fix Action Bar Overlap - Change the height of the fire overlay. - Fix Action Bar Overlap - Change the opacity of the fire overlay. - Fix Action Bar Overlap - Hide the fire overlay when you have fire resistance active. The overlay will blink 5 seconds before your fire resistance is about to run out. - Fix Action Bar Overlap *(not in original)* - Change the opacity of the pumpkin overlay. - Fix Action Bar Overlap - Remove the water texture overlay when underwater. - ~~Fix Action Bar Overlap - Remove the inverted color effect on the crosshair.~~ (replaced by %%MD1%%) - Fix Action Bar Overlap - Remove lighting updates, increasing visibility. (Can positively impact performance. May conflict with minimaps) *default - Fix Action Bar Overlap - Automatically Disable the Fullbright Effect when using OptiFine Shaders. (Requires Fullbright) *default - Fix Action Bar Overlap *(not in original)* - Completely disables the effects of night vision. - Fix Action Bar Overlap *(not in original)* - Makes the night vision effect fade out instead of a flashing effect. - ~~Fix Action Bar Overlap - See your nametag in third person.~~ (replaced by %%MD2%%) - Fix Action Bar Overlap - Show projectiles 2 ticks after they're shot up to stop them from obstructing your view. (Includes eggs, snowballs, and fishing hooks) - Fix Action Bar Overlap - Change the opacity of the horse you're currently riding for visibility. - Fix Action Bar Overlap *(not in original)* - Changes the fog density in water to improve visibility. - Fix Action Bar Overlap - Don't render the aura around a wither when it is invisible. - Fix Action Bar Overlap - Use readable numbers instead of Roman numerals on enchants. - Fix Action Bar Overlap - Generate Roman Numeral from enchantment/potion level instead of using language file. *default - ~~Fix Action Bar Overlap - Stop rendering your potion effect particles.~~ (replaced by %%MD3%%) - ~~Fix Action Bar Overlap - Remove block-breaking particles for visibility.~~ (replaced by %%MD4%%) - Fix Action Bar Overlap - Stop lightning bolts from rendering. - Fix Action Bar Overlap - Change the text-shadow to only move down rather than move to the side. - ~~Fix Action Bar Overlap - Render nametag with shadowed text.~~ (replaced by %%MD5%%) - ~~Fix Action Bar Overlap - Render actionbar messages with shadowed text.~~ (replaced by %%MD6%%) - ~~Fix Action Bar Overlap - Render a background behind the actionbar.~~ (replaced by %%MD7%%) - Fix Action Bar Overlap - Remove shadows from text. (Can positively impact performance). - Fix Action Bar Overlap - Render the first-person hand on the left of the screen. - ~~Fix Action Bar Overlap - Hold tab open without needing to hold down the tab key.~~ (replaced by %%MD8%%) - ~~Fix Action Bar Overlap - Show a readable ping number in tab instead of bars.~~ (replaced by %%MD9%%) - ~~Fix Action Bar Overlap - Stop titles from appearing.~~ (replaced by %%MD10%%) - ~~Fix Action Bar Overlap - Set the scale for titles.~~ (replaced by %%MD11%%) - Fix Action Bar Overlap - Automatically scale titles if the title goes over the screen. - ~~Fix Action Bar Overlap - Change the opacity of titles.~~ (replaced by %%MD12%%) - Fix Action Bar Overlap - Implement Windowed Fullscreen in Minecraft, allowing you to drag your mouse outside the window. - Fix Action Bar Overlap - Instant switching between fullscreen and non-fullscreen modes. - ~~Fix Action Bar Overlap - Prevents action bar text from overlapping with armor or health bars.~~ (replaced by %%MD13%%)
Performance
Performance
- Batch Model Rendering - Check to see if an entity is visible to the player before attempting to render them. *default - Batch Model Rendering - The amount of time in ms between occlusion checks for entities. Shorter periods are more costly toward performance but provide the most accurate information. Lower values are recommended in competitive environments. - Batch Model Rendering - Disable Entity Culling effect when using OptiFine shaders. (Due to the way OptiFine shaders work, we are unable to make Entity Culling compatible). *default - Batch Model Rendering *(not in original)* - Continue to render Ender Dragons when the entity is being occluded. - Batch Model Rendering *(not in original)* - Continue to render Withers when the entity is being occluded. - Batch Model Rendering - Continue to render Player Nametags when the entity is being occluded. *default - Batch Model Rendering - Continue to render Entity Nametags when the entity is being occluded. *default - Batch Model Rendering - Continue to render Armorstand Nametags when the entity is being occluded. *default - Batch Model Rendering - Don't cull armor stands that have a specific rule assigned to them. This will result in a lot of non-occluded armor stands in places like Hypixel Skyblock, but will resolve special entities being occluded when they typically shouldn't be. - Batch Model Rendering - Stop rendering sides of entities that you cannot see. Being inside an entity will cause that body part to be invisible. (Some models may have a transparent face and will cause the back face to not show, such as Wither Skeletons.) - Batch Model Rendering - Stop rendering sides of players that you cannot see. Being inside a player will cause that body part to be invisible. - Batch Model Rendering - Stop armor stands from rendering. (Armor stands are commonly used for NPC nametag rendering. Enabling this will stop those from rendering as well) - Batch Model Rendering - Stop semitransparent players from rendering. - Batch Model Rendering - Stop enchantment table books from rendering. - Batch Model Rendering - Stop item frames from rendering. - Batch Model Rendering - Stop item frames only with maps as their item from rendering. - Batch Model Rendering - Stop arrows that are in the ground from rendering. - Batch Model Rendering - Stop arrows that are attached to a player from rendering. - Batch Model Rendering - Stop skulls from rendering. - Batch Model Rendering *(not in original)* - Stops falling blocks from rendering. - ~~Batch Model Rendering - Remove the transparent box around the nametag.~~ (replaced by Batch Model Rendering) - Batch Model Rendering - Render stacks of items on the ground as just one instead of having up to 5 copies in one stack. - Batch Model Rendering - Toggle allowing a custom entity render distance. - Batch Model Rendering *(not in original)* - Stop rendering tile entities outside of a specified radius. - Batch Model Rendering - Stop rendering hostile entities outside a specified radius. - Batch Model Rendering - Stop rendering passive entities outside a specified radius. - Batch Model Rendering - Stop rendering player entities outside a specified radius. - Batch Model Rendering - Stop rendering all entities outside a specified radius. This will ignore the distance of other entity render distances if smaller. - Batch Model Rendering - Stop end portals from rendering. - Batch Model Rendering - Disable the enchantment glint. - ~~Batch Model Rendering - Disable particle lighting checks each frame. *default~~ (replaced by %%MD1%%) - ~~Batch Model Rendering - Stop additional particles from appearing when there are too many at once.~~ (replaced by %%MD2%%) - Batch Model Rendering - Change all pack icons to 64x64 to reduce memory usage. *default - Batch Model Rendering - Use modern rendering techniques to improve font renderer performance. *default (%%MD3%%) - Batch Model Rendering - Cache font data, allowing for it to be reused multiple times before needing recalculation. *default (%%MD4%%) - Batch Model Rendering - Remove unnecessary garbage collection & screen displaying to make world swapping feel nearly instant. *default - Batch Model Rendering - Limit the number of chunk updates that happen a second. - Batch Model Rendering - Specify the number of updates that can happen a second. - Batch Model Rendering - Lowers the number of animations that happen a second from 1000 to 500. *default - Batch Model Rendering - Render models in a single draw call. *default
Screens
Screens
- Set Tab Height - Extend the number of characters you can type from 100 to 256 on supported servers. (Supported servers are servers that support 1.11 or above. Some servers may kick you for this despite supporting 1.11 or above) *default - Set Tab Height *(not in original)* - Remove the limit on how many messages can show up in chat. *default - ~~Set Tab Height - Remove the background from chat. (Can positively impact performance).~~ (replaced by Set Tab Height) - ~~Set Tab Height - Remove the background from chat's input field. (Can positively impact performance).~~ (replaced by %%MD1%%) - ~~Set Tab Height - Extend the chat background all the way to the left of the screen. *default~~ (replaced by %%MD2%%) - Set Tab Height - Clean up the chat by stacking duplicate messages (Does not work with Labymod) *default - Set Tab Height - Only compact messages if they're consecutive. - Set Tab Height - Change the amount of time old messages take to stop being compacted. (Measured in seconds) - Set Tab Height - Stop messages with no content from showing up in chat. - Set Tab Height - Keep chat open while sending a message if Shift is held while pressing Enter. - Set Tab Height - Delay chat messages if they're sent within the selected timeframe after the previous message. (Measured in seconds) - ~~Set Tab Height - Move the chat up 12 pixels to stop it from overlapping the health bar, as done in 1.12+. *default~~ (replaced by %%MD3%%) - Set Tab Height - Add timestamps before a message. - Set Tab Height - Choose how Chat Timestamps should appear. - Set Tab Height - Change the time format of Chat Timestamps. - Set Tab Height - Show the seconds on a timestamped message. - Set Tab Height - Show the command or link that is run/opened on click. - Set Tab Height - View the damage value of the currently held item above your hotbar. - Set Tab Height - View the total amount of the currently held item above your hotbar. - Set Tab Height - View the enchantments of the currently held item above your hotbar. - Set Tab Height - View how much total armor protection you have inside your inventory. - Set Tab Height - View how much total projectile protection you have inside your inventory. - Set Tab Height *(not in original)* - Change the opacity of the dark background inside a container, or remove it completely. - Set Tab Height - Change the opacity of supported containers. Includes Chests & Survival inventory. - ~~Set Tab Height - Stop rendering the crosshair when in a GUI.~~ (replaced by %%MD4%%) - Set Tab Height - Notify how long the game took to start. *default - Set Tab Height - Remove the Realms button on the main menu as it's useless on 1.8.9. *default - Set Tab Height - Modify the Open to LAN button to either redirect to the server list or be removed. - Set Tab Height Choose between disconnecting or relogging when clicking the disconnect button. (Only works on multiplayer servers) - Set Tab Height - Preview image links when hovering over a supported URL. Press shift to use fullscreen and Control to render in native image resolution. (Currently supported: Imgur, Discord, Badlion screenshots) - Set Tab Height - The % of screen width to be used for image preview. - Set Tab Height - Stop potion effects from shifting your inventory to the right. *default - Set Tab Height - Click outside a container to close the menu. - Set Tab Height - Change the scale of your inventory independent of your GUI scale. - ~~Set Tab Height - Change the tab list opacity.~~ (replaced by %%MD5%%) - ~~Set Tab Height - Move the tab overlay down the selected amount of pixels when there's an active bossbar.~~ (replaced by %%MD6%%) - ~~Set Tab Height - Choose how many pixels tab will move down when there's an active bossbar~~ (replaced by %%MD7%%)
Screenshots
Screenshots
- Preview Scale - Remove the messages from screenshots entirely. - Preview Scale - Compact the message given when screenshotting. - Preview Scale - Show a text component that allows you to delete a screenshot. *default - Preview Scale - Show a text component that allows you to delete. *default - Preview Scale - Show a text component that allows you to upload a screenshot to Imgur. *default - Preview Scale - Show a text component that allows you to copy a screenshot. *default - Preview Scale - Show a text component that allows you to open the screenshots folder. *default - Preview Scale - Change the way screenshotting works as a whole, creating a whole new process to screenshotting such as uploading to Imgur, copying to clipboard, etc. *default - Preview Scale - Automatically copy screenshots to the clipboard when taken. - Preview Scale - Preview the look of your screenshot when taken in the bottom right corner. - Preview Scale - Adjust how long the preview should stay on the screen before sliding out. time is measured in seconds. - Preview Scale - Select an animation style for the screenshot preview. - Preview Scale - Change the scale of the preview.
Changes from original mod
Changes from original mod
PolyPatcher 1.10.1: - Add toggle for "OptiFine Custom Sky Fix" - Fix compatibility with NormalASM - Fix alpha not being set when rendering container slots
PolyPatcher 1.10.0: - Boost performance by only rendering special tile entities once instead of twice per frame (e.g beacons) - Boost performance by unloading tile entities quicker - Boost performance by optimizing adding normals to vertex formats - Boost performance by reducing allocations in EnumFacing - Fix vanilla log spam with Util class - Fix vanilla texture manager memory leak - Fix vanilla enchantment memory leak
- Fix vanilla server list from buffering - Fix vanilla light initializing too early - Fix vanilla bug where invalid tile entities try to render - Fix vanilla bug where entities don't render at certain camera angles below Y=0 and above Y=255 - Fix vanilla bug where spaces are not trimmed in server address fields - Fix vanilla bug where the pumpkin overlay shows in spectator mode
- Decrease startup time significantly by computing part of FML mod loading asynchronously - Decrease startup time by replacing unnecessary regexes during mod loading - Decrease startup time by skipping first baking in ModelLoader - Boost performance by switching some Forge internals over to FastUtil - Boost performance by improving insertion into Forge's inventory wrappers - Boost performance of Forge's block state implementation - Add micro-optimization in the FML registry - Reduce memory usage of Forge model transformations - Fix OBJModel-related Forge memory leaks - Fix Forge bug by skipping fatal models
- "Entrypoint Caching" feature - Cache Forge mod entry points, improving startup time as Forge no longer needs to walk through every class to find the @Mod annotation. - This will only work after your second launch with PolyPatcher 1.10.0, because it needs to cache this data first. - This decreases startup time significantly - Compact LUT Tables / Fast Math (replaces BetterFPS / OptiFine Fast Math) - Add toggle for cacti in "1.12 Farm Selection Boxes" - This fixes cacti farming in SkyBlock. - New experimental option to improve head rendering by removing black pixels ("Improved Skin Rendering") - Add "Background to Book GUI" - Add "Flying FOV" to "FOV Modifier"
- Fix compatibility with CensoredASM - Make "Resource Exploit Fix" not do any extra validation other than detecting the exploit - Fix "Compact Chat" scrolling - Fix entity outline compatibility with "Entity Culling" - Fix "HUDCaching" issues with vignette and crosshair color - Fix "FOV Modifier" with high speed or slowness
PolyPatcher 1.9.2:
None
PolyPatcher 1.9.1: - Reload language-related managers only when selecting a new language in vanilla Minecraft - Fix parallax fix making debug crosshair disappear - Try-catch sound menu to prevent crashes
PolyPatcher 1.9.0: - Replace Essential with OneConfig - Boost performance by batch-drawing tile entities - Boost performance by reducing quad counts in item models - Fix Forge held item lighting to match vanilla - Fix vanilla bug where entering an entity in spectator mode while in third person applies shaders - Fix vanilla bug where enchantment glint takes up the whole slot - Fix vanilla bug where items glitch out when using negative scale - Fix vanilla sky lighting calculation - Add ability to change HUD Caching FPS - Add "Natural Capes" feature - Add "Pumpkin Overlay Opacity" - Add "Cleaner Night Vision" and "Disable Night Vision" - Add Invert Hotbar Scrolling - Add Prevent Overflow Hotbar Scrolling - Add "Disable Falling Blocks" - Replace "Remove Container Background" with "Container Background Opacity" - Replace "Nausea Effect" toggle to "Distortion Effects" slider - Add ability to change tile entity render distance - Add ability not to cull ender dragons and withers from Entity Culling - Fix very rare crash on Minecraft's main menu - Re-add "Remove Water FOV" - Re-add "Remove Chat Message Limit" feature - Remove features replaced by various Polyfrost mods - Please install VanillaHUD for any title-related, actionbar-related, or tablist-related features - Please install PolyCrosshair for any crosshair-related features - Please install PolyNametag for any nametag-related features - Please install OverflowParticles for any particle-related features ("Clean View," "Disable Breaking Particles," "Static Particle Color," "Max Particle Limit") - Please install OverflowAnimations for "Remove Vertical Bobbing" - Change all opacity options to percentages - Remove Patcher version info from debug HUD
<br><br>
Replacement Mods
Replacement Mods
PolyPatcher reproduces the functionality of these mods and as such, they are no longer needed.
This list may not always be up-to-date. To view an updated list, click NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll (sk1er_fullscreen) - ~~NoScroll~~ Replaced by %%MD1%% instead - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll - NoScroll
License
How we comply with Patcher's original license
NOTE: This is in no way legal advice or legally-binding text, and is purely intended as a brief explanation of how we follow Patcher's license.
The original Patcher mod, as well as "PolyPatcher" (our fork), is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International license (aka, the CC BY-NC-SA 4.0). Therefore, we are not allowed to earn monetary compensation from this mod. PolyPatcher is hosted on three different websites, GitHub, Modrinth, and CurseForge: there are no ads on the GitHub and we have asked Modrinth / CurseForge to disable monetization on this project manually. The Modrinth correspondence is below, and the CurseForge support thread is shown on the CurseForge description.
