chore: Assets 디렉토리 구조 정리 및 네이밍 컨벤션 적용

- Assets/_Game/ 하위로 게임 에셋 통합
- External/ 패키지 벤더별 분류 (Synty, Animations, UI)
- 에셋 네이밍 컨벤션 확립 및 적용
  (Data_Skill_, Data_SkillEffect_, Prefab_, Anim_, Model_, BT_ 등)
- pre-commit hook으로 네이밍 컨벤션 자동 검사 추가
- RESTRUCTURE_CHECKLIST.md 작성

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
2026-03-16 19:08:27 +09:00
parent 309bf5f48b
commit c265f980db
17251 changed files with 2630777 additions and 206 deletions

View File

@@ -0,0 +1,37 @@
using UnityEngine;
using Colosseum.Abnormalities;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 이상 상태 효과
/// AbnormalityManager를 통해 대상에게 이상 상태를 적용합니다.
/// </summary>
[CreateAssetMenu(fileName = "AbnormalityEffect", menuName = "Colosseum/Skills/Effects/Abnormality")]
public class AbnormalityEffect : SkillEffect
{
[Header("Abnormality")]
[Tooltip("적용할 이상 상태 데이터")]
[SerializeField] private AbnormalityData abnormalityData;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (target == null) return;
if (abnormalityData == null) return;
var abnormalityManager = target.GetComponent<AbnormalityManager>();
if (abnormalityManager == null) return;
abnormalityManager.ApplyAbnormality(abnormalityData, caster);
}
/// <summary>
/// 이상 상태 데이터 설정 (런타임용)
/// </summary>
public void SetAbnormalityData(AbnormalityData data)
{
abnormalityData = data;
}
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: bf750718c64c4bd48af905d2927351de

View File

@@ -0,0 +1,92 @@
using UnityEngine;
using Colosseum.Stats;
using Colosseum.Combat;
using Colosseum.Weapons;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 대미지 타입
/// </summary>
public enum DamageType
{
Physical, // 물리 대미지 (STR 기반)
Magical, // 마법 대미지 (INT 기반)
Ranged, // 원거리 대미지 (DEX 기반)
True, // 고정 대미지 (스탯 영향 없음)
}
/// <summary>
/// 데미지 효과
/// </summary>
[CreateAssetMenu(fileName = "DamageEffect", menuName = "Colosseum/Skills/Effects/Damage")]
public class DamageEffect : SkillEffect
{
[Header("Damage Settings")]
[Min(0f)] [SerializeField] private float baseDamage = 10f;
[SerializeField] private DamageType damageType = DamageType.Physical;
[Tooltip("스탯 계수 (1.0 = 100%)")]
[Min(0f)] [SerializeField] private float statScaling = 1f;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (target == null) return;
// 대미지 계산
float totalDamage = CalculateDamage(caster);
// 타겟에 대미지 적용 (IDamageable 인터페이스 사용)
var damageable = target.GetComponent<IDamageable>();
if (damageable != null)
{
damageable.TakeDamage(totalDamage, caster);
}
}
/// <summary>
/// 시전자 스탯 기반 대미지 계산
/// 공식: baseDamage + (statDamage * scaling)
/// </summary>
private float CalculateDamage(GameObject caster)
{
if (damageType == DamageType.True)
{
return baseDamage;
}
var stats = caster.GetComponent<CharacterStats>();
if (stats == null)
{
return baseDamage;
}
float statDamage = damageType switch
{
DamageType.Physical => stats.PhysicalDamage,
DamageType.Magical => stats.MagicDamage,
DamageType.Ranged => stats.Dexterity.FinalValue * 2f, // DEX 기반 원거리 대미지
_ => 0f,
};
float baseTotal = baseDamage + (statDamage * statScaling);
// 무기 데미지 배율 적용
float damageMultiplier = GetDamageMultiplier(caster);
return baseTotal * damageMultiplier;
}
/// <summary>
/// 시전자의 무기 데미지 배율 조회
/// </summary>
private float GetDamageMultiplier(GameObject caster)
{
var weaponEquipment = caster.GetComponent<WeaponEquipment>();
if (weaponEquipment != null)
{
return weaponEquipment.DamageMultiplier;
}
return 1f;
}
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: 58efb3c775496fa40b801b21127a011e

View File

@@ -0,0 +1,49 @@
using UnityEngine;
using Colosseum.Stats;
using Colosseum.Combat;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 치료 효과
/// </summary>
[CreateAssetMenu(fileName = "HealEffect", menuName = "Colosseum/Skills/Effects/Heal")]
public class HealEffect : SkillEffect
{
[Header("Heal Settings")]
[Min(0f)] [SerializeField] private float baseHeal = 10f;
[Tooltip("회복력 계수 (1.0 = 100%)")]
[Min(0f)] [SerializeField] private float healScaling = 1f;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (target == null) return;
// 회복량 계산
float totalHeal = CalculateHeal(caster);
// 타겟에 회복 적용 (IDamageable 인터페이스 사용)
var damageable = target.GetComponent<IDamageable>();
if (damageable != null)
{
damageable.Heal(totalHeal);
}
}
/// <summary>
/// 시전자 스탯 기반 회복량 계산
/// 공식: baseHeal + (healPower * healScaling)
/// </summary>
private float CalculateHeal(GameObject caster)
{
var stats = caster.GetComponent<CharacterStats>();
if (stats == null)
{
return baseHeal;
}
return baseHeal + (stats.HealPower * healScaling);
}
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: abc224c01f587d447bc8df723ef522ba

View File

@@ -0,0 +1,30 @@
using UnityEngine;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 넉백 효과
/// </summary>
[CreateAssetMenu(fileName = "KnockbackEffect", menuName = "Colosseum/Skills/Effects/Knockback")]
public class KnockbackEffect : SkillEffect
{
[Header("Knockback Settings")]
[Min(0f)] [SerializeField] private float force = 5f;
[SerializeField] private float upwardForce = 2f;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (target == null || caster == null) return;
Vector3 direction = target.transform.position - caster.transform.position;
direction.y = 0f;
direction.Normalize();
Vector3 knockback = direction * force + Vector3.up * upwardForce;
// TODO: 실제 물리 시스템 연동
// if (target.TryGetComponent<Rigidbody>(out var rb))
// rb.AddForce(knockback, ForceMode.Impulse);
}
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: 27cd4e4eb6a485845953db2a108a37f8

View File

@@ -0,0 +1,22 @@
using UnityEngine;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 사운드 재생 효과
/// </summary>
[CreateAssetMenu(fileName = "SoundEffect", menuName = "Colosseum/Skills/Effects/Sound")]
public class SoundEffect : SkillEffect
{
[Header("Sound Settings")]
[SerializeField] private AudioClip clip;
[Range(0f, 1f)] [SerializeField] private float volume = 1f;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (clip == null || caster == null) return;
AudioSource.PlayClipAtPoint(clip, caster.transform.position, volume);
}
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: 052c59e9f6bf6864da0248beab125037

View File

@@ -0,0 +1,68 @@
using UnityEngine;
namespace Colosseum.Skills.Effects
{
/// <summary>
/// 프리팹 스폰 효과 (투사체, 파티클 등)
/// </summary>
[CreateAssetMenu(fileName = "SpawnEffect", menuName = "Colosseum/Skills/Effects/Spawn")]
public class SpawnEffect : SkillEffect
{
[Header("Spawn Settings")]
[SerializeField] private GameObject prefab;
[SerializeField] private SpawnLocation spawnLocation = SpawnLocation.Caster;
[SerializeField] private Vector3 spawnOffset = Vector3.zero;
[SerializeField] private bool parentToCaster = false;
[Min(0f)] [SerializeField] private float autoDestroyTime = 3f;
protected override void ApplyEffect(GameObject caster, GameObject target)
{
if (prefab == null || caster == null) return;
Vector3 spawnPos = GetSpawnPosition(caster, target) + spawnOffset;
Quaternion spawnRot = GetSpawnRotation(caster, target);
Transform parent = parentToCaster ? caster.transform : null;
GameObject instance = Object.Instantiate(prefab, spawnPos, spawnRot, parent);
// SkillProjectile 컴포넌트가 있으면 초기화
var projectile = instance.GetComponent<SkillProjectile>();
if (projectile != null)
{
projectile.Initialize(caster, this);
}
if (autoDestroyTime > 0f)
{
Object.Destroy(instance, autoDestroyTime);
}
}
private Vector3 GetSpawnPosition(GameObject caster, GameObject target)
{
return spawnLocation switch
{
SpawnLocation.Caster => caster.transform.position,
SpawnLocation.CasterForward => caster.transform.position + caster.transform.forward * 2f,
SpawnLocation.Target => target != null ? target.transform.position : caster.transform.position,
_ => caster.transform.position
};
}
private Quaternion GetSpawnRotation(GameObject caster, GameObject target)
{
if (spawnLocation == SpawnLocation.Target && target != null)
{
return Quaternion.LookRotation(target.transform.position - caster.transform.position);
}
return caster.transform.rotation;
}
}
public enum SpawnLocation
{
Caster,
CasterForward,
Target
}
}

View File

@@ -0,0 +1,2 @@
fileFormatVersion: 2
guid: a3139ddf07cfe324fa692a88cd565e24