basegames/zeling_v2
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

多轮审查和修复

Browse Source
This commit is contained in:
Joywayer
2026-05-12 15:34:08 +08:00
parent f55d2a57c3
commit ebbbb7332e
805 changed files with 838724 additions and 1905 deletions
Download Patch File Download Diff File Expand all files Collapse all files

97
Assets/Scripts/Core/GameIds.cs Normal file
View File

@@ -0,0 +1,97 @@
namespace BaseGames.Core
{
// =====================================================================
// GameIds —— 全局字符串 ID 常量（架构 02_CoreModule §IDs）
// =====================================================================
// 目的：消除散落在配置 SO 和代码中的 magic string，
// 提供编译期校验 + IDE 自动补全 + 全局唯一检索点。
//
// 使用方式：
// ① Inspector 侧：在 ScriptableObject 的 string 字段输入对应常量值（仅此处可见文本）。
// ② 代码侧：直接引用常量，如 GameIds.Boss.ForestBoss，避免硬编码字符串。
//
// 新增规则：
// - 按域划分嵌套静态类（Boss / Chain / Quest / Ability / Scene / Collectible / Npc）
// - 命名风格：PascalCase，与 Unity 资产命名对齐（如 "Chain_BossForest_Defeated"）
// - 不要将常量值改名，只新增；如需废弃请标注 [System.Obsolete]
// =====================================================================
public static class GameIds
{
// ── Boss IDs ───────────────────────────────────────────────────────
/// <summary>Boss 唯一标识符，对应 BossDefeatedCondition.bossId 及 BossDataSO.bossId。</summary>
public static class Boss
{
public const string ForestBoss = "Boss_Forest";
public const string CaveBoss = "Boss_Cave";
public const string CastleBoss = "Boss_Castle";
public const string FinalBoss = "Boss_Final";
}
// ── Chain IDs ──────────────────────────────────────────────────────
/// <summary>事件链唯一标识符，对应 EventChainSO.chainId 及 ChainCompletedCondition.chainId。</summary>
public static class Chain
{
public const string BossForestDefeated = "Chain_BossForest_Defeated";
public const string CaveBossDefeated = "Chain_CaveBoss_Defeated";
public const string CastleBossDefeated = "Chain_CastleBoss_Defeated";
public const string FinalBossDefeated = "Chain_FinalBoss_Defeated";
public const string TutorialComplete = "Chain_Tutorial_Complete";
}
// ── Quest IDs ──────────────────────────────────────────────────────
/// <summary>任务唯一标识符，对应 QuestSO.questId。</summary>
public static class Quest
{
public const string MainQuest_Chapter1 = "Quest_Main_Ch1";
public const string MainQuest_Chapter2 = "Quest_Main_Ch2";
public const string SideQuest_Merchant = "Quest_Side_Merchant";
}
// ── Ability IDs ────────────────────────────────────────────────────
/// <summary>能力/技能唯一标识符，对应 AbilityUnlockedCondition.abilityId。</summary>
public static class Ability
{
public const string DoubleJump = "Ability_DoubleJump";
public const string Dash = "Ability_Dash";
public const string WallJump = "Ability_WallJump";
public const string Parry = "Ability_Parry";
}
// ── Scene / Room Names ─────────────────────────────────────────────
/// <summary>场景/房间标识符，对应 RoomEnteredCondition.sceneName。与 Unity Build Settings 场景名对齐。</summary>
public static class Scene
{
public const string Forest = "Scene_Forest";
public const string Cave = "Scene_Cave";
public const string Castle = "Scene_Castle";
public const string Hub = "Scene_Hub";
public const string Tutorial = "Scene_Tutorial";
}
// ── Collectible IDs ────────────────────────────────────────────────
/// <summary>可收集物唯一标识符，对应 CollectibleCollectedCondition.itemId。</summary>
public static class Collectible
{
public const string AncientKey = "Item_AncientKey";
public const string MapFragment = "Item_MapFragment";
}
// ── NPC IDs ────────────────────────────────────────────────────────
/// <summary>NPC 唯一标识符，对应 DialogueCompletedCondition.npcId。</summary>
public static class Npc
{
public const string OldMerchant = "Npc_OldMerchant";
public const string SageGuard = "Npc_SageGuard";
}
// ── Flag IDs ───────────────────────────────────────────────────────
/// <summary>全局布尔存档标记，对应 FlagSetCondition.flagId 及 SaveManager.SetFlag/GetFlag。</summary>
public static class Flag
{
public const string TutorialShown = "Flag_TutorialShown";
public const string FirstDeath = "Flag_FirstDeath";
public const string MerchantIntroduced = "Flag_MerchantIntroduced";
}
}
}