Unturned Modding SDK (CPL's SDK)

This repository contains a set of Unity Editor tools designed to streamline the creation and exporting of custom assets for the game Unturned. It provides custom inspectors for Unturned asset types, custom generators for Unturned assets, miscellanious tools for easy asset creation, and a tool for bundling and exporting them in the required format.

Features

Items

• Item Generator | Creates simple Item Prefabs quickly
• Item Asset | Create Item Dat files within unity
• Spawn Table Asset | Create Spawn Tables within Unity
• ID Browser | View all IDs of Item Definition Assets within a folder
• Empty ID Checker | Check the ID range of the Item Definition Assets within a folder for unused IDs
• Steam Guide Exporter | Create an ID list of all Item Definition Assets in a folder
• Crafting Blacklist Asset | Creates Crafting Blacklist Asset files within unity
• Crafting Asset | Creates Crafting Asset files within unity
• Tag Asset | Creates a tag asset in unity

Clothing

• Clothing Generator | Create Clothing prefabs and materials quickly
• Clothing Variant Generator | Create color variations of existing clothing textures
• Clothing Definition Asset | A clothing-specific version of the Item Definition Asset

Objects

• Object Generator | Create simple object prefabs quickly
• Object Asset | Create Object Dat files within Unity
• Material Palette | Create a Material Palette Asset within Unity

Resources and Foliage

• Resource Generator | Create simple resource prefabs quickly
• Foliage Asset | Create a Foliage Asset file within Unity
• Resource Dat | Create a Resource Dat file within Unity

Mapping Assets

• Ground Material Asset | Create an asset file for map ground materials
• Airdrop Asset | Create an asset file for Airdrops
• Road Asset | Create an asset file for new road assets
• Weather Asset | Create an asset file for weather assets

Misc Assets

• Stereo Song Asset | Create a custom music asset
• Animal Asset | Creates an asset file for animals
• Effect Asset | Creates an asset file for effects

Textures and Materials

• Material Importer | Select textures from outside of Unity and quickly import them with preset settings
• Color Variation Maker | Create color variations of any texture

Prefab Tools

• Duplicator and Modifier | Batch duplicates prefabs with set modifications
• Multi-Material Duplicator | Create Material varients from prefabs
• Item Prefab Fixer | Reorganize Item Models so the model is on a "Model_0" game object at a set scale

Build and Export

• Master Bundle Tool | Bundle your asset bundles while automatically creating a masterbundle.dat and exporting all in-unity dat/asset files

Requirements

• Unity Editor version 2022.3.62f3
• Unturned Game (For testing the exported assets)
• Unity Package: com.unity.editorcoroutines (The Master Bundle Tool will prompt to install if missing)

Getting Started

1. Import the official Unturned example project into Unity from Your_Unturned_Install_Directory\Extras\Sources\Project.unitypackage.
2. Download the latest CPL_SDK_Full_<Version>.unitypackage from the Releases page.
3. Import the downloaded package into your Unity project (Assets > Import Package > Custom Package...).
4. Tools should now appear under the CPL's SDK menu in Unity, and custom inspectors will be active for relevant asset types.
5. Other assets can be found under CPL's SDK in the add asset menu

License

This project uses a modified MIT license. The full license text can be found here.

Credits & Support

• Development: CPL
• Contributions/Support: JienSultan, PuggosWorld, SomeAussieGamer
• Join our Discord: https://discord.gg/NuktZyWCWX