[1.5.2] OptiFine HD D2 (FPS Boost, HD Textures, AA, AF and much more)

Hello everybody,

This mod adds support for HD textures and a lot of options for better looks and performance. Doubling the FPS is common.

You can follow the OptiFine development here: sp614x@twitter or http://optifog.blogspot.com/.

Get the Magic Launcher for easy mod installation, compatibility checking and more.

Donate to OptiFine and receive the OptiFine cape as a sign of your awesomeness.
Enter your Minecraft username when donating (case-sensitive). The cape is visible to everyone using OptiFine 1.1_B or newer. Thank you for being awsome.

Features

Spoiler:

FPS boost (examples)
- doubling the FPS is common
- decreases lag spikes and smooths gameplay
Support for HD Textures (info)
- HD textures and HD fonts (MCPatcher not needed)
- custom terrain and item textures
- animated terrain and item textures
- custom HD Font character widths
- custom colors
- custom block color palettes
- custom lighting
- unlimited texture size
Variable Render Distance (example)
- from Tiny to Extreme (2 x Far) in 16m steps
- sun, moon and stars are visible in Tiny and Short distance
Configurable Smooth Lighting (examples)
- from 1% - smooth lighting without shadows
- to 100% - smooth lighting with full shadows
Performance: VSync
Synchronizes framerate with monitor refresh rate to remove split frames and smooth gameplay
Smart Advanced OpenGL
- more efficient, less artifacts
- Fast - faster, some artifacts still visible
- Fancy - slower, avoids visual artifacts
Fog control
- Fog: Fancy, Fast, OFF
- Fog start: Near, Far
Mipmaps (examples)
- Visual effect which makes distant objects look better by smoothing the texture details
- Mipmap level - OFF, 1, 2, 3, Max
- Mipmap type - Nearest, Linear
Anisotropic Filtering (examples)
- Restores details in mipmapped textures
- AF level - OFF, 2, 4, 8, 16 (depends on hardware support)
Antialiasing (examples)
- Smooths jagged lines and sharp color transitions
- AA level - OFF, 2, 4, 6, 8, 12, 16 (depends on hardware support)
Better Grass
Fixes grass blocks side texture to match surrounding grass terrain
Better Snow (examples, credit)
Fixes transparent blocks textures to match surrounding snow terrain
Clear Water (examples)
Clear, transparent water with good visibility underwater
Custom Sky (info)
Use custom textures for the day and night skies. Multiple layers, blending options, time configuration.
Random Mobs
Use random mob textures if available in the texture pack
Connected Textures (examples)
Connects textures for glass, glass panes, sandstone and bookshelf blocks which are next to each other.
Natural Textures (examples, idea)
Removes the gridlike pattern created by repeating blocks of the same type. Uses rotated and flipped variants of the base block texture.
FPS control
- Smooth FPS - stabilizes FPS by flushing the graphics driver buffers (examples)
- Smooth Input - fixes stuck keys, slow input and sound lag by setting correct thread priorities
Chunk Loading Control
- Load Far - loads the world chunks at distance Far, allows fast render distance switching
- Preloaded Chunks - defines an area in which no new chunks will be loaded
- Chunk Updates per Frame - allows for faster world loading
- Dynamic Updates - loads more chunks per frame when the player is standing still
Configurable Details
- Clouds - Default, Fast, Fancy
- Cloud Height - from 0% to 100%
- Trees - Default, Fast, Fancy
- Grass - Default, Fast, Fancy
- Water - Default, Fast, Fancy
- Rain and Snow - Default, Fast, Fancy
- Sky - ON, OFF
- Stars - ON, OFF
- Sun & Moon - ON, OFF
- Depth Fog - ON, OFF
- Weather - ON, OFF
- Swamp Colors - ON, OFF
- Smooth Biomes - ON, OFF
- Custom Fonts - ON, OFF
- Custom Colors - ON, OFF
- Show Capes - ON, OFF (supports HD capes)
Configurable animations
- Water Animated - OFF, Dynamic, ON
- Lava Animated - OFF, Dynamic, ON
- Fire Animated - OFF, ON
- Portal Animated - OFF, ON
- Redstone Animated - OFF, ON
- Explosion Animated - OFF, ON
- Flame Animated - OFF, ON
- Smoke Animated - OFF, ON
- Void Particles - OFF, ON
- Water Particles - OFF, ON
- Rain Splash - OFF, ON
- Portal Particles - OFF, ON
- Dripping Water/Lava - OFF, ON
- Terrain Animated - OFF, ON
- Items Animated - OFF, ON
Fast Texturepack Switching
Switch the current Texturepack without leaving the world
Fullscreen Resolution
Configurable fullscreen resolution
Debug
- Fast Debug Info - removes lagometer from debug screen
- Debug Profiler - removes profiler from debug screen
Time Control
Default, Day Only or Night Only - works in only in Creative mode
Autosave
- Configurable Autosave interval
- A fix for the famous Lag Spike of Death

Editions

Spoiler:

OptiFine HD D2 Ultra for Minecraft 1.5.2
(has all the features of Standard, Smooth, Multi-Core and AA, highly configurable)

The option "Video Settings -> Chunk Loading" switches between Standard, Smooth and Multi-Core chunk loading. When using "Chunk Loading: Multi-Core" make sure to Disable "Threaded Optimization" / "OpenGL Threading" in the graphics card control panel (example). For best results disable it globally, not only for java.exe or minecraft.exe.

Download OptiFine 1.5.2_HD_U_D2 (updated to 1.5.2): Download, mirror
(02.05.2013)

Older versions:

Spoiler:

OptiFine HD D2 Standard for Minecraft 1.5.2
(has built-in support for HD textures, HD fonts and BetterGrass, MCPatcher not needed)

Download OptiFine 1.5.2_HD_D2 (updated to 1.5.2): Download, mirror
(02.05.2013)

Older versions:

Spoiler:

OptiFine D2 Light for Minecraft 1.5.2
The light edition improves FPS, especially for slower computers. Gains of 20 FPS and more are common.
No HD features or extended configurations included. Based on Optimine by Scaevolus.

The Light edition is not compatible with ModLoader and Forge.

Download OptiFine 1.5.2_L_D2 (updated to 1.5.2): Download, mirror
(02.05.2013)

Older versions:

Spoiler:

Older Editions

Spoiler:

If you have previously used MCPatcher for HD Textures, HD Fonts or Better Grass (important)

Spoiler:

Compatibility with other mods

Spoiler:

If you have found OptiFine or this post helpful, please donate to show your support.

Installation

If possible start with a clean minecraft.jar and check the mod compatibility section above.

A. Easy Installation

1) Download and start the Magic Launcher
2) Click Setup, click Add, select the downloaded zip file
3) Click OK, login and play Minecraft

B. Manual Installation

Windows/Linux Instructions:
1) Locate your minecraft.jar file. On Windows, it's in %APPDATA%/.minecraft/bin
2) Create a backup of minecraft.jar
3) Open minecraft.jar in an archive editor (WinRar/7-Zip/etc)
4) Delete the META-INF folder.
5) Copy (drag and drop) the .class files from the downloaded zip file into the jar file, replacing previous files.
6) Run Minecraft and test!

Mac Instructions:
1) Locate your minecraft.jar file. On Mac, it's in <home>/Library/Application Support/minecraft/bin
2) Create a backup of minecraft.jar
3) rename minecraft.jar to minecraft.zip and double-click it to extract the contents
4) rename the resulting folder to minecraft.jar and open it
5) copy the .class files from the downloaded zip into the minecraft.jar folder, replacing previous files
6) Run Minecraft and test!

Please test and report back, include CPU, GPU and FPS before/after. Feedback is always welcome.

TODO

Spoiler:

Information for Texture Pack Authors (based on MCPatcher's description)

Spoiler:

HD Textures
Minecraft 1.5 and above comes with general support for HD textures. OptiFine fixes many bugs, adds support for new features and fixes the performance of larger texture packs.

Custom Animations
Minecraft 1.5 and above supports animations for blocks and items (info). OptiFine additionally enables the animation of all other textures.

To create a custom animation for any texture in the game create a ".properties" file in the anim/ folder of your texture pack. In it, supply the source and destination texture, along with coordinates of the area you wish to animate. The following example animates the first painting in kz.png.

from=/anim/mypainting.png
to=/art/kz.png
x=0
y=0
w=16
h=16

- "from" is the location of the custom animation.
- "to" is the texture you wish to animate.
- "x, y, w, h" are the coordinates of the rectangular area of the destination texture.

The source texture should be a vertical strip of separate frames. The width of the source texture should be equal to the value of "w". If not, it will be scaled automatically.  You can have many different animations applied to the same texture by creating separate properties files for each. The properties file can also contain tile order and speed information as described above.

Each custom animation may specify its animation speed and frame order.

tile.X=Y
duration.X=Z

X starts at 0 and represents the order you want frames to display in. Y in the tile number in the animation .png file. The first tile is 0, the second is 1, etc. Z is the duration you want that frame displayed, in game ticks (if omitted, duration is assumed to be 1 for that frame). For example, to make an animation with 3 tiles, run on a 5-frame animation with a pause in the middle, the .properties file might look like this:

tile.0=0
tile.1=1
tile.2=2
duration.2=5
tile.3=1
tile.4=0

Random Mobs
You may include multiple skins for the same mob and the game will automatically pick one at random. Add a number to the end of the filename before the .png, e.g., /mob/creeper2.png. Start at number 2 and do not skip any numbers. For the wolf textures, make sure you include the same number of wolf, wolf_tame, and wolf_angry textures or it will look strange when a wolf changes moods.

HD Fonts
To configure the widths of individual characters create a text file called /font/default.properties or /font/alternate.properties. Each line in this file specifies the width of a character:

width.<ascii value="" 0-255="">=<width 0-8="">

For example, to specify the widths of capital A, B, and C, you might use

width.65=5.9
width.66=5
width.67=5.25

Values can be floating point numbers (Notch's original code only supported integer widths) and range from 0-8 regardless of the resolution of the font.  You do not need to specify widths for all characters, only ones where you want to override the default width.

The space character has a default width 2.  However you can override this the same way, by setting width.32 to a custom value.

Nuin has created an Excel spreadsheet to make the font calculations easier.  Also see his Berylium font.

Because vanilla Minecraft does not handle correctly character spacing of HD fonts you can mark a font as HD and it will only be used when OptiFine is installed. To mark the font as HD add the suffix "_hd" to the font name, for example "/font/default_hd.png".

Custom Colors (sample color.properties)
The CustomColors allow texture pack authors to customize many of the games hardcoded colors.  Here are the files you will need to include in the texture pack:

/color.properties:
This text file allows you to specify colors for potions, spawner eggs, lilypads, and a base color for water particle effects (drops, splashes, and bubbles).  A template file with the game's default values is available here.  See the # comments above each value for a description of how it is used in game.

/misc/redstonecolor.png:
This is a 16x1 bitmap used for redstone wiring and particle effects.  Other redstone colors (torches, repeaters, etc.) are still in terrain.png / items.png as usual.  The x-axis of the redstonecolor.png bitmap represents the current strength.  0 is fully off, 15 is fully on.

/misc/stemcolor.png:
This is an 8x1 bitmap used for pumpkin and melon stems at each growth stage.  0 is a sprout, 7 is fully grown.

/misc/lavadropcolor.png:
This is a bitmap used for the lava drop particle effect as it cools during its fall.  The height should be 1 pixel but the width can be anything.  The x-axis represents the particle's age in game ticks (about 1/20th of a second).  Lava drop particles are generally not visible for the first 40 ticks or so because they start out embedded in the block above.  90 pixels is a good width.  If the particle lives longer than the width of the image, the last pixel is used for the remaining time.

/misc/myceliumparticlecolor.png:
Used for the particle effect created by mycelium blocks.  This image can be any size.  A random color is chosen from this bitmap for each new particle.

/misc/xporbcolor.png:
Used for the experience orbs.  This image can be any size.  The color chosen will move in a sinusoidal pattern from (0,0) to the end of the image.  The speed of the sine wave is slowed down by a factor of 4 to allow texture packs to have slower pulsing xp orbs than the default.  If you want to keep the default speed, simply copy your image 4 times vertically.

/misc/swampgrasscolor and /misc/swampfoliagecolor:
256x256 biome palettes used in swampy areas.  They work just like their non-swamp counterparts.

/misc/pinecolor and /misc/birchcolor:
Biome color palettes for pine and birch leaves.  The pixel at (127, 127) is used for the default color when the block is held or in inventory.

/misc/watercolorX.png:
Biome color palette for water.  Note the capital X in the filename to prevent the default watercolor.png from being used accidentally.

Other biome palettes:
You can also assign a custom biome palette to any standard block.  Here "standard" means any block that does not already have its own special coloring.  In MCP terms, this is any Block subclass that does not override the colorMultiplier method.  Create a 256x256 bitmap, then in color.properties add a line

palette.block.<path>=<list of="" block="" ids="">

For example, to use /misc/stonecolor.png with all stone and ore blocks, use

palette.block./misc/stonecolor.png=1 14 15 16 21 56 73 74

To further restrict the palette by block metadata, use the syntax <id>:<metadata>, e.g., 43 would affect all double slabs, 43:1 would apply to only sandstone double slabs.

/environment/lightmap-1.png: (Nether)
/environment/lightmap0.png: (Overworld)
/environment/lightmap1.png: (The End)
These are custom lighting palettes for each world.  The height must be exactly 32 pixels but they can be any width.  Each bitmap actually consists of two palettes, but we'll get into that later.

First an explanation of how lighting normally works in Minecraft.  Every block has two light values from 0 to 15 assigned to it, one for sky brightness and one for torch brightness.  A block in direct sunlight has a sky value of 15.  A block in the shade directly adjacent to it has a value of 14 and so on.  Blocks deep underground far from any block that can see the sky have sky brightness 0.  Similarly for torches.  A torch block has light value 14 and the light value drops by 1 each block away from it.

To generate the lighting you actually see in game, Minecraft uses a 16x16 lightmap.  Its axes correspond to the 16 light levels of each type.  If a block has torch brightness x and sky brightness y, it uses (x,y) for its lightmap coordinates.  The lightmap is not in any of the game's files but is generated each frame.  You may have found that light_normal.png file in minecraft.jar, but it is not used at all.  Two variables affect the lightmap, the time of day and the torch flicker.  Minecraft implements night and day and torch flicker by making the entire lightmap darker or lighter rather than by adjusting the sky/torch brightness values.

Remember your palette must be exactly 32 pixels high, but can be any width.  The top 16 rows represent sunlight and the bottom 16 represent torchlight.  Two columns, 16 pixels from the top half and 16 pixels from the bottom half, are chosen to form the axes of the final 16x16 lightmap used for rendering.

In the top half, the left-hand side represents night and the right-hand side represents day, with the dusk/dawn transitions in between.  The very far right of the palette represents lightning flashes.  There is no specified width for the palette, but more width means more room for detail in the dusk/dawn transitions.

Posted Image

Blue=night, orange=dusk/dawn, cyan=day, yellow=lightning.  (Template by Misa.)

Torches work similarly, but in this case x is a random value based on the torch flicker.

The method described above is used for all three worlds (Overworld, Nether, The End), but since there is no night or day in Nether and The End, the "time of day" value is constant.  For these worlds you can simply give each row 0-15 the same color all the way across.

The lightmap may be extended to cover the nightvision effect by making its height 64 pixels. The top 32 pixels define the standard sun and torch palettes, the bottom 32 pixels define the sun and torch palettes when the nightvision effect is active.

Connected Textures (sample ctm .properties)
Minecraft 1.5 adds new block texture handling, so the original CTM mod texture sheet (ctm.png) is no longer supported. You can convert an old texture pack to the new CTM format using the MCPatcher converter.

The connected textures property files are located in folder "ctm" in the texture pack. You can use any subfolders to organize the configuration files.

Each subfolder should contain one or more properties files and a set of png images that will be used as replacement textures.  Each properties file represents one block or tile override and contains options which control when and which tiles are to be used for replacement. Multiple properties files can affect the same block or tile, but only the first matching one (in alphabetical order by filename) will be used.

A simple connected glass block requires a properties file and 47 separate textures:

/ctm/myglass/block20.properties:method=ctmtiles=0-46

Standard connected textures (method=ctm) follow this pattern:
Posted Image

Horizontally-connected textures follow this pattern:
Posted Image

Vertically-connected textures follow this pattern:
Posted Image

You can also use the .properties file to specify random textures or repeat a larger pattern over several blocks.  See the sample .properties file here for more information.

Natural Textures (examples)
Natural Textures fixes the gridlike pattern created by repeating blocks having the same texture.
It uses the configuration file "natural.properties". A template is included in OptiFine ("template.natural.properties") which has to be renamed to be effective. When no configuration is found, OptiFine uses fixed defaults, but only for the default texture pack.
Custom texture packs need the configuration file to be present for the Natural Textures to be active.

Custom Sky (sample sky.properties, skybox template)
OptiFine allows custom textures to be used for the day and night skies. Multiple layers can be merged together using several blending methods and set to fade in and out at certain times of the day.

Each "layer" of custom sky must have a .properties file located at /environment/sky0/sky<n>.properties.  In it you specify a texture (default: /environment/sky0/sky<n>.png), the time of day the texture should fade in and out, and a blending method (default: add).  Various blending methods are available: add, subtract, multiply, dodge, burn, screen, and replace.  See the sample sky.properties file for more options.

The skybox texture is mapped onto a rotating cube around the game world.  The texture can be any size but must have 2 rows of 3 tiles.  The template shows how the six tiles on the texture map to faces of the skybox.  This orientation is taken at noon in game time, so the sun is drawn in the center of the top face and the moon in the center of the bottom face.  This means that a custom starfield should have whatever you want to be directly overhead on the bottom face.

Custom Sky works only in the overworld.  The Nether and The End are not supported.

Even Older Versions

Spoiler:

For maximum FPS use:
- Graphics: Fast
- Render Distance: Short/Tiny
- Smooth Lighting: OFF
- Performance: Max FPS
- AdvancedOpenGL: Fast
- Clouds: OFF
- Fog: OFF
- Animations: All OFF
- Sky: OFF
- Stars: OFF

Tips and tricks:

1. Download the latest Java 7 builds from here: http://download.java.net/jdk7/. Minecraft should run much smoother with less lag spikes. It really helps.
2. Set the Java process to higher priority
3. Set "Limit framerate" to Max FPS. The limiter is so implemented that it always decreases the FPS.
4. Update LWJGL from here.
5. Lauch Minecraft with less memory (yes, really). Usually it does not need more than 350 MB and runs fine on all settings with the default texture pack. By default java allocates way too much memory (1GB) which may get swapped to disk and the overall performance may suffer a lot. To start Minecraft with less memory:

Download and start the Magic Launcher.
Click Setup, click tab Advanced
Enter 350 in the field "Memory"
Click OK
Login and play

6. Check your computer for malware and viruses - even "harmless" malware programs may affect badly the Minecraft performance.

Fog Control Examples

Spoiler:

Copyright

Spoiler:

[1.5.2] OptiFine HD D2 (FPS Boost, HD Textures, AA, AF and much more)

#1

#2

#3

#4

#5

#6

#7

#8

#9

#10

#11

#12

#13

#14

#15

#16

#17

#18

#19

#20