Schwarzerblitz currently supports custom content of the following types:

• characters
  
• stages
  
• story episodes

Once you are subscribed to any of those items, they will be available for play and appear alongside the core content. Notice that workshop content is disabled when playing the game in TourneyMode.

The Workshop Uploader is available as a separate tool from the main game. The tool can be downloaded from this DropBox link[www.dropbox.com].
In the future, it will be able to be downloaded from the Steam GUI, but this function is not available yet.

If for some reason you can't find download the tool from the link or you cannot find it using the Steam GUI, join the Discord server[discord.gg] to receive a copy of it.

A basic modding kit for creating new characters can be downloaded from this link[cdn.discordapp.com]. The kit includes:

• A 33 pages guide on the basics of creating and configuring a new character;
  
• A sample character with two costumes and a basic moveset;
  
• A sample Blender file configured with the universal character rig + a poseable dummy

The tools required to create a custom character are:

• Blender 2.79[download.blender.org] or older (Blender 2.8 removed support for the .x exporter)
  
• An image editor
  
• A text editor

To add the DirectX exporter to Blender, please follow this thread[blender.stackexchange.com].


Import a .x model from Schwarzerblitz:

Prepare an already rigged model for use in Scharzerblitz:

Rigging an existing model for use in Scharzerblitz:

There is currently no official guide on how to edit the files for a stage. Here's a quick explanation of the main fields of the configuration file:



The 3D model formats accepted are .obj, .x and .3ds

There is currently no open documentation on how to create a story episode - I will add it in the future. You can get inspiration from the episodes in media/scenes/story/episodes, as they follow the same format and require the same files.

Follow the instruction from the section "Installing the Schwarzerblitz Workshop Uploader" to install the uploading tool "SCHWB_Workshop_Uploader". Extract the content of the zip in a folder. You should see an executablenamed SCHWB_Workshop_Uploader.exe.


To add new content, enter the folder named workshop. You will find a file named "itemList.ini". Open it with a text editor.


To help you understand how it works, I will use one of my dummy characters. After you create a character, paste your character folder inside the "workshop" folder and add it's location to the itemList.ini file (in this case, characters/chara_sample). Enter the folder chara_sample and create a text file named workshop.ini as in the following:


Once the file is complete, go back to the main folder and double click on SCHWB_Workshop_Uploader.exe.


The console will show the progress and show a small amount of error messages. The right window will display instead the local location of all the installed workshop content.
If the upload was successful, a "success" message will be displayed in the console. Moreover, inside the uploaded content folder, you will find a new file called "workshopItemFileId.ini". If the upload has been successful, this file will host one single number greater than 0.
Make sure to keep this file and don't delete it, as it is needed to update your workshop content! Without it, the uploader will instead create a new item!

To update your already submitted workshop content:

• go back to the content's folder;
  
• update the files you need to;
  
• open the file workshop.ini;
  
• increase the version;
  
• change the changelog message;
  
• run the uploader as in the "Uploading content" section;
  
• the uploader will take care of everything else - that's it!

Be sure that the file named "workshopItemFileId.ini" has been created by the uploader. If the file is not there, the content will be submitted as a new workshop item!

As of 09.07.2020, Workshop Characters have the following limitations:

• No arcade endings (the game will simply not find the files)
  
• No climatic battle against a Workshop character or on a Workshop stage
  
• No diorama (this will be fixed in the future)
  
• No marker is shown when arcade is completed with them

Some of these features will be added in the near future