# 🛠️ Samurai Armory – Forge your own Japanese-inspired weapons directly in Unreal Engine
Watch the Showcase Video : https://youtu.be/EVSK-Drvn_8
Samurai Armory is a versatile plugin that lets you create modular Japanese-style weapons directly in the editor — with zero coding required.
Mix and match blades, guards, pommels, shafts, and wraps through an intuitive editor widget.
Adjust the shaft length to switch from a katana to a naginata — or combine any blade with any guard, pommel, or wrap for full modularity.
Every part of the weapon is customizable — both visually and structurally.
⚠ This is not a runtime weapon creator.
This is an editor-only tool designed for developers to easily create custom weapons.
> All meshes were modeled in Blender, and all textures were created in Substance 3D Designer.
---
## 🔧 Plugin Usage
After installing the plugin, click the Samurai Armory button in the top toolbar to launch the weapon customization editor.
No setup required – everything works directly inside the Unreal Editor.
## ⚙️ Core Features
🔩 30+ handcrafted meshes: blades, fittings, spikes, wraps, and more
🎨 20+ tileable materials: steel, wood, dirt, scratches, and more
🧠 100+ tweakable parameters via a clean, user-friendly UI
🧱 Advanced Master Material with vertex color masking (Blade = R, Fittings = G, Shaft = B)
🖌️ Built-in paint system to manually paint color and normal details directly on your weapon
💾 Save & load presets anytime to iterate fast
🧰 100% plug-and-play — no coding or shader knowledge needed
📘 In-plugin documentation included
🔄 Set the pivot point location before merging — for accurate weapon placement in character hands
🧩 LODs are automatically generated during mesh merging
🎁 Comes with 5 example presets to get started quickly
🧪 Includes a complete Editor UI (buttons, sliders, color pickers...) you can reuse in your own projects
> Assembled weapons range between 2,000 and 12,000 triangles, depending on configuration.
> All parts are UV-unwrapped and arranged in a clean shared atlas layout (see last image), optimized for baking and texture packing.
## 📦 Preview Assets
All 3D models shown in the FAB 3D viewer are displayed with 2K tileable textures, optimized for performance and flexibility.
(Note: actual in-editor materials can go up to 4K)
---
## 🔧 System Requirements
Some of the included tileable textures (such as steel or wood variants) are provided in 4K resolution to ensure visual quality on large weapons.
While the plugin is optimized for Editor use, performance may vary slightly on low-end machines — especially during material preview or painting.
With a GTX 1060, for example, you may experience minor lag during painting or material preview — but the plugin remains fully usable.
Due to engine changes in UE 5.6, some material adjustments were necessary. You may notice slightly reduced performance compared to the 5.4–5.5 versions in certain cases.
## 🧪 Optimized for Performance
The Master Material delivers high-end customization (scratches, emissive, color variation...), and can push over 600 instructions with 20+ samplers when fully enabled — great for previews, but not ideal for runtime.
That’s why Samurai Armory includes a fully automated bake system, using Unreal's native Bake Out Material, enhanced by custom Python scripts.
You can:
- 🧵 Create a lightweight Material Instance
- 🖼 Generate 3 optimized textures directly in-engine: BaseColor, Normal, ORM
- 🕹 Make your weapons runtime-ready in just a few clicks
---
## 🎨 Painting System
Samurai Armory includes a dedicated painting tool that lets you directly paint colors and normal details on your weapon using a render target.
This system is completely separate from the procedural masks (scratches, stains, dirt, etc.) and gives you full creative freedom.
Paint engravings, symbols — or anything else you want.
> Paint data is stored in 2K textures and can be saved/loaded independently.
---
## 🎯 Who is it for?
Whether you're working on an action RPG, a samurai-themed game, or a post-apocalyptic survival game —
Samurai Armory is made for developers who want to focus on creativity, not complexity.
Perfect for indie teams and solo devs building their own arsenal, without writing a single line of code.
---
## ✅ Technical Info
- Compatible with Unreal Engine 5.4, 5.5, and 5.6
- Works exclusively in editor mode (Editor Utility Widgets)
- All features are accessible through a guided workflow — no need to dig through Blueprints or documentation
---
## 💬 Support & Community
Join the Discord server for help, feedback, or to showcase your creations : https://discord.gg/zCAgv7W64K
---
> 📝 Note: Samurai Armory is designed for editor use only.
> It is not a runtime weapon system or a full 3D painting suite — it’s a fast, focused toolset for Unreal Engine.