HOW TO MAKE CUSTOM MAPS WITH TRENCHBROOM

This guide will show you how to setup mapping for Bullet Speed, this is not a guide on how to use Trenchbroom.

Install Trenchbroom and configure it.

Guide is still WIP, please report any issue and i'll fix it asap.

The only tested version of Trenchbroom is this one (2023.1): https://github.com/TrenchBroom/TrenchBroom/releases/tag/v2023.1
(feel free to notice me if other versions works)

Setup

• Download Trenchbroom 2023.1, unzip the archive and open the games folder.
  
• Get the BulletSpeed game config folder here:
  https://github.com/lambda505/BulletSpeedGameConfig
  
• Copy the folder BulletSpeed in the games folder from Trenchbroom.

It should look this.

Import the textures

If you open threnchbroom now, create a new map and choose BulletSpeed as the game. You will notice that the entities works but that in face there is no texture to import.

• Get the BulletSpeed texture folder here:
  https://github.com/lambda505/BulletSpeedGameConfig
  
• Drop the folders from the Textures folder in TrenchBroom\defaults\assets\textures.
  
• You can now import the textures in Trenchbroom.
  
  

Point Entities

SpawnPoint

Define where the players can spawn.
If no spawn point are set the players will spawn at 0,0,0.

DefaultTeam:

• 0: No team
  
• 1: Blue Team
  
• 2: Red Team

OmniLight

Will create a light in the world.
You can choose the color, range and intensity.
Pair it with a block of Animal_23 texture to make a lamp.

Object_Spawner

Will spawn an object in the world at a set interval.
Object paths:
res://Assets/objects/weapons/Pickable/

Weapons
• revolver_pickable.tscn
  
• sniper_pickable.tscn
  
• smg_pickable.tscn
  
• rifle_pickable.tscn
  
• rocket-launcher_pickable.tscn
  
• grenade-launcher_pickable.tscn
  
• electrifier_pickable.tscn
  
• shotgun_pickable.tscn
  Ammo
  
• heavy_ammo_pickable.tscn
  
• light_ammo_pickable.tscn
  
• explosif_ammo_pickable.tscn
  
• energy_ammo_pickable.tscn
  Refills
  
• health_pickable.tscn
  
• armor_pickable.tscn
  
• health_armor_pickable.tscn

For the spawnTimer: Weapons = 45s; Refills = 30s; Ammo = 15s

Gamemode

Defines the gamemode the map will default on.

Gamemode:

• FFA: Free for All
  
• TDM: Team Deathmatch
  
• CTF: Capture the flag (need FlagSpawner)
  
• JMP: Jump maps with timer
  
• ARN: Arena maps with scores

Start Weapons:
Weapon names in CAPS, separated by commas.
ex: REVOLVER,SMG,ROCKET-LAUNCHER

FlagSpawner

Define CTF flag will spawn.

FlagTeamIndex:

• 0: No team (Will not work)
  
• 1: Blue Team
  
• 2: Red Team

Brush Entities

JMP

• start
  
• checkpoint
  
• finish

Create the brush entity.


Apply the right texture.



After export, build and reload it should look like this.

The timer appears on maps with a start brush entity.

MAP

• limit
  
• deathzone
  
• jump
  
• speed
  
• tp

Block the player.


Kill the player


Boost the player upwards

Boost the player forward


Teleport the player from PortalA to PortalB

Special Textures

Special Materials

Elements_10




Elements_22

Clipping Material / Stairs

How to make stairs
I use a grid of 8 to make the stairs.
I create a ramp shape for the stairs.
I move it one unit further from the stair base to avoid steps clipping though this shape.
Final result is a working stairs.

Load the map in Bullet Speed

Import to custom folder

Save the map in Trenchbroom wherever you want.

WIN+R and type %appdata%/Godot/app_userdata/Bullet Speed.


Copy the saved map in the custom_maps folder.

Load the map in game

In game open the CUSTOM menu.

Select the map in the first dropdown and press build and test.
After generating the map you can quit, select the newly generated map in the second drop down and press play.

THE WORKSHOP WILL BE OPENED FOR V1.