blog image

2. A new feature: Online Instructions

By SkySaac    Published at 2025-01-11

As some of you might have noticed already there is a new feature on this site that is available for some of the newly updated and added MOCs. You can now view their instructions directly on the computer, but not in a pdf format, but instead in an (more or less) interactive format. Meaning that you can turn the model at each step, allowing for a hopefully easy assembly, though I personally think that my normal pdf instructions probably were good enough for an easy assembly too :D. For me this new feature means MUCH less work as the pdf instructions always take hours of work (depending on the size of the model of course). When making the instructions for this viewer I only need to arrange the step order in which the parts get added in a nice way and don't have to worry at all about things like the camera rotation or anything that usually take a lot of time and for sure are not fun at all to do. Of course if you (for some reason) still want pdf instructions for any of the MOCs, I will still make them for you!

This is the button you'll see when the online instructions are available for the MOC.
This is the button you'll see when the online instructions are available for the MOC.

There also are a lot of settings that can be toyed with. Everything from the background color to the movement speed of the camera. Although I do recommend to not touch them (except for maybe the colors), as you can quickly destroy the usability of the instruction viewer... Luckily there is a reset button ;)

How the instruction viewer itself looks like.
How the instruction viewer itself looks like.

The technical background

The technical framework of this new feature is in some parts similar to the existing 3D viewer that was already present fro some MOCs, so I was able to copy quite some code. How it currently works is that when you first open the site the assemblies for each step get made all at once and then the one fitting the current step will just be picked out and displayed. At first I thought that maybe assembling the step specific assembly as someone opens the step would be the way to do it, as I was suspecting that if I would do it all at once the initial delay would be too big when one enters the site. But that problem didn't manifest and the initial delay is quite short, so all good :P. Like it is with the 3D viewer, I don't have this feature enabled on every MOC, not even every new one. Reasons may either be that I just haven't prepared it for the instructions, or a problem that occurred in the same way with the 3D viewer is that I used a brand new Lego piece whose model is not part of the ldraw library yet. A feature that I thought quite a bit about during development was the auto rotation of the displayed parts and the camera. I wanted to have it so that the model automatically turns to the newly added parts so that they are automatically visible and that the user doesn't have to turn the model themself. How it works right now, is that the viewer just checks in which direction from the center point of the previously added parts the center point of the newly added parts is. The camera then has a few predetermined positions and selects the closest one. It quite simple and works well, but can, if the model is pretty complicated, not work in a few cases. But since the user can just rotate the MOC themself, it should be fine. What it does change, is that I need to be more careful with the order in which the parts get assembled, as it's quite easy for the camera to flip around if parts get added in different orders. I would love to program this feature a different way some day, but it won't be that easy. The idea would be to again have some predetermined positions of the camera and then render a lower quality image and detect from which angle the new parts in the step can be seen best from. I would have to tinker around a lot with shaders for that to work and well I guess I can't be bothered to do that, so it'll probably stay the way it is right now :P.

Future additions

There are a few things which I am planning to add as new features for the instruction viewer in the future. I want to improve the touch controls as they aren't as smooth as I want them yet, luckily the mouse controls are working fine already. Many instructions from Lego and other companies have rotation indicator whenever the model should be rotated for the current step. I am thinking about adding this as well, although it's not that high on my todo list. Metallic parts should get a small indicator in the parts list that they are metallic as it's not directly visible that which color they have right now. That's a feature that should be quite easy so add, so it should be coming more or less soon. A big feature that I know some people want, is an option for outlining newly added parts. This normally helps the user to identify the newly added parts on the picture And although currently the new and old parts in the same step can already be differentiated, as the old parts are of faded colors, I do still will add on outline in the future. When exactly I am going to add these features (if ever), that I don't know yet, you'll just have to wait and see :).

Terms of Service

All of this site is licensed under CC BY-NC 4.0
Feel free to contact me if you require a different one!

FlosRocketBricks

This website provides free digital files and instructions for spaceflight related MOCs out of building blocks!
This website doesn't use ANY cookies! Cookies are only good when I am eating them.