{
  "success": true,
  "message": "Tag 'TagName' added to instance"
}

// Tag a weapon
add_tag("game.Workspace.Sword", "Weapon")

// Tag an enemy
add_tag("game.Workspace.Zombie", "Enemy")

// Tag a collectible
add_tag("game.Workspace.Coin", "Collectible")

// Tag a sword with multiple categories
const swordPath = "game.Workspace.Sword";
add_tag(swordPath, "Weapon");
add_tag(swordPath, "Melee");
add_tag(swordPath, "Legendary");
add_tag(swordPath, "TwoHanded");

// Tag all weapons in workspace
const weaponPaths = [
  "game.Workspace.Sword",
  "game.Workspace.Gun",
  "game.Workspace.Bow"
];

weaponPaths.forEach(path => {
  add_tag(path, "Weapon");
});

// Tag high-value items
const item = "game.Workspace.DiamondSword";
const damage = get_attribute(item, "Damage");

if (damage > 100) {
  add_tag(item, "HighDamage");
  add_tag(item, "Legendary");
}

-- Lua script listening for tagged instances
local CollectionService = game:GetService("CollectionService")

-- Get all instances with "Weapon" tag
local weapons = CollectionService:GetTagged("Weapon")

for _, weapon in pairs(weapons) do
  print("Found weapon:", weapon.Name)
end

-- Listen for new tagged instances
CollectionService:GetInstanceAddedSignal("Enemy"):Connect(function(instance)
  print("New enemy spawned:", instance.Name)
end)

// Gameplay categories
add_tag(instance, "Weapon");
add_tag(instance, "Enemy");
add_tag(instance, "Collectible");
add_tag(instance, "Interactable");

// Weapon types
add_tag(instance, "WeaponMelee");
add_tag(instance, "WeaponRanged");
add_tag(instance, "WeaponMagic");

// Enemy types
add_tag(instance, "EnemyUndead");
add_tag(instance, "EnemyBoss");
add_tag(instance, "EnemyPassive");

// Team assignment
add_tag(instance, "RedTeam");
add_tag(instance, "BlueTeam");

// Special properties
add_tag(instance, "Destructible");
add_tag(instance, "Flammable");
add_tag(instance, "Explosive");

// Add tag twice
add_tag("game.Workspace.Part", "Weapon");
add_tag("game.Workspace.Part", "Weapon"); // No error, no duplicate

// Part still has only one "Weapon" tag
get_tags("game.Workspace.Part");
// Returns: { "tags": ["Weapon"] }

// Tag all parts in a model based on their properties
const modelPath = "game.Workspace.WeaponRack";
const children = get_instance_children(modelPath);

children.forEach(childPath => {
  // Get part properties
  const props = get_instance_properties(childPath);
  
  // Tag based on class
  if (props.ClassName === "Part") {
    add_tag(childPath, "PhysicsPart");
  }
  
  // Tag based on properties
  if (props.CanCollide === false) {
    add_tag(childPath, "NonCollidable");
  }
  
  // Tag based on attributes
  const damage = get_attribute(childPath, "Damage");
  if (damage && damage > 50) {
    add_tag(childPath, "HighDamage");
  }
});