wolf mechanic (half tested) and psychic (tested)

Author: RobotHanzo

src/dashboard/src/constants/gameData.ts

@@ -169,13 +169,20 @@ export const GAME_ROLES: Record<string, GameEntityConfig> = {
     translationKey: 'roles.labels.BLOOD_MOON',
     camp: 'WEREWOLF',
   },
-  ROBOT_WOLF: {
-    id: 'ROBOT_WOLF',
+  WOLF_MECHANIC: {
+    id: 'WOLF_MECHANIC',
     color: '#dc2626', // Red-600
     icon: Zap,
-    translationKey: 'roles.labels.ROBOT_WOLF',
+    translationKey: 'roles.labels.WOLF_MECHANIC',
     camp: 'WEREWOLF',
   },
+  PSYCHIC: {
+    id: 'PSYCHIC',
+    color: '#06b6d4', // Cyan-500
+    icon: Eye,
+    translationKey: 'roles.labels.PSYCHIC',
+    camp: 'GOD',
+  },
   CLONE: {
     id: 'CLONE',
     color: '#8b5cf6', // Violet-500
@@ -237,6 +244,12 @@ export const GAME_ACTIONS: Record<string, GameEntityConfig> = {
     icon: Search,
     translationKey: 'roles.actions.SEER_CHECK',
   },
+  PSYCHIC_CHECK: {
+    id: 'PSYCHIC_CHECK',
+    color: '#06b6d4',
+    icon: Search,
+    translationKey: 'roles.actions.PSYCHIC_CHECK',
+  },
   GUARD_PROTECT: {
     id: 'GUARD_PROTECT',
     color: '#f59e0b',
@@ -303,6 +316,42 @@ export const GAME_ACTIONS: Record<string, GameEntityConfig> = {
     icon: Ghost,
     translationKey: 'roles.actions.NIGHTMARE_FEAR',
   },
+  WOLF_MECHANIC_LEARN: {
+    id: 'WOLF_MECHANIC_LEARN',
+    color: '#dc2626',
+    icon: Zap,
+    translationKey: 'roles.actions.WOLF_MECHANIC_LEARN',
+  },
+  WOLF_MECHANIC_SEER_CHECK: {
+    id: 'WOLF_MECHANIC_SEER_CHECK',
+    color: '#06b6d4',
+    icon: Search,
+    translationKey: 'roles.actions.WOLF_MECHANIC_SEER_CHECK',
+  },
+  WOLF_MECHANIC_POISON: {
+    id: 'WOLF_MECHANIC_POISON',
+    color: '#a855f7',
+    icon: Pill,
+    translationKey: 'roles.actions.WOLF_MECHANIC_POISON',
+  },
+  WOLF_MECHANIC_GUARD_PROTECT: {
+    id: 'WOLF_MECHANIC_GUARD_PROTECT',
+    color: '#f59e0b',
+    icon: Shield,
+    translationKey: 'roles.actions.WOLF_MECHANIC_GUARD_PROTECT',
+  },
+  WOLF_MECHANIC_HUNTER_REVENGE: {
+    id: 'WOLF_MECHANIC_HUNTER_REVENGE',
+    color: '#ec4899',
+    icon: Crosshair,
+    translationKey: 'roles.actions.WOLF_MECHANIC_HUNTER_REVENGE',
+  },
+  WOLF_MECHANIC_EXTRA_KILL: {
+    id: 'WOLF_MECHANIC_EXTRA_KILL',
+    color: '#f87171',
+    icon: Flame,
+    translationKey: 'roles.actions.WOLF_MECHANIC_EXTRA_KILL',
+  },
   DEATH: {
     id: 'DEATH',
     color: '#6b7280',
@@ -325,8 +374,9 @@ export const getRoleConfig = (roleName: string): GameEntityConfig => {
   if (roleName.includes('石像鬼')) return GAME_ROLES.GARGOYLE;
   if (roleName.includes('惡靈騎士')) return GAME_ROLES.NIGHT_KNIGHT;
   if (roleName.includes('血月使者')) return GAME_ROLES.BLOOD_MOON;
-  if (roleName.includes('機械狼')) return GAME_ROLES.ROBOT_WOLF;
+  if (roleName.includes('機械狼')) return GAME_ROLES.WOLF_MECHANIC;
   if (roleName.includes('狼')) return GAME_ROLES.WEREWOLF;
+  if (roleName.includes('通靈師')) return GAME_ROLES.PSYCHIC;
   if (roleName.includes('預言')) return GAME_ROLES.SEER;
   if (roleName.includes('女巫')) return GAME_ROLES.WITCH;
   if (roleName.includes('守衛')) return GAME_ROLES.GUARD;

src/dashboard/src/features/game/components/NightStatus.tsx

@@ -26,6 +26,7 @@ interface NightStatusData {
     | 'WEREWOLF_VOTING'
     | 'ROLE_ACTIONS'
     | 'WOLF_YOUNGER_BROTHER_ACTION'
+    | 'WOLF_MECHANIC_ACTION'
     | 'NIGHTMARE_ACTION'
     | 'MAGICIAN_ACTION';
   startTime: number;
@@ -52,7 +53,7 @@ export const NightStatus: React.FC<NightStatusProps> = ({
 }) => {
   const { t } = useTranslation();
   const [activeTab, setActiveTab] = useState<
-    'werewolves' | 'actions' | 'nightmare' | 'wolf_brother' | 'magician'
+    'werewolves' | 'actions' | 'nightmare' | 'wolf_brother' | 'wolf_mechanic' | 'magician'
   >('werewolves');
   const messageScrollContainerRef = useRef<HTMLDivElement>(null);
 
@@ -128,6 +129,8 @@ export const NightStatus: React.FC<NightStatusProps> = ({
       setActiveTab('nightmare');
     } else if (type === 'WOLF_YOUNGER_BROTHER_ACTION') {
       setActiveTab('wolf_brother');
+    } else if (type === 'WOLF_MECHANIC_ACTION') {
+      setActiveTab('wolf_mechanic');
     } else if (type === 'MAGICIAN_ACTION') {
       setActiveTab('magician');
     } else {
@@ -262,6 +265,18 @@ export const NightStatus: React.FC<NightStatusProps> = ({
     return nightStatus.actionStatuses.find((a) => a.actorRole.includes('狼弟'));
   }, [nightStatus.actionStatuses]);
 
+  const hasWolfMechanic = useMemo(() => {
+    return players.some((p) =>
+      p.roles?.some((r) => r.includes('機械狼') || r.includes('WOLF_MECHANIC'))
+    );
+  }, [players]);
+
+  const wolfMechanicAction = useMemo(() => {
+    return nightStatus.actionStatuses.find(
+      (a) => a.actorRole.includes('機械狼') || a.actorRole.includes('WOLF_MECHANIC')
+    );
+  }, [nightStatus.actionStatuses]);
+
   const hasMagician = useMemo(() => {
     return players.some((p) =>
       p.roles?.some((r) => r.includes('魔術師') || r.includes('MAGICIAN'))
@@ -310,6 +325,15 @@ export const NightStatus: React.FC<NightStatusProps> = ({
             </button>
           )}
 
+          {hasWolfMechanic && (
+            <button
+              onClick={() => setActiveTab('wolf_mechanic')}
+              className={`px-4 py-2 text-sm font-medium rounded-md transition-colors whitespace-nowrap ${activeTab === 'wolf_mechanic' ? 'bg-white dark:bg-slate-700 text-red-600 dark:text-red-300 shadow-sm' : 'text-slate-500 hover:text-slate-700 dark:text-slate-400 dark:hover:text-white'}`}
+            >
+              {t('roles.labels.WOLF_MECHANIC')}
+            </button>
+          )}
+
           <button
             onClick={() => setActiveTab('werewolves')}
             className={`px-4 py-2 text-sm font-medium rounded-md transition-colors whitespace-nowrap ${activeTab === 'werewolves' ? 'bg-white dark:bg-slate-700 text-indigo-600 dark:text-white shadow-sm' : 'text-slate-500 hover:text-slate-700 dark:text-slate-400 dark:hover:text-white'}`}
@@ -629,6 +653,16 @@ export const NightStatus: React.FC<NightStatusProps> = ({
             />
           )}
 
+          {activeTab === 'wolf_mechanic' && wolfMechanicAction && (
+            <StandardActionCard
+              status={wolfMechanicAction}
+              roleId="WOLF_MECHANIC"
+              players={players}
+              guildId={guildId}
+              variant="large"
+            />
+          )}
+
           {activeTab === 'actions' && (
             /* Role Actions Screen (Redesigned) */
             <div className="space-y-8 pb-32 animate-in fade-in duration-500">

src/dashboard/src/locales/zh-TW.json

@@ -49,6 +49,13 @@
       "HUNTER_REVENGE": "獵人開槍",
       "WOLF_KING_REVENGE": "狼王復仇",
       "WOLF_YOUNGER_BROTHER_EXTRA_KILL": "狼弟復仇",
+      "WOLF_MECHANIC_LEARN": "機械狼學習",
+      "WOLF_MECHANIC_SEER_CHECK": "機械狼查驗",
+      "WOLF_MECHANIC_POISON": "機械狼毒藥",
+      "WOLF_MECHANIC_GUARD_PROTECT": "機械狼守護",
+      "WOLF_MECHANIC_HUNTER_REVENGE": "機械狼開槍",
+      "WOLF_MECHANIC_EXTRA_KILL": "機械狼復仇",
+      "PSYCHIC_CHECK": "通靈師查驗",
       "MERCHANT_SEER_CHECK": "查驗 (商人贈予)",
       "MERCHANT_POISON": "毒藥 (商人贈予)",
       "MERCHANT_GUN": "獵槍 (商人贈予)",
@@ -229,7 +236,8 @@
       "GARGOYLE": "石像鬼",
       "NIGHT_KNIGHT": "惡靈騎士",
       "BLOOD_MOON": "血月使者",
-      "ROBOT_WOLF": "機械狼",
+      "WOLF_MECHANIC": "機械狼",
+      "PSYCHIC": "通靈師",
       "IDIOT": "白痴",
       "KNIGHT": "騎士",
       "GRAVE_KEEPER": "守墓人",
@@ -248,6 +256,13 @@
       "GUARD_PROTECT": "守衛守護",
       "HUNTER_REVENGE": "獵人開槍",
       "WOLF_KING_REVENGE": "狼王開槍",
+      "WOLF_MECHANIC_LEARN": "機械狼學習",
+      "WOLF_MECHANIC_SEER_CHECK": "機械狼查驗 (通靈師)",
+      "WOLF_MECHANIC_POISON": "機械狼毒藥",
+      "WOLF_MECHANIC_GUARD_PROTECT": "機械狼守護",
+      "WOLF_MECHANIC_HUNTER_REVENGE": "機械狼開槍",
+      "WOLF_MECHANIC_EXTRA_KILL": "機械狼復仇刀",
+      "PSYCHIC_CHECK": "通靈師查驗",
       "DARK_MERCHANT_TRADE": "黑市商人交易",
       "MIRACLE_MERCHANT_TRADE_GUARD": "奇蹟商人交易 (給予守護)",
       "MERCHANT_SEER_CHECK": "商人技能：查驗",
@@ -569,7 +584,9 @@
       "ROLE_ACTIONS": "角色行動",
       "NIGHTMARE_ACTION": "夢魘行動",
       "WOLF_YOUNGER_BROTHER_ACTION": "狼弟行動",
-      "MAGICIAN_ACTION": "魔術師行動"
+      "WOLF_MECHANIC_ACTION": "機械狼行動",
+      "MAGICIAN_ACTION": "魔術師行動",
+      "WEREWOLF_ACTION": "狼人行動"
     }
   },
   "replays": {

src/main/kotlin/dev/robothanzo/werewolf/database/documents/Session.kt

@@ -283,6 +283,33 @@ data class Session(
         return false
     }
 
+    fun isWolfMechanicInherited(): Boolean {
+        // Mechanic inherits the extra kill phase when all original wolves are dead.
+        val mainWolves = players.values.filter {
+            it.wolf &&
+                !it.roles.contains("機械狼") &&
+                !(it.roles.contains("狼弟") && isCharacterAlive("狼兄"))
+        }
+        val aliveMainWolves = mainWolves.any { it.alive }
+        return mainWolves.isNotEmpty() && !aliveMainWolves
+    }
+
+    /**
+     * Resolves the string role name learned by the Wolf Mechanic.
+     * Maps mechanic playerId -> learned role name
+     */
+    val wolfMechanicLearnedRole: Map<Int, String>
+        get() {
+            val result = mutableMapOf<Int, String>()
+            stateData.wolfMechanicLearnedPlayerId.forEach { (actor, targetId) ->
+                val target = getPlayer(targetId)
+                val targetRole =
+                    target?.roles?.firstOrNull { it !in target.deadRoles } ?: target?.roles?.firstOrNull() ?: "平民"
+                result[actor] = targetRole
+            }
+            return result
+        }
+
     companion object {
         val DASHBOARD_BASE_URL: String
             get() = System.getenv("DASHBOARD_URL")?.removeSuffix("/") ?: "http://localhost:5173"

src/main/kotlin/dev/robothanzo/werewolf/game/model/ActionDefinitionId.kt

@@ -11,12 +11,21 @@ enum class ActionDefinitionId(val actionName: String) {
     WOLF_YOUNGER_BROTHER_EXTRA_KILL("狼弟復仇刀"),
     WOLF_DETONATE("自爆"),
 
+    // Wolf Mechanic Actions
+    WOLF_MECHANIC_LEARN("學習"),
+    WOLF_MECHANIC_SEER_CHECK("查驗 (機械狼)"),
+    WOLF_MECHANIC_POISON("毒藥 (機械狼)"),
+    WOLF_MECHANIC_GUARD_PROTECT("守護 (機械狼)"),
+    WOLF_MECHANIC_HUNTER_REVENGE("開槍 (機械狼)"),
+    WOLF_MECHANIC_EXTRA_KILL("機械狼復仇刀"),
+
     // Witch Actions
     WITCH_ANTIDOTE("解藥"),
     WITCH_POISON("毒藥"),
 
-    // Seer Actions
+    // Seer & Psychic Actions
     SEER_CHECK("查驗"),
+    PSYCHIC_CHECK("查驗 (通靈師)"),
 
     // Guard Actions
     GUARD_PROTECT("守護"),

src/main/kotlin/dev/robothanzo/werewolf/game/model/GameStateData.kt

@@ -12,6 +12,7 @@ import org.springframework.data.annotation.Transient
 enum class NightPhase(val defaultDurationMs: Long) {
     NIGHTMARE_ACTION(60_000L),
     MAGICIAN_ACTION(60_000L),
+    WOLF_MECHANIC_ACTION(60_000L),
     WOLF_YOUNGER_BROTHER_ACTION(60_000L),
     WEREWOLF_VOTING(90_000L),
     ROLE_ACTIONS(60_000L)
@@ -144,6 +145,7 @@ data class GameStateData(
 
     @Schema(description = "Player ID of the Wolf Younger Brother if he is awakened this night")
     var wolfBrotherAwakenedPlayerId: Int? = null,
+
     @Schema(description = "Start time of the current game step")
     var stepStartTime: Long = 0,
 
@@ -313,6 +315,33 @@ data class GameStateData(
 
             return result
         }
+
+    @get:BsonIgnore
+    val wolfMechanicLearnDay: Map<Int, Int>
+        get() {
+            val result = mutableMapOf<Int, Int>()
+            executedActions.forEach { (day, actions) ->
+                actions.filter { it.actionDefinitionId == ActionDefinitionId.WOLF_MECHANIC_LEARN }
+                    .forEach { result[it.actor] = day }
+            }
+            submittedActions.filter { it.actionDefinitionId == ActionDefinitionId.WOLF_MECHANIC_LEARN && it.status.executed }
+                .forEach {
+                    val currentDay = (executedActions.keys.maxOrNull() ?: 0) + 1
+                    result[it.actor] = currentDay
+                }
+            return result
+        }
+
+    @get:BsonIgnore
+    val wolfMechanicLearnedPlayerId: Map<Int, Int>
+        get() {
+            val result = mutableMapOf<Int, Int>()
+            executedActions.values.flatten().filter { it.actionDefinitionId == ActionDefinitionId.WOLF_MECHANIC_LEARN }
+                .forEach { if (it.targets.isNotEmpty()) result[it.actor] = it.targets.first() }
+            submittedActions.filter { it.actionDefinitionId == ActionDefinitionId.WOLF_MECHANIC_LEARN && it.status.executed }
+                .forEach { if (it.targets.isNotEmpty()) result[it.actor] = it.targets.first() }
+            return result
+        }
 }
 
 /**

src/main/kotlin/dev/robothanzo/werewolf/game/model/SessionExtensions.kt

@@ -96,21 +96,14 @@ fun Session.isActionAvailable(
         }
     }
 
-    // Check usage limit
-    if (action.usageLimit == -1) {
-        return true
+    // Delegate to action's isAvailable method which may contain additional logic (like limits or role-specific checks)
+    if (!action.isAvailable(this, playerId)) {
+        return false
     }
 
-    val usage = getActionUsageCount(playerId, actionDefinitionId, roleRegistry)
-    if (usage >= action.usageLimit) return false
-
-    // Wolf Younger Brother extra kill logic
     val currentPlayer = getPlayer(playerId)
-    if (actionDefinitionId == ActionDefinitionId.WOLF_YOUNGER_BROTHER_EXTRA_KILL) {
-        // Delegate to action's isAvailable method which now contains the logic
-        return action.isAvailable(this, playerId)
-    }
 
+    // Wolf Younger Brother default kill logic
     if (actionDefinitionId == ActionDefinitionId.WEREWOLF_KILL && currentPlayer?.roles?.contains("狼弟") == true) {
         val isWolfBrotherAlive = alivePlayers().values.any { it.roles.contains("狼兄") }
         // Younger Brother only gets to kill if Brother is dead

src/main/kotlin/dev/robothanzo/werewolf/game/roles/PredefinedRoles.kt

@@ -7,13 +7,15 @@ object PredefinedRoles {
     const val WITCH_ANTIDOTE_PRIORITY = 200
     const val WITCH_POISON_PRIORITY = 210
     const val SEER_PRIORITY = 300
+    const val PSYCHIC_PRIORITY = 300 // Same as Seer
     const val GUARD_PRIORITY = 150
     const val HUNTER_PRIORITY = 250
     const val POLICE_PRIORITY = 400
     const val DARK_MERCHANT_PRIORITY = 50
+    const val NIGHTMARE_PRIORITY = 0 // First thing at night
+    const val WOLF_MECHANIC_PRIORITY = 50
     const val DREAM_WEAVER_PRIORITY = 60 // Before wolves
     const val MAGICIAN_PRIORITY = 40 // Before Dream Weaver and Wolves
-    const val NIGHTMARE_PRIORITY = 0 // First thing at night
 
     // Action IDs
 
@@ -22,6 +24,7 @@ object PredefinedRoles {
     const val WITCH_ANTIDOTE = "WITCH_ANTIDOTE"
     const val WITCH_POISON = "WITCH_POISON"
     const val SEER_CHECK = "SEER_CHECK"
+    const val PSYCHIC_CHECK = "PSYCHIC_CHECK"
     const val GUARD_PROTECT = "GUARD_PROTECT"
     const val HUNTER_REVENGE = "HUNTER_REVENGE"
     const val WOLF_KING_REVENGE = "WOLF_KING_REVENGE"
@@ -39,6 +42,14 @@ object PredefinedRoles {
     const val DREAM_WEAVER_LINK = "DREAM_WEAVER_LINK"
     const val NIGHTMARE_FEAR = "NIGHTMARE_FEAR"
 
+    // Wolf Mechanic
+    const val WOLF_MECHANIC_LEARN = "WOLF_MECHANIC_LEARN"
+    const val WOLF_MECHANIC_SEER_CHECK = "WOLF_MECHANIC_SEER_CHECK"
+    const val WOLF_MECHANIC_POISON = "WOLF_MECHANIC_POISON"
+    const val WOLF_MECHANIC_GUARD_PROTECT = "WOLF_MECHANIC_GUARD_PROTECT"
+    const val WOLF_MECHANIC_HUNTER_REVENGE = "WOLF_MECHANIC_HUNTER_REVENGE"
+    const val WOLF_MECHANIC_EXTRA_KILL = "WOLF_MECHANIC_EXTRA_KILL"
+
     // Special death causes (legacy)
     const val DOUBLE_PROTECTION = "DOUBLE_PROTECTION"