Grimwar/Getting started

Getting started · Maps · VSig · VMod · Addons · Workshop · Servers · SDK

Version target. Use Vellocet SDK 1.0.3 with Unity 6000.3.17f1. Current packages use addon schema 9 and VMod API 5.

Start with the result you want:

Goal	Guide
Create a playable map	Map authoring
Script doors, triggers, objectives, timers, and round logic	VSig
Write C# server gameplay, commands, or a game mode	VMod
Install, enable, select, or test a package	Using addons
Publish a map on Steam	Steam Workshop publishing
Run a community server	Dedicated servers

Install the authoring tools

1. Install the current Vellocet SDK with the VSDK app.
2. Install Unity 6000.3.17f1.
3. In Unity, open Window > Package Manager and select + > Add package from disk....
4. Select SDKPackage/package.json inside the VSDK install folder.
5. Complete Tools > Vellocet > SDK > Welcome & Setup.
6. Choose an addon export folder outside the Unity project.
7. Open Tools > Vellocet > SDK > Workbench and confirm the Project tab reports current managed content.

See Install the SDK for project paths, content sync, and editor support.

Build and test a first map

1. In SDK Workbench, select Create New Map... and save it below Assets/CustomContent/Maps.
2. Add geometry, collision, at least one info_player_spawn, and any required mode entities from the Entities tab.
3. Give marker GameObjects stable names.
4. Create a .vsig file beside the scene when the map needs scripted behavior.
5. Open Tools > Vellocet > SDK > Map Exporter, set stable package and map IDs, and run Compile Scene.
6. Export a Development package.
7. Open Grimwar's Addons screen, enable the package, and select Use This Copy if another source has the same addon ID.
8. Open Host and select Test Map. Test the exported scene, spawns, collision, logic, lighting, audio, and round transitions.

Use a Release package only after the Development package works. Release export builds all required desktop artifacts and requires complete lighting and spatial bakes.

Build and test a first VMod

1. Create one addon folder with addon.json, mod.json, and a .csx source file.
2. Implement Grimwar.ModApi.IMod and register one command in OnLoad.
3. On the test server, run vmod_runtime_paths and copy the complete folder into the printed addons root.
4. Run vmod_runtime_reload, then vmod_runtime_list.
5. Invoke the command through chat and authenticated console, then reload the package again to check cleanup.

The minimal VMod contains working manifests and C# source. VMod packages are server-authoritative and are currently installed manually or through the development overlay.

Keep these boundaries straight

• Original Unity assets belong below Assets/CustomContent.
• Assets/VellocetSDK is managed by SDK content sync.
• A Unity scene is authored content; the exported addon folder is what Grimwar installs.
• VSig controls map entities and map-local logic. VMod controls server gameplay through Grimwar.ModApi.
• The complete addon folder is the install unit.
• Steam Workshop publishing currently accepts map-only Release packages. It does not accept a package containing VMods.