========== How to Make a TTT Map ==========

Whether you are starting a new level or adding support for an existing map making it game ready is pretty simple. All that is required are **weapon placements** and **spawnpoints**. The rest of the entities are optional ([[Advanced Entities Explanation]]).

========Spawns========

To set up spawns simply drop a **player_info_start** into the world for each spot a want a player to spawn, the player will spawn right on it and face the direction the preview shows. 

{{:player_info_start.png?400|}}

It is **HIGHLY** recommended you place down as many spawns as you can so larger population servers don't run into issues. **A good rule of thumb is to aim for 32 spawnpoints**, that is usually what bigger servers cap their player slots at.

======== Weapon Placements ========

There a few ways to do weapon placements on your map. You can either do random placements with **ttt_weapon_random**, **ttt_grenade_random**, and **ttt_ammo_random** or do hand placements of each gun. You can also do a bit of both.

=====ttt_weapon_random=====

The easiest and most versatile method for gun placements is using **ttt_weapon_random.** This entity will choose a random weapon from the list of regular terrorist weapons. To use simply place in hammer where you want the weapon to spawn. It has a big bounding box that shows where the weapon and ammo can possibly spawn in the entity. This is to prevent the weapon spawning inside something and getting sent flying on round start. **If the bounding box is not inside of something the weapon will have no issue spawning where you placed it.**

{{::weapon_random_in_hammer.png?400|}}

**ttt_weapon_random** in hammer

{{::randomweaponingamescreenshot.png?400|}}


an example of how **ttt_weapon_random** will show up in game

You can determine how many ammo boxes spawn with the weapon. To do this go into the Object Properties in hammer and change the number for the Bonus ammo. **If you do not change the bonus ammo amount gun will spawn with no ammo.**

//Note: The bounding box for the entity also does not support more than 2 bonus ammo//

{{:weapon_random_properties.png?600|}}

=====ttt_grenade_random & ttt_ammo_random=====

These ents will spawn a random grenade or ammo box where you place them. Simply place them down where you want them to spawn.


=====Hand Placements=====

If you want a consistent spawn for a certain weapon, you can use the gun entities and manually place them. To find the weapon entity names select the **Entity Tool** for the game and type in, "weapons" in the search bar.

Each weapon and ammo type has its own world model when you place it, this will show you exactly where it will spawn. Just simply place them where you want them to appear. You should put the correct ammo type near each weapon if you want them to have ammo, how much is up to preference.

{{::handplaced.png?400|}}

an example of manual placements

=====Tips=====

  * A good rule of thumb is 60-100 gun placements for most maps. May have to adjust for extra small or large maps
  * Don't worry about the map lagging due to too many guns and ammo, s&box is way better at handling it than gmod
  * The weapon entities can be manipulated with the **Physics Simulation Tool** to give placements a natural look
  * Don't forget grenades!

========Uploading and Adding Support========

Adding support is very simple, but must be done when uploading/updating your map through asset.party. Make sure the map is **final compiled** before uploading. 

//Make sure the vmap name is 16 characters or less and does not contain spaces or symbols. Only letters, numbers, and underscores will work//

====Uploading A Map====

Make sure before you compile your map you

To upload your map simply go to the editor and find the vmap file in the asset browser for your map and click it. The inspector will show an option to **Publish as package**, check it.

{{::inspector_menu.png?600|}}

Click the upload button that appears. It will open up a menu, click **Project Setup** on the top left and find **Supported Games** under Target Information. Click in the box next to it and then type in **thieves.terrortown**

//Note: If you need to support multiple games you can separate them with a semicolon as shown below//

{{::project_setup.png?600|}}

Once entered it should show the icon for TTT in the box (will show a random one for multiple games). From there click save and then go back to **Upload to Asset Party** on the bottom. 

Enter the package indent (MUST BE THE SAME AS VPK AND VMAP) and select your org and then hit next.

{{::punlishing_map.png?600|}}

On the next page fill out the Title option with the name you want to map to be with proper formatting (ex. community_pool can be Community Pool). You can change everything on this page later in asset party. Only thing required is the title.

**MAKE SURE YOU MAKE THE MAP PUBLIC OR IT WON'T BE VISIBLE IN S&BOX**

{{::package_meta.png?600|}}

Once you are done hit next, s&box will now find all the assets the map needs so it will freeze for a bit. Once it lists items as shown in the image below hit **Upload** to begin uploading the map.

{{::file_uploads.png?600|}}

Once the upload is complete you can fill out a change log if you want or let it auto fill with the date. When you are ready click **Publish New Revision**

====Congratulations your TTT map is now published!====

//Note: Players will have to restart their s&box to see the map if they have it open when you upload//