Skip to content
mouse114514 edited this page Sep 6, 2026 · 2 revisions

Getting Started

中文版

Requirements

  1. Casualties Unknown �Installed via Steam
  2. CUCoreLib (CCL) �Installation Guide
  3. .NET 9 Runtime �Download
  4. CuBlocky �Download v0.1.3

Step 1: Launch CuBlocky

Extract the zip and run CuBlocky.Server.exe. The browser opens automatically to http://localhost:5099.

Step 2: Create a New Project

  1. Click "Create New Project" on the welcome page
  2. Enter a project name (e.g., MyFirstMod)
  3. Fill in the mod metadata:
    • Mod Name: Display name
    • Mod ID: Unique identifier (e.g., com.yourname.myfirstmod)
    • Version: Version number (e.g., 1.0.0)
    • Description: What your mod does
  4. Click "Create"

Step 3: Add an Item

  1. In the block editor, find the Register category
  2. Drag a "Register Item" block to the workspace
  3. Configure the item:
    • ID: Item identifier (e.g., my_sword)
    • Name: Display name
    • Category: weapon, tool, medical, etc.
    • Weight: Item weight
    • Value: Item value

Step 4: Add Properties

Add property blocks to customize your item:

Register Item:
  ID: "my_sword"
  Name: "My Sword"
  Category: weapon

Set Tool Properties:
  Damage: 25
  Distance: 1.5
  Cooldown: 0.8

Step 5: Add a Recipe (Optional)

Recipe:
  Ingredients: iron_ingot ×3, wood ×1
  Output: my_sword ×1
  Condition: 1.0
  Repair: false

Step 6: Build

  1. Click the "Build" button (green play icon) in the toolbar
  2. Wait for compilation to complete
  3. The mod DLL is generated in builds/MyFirstMod/

Step 7: Install the Mod

  1. Copy the generated DLL to your game's BepInEx plugins folder:
    Steam\steamapps\common\Casualties Unknown Demo\BepInEx\plugins\
    
  2. Restart the game
  3. Your mod is active!

Next Steps

Clone this wiki locally