Inkipedia:3D Models

From Inkipedia, the Splatoon wiki
Revision as of 19:05, 24 November 2021 by Shahar (talk | contribs) (S1 models)
Shortcut:
INK:3D

The 3D Models project's goal is to construct pseudo-3D images of the weapons in Splatoon that can be freely rotated.

Example

S2 Weapon Main .96 Gal Deco.png

Template:!! Note: This is not for the faint of heart. It requires a bit of knowledge on how Blender works and a lot of time and patience since a lot of models will not be centered correctly by default or would require manually editing the textures, thus requiring plenty of tweaking to get them ready for the process.

Requirements

The rendering system works as a Blender add-on, so you will need to install the latest version of Blender.

You will also need the latest version of the add-on itself. Select "Code" and then "Download Zip" from the menu and you should be good to go.

Initial setup

If you have never used Blender before, you will want to play around with it a bit to get used to the basics.

This might be a good video to follow: YouTube ABSOLUTE Beginner Basics of Blender

Installation

Once you have got Blender up and running, you will need to install the add-on itself. This is pretty straightforward.

Click Edit → Preferences and select the Add-ons sub-menu.
Click on the "Install" button at the top right and then select the zip file you have downloaded.

You should see the SplatoonImageGenerator add-on pop up. Tick the checkbox to the left of the menu to enable the add-on.

Now that you have got the add-on installed, you will need to install the libraries the add-on needs to run. Expand the menu that just appeared with the dropdown arrow and click on "Install Dependencies". This will install the Python library Pillow so that it can be used by Blender.

Troubleshoot >
In case that the button does not work, or an error appears either near the button or on the bottom bar, don't panic! Open Command Prompt and navigate to the location where your python.exe application is by entering the command cd <Blender Folder>/<Blender Version>/python/bin. Then, enter the command python -m pip install pillow to install the libraries required.

If this does not work either, you might be successful copying the Pillow installation folder from your global Python site-packages to Blender's site-packages. You'll have to find your global site-packages, since it differs per user, but Blender's site-packages is located in <Blender Folder>/<Blender Version>/python/lib/site-packages. You'll need both the PIL and Pillow folders.

Once you successfully install the required libraries, you should see a new category in the tools panel (press N on your keyboard to open the tools panel when in the 3D layout).

That's it! You're all set up and ready to start loading in your models.

Getting models

You can get almost all of the Splatoon models from https://www.models-resource.com/nintendo_switch/splatoon2. The add-on has only been tested with a select few weapon models, so don't be too surprised if it does not work out of the box for some of the other types. However, with a bit of tweaking, you should be able to take images of any model of your choice, Splatoon or otherwise!

Importing models

Importing models is quite straightforward, simply go to File → Import → fbx, and select the model you would like to take an image of.

Using the add-on

Add-on structure

A picture of the add-on in Blender

The main meat of the add-on is its ability to rotate and render 3D models to form the pseudo-3D images you see around the wiki. However, it comes with a few helper functions to make your life easier when rendering the models. The helper functions can be found under "Basic Settings" and help complete commonly used tasks on the model to prepare it for rendering. Their exact functions are as follows:

Base armature

This is to select the top-level armature object of the model, which will dictate which model is rotated and processed. If something is not working right, check that the correct armature is selected!

Rotate and Scale

Rotate and Scale does exactly what it says, it rotates the model and scales it up so it is easier to navigate from the default Blender view. It relies on the fact that each model comes with the same starting rotation, though, so take care to check it has done its job correctly.

Position Cursor

The add-on rotates the 3D model around the 3D cursor when rendering, rather than object origin, since the origin is rarely at the centre of mass of the model. This button places the 3D cursor at an approximate midpoint of the model. Again, it is not infallible, so check that it looks approximately right before rendering.

Position Camera

This button positions the camera to look at the model side-on, with enough margin around the edges to leave some space if the model grows when rotating. Check that the model is centred well and that it fills the camera with a bit of margin.

Check Object Rotation

This button is simply there for a check, it rotates the model as it would be rotated during rendering, to see whether it fits within frame and if rotation is being calculated accurately. Just ensure that the model spins around and pivots up and down.

Fix Object Material

For some reason, Splatoon models are imported with backfaces visible. This button simply disables this for all meshes, so that you do not have to do it yourself. You can easily see what it does to an imported model in the Rendered view.

Set HDRI

This just adds a skatepark HDRI to the scene to add some organic lighting.

Some further options are available in Advanced Settings:

X Rotations

Sets the number of rotations in the X-axis displayed on the final image. More leads to a smoother rotation experience, at the cost of higher storage space.

X Resolution and Y Resolution

These determine the resolution of the image rendered by Blender, NOT the final generated image. There does not appear to be much of a use for this, except to tweak the aspect ratio, but it has been left in anyway.

Output Format

Does exactly what it says. Choose between PNG (transparent) or JPEG (lower file size)

Finally, to render, there are the following options:

Output Folder

The folder where the final image will be placed. CAUTION: The add-on uses a folder called 'tmp' within the selected folder to store images, so maybe make a separate folder to store the outputs if you already have a folder called tmp with the important stuff.

Render to Wiki Image

Renders the final images, generates a weapon.{output format} file and a weaponoffsets.txt file with the description needed to get it to work.

Taking images

The basic steps to take an image are quite straightforward. Import your model, select the armature, go down the list of buttons in Basic settings, select your output folder and render! However, use each of the steps with care, as every Splatoon model is different and the addon may make mistakes. Check each step to see whether it has worked as intended. Checks are as follows:

Rotate and Scale

Check that the model is in the right orientation (muzzle facing left/right, handle facing down, etc.) If this is not the case, you will have to rotate the armature manually to fix it.

Also, check that the model rotates as intended (i.e. local axis are lined up). The local Y-axis should pitch the armature up and down as if it were aiming towards higher and lower targets. If this is not the case, you will have to reposition the armature and apply scale as necessary to get this to happen.

Position Cursor

This usually works fine, but check that the cursor is at the approximate centre of the model. You can also set Blender's pivot point to a 3D cursor, and check that the model rotates naturally around it. If not, reposition the armature (or 3D cursor) so that it is about right.

Position Camera

Check that the model is fully framed and that when rotated it never leaves the frame. You could, at this point, zoom the camera in to frame the model even closer to get a higher resolution final image, being careful that nothing leaves the frame.

Fix Object Material

Just check that the mesh does not look weird and inside-out after using this. Sometimes you will not have to use this button at all. If the material still looks wrong because of colour issues, shininess, surface detail or missing glow, check Advanced Usage to modify the material.

Set HDRI

Check that the model lights up in rendered view. If you do not want to use the skatepark HDRI, simply select your own and skip this button, which would normally overwrite it.

Advanced usage

Setting materials

If your material looks a bit off, the FBX import likely did not use all the textures needed for your model. It is easy enough to fix this, but some experience with Blender's shader editor is useful but not necessary. Here are some common issues and their fixes:

Missing glow

The model is likely missing an emission shader. Add an image texture to the object material and import the texture ending with _emm from the model's images folder. Connect this as the fac value to a MixRGB node and plug this into the emission input of Principled BSDF. Turn up the emission strength, set one colour to black and the other to one of your choosing, and you should be good to go.

Missing surface detail

It is possible that the normal map for the model is not being applied strongly enough. Turn up the strength on the Normal Map node connected to the normal input of the Principled BSDF.

Missing colours or black sections

This might be due to a Team Colour not being applied. Add an image texture to the material and import the image ending with _tcl from the model's images folder. Connect this as Fac to a MixRGB node. Connect the albedo texture that should be already connected to Base Color to one color input. Choose a color for the other input and plug the output of the MixRGB into the Base Color of the Principled BSDF. This hopefully should fix any colour issues with the model.

Not shiny enough

Possibly due to a missing metallic texture or roughness texture. Check which nodes on the Principled BSDF have nothing connected, out of Metallic and Roughness. Find the image ending with _mtl for Metallic, or _rgh for Roughness in your model's images folder. Add the ones you need as image textures and connect them up to the relevant node on the Principled BSDF block.

Changing lighting

Feel free to add any other lighting if needed, if you feel it improves the look of the model. For instance, consider area lights to improve surface detail and cast shadows or coloured sunlight to add a tint to the model. You can also change the HDRI to add a different lighting effect. Just remember not to press the "Set HDRI" button as this will overwrite any HDRIs you use.

Uploading your image

Upload your weapon.png image file with Special:Upload. In-case of files larger than 5 MB size, upload with Special:UploadWizard.

Copy the text in weaponoffset.txt to the file's page and enter the link address of the file page to the URL parameter between the <nowiki> tags.

Model repositories

Process example

Weapons

This is a list of weapon models that need render or are finished. Needed weapons have blank cells while finished ones have blue cells with letter ratings. The ratings are based on their quality and resemblance to the weapon icons. Ratings are S,A,B,C,D,F,X,?. If two ratings are present the weapon may have two stages (for example, folded and unfolded of the Brellas)

The renders are actively being updated. Those that have been changed are marked with an apostrophe, but please note that the old and new ratings might not match.

Weapon models
Name Splatoon "S" icon.svg Splatoon 2 "2" icon.svg Splatoon 3 "3" icon.svg
Mains
Shooter
S2 Weapon Main Sploosh-o-matic.png Sploosh-o-matic A
S2 Weapon Main Neo Sploosh-o-matic.png Neo Sploosh-o-matic A
S2 Weapon Main Sploosh-o-matic 7.png Sploosh-o-matic 7 A
S2 Weapon Main Splattershot Jr..png Splattershot Jr. A
S2 Weapon Main Custom Splattershot Jr..png Custom Splattershot Jr. B
S2 Weapon Main Kensa Splattershot Jr..png Kensa Splattershot Jr. B
S2 Weapon Main Splash-o-matic.png Splash-o-matic A
S2 Weapon Main Neo Splash-o-matic.png Neo Splash-o-matic A
S2 Weapon Main Aerospray MG.png Aerospray MG A'
S2 Weapon Main Aerospray RG.png Aerospray RG A'
S2 Weapon Main Aerospray PG.png Aerospray PG A'
S2 Weapon Main Splattershot.png Splattershot A
S2 Weapon Main Tentatek Splattershot.png Tentatek Splattershot A
S Weapon Main Wasabi Splattershot.png Wasabi Splattershot
S2 Weapon Main Kensa Splattershot.png Kensa Splattershot A
S2 Weapon Main Hero Shot Replica.png Hero Shot Replica A
S2 Weapon Main Octo Shot Replica.png Octo Shot Replica A
S2 Weapon Main .52 Gal.png .52 Gal A'
S2 Weapon Main .52 Gal Deco.png .52 Gal Deco A'
S2 Weapon Main Kensa .52 Gal.png Kensa .52 Gal A'
S2 Weapon Main N-ZAP '85.png N-ZAP '85 A
S Weapon Main N-ZAP '89.png N-ZAP '89 A
S Weapon Main N-ZAP '83.png N-ZAP '83 A
S2 Weapon Main Splattershot Pro.png Splattershot Pro A
S2 Weapon Main Forge Splattershot Pro.png Forge Splattershot Pro A
S Weapon Main Berry Splattershot Pro.png Berry Splattershot Pro
S2 Weapon Main Kensa Splattershot Pro.png Kensa Splattershot Pro B
S Weapon Main Dual Squelcher.png Dual Squelcher
S Weapon Main Custom Dual Squelcher.png Custom Dual Squelcher
S2 Weapon Main .96 Gal.png .96 Gal A'
S2 Weapon Main .96 Gal Deco.png .96 Gal Deco A'
S2 Weapon Main Jet Squelcher.png Jet Squelcher A
S2 Weapon Main Custom Jet Squelcher.png Custom Jet Squelcher A
Blaster
S2 Weapon Main Luna Blaster.png Luna Blaster A
S2 Weapon Main Luna Blaster Neo.png Luna Blaster Neo A
S2 Weapon Main Kensa Luna Blaster.png Kensa Luna Blaster A
S2 Weapon Main Blaster.png Blaster A
S2 Weapon Main Custom Blaster.png Custom Blaster A
S2 Weapon Main Hero Blaster Replica.png Hero Blaster Replica A
S2 Weapon Main Range Blaster.png Range Blaster A
S2 Weapon Main Custom Range Blaster.png Custom Range Blaster A
S2 Weapon Main Grim Range Blaster.png Grim Range Blaster A
S2 Weapon Main Clash Blaster.png Clash Blaster C
S2 Weapon Main Clash Blaster Neo.png Clash Blaster Neo C
S2 Weapon Main Rapid Blaster.png Rapid Blaster A
S2 Weapon Main Rapid Blaster Deco.png Rapid Blaster Deco A
S2 Weapon Main Kensa Rapid Blaster.png Kensa Rapid Blaster A
S2 Weapon Main Rapid Blaster Pro.png Rapid Blaster Pro A
S2 Weapon Main Rapid Blaster Pro Deco.png Rapid Blaster Pro Deco A
Burst Fire or Semi-Automatic
S2 Weapon Main L-3 Nozzlenose.png L-3 Nozzlenose A
S2 Weapon Main L-3 Nozzlenose D.png L-3 Nozzlenose D A
S2 Weapon Main Kensa L-3 Nozzlenose.png Kensa L-3 Nozzlenose A
S2 Weapon Main H-3 Nozzlenose.png H-3 Nozzlenose A
S2 Weapon Main H-3 Nozzlenose D.png H-3 Nozzlenose D A
S2 Weapon Main Cherry H-3 Nozzlenose.png Cherry H-3 Nozzlenose A
S2 Weapon Main Squeezer.png Squeezer B
S2 Weapon Main Foil Squeezer.png Foil Squeezer B
Roller
S2 Weapon Main Carbon Roller.png Carbon Roller A
S2 Weapon Main Carbon Roller Deco.png Carbon Roller Deco A
S2 Weapon Main Splat Roller.png Splat Roller A
S2 Weapon Main Krak-On Splat Roller.png Krak-On Splat Roller A
S Weapon Main CoroCoro Splat Roller.png CoroCoro Splat Roller
S2 Weapon Main Kensa Splat Roller.png Kensa Splat Roller A
S2 Weapon Main Hero Roller Replica.png Hero Roller Replica A
S2 Weapon Main Dynamo Roller.png Dynamo Roller B
S2 Weapon Main Gold Dynamo Roller.png Gold Dynamo Roller B
S Weapon Main Tempered Dynamo Roller.png Tempered Dynamo Roller
S2 Weapon Main Kensa Dynamo Roller.png Kensa Dynamo Roller B
S2 Weapon Main Flingza Roller.png Flingza Roller B
S2 Weapon Main Foil Flingza Roller.png Foil Flingza Roller B
Brush
S2 Weapon Main Inkbrush.png Inkbrush A
S2 Weapon Main Inkbrush Nouveau.png Inkbrush Nouveau A
S2 Weapon Main Permanent Inkbrush.png Permanent Inkbrush A
S2 Weapon Main Octobrush.png Octobrush A
S2 Weapon Main Octobrush Nouveau.png Octobrush Nouveau A
S2 Weapon Main Kensa Octobrush.png Kensa Octobrush A
S2 Weapon Main Herobrush Replica.png Herobrush Replica A
Charger
S2 Weapon Main Classic Squiffer.png Classic Squiffer A
S2 Weapon Main New Squiffer.png New Squiffer A
S2 Weapon Main Fresh Squiffer.png Fresh Squiffer A
S2 Weapon Main Splat Charger.png Splat Charger A
S Weapon Main Kelp Splat Charger.png Kelp Splat Charger
S2 Weapon Main Firefin Splat Charger.png Firefin Splat Charger A
S Weapon Main Bento Splat Charger.png Bento Splat Charger
S2 Weapon Main Kensa Charger.png Kensa Charger A
S2 Weapon Main Hero Charger Replica.png Hero Charger Replica A
S2 Weapon Main Splatterscope.png Splatterscope A
S Weapon Main Kelp Splatterscope.png Kelp Splatterscope
S2 Weapon Main Firefin Splatterscope.png Firefin Splatterscope A
S Weapon Main Bento Splatterscope.png Bento Splatterscope
S2 Weapon Main Kensa Splatterscope.png Kensa Splatterscope A
S Weapon Main E-liter 3K.png E-liter 3K
S Weapon Main Custom E-liter 3K.png Custom E-liter 3K
S2 Weapon Main E-liter 4K.png E-liter 4K A
S2 Weapon Main Custom E-liter 4K.png Custom E-liter 4K A
S Weapon Main E-liter 3K Scope.png E-liter 3K Scope
S Weapon Main Custom E-liter 3K Scope.png Custom E-liter 3K Scope
S2 Weapon Main E-liter 4K Scope.png E-liter 4K Scope A
S2 Weapon Main Custom E-liter 4K Scope.png Custom E-liter 4K Scope A
S2 Weapon Main Bamboozler 14 Mk I.png Bamboozler 14 Mk I A
S2 Weapon Main Bamboozler 14 Mk II.png Bamboozler 14 Mk II A
S2 Weapon Main Bamboozler 14 Mk III.png Bamboozler 14 Mk III A
S2 Weapon Main Goo Tuber.png Goo Tuber A
S2 Weapon Main Custom Goo Tuber.png Custom Goo Tuber A
Slosher
S2 Weapon Main Slosher.png Slosher B
S2 Weapon Main Slosher Deco.png Slosher Deco B
S2 Weapon Main Soda Slosher.png Soda Slosher B
S2 Weapon Main Hero Slosher Replica.png Hero Slosher Replica B
S2 Weapon Main Tri-Slosher.png Tri-Slosher A
S2 Weapon Main Tri-Slosher Nouveau.png Tri-Slosher Nouveau A
S2 Weapon Main Sloshing Machine.png Sloshing Machine A
S2 Weapon Main Sloshing Machine Neo.png Sloshing Machine Neo A
S2 Weapon Main Kensa Sloshing Machine.png Kensa Sloshing Machine A
S2 Weapon Main Bloblobber.png Bloblobber A
S2 Weapon Main Bloblobber Deco.png Bloblobber Deco A
S2 Weapon Main Explosher.png Explosher A
S2 Weapon Main Custom Explosher.png Custom Explosher A
Splatling
S2 Weapon Main Mini Splatling.png Mini Splatling A
S2 Weapon Main Zink Mini Splatling.png Zink Mini Splatling A
S Weapon Main Refurbished Mini Splatling.png Refurbished Mini Splatling
S2 Weapon Main Kensa Mini Splatling.png Kensa Mini Splatling A
S2 Weapon Main Heavy Splatling.png Heavy Splatling A
S2 Weapon Main Heavy Splatling Deco.png Heavy Splatling Deco A
S2 Weapon Main Heavy Splatling Remix.png Heavy Splatling Remix A
S2 Weapon Main Hero Splatling Replica.png Hero Splatling Replica A
S2 Weapon Main Hydra Splatling.png Hydra Splatling A
S2 Weapon Main Custom Hydra Splatling.png Custom Hydra Splatling A
S2 Weapon Main Ballpoint Splatling.png Ballpoint Splatling B
S2 Weapon Main Ballpoint Splatling Nouveau.png Ballpoint Splatling Nouveau B
S2 Weapon Main Nautilus 47.png Nautilus 47 B
S2 Weapon Main Nautilus 79.png Nautilus 79 B
Dualies
S2 Weapon Main Dapple Dualies.png Dapple Dualies A
S2 Weapon Main Dapple Dualies Nouveau.png Dapple Dualies Nouveau A
S2 Weapon Main Clear Dapple Dualies.png Clear Dapple Dualies B
S2 Weapon Main Splat Dualies.png Splat Dualies A
S2 Weapon Main Enperry Splat Dualies.png Enperry Splat Dualies A
S2 Weapon Main Hero Dualie Replicas.png Hero Dualie Replicas A
S2 Weapon Main Kensa Splat Dualies.png Kensa Splat Dualies A
S2 Weapon Main Glooga Dualies.png Glooga Dualies A
S2 Weapon Main Glooga Dualies Deco.png Glooga Dualies Deco B
S2 Weapon Main Kensa Glooga Dualies.png Kensa Glooga Dualies A
S2 Weapon Main Dualie Squelchers.png Dualie Squelchers A
S2 Weapon Main Custom Dualie Squelchers.png Custom Dualie Squelchers A
S2 Weapon Main Dark Tetra Dualies.png Dark Tetra Dualies A
S2 Weapon Main Light Tetra Dualies.png Light Tetra Dualies A
Brella
S2 Weapon Main Splat Brella.png Splat Brella A A
S2 Weapon Main Sorella Brella.png Sorella Brella A A
S2 Weapon Main Hero Brella Replica.png Hero Brella Replica A A
S2 Weapon Main Tenta Brella.png Tenta Brella A A
S2 Weapon Main Tenta Sorella Brella.png Tenta Sorella Brella A A
S2 Weapon Main Tenta Camo Brella.png Tenta Camo Brella A A
S2 Weapon Main Undercover Brella.png Undercover Brella A A
S2 Weapon Main Undercover Sorella Brella.png Undercover Sorella Brella A A
S2 Weapon Main Kensa Undercover Brella.png Kensa Undercover Brella A A
Stringers
S3 Weapon Main Tri-Stringer.png Tri-Stringer B
Splatanas
S3 Weapon Main Splatana Stamper.png Splatana Stamper A
Subs
S2 Weapon Sub Splat Bomb.png Splat Bomb B
S2 Weapon Sub Suction Bomb.png Suction Bomb B
S2 Weapon Sub Burst Bomb.png Burst Bomb B
S Weapon Sub Seeker.png Seeker
S2 Weapon Sub Curling Bomb.png Curling Bomb B
S2 Weapon Sub Autobomb.png Autobomb B
S Weapon Sub Disruptor.png Disruptor
S2 Weapon Sub Toxic Mist.png Toxic Mist B
S2 Weapon Sub Point Sensor.png Point Sensor B
S2 Weapon Sub Splash Wall.png Splash Wall B
S2 Weapon Sub Sprinkler.png Sprinkler B
S2 Weapon Sub Squid Beakon.png Squid Beakon B
S2 Weapon Sub Fizzy Bomb.png Fizzy Bomb B
S2 Weapon Sub Torpedo.png Torpedo ? B
Specials
S Weapon Special Inkstrike.png Inkstrike
S Weapon Special Inkzooka.png Inkzooka
S Weapon Special Killer Wail.png Killer Wail
S Weapon Special Kraken.png Kraken
S2 Weapon Special Tenta Missiles.png Tenta Missiles
S2 Weapon Special Sting Ray.png Sting Ray
S2 Weapon Special Inkjet.png Inkjet
S2 Weapon Special Splat-Bomb Launcher.png Splat-Bomb Launcher
S2 Weapon Special Ink Storm.png Ink Storm A
S2 Weapon Special Baller.png Baller B
S2 Weapon Special Bubble Blower.png Bubble Blower
S2 Weapon Special Ultra Stamp.png Ultra Stamp
S3 Weapon Special Zipcaster.png Zipcaster S S
S3 Weapon Special Kraken Royale.png Kraken Royale A A
S3 Weapon Special Tacticooler.png Tacticooler A A
Others
Princess Cannon
Rainmaker B
Ink Cannon
Single-Player 1st slot: Splat Bomb
Single-Player 2nd slot: Burst Bomb/Curl Bomb
Single-Player 3rd slot: Seeker/Autobomb
S2 Weapon Main Hero Charger Replica Marie B
S Rainmaker beta / S2 Rainmaker Octo Expansion B
S2 Weapon Main Hero Shot Lv.0 A
S2 Weapon Main Hero Shot Lv.1 A
S2 Weapon Main Octo Shot Lv.0 Green A
S2 Weapon Main Hero Roller Lv.1 Red em A
S2 Weapon Main Hero Charger Lv.1 Red em
S2 Weapon Main Hero Slosher Lv.1 Red em B
S2 Weapon Main Hero Splatling Lv.1 Red em
S2 Weapon Main Hero Dualies Lv.1 Red em A
S2 Weapon Main Hero Brella Lv.1 Red em A A
S2 Weapon Main Hero Blaster Lv.1 Red em A
S2 Weapon Main Herobrush Lv.1 Red em A
Grizzco Blaster
Grizzco Brella
Grizzco Charger
Grizzco Slosher
S2 Octo Hero Blaster/Roller/Slosher/Brush/Dualies/Brella ?

[Edit]

Help develop the add-on!

Needed features
  • Auto import textures: It would be nice to have a system that would automatically import emission maps, team colour textures etc.
Known bugs
  • Micro difference in position due to combined floating point errors after rotation.
Github

You can find the Github here: https://github.com/RadiatorSyrup/SplatoonImageGenerator

Any contributions are very welcome.

Special thanks

  • Darkid from TF2wiki for the HLMV script.
  • Radiator Syrup from freelancer site for the Blender add-on.
  • Shahar for the implementation to Inkipedia.