Using Raycast MMD like a pro!

Miku Hatsune (C) Crypton Future Media, Inc.

A feature article on LearnMMD by Trackdancer2015!

Raycast MMD is a popular MME that seems to be all the rage these days in MMD Editor’s Note: LearnMMD has several Ray-MMD and Raycast tutorials... some are more “learned” than others but you might review each of them so as to get of the tips and ideas they offer as you learn from the experiences of the various authors. CLICK this box to see them all.videos on YouTube. But there’s very little information for the average user on how to use the system to get the kind of awesome results that the better MMDers seem to be able to get from this MME.

In this article, we will show you exactly how it can be done by using an actual example and showing you the techniques behind the scene that are needed to create those kind of results.

Using Raycast MMD like a pro!

First of all, go watch our sample video; at least a part of it to see what can be done. Then we will show you all the necessary steps.

If you do not know how to use Raycast MMD, read this article first as we won’t be teaching you the basics in this article: How to use Raycast MMD MME Shader Effect

If you want to follow along and recreate the scene used in the video, the links to the models used are included in the credit section.

  • Important: We will be using Raycast MMD ver 1.5.0 in this article.
  • Note: All images in this article can be seen at their original render sizes by clicking on the image. The original renders will show details that might not be evident in the smaller images.


There is a lot of misunderstanding about what Raycast MMD really is, and it is important to know exactly what it is to get the most out of it. For a start, some of Raycast MMD’s more powerful features are “OFF” by default. In this article, we will explain some of these features in more detail.

Raycast MMD isn’t just another MME shader. It should be regarded as an entire lighting system that brings MMD’s lighting system up to par with contemporary computer rendering methods. MMD and its lighting engine is over a decade old; a lot of things have changed in the technology field since then including the capabilities of video graphic cards. Raycast MMD takes full advantage of many of these advances.

Also, and most importantly, Raycast MMD is an environmental lighting system. It takes account of (or simulates) lighting from multiple sources, not just from a single light source which is the default behavior of MMD’s own lighting system.

So exactly how good is Raycast MMD? The short answer is that it makes renders using MMD competitive with some of the render engines in the best computer games currently out there today.


You will need a better than average computer to take full advantage of Raycast MMD; but it should run on most 64 bit systems with a decent graphics card or high performance graphics chip.

For example, the system I am currently using for MMD is an ASUS gaming laptop. It has both a Nvidia graphics card and an Intel graphics chip. I have set up my system to force MMD to use the Nvidia graphics card by default to ensure that I have maximum graphics processing power. It took my system just under 10 minutes to render the video above.


Raycast MMD like I said above is an environmental lighting system. Exactly what this means is that it takes into account all sources of light falling on a surface, much like how light behaves in the real world. It also, ignores artificial constructs such as toon maps, by default. This also applies to most SPA and SPH files. To make things really shiny in Raycast MMD requires a different approach but it can make metals look really shiny and glass look like glass. It also has the ability to make materials give off light much like Autoluminous.

Basically though, Raycast MMD works best in an environment. This gives it plenty of surfaces to bounce lights off to create an illusion of a real world scene. So we start by setting up the world. In our video example we are using a sky dome of our choosing rather than the default Raycast MMD sky boxes. Nothing wrong with those, in fact the ones included with the Raycast MMD download are dynamic and offers some really nice features like moving clouds.


Specific to our video only, we added our own choice of skydome, a stage and a model of Miku. It looks exactly like this before Raycast MMD was added:

Click image to view full size image.

Scene without any effects

This is what the same scene looks like with Raycast MMD added and configured:

Click image to view full size image.

The same scene with Raycast MMD added and configured.

If you click on the images above, you should be able to see both images at their original rendered sizes. Compare them, the differences are on the one hand subtle and on the other hand quite different. See if you can spot the differences.

Which scene looks more like a real world scene?


There’s a lot of light bouncing around the atmosphere. If you look out at a real sky, it’s actually quite bright. Raycast MMD comes with several sky boxes; if you want to use your own sky dome, first load that and then add the Sky Hemisphere sky box.

The Sky Hemisphere is important as it allows us to control the behavior of light under your sky. Also, if you have not already done so, add ray.x and the Raycast MMD controller to MMD. Our camera motion uses essentially the default light set up, which works fine for our scene.

Under the EnvLightMap tab in the MME UI, add Sky with lighting.fx to the Raycast MMD skybox. Add the main.fx to your sky dome. To make your sky dome bright like a real sky, under the MaterialMap tab add Materials>Emissive>Fixed Color x1>material_albedo_x1.fx. It should brighten up your sky dome perceptively and in a natural manner.

Next go to the facial controls for the Sky Hemisphere model. Play with these facials to see what they do. Once you figured them out, use them to set the behavior of ambient light and shadows under your sky.

Note that these controls work in conjunction with the controls under the Raycast MMD controller. Don’t worry about fine controls at this point. We will need to revisit all these controls again when we set up Miku’s shading.


This temple model is absolutely stunning but, and this has been noted by its modeler as well, the vegetation could be dodgy under certain circumstances and Raycast MMD treats the vegetation material like the flat surfaces that they really are. So we will try not to show them in too much detail.

The interior of the main temple building is going to be very dark and you won’t be able to see any of the fine details. There are solutions to this, but the simplest method is to cheat. Simply add the same material that we added to the sky dome to it. Since the material is emissive, it will allow the interior to be somewhat visible, but not in an unnatural fashion.

The only other thing needed for the temple is to add some shine to the main paved area. We added Materials>Subsurface>material_marble.fx to these areas. The main reason for this isn’t just to make the paved areas look like marble/stone, but also to reflect some light back up at Miku.

Click image to view full size image.

The temple after the Raycast MMD material specifications looks much better.


Raycast MMD works really well with Tda models; that’s why there are so many MMD videos that features this type of model. Raycast MMD even has materials specially set up to cater to this type of model.

First thing to do is to run your model through the PMXe and label the materials in English so that you can easily identify what material is what. Then it becomes a simple matter of applying the correct materials to the model.

Here’s my approach. I like to make my models look doll like, and I especially want to give special emphasis to those lovely anime style eyes. You might want to take a different approach, which is fine, but here in this article, I will just show you how I achieve the effect that I want. First though, let’s have a closer look at the model.

Click image to view full size image.

Miku up close. She’s got nice shiny/glassy eyes, healthy skin tones, texture to her hair and clothing. She looks like a Japanese doll/figurine, which is exactly what I was aiming to do.

Miku’s skin tones just used the ones in the Materials>Skin>TDA folder; likewise her clothing uses Materials>Cloth>material_cloth.fx.

To create the glass eye effect the following was done (and bear in mind that on Tda models, the whites of the eyes is actually a concave area that recedes into the model’s head). The materials applied are as follows:

  • Eye whites: Materials>Subsurface>material_jade_white.fx
  • Pupils: Materials>ClearCoat>material_albedo.fx
  • Highlight: Materials>Emissive>Fixed Color x1>material_white_x1.fx
  • Highlight2: material_2.0.fx (default material)
Click image to view full size image.

Miku’s hair uses a custom normal map. Also, this view shows the sparkle that we have given to her eyes by using an emissive material for the highlights.

Raycast MMD makes it very easy to add your own custom materials. In fact, it even comes with template files for making your own materials fx files. These are all in the Materials>Editor folder. We used a custom material fx file for Miku’s hair and it is really easy to do this.

The procedure is to create a new folder for your custom materials. Then copy over one of the Editor template files and edit its references as well as to add the normal map. We got our normal map for the hair from a package from Bowlroll made for the NCHL2 shader set.

The only things we needed to edit for our custom fx file was simply to add a reference to the normal map that we wanted the material to use and to set the FROM value to “1”.


#define NORMAL_MAP_FILE "mat5.png"

mat5.png is the name of the displacement map file which is kept in the same folder as the fx file which references it. The fx file needs to be able to resolve the path to the file so it is easiest to keep both in the same folder.

There are other references to other types of bump maps. These all use default names and if the file doesn’t exist, the fx just simply ignores it. If you’re not a programmer, like me, just use the template file closest to the type of material that you want to replicate.

The other thing we did with Miku’s hair was to change the main shader file from main.fx to main_ex_with_sphmap.fx. This takes advantage of the sph/spa file assigned to Miku’s hair and makes the hair more shiny. This is essentially the same technique used to make metal objects really shiny.


This is the key to success in using Raycast MMD. Unfortunately, if I tried to write down everything I did, this would be a very long and tedious article. So instead, I will just make note of the general principles as they will be fairly uniform across applications.

  1. Set up the light direction using MMD’s own light controls. This also determines where the sun or moon’s position is for Raycast MMD.
  2. Using the Raycast MMD’s sky box controls, set up the behavior of ambient lighting. With the dynamic sky boxes ( Time of Day / Time of Night ) , there are other special effect controls as well.
  3. Using the Raycast main controller (ray_controller.pmx), set up the strength of the principle light source and the behaviors of the shadows.

Most of these things will be apparent by eye, so use those, your own intuition and look out the window if necessary for reference. Use a light touch. The controls are linked in a sense so changing one thing may require changes elsewhere. Honestly, I just do it by eye but that said, I have a good basic understanding of how lighting behavior works in computer simulations so that helps.


Key to working with Raycast MMD is understanding what Bloom is; these are controlled by the facials in the third set of facial controls (normally used for the brows).

Main lighting and shadow controls are in the first set of facial controls (normally used for the eyes).

Fine tuning is in the fourth set of facial controls (normally used for miscellaneous facials).

But back to bloom. Bloom doesn’t generally exist in the real world. It is a computer rendering construct but very effective. What it represents is, in very simplistic terms, imaging artifacts in a camera. If you want some idea of what bloom looks like, the best analogy is to go to a darken church interior and look at the light coming through the windows. That’s the closest you will come to bloom in the real world, however, with cameras it is fairly common. So common in fact that we hardly notice that it isn’t actually real for the most part as there are millions of images around featuring the effect and of course it is prevalent in computer games.

Raycast MMD features bloom and it is extremely effective. It is what gives the subtle, and I emphasize subtle, glow around Miku and this adds poignancy to her appearance in the video imagery.

This close up of Miku against a dark background shows the bloom effect in action. See the subtle glow around her? Use this carefully to frame Miku or your performing models. This is what gives Raycast MMD its signature unique look.


You will notice that the second group of facials (normally those used to control mouth morphs) have no effect. These are the depth of field controls and by default Raycast MMD’s depth of field features are turned off. In the video and the images shown here I used PowerDOF instead as it is easier to control and essentially does the same thing. If you want to turn on the depth of field controls in Raycast MMD (as well as other hidden features) you will have to edit the configuration file.

In the main Raycast MMD folder there is a file named: ray.conf
Make a backup of this file before messing with it, but it can be edited with Notepad or any other plain text editor. Don’t use a word processor to edit this file!

The file includes notes as to what values to use to enable or change the behavior of effects. Here I will just cover a few of them.

  1. Support for toon shaders is off by default. There is a good reason for this, but if you do want to use toon shaders, you can turn it on here.
  2. Bokeh Depth of Field. Turn this on and the ray_controller depth of field features will work.
  3. Lens glare and flare can be turn on here.
  4. Tonemapping; if you want your MMD render to look more like something from a computer game, mess with these values.
  5. Anti-aliasing. By default, Raycast MMD overrides the MMD anti-aliasing method using the FXAA system instead. Keep this value; it is the latest and the greatest.
  6. By default, Raycast MMD turns off the outlines of models it renders. If for some reason you want the outlines, just change the values in the field provided.


To set Bokeh DOF “ON”, change this line to read: #define BOKEH_QUALITY 1

// Bokeh Depth Of Field
// MeasureMode can supports the following options:
// When MeasureMode at (0.00 ~ 0.24) : Test circle 
// When MeasureMode at (0.25 ~ 0.49) : Test circle + Bone from ray.x
// When MeasureMode at (0.50 ~ 0.98) : FocalDistance Only
// When MeasureMode at (0.99 ~ 1.00) : FocalDistance + Bone from ray.x
// 0 : None
// 1 : Enable


If you take a look at the images here again, the temple in a lot of the video is actually blurred. This is deliberate as the temple model has a lot of details which can be distracting and we wanted attention focused on Miku. This is done with PowerDOF but there is a trick to it.

Before we get to that, however, note that Raycast MMD has its own DOF controls (disabled by default as noted above). I chose not to use that option as PowerDOF makes things a lot simpler.

To set up PowerDOF, simply I set its Si value to 0.125. This reduces it’s strength considerably; if I did not the background would be very blurred and it is not a good look. Using the effect at reduced strength is more “realistic”. Also, I attached the effect to Miku’s neck bone. This ensures that Miku is in focus at all times.

When the camera focal length is a high value such as in this wide angle view, the background becomes sharper.

On the other hand, if the camera focal length is a low value, such as in this telephoto shot, the background becomes much more blurred which helps focus attention on Miku. Note that in all cases, since the PowerDOF effect is attached to Miku, Miku remains sharp regardless of the camera’s focal length value.

Giving a vintage feel to the video imagery was done in two ways. First of all, we took advantage of Raycast MMD’s vignette feature. This is the fuzzy black border around all the images. The old picture effect uses the o_psSepia.fx. Simply this is used at full strength and then faded out completely simply by tweaking it’s Tr value.


  • Set it up at full strength (Tr=1.0) at frame 1
  • Set it disappear completely (Tr=0.0) at frame 100

All you have to do is to set the start and end Tr values; MMD will automatically work out the intermediate values for you.

Tip: Once the effect is faded out completely, disable it by turning off its display attribute (uncheck the display check box). This will tell MMD to ignore the effect thereafter and save on system resources. Do this the frame after the effect fades to “0”. You can always enable it again later by checking the display check box as was done at the end of this example video.

This is a transitional frame where the o_psSepia effect is at approximately half strength, allowing the rich underlying colors to come through.


In essence, Raycast MMD makes doing videos like these very, very easy. In fact, all of this could have been done with Raycast MMD alone, but I chose to mix in other effects as I was just plain lazy.

Anyway, thanks for reading. Hopefully, you learned some of the tricks on how to use Raycast MMD more effectively here. If you have questions, just post a comment below.


Miku Hatsune (C) Crypton Future Media, Inc.

Other credits are on the video page.


Visit the Homepage! Plenty of Mikumikudance instruction and info!