Skip to content
James Horsley edited this page May 29, 2022 · 4 revisions

What's this do?

Probably something you've asked a lot if you've used this for a bit. Well don't worry! Here's a list of all the settings, and what they do.

Main jMC2Obj Window

image

  • "..." - Browse for the Minecraft save directory

  • "Load" - Load the world Minecraft save

  • Dimension - Select the Minecraft dimension to use

      0 = Overworld
      -1 = Nether
      1 = End
    
  • Goto - Go to specific coordinates in the selected dimension

  • Export - Export the selected area

  • Settings - Configure settings for JMC2OBJ to use

  • Update - Opens window to check for program update

  • About - Opens the about window for the program

  • Console - Shows the programs console (Usually used for debugging)


Export Settings

Here's what the options on the Export window do:

image

Offset

  • Map Scale - Sets the scale for the selected region. Use this to make the exported file bigger or smaller when it's imported.
  • None - Do not offset the object
  • Center - Center the object when exported
  • Custom - Enter custom X/Y values for exporting a specific amount to offset the object.

Texture export

  • Pre-scale textures - Upscale textures on export (Useful for 3D applications that utilize texture filtering, which is most of them)

      You can use 1x, 2x, 4x, 8x, and 16x. This is for scaling the texture's resolution by 1 times, 2 times, 4 times, 8 times, and 16 times respectively. 
    
  • Export Textures - Export textures for the current resource pack.

  • Export alpha channel in separate file(s) - Exports the alpha channels of the block textures to separate files.

      Useful for those who want to control the alpha values for their textures.
    
  • Extra Maps - Some resource packs contain normal and specular maps, enable these options to search for and export them.

  • Export Normal - Exports normal maps

  • Export specular - Exports specular maps

      Normal and Specular maps are used in some resource packs for shaders. This is covered in the jMC2Obj and Shaders page.
    

Export Clouds OBJ From

You can tell jMC2Obj to export a specific model for the clouds. By default this will use the Minecraft clouds, but if a resourcepack has a different cloud model, you can set that here.

  • Minecraft - Exports the default Minecraft clouds
  • Custom Resourcepack - Select a resourcepack to export a custom cloud model from.

Export selection

Here is where we can set all the export options for the Obj model.

  • Select blocks to export - Specify which blocks you would like to export. You can exclude specific ones here if you'd like, or if you add blocks, enable them here.

  • Render unknown blocks - Exports an object for any unknown blocks as pink squares.

  • Render world sides & bottom - Will render the side of blocks that are at the edge of the selected area. Makes it so that the borders are not see-through.

  • Render biomes - Renders blocks with specific biomes in the selected area. Usually, this just pertains to the grass color, as Minecraft changes that depending on which biome you are in.

  • Render entities - Renders any entities in the selected area. Currently supported: Minecarts, Boats, Item Frames (with maps), Armour stands, Paintings, Slimes, Pigs, Sheep, Cows, Chickens & Squids.

  • Convert all ore blocks to stone - Converts any ore block to stone instead.

  • Create a separate object for each material - Will split the map up to its individual parts based on their materials

    • Occlude different adjacent materials - Will remove all faces on blocks that are bordering another block with a different material.
  • Create a separate object for each chunk - Will export a separate object/mesh for each chunk, this setting will work cohesively with the previous two settings. As of #117

  • Create a separate object for each block - Will export each and every block as separate objects/meshes. Warning! This creates HUGE file sizes, if used in wide-area might cause JMC2OBJ to crash, please read the command line settings to avoid this. (TBD)

    • Occlude adjacent blocks - Will remove faces between adjacent blocks. Very much recommended if you don't need the full block models and wish to lower the load time and file size.
  • Allow block model randomization - Enables similar behaviour as seen in Minecraft that allows for texture rotation randomisation. This setting doesn't disable/enable block randomisation in config.

  • Add double sided faces for backface culling - Creates faces for both sides of all objects. This is useful if you need your software to be able to render both sides of a block, and not cull the back-facing normal.

  • Optimize mesh - Optimizes the mesh within the Obj file. For example: On a large flat part of the map, instead of having a polygon for each individual grass block, jMC2Obj will dissolve polygons on faces to save on polygon count. Makes your 3D application run better for large areas.

  • Do not allow duplicate vertexes - Combines any close vertexes into one to avoid duplicates, and keeps a manifold mesh. A mesh is considered manifold if it is completely closed, and the UV map can correctly be flattened.

  • Export threads - Specify how many CPU Threads for jMC2Obj to use for exporting. Recommended to set this to 1 less than the number of cores your CPU has. Note: More threads use more RAM.

  • Use the last save location and name? - Won't ask where to export the obj file, exports to the last exported name and location.


Settings

image

Here we can specify the in-application settings.

  • Drag map using: - Select what method you'd like to drag the map around with. Default: Right-mouse button.

  • Select using: - Select what method you'd like to select the area to render an object from. Default: Left-mouse button.

  • Language: - Specify what language to use in the program. Currently supports English, German, Chinese, and Polish.

  • Use System Browser - Utilize the operating systems file browser instead of the built-in one. Currently in beta.

  • Preview threads: - Specify how many threads for the world preview to use.

  • Resource Packs - Here you can add any custom resource packs you'd like jMC2Obj to use. Please reference the Custom Resourepacks page for more info.

  • Use latest minecraft version found as default - Will use any textures/blocks from the latest version of Minecraft as default.

      Resourcepacks will overwrite this, but enabling this will ensure that any objects/textures the program can't find in the custom resourcepack will instead use the one from Minecraft, if it can.
    
  • Restore to factory settings - Restores the program as it was.

  • Restart program - Self explanatory.

  • Reload configs - Reloads all conf files and resource packs.


Preview Options

  • Fast Render - Renders the preview quickly with more basic textures.
  • Show Chunks - Shows lines for the individual chunks.
  • Select Chunks - Allows for selecting individual chunks instead of a click-and-drag area.

Floor-Ceiling

Set the floor and ceiling to export. Remember, jMC2Obj uses a top-down view, so setting the floor higher will export less blocks from lower layers, and setting a lower ceiling will export less blocks from high up in the air.


Position 1/2

Set the export area to specific X/Y values if you need a bit more precision on what area to export.