effect · `transfer_navy`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Transfers the entire navy from scope country to target country. Does not support carriers!
Example:
ENG={
	target = NZL
	is_government_in_exile = yes #optional, default is no; the navy will be tagged as exile if this is yes so that it will return to owner if they return from exile.
}

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

transfer_navy 常用于剧本事件中模拟历史上的舰队移交场景，例如法国投降后将部分海军转交给流亡政府，或宗主国向自治领划拨舰队。流亡标记（is_government_in_exile = yes）尤为实用，可以让被转移的舰队在原国家复国后自动归还，精确还原流亡海军的历史逻辑。

# 法国投降，将海军转交给自由法国（流亡政府）
country_event = {
    id = fall_of_france.5
    option = {
        name = fall_of_france.5.a
        FRA = {
            transfer_navy = {
                target = F30        # 自由法国TAG
                is_government_in_exile = yes
            }
        }
    }
}

配合关系

[become_exiled_in](/wiki/effect/become_exiled_in)：通常在让某国进入流亡状态的同时调用 transfer_navy，确保流亡政府实际掌握一支海军力量而非空架子。
[annex_country](/wiki/effect/annex_country) / [end_puppet](/wiki/effect/end_puppet)：在并吞或解除傀儡关系前先转移海军，避免舰队随国家消失而凭空消失，保留装备给接收方使用。
[has_capitulated](/wiki/trigger/has_capitulated)：作为触发条件，在目标国投降时才执行海军转交逻辑，防止事件在非预期时机触发导致舰队丢失。
[destroy_ships](/wiki/effect/destroy_ships)：当不希望转移而是希望击沉/销毁舰队时作为替代手段，与 transfer_navy 形成互斥分支选项，给玩家或 AI 提供不同处置方式。

常见坑

航母不受支持：官方明确说明该效果不会转移航空母舰，新手若直接用此命令移交含航母的舰队，会发现航母凭空消失（既未转交也不在原国），应提前用 [destroy_ships](/wiki/effect/destroy_ships) 单独处理航母，或通过其他方式规避。
scope 指向错误：transfer_navy 的 scope 必须是转出国（即原舰队拥有者），target 才是接收国。新手常将两者颠倒，写成在接收国 scope 下执行，导致脚本无效或报错，务必确认进入正确国家 scope 再调用。

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

transfer_navy is commonly used in scenario events to simulate historical fleet transfers, such as France transferring part of its navy to the government-in-exile after surrender, or a metropolitan power allocating fleets to dominions. The exile flag (is_government_in_exile = yes) is particularly useful, allowing transferred fleets to automatically return to the original nation upon restoration, accurately recreating the historical logic of exiled navies.

# France surrenders and transfers navy to Free France (government-in-exile)
country_event = {
    id = fall_of_france.5
    option = {
        name = fall_of_france.5.a
        FRA = {
            transfer_navy = {
                target = F30        # Free France TAG
                is_government_in_exile = yes
            }
        }
    }
}

Synergy

[become_exiled_in](/wiki/effect/become_exiled_in): Typically invoked alongside transfer_navy when placing a nation into exile status, ensuring the government-in-exile actually controls naval forces rather than being an empty shell.
[annex_country](/wiki/effect/annex_country) / [end_puppet](/wiki/effect/end_puppet): Transfer the navy before annexation or ending puppet status to prevent fleets from disappearing with the nation, preserving equipment for the recipient.
[has_capitulated](/wiki/trigger/has_capitulated): Use as a trigger condition to execute fleet transfer logic only when the target nation capitulates, preventing unintended timing that could result in fleet loss.
[destroy_ships](/wiki/effect/destroy_ships): An alternative when destruction rather than transfer is desired, forming mutually exclusive branch options with transfer_navy to provide different disposal methods for players or AI.

Common Pitfalls

Aircraft Carriers Not Supported: The official documentation explicitly states this effect does not transfer aircraft carriers. Novices using this command to transfer fleets containing carriers will find the carriers disappearing without explanation (neither transferred nor remaining with the original nation). Pre-handle carriers separately with [destroy_ships](/wiki/effect/destroy_ships) or use alternative methods to avoid this issue.
Incorrect Scope Targeting: The scope of transfer_navy must be the exporting nation (the original fleet owner), with target being the recipient. Beginners often reverse these, executing within the recipient nation's scope, resulting in invalid or erroneous scripts. Always verify you are in the correct nation scope before invoking the command.

effect · transfer_navy