Skip to main content

Advanced rpg looting chest in typescript

In this guide you will learn to create a channeling chest, which drops loot. The tricky part is to scale that item, because "Scale" is not supported, and to keep that item while channeling. Also you want to replace it with a opened chest model after successfully opening it. If the channeling fails, you also want to keep the chest. It also should keep the scale and rotation. Also the chest we are using has two different material sets and of course we want to support "Skin" either.

So we gotta implement that. Lets go.

In our example we use models/props_generic/chest_treasure_02.vmdl and models\props_generic\chest_treasure_02_open.vmdl, which both have a golden and brown material. 0 is brown, 1 is gold.


"BaseClass" "item_lua"
"Model" "models/props_generic/chest_treasure_02.vmdl"
"ScriptFile" "item_treasure_chest_2.lua"
"AbilityTextureName" "item_desolator"

"ItemShareability" "ITEM_FULLY_SHAREABLE"
"ItemKillable" "0"
"ItemSellable" "0"
"ItemPurchasable" "0"
"ItemDroppable" "1"
"ItemPermanent" "0"
"ItemCost" "99999"

"AbilityCooldown" "0.0" // Ability cooldown must be 0
"AbilityChannelTime" "2.5"
"AbilityUnitTargetType" "DOTA_UNIT_TARGET_HERO"
"OnlyPlayerHeroPickup" "1"
"CreepHeroPickup" "1"
"DisplayOverheadAlertOnReceived" "0" // Show no item accquired overhead effect
"ItemCastOnPickup" "1" // Start channeling on pickup

// Custom Values
// -------------
"ReplaceOnOpen" "models\props_generic\chest_treasure_02_open.vmdl"
"Skin" "1"

Instead of item_desolator, you should use a better icon :)

// registerAbility() and BaseItem is provided by dota_ts_adapter and needs to imported.

class item_treasure_chest_2 extends BaseItem {

position!: Vector;
angles!: Vector;
kv!: Record<string, string>;
channelingPlaceholder!: CBaseAnimating;

Spawn() {
if (IsServer()) {
this.kv = this.GetAbilityKeyValues() as Record<string, string>;

private HandleSkinAndScale(){
const kvSkin = this.GetSkin();
const kvScale = this.GetScale();

if(kvSkin == 0 && kvScale == 1){
// Container is not created by engine at Spawn() time
Timers.CreateTimer(0.01, () => {
const container = this.GetContainer();


// Since we channel this ability on pickup it isnt the same as the item icon, so we need to set it here.
// When using a custom icon, make sure to support both formats (spellicon/icon)
GetAbilityTextureName() {
return GetAbilityTextureNameForAbility(this.GetName());

// OnSpellStart gets called twice for some reason, thats why we check if position and placeholder are set
OnSpellStart() {
if (IsClient()) {

this.position = this.GetContainer()!.GetOrigin();
this.angles = this.GetContainer()!.GetAnglesAsVector();

if (!this.channelingPlaceholder) {
this.channelingPlaceholder = this.SpawnReplacementChests(this.GetChestModel());

OnChannelFinish(interrupted: boolean) {
if (IsClient()) {
if (interrupted) {

OnChestOpen() {
print("Opened chest");


// spawned chests do not have a collider
private SpawnReplacementChests(model: string): CBaseAnimating{

const item = SpawnEntityFromTableSynchronous("prop_dynamic", {
model: model,
scale: this.GetScale(),
origin: this.position,
angles: this.angles,
skin: this.GetSkin()
}) as CBaseAnimating;


return item as CBaseAnimating;

private RedropChest() {
const chestReplace = CreateItem(this.GetName(), undefined, undefined);
const item = CreateItemOnPositionSync(this.position, chestReplace);
item.SetAngles(this.angles.x, this.angles.y, this.angles.z);

private DeletePlaceholder(){

private DeleteChest() {
// Removing an item also destroys the underlying entity, be carefull

private CreateLoot(){
const caster = this.GetCaster();

const item = CreateItem("item_desolator", caster.GetPlayerOwner(), undefined);
const worldItem = CreateItemOnPositionSync(this.position, item);
item?.LaunchLoot(false, 124, RandomFloat(0.5, 1.2), caster.GetOrigin().__add(RandomVector(RandomInt(50, 150))));

private GetChestOpenModel() {
return this.kv["ReplaceOnOpen"];

private GetChestModel(){
return this.kv["Model"];

private GetSkin(){
return tonumber(this.kv["Skin"]) || 0;

protected GetScale(){
return tonumber(this.kv["Scale"]) || 1;

Finally you will want to give your chest a tooltip name. Add "DOTATooltip_ability_item_treasure_chest_2" "Testchest" to your addon*.txt.

There are some drawbacks to this approach. You cant change the pickup range and the itemquality. Please leave a comment in discord or edit this page, if you know.