编辑“Ship modding”（章节）

=== Data Structure ===
{| class="wikitable mw-collapsible"
|-
! width="20%"| Property
! width="16%"| Military Ships
! width="16%"| Civilian Ships
! width="16%"| Starbases
! width="16%"| Defense Platforms
! width="16%"| Civilian Stations
|-
| '''graphical_culture = { mammalian_01 … }'''
|colspan="5"| A list of [[Species modding|Graphical Cultures]] this ship size is valid to have. Can also specify as <code>graphical_culture = no</code> to indicate that this Ship Size doesn't need Graphical Cultures.
|-
| '''entity = some_entity'''
|colspan="5"| Defines the graphical entity used, replacing the default SHIPSIZE_entity lookup.
|-
| '''max_hitpoints = <int>'''
|colspan="5"| Defines the base Hull Points of this ship size.
|-
| '''combat_disengage_chance = <float>'''
|colspan="2"| This property multiplies the chance this Ship disengages in battle.
|colspan="3"| Vanilla always have 0 or leave this property undefined.
|-
| '''max_speed = <int>'''
| colspan=2 rowspan=3 | Defines the base speed, acceleration and rotation speed of this ship size.
|rowspan="3"| Vanilla Starbases usually have 0 for these properties, except for the Juggernaut.
|rowspan="3"| Defense Platforms also need these properties because they need to move from the Starbase to their defense position.
|rowspan="3"| Vanilla Civilian Stations always have 0 for these properties.
|-
| '''acceleration = <float>'''
|-
| '''rotation_speed = <float>'''
|-
| '''formation_priority = <int>'''
| Ships with higher formation priority trends to go ahead of the rest of the fleet.
| style="text-align: center;" rowspan=2 colspan=4 | {{icon|no}}
|-
| '''collision_radius = <int>'''
| The radius other ships will try to avoid colliding with.
|-
| '''modifier'''
|colspan="5"| A block of [[Modifiers]] to be added to the ships of this size. These modifiers will come to effect even before the actual ships are built, you can see these in the Ship Designer. Only the following modifiers are allowed here.
* ship_evasion_(add/mult)
* ship_speed_mult & ship_base_speed_mult
* ship_(hull/armor/shield)_(add/mult) & ship_(hull/armor/shield)_regen_add_(static/perc)
* ship_weapon_damage & <weapon slot size>_weapon_damage_mult
* ships_upkeep_mult & ships_<resource type>_upkeep_mult
* ship_piracy_suppression_add

Starbases can also use the following modifiers here.
* starbase_(module/building/defense_platform/shipyard)_capacity_add
* starbase_(trade_collection_range/protection_range/protection)_add
|-
| '''ship_modifier'''
|colspan="5"| Another block of [[Modifiers]] to be added to the ships of this size. Modifiers like <code>ship_fire_rate_mult</code> and <code>ship_weapon_range_mult</code> go here.
|-
|rowspan="2"| '''size_multiplier'''
|colspan="5"| How large should the fleet battle AI consider this ship of.
|-
| This also determines the number of Command Points needed to add this Ship Design to a Fleet.
| Vanilla Civilian Ships always have 1 for this property.
| Vanilla Starbases always have 4 for this property.
| This also determines the number of Defense Platform Capacities this Defense Platform will take up from a Starbase.
| Vanilla Civilian Stations always have 1 for this property.
|-
| '''combat_size_multiplier'''
|colspan="5"| How large should the fleet battle AI consider this ship of, overwriting the <code>size_multiplier</code>.
|-
| '''fleet_slot_size'''
| This determines the order this ship size appears in a fleet, with Corvettes having 1 up to Titans having 8.
| colspan=4 style="text-align: center;" | {{icon|no}}
|-
| '''num_target_locators'''
| colspan=5 | ??
|-
| '''is_civilian = <yes/no>'''
| style="text-align: center;" | {{icon|no}}
| Vanilla always have <code>is_civilian = yes</code>. Other Ship Sizes have either <code>is_civilian = no</code> or just have this property undefined, except for the Observation Station being <code>yes</code>.
| colspan=3 style="text-align: center;" | {{icon|no}}
|-
| '''valid_target_aggressive_stance = <yes/no>'''
|colspan="5"| Determines should this Ship be ignored by a Military Fleet in aggressive stance.<br>Among vanilla Ship Sizes, only Civilian Ships and Civilian Stations have <code>valid_target_aggressive_stance = no</code>.
|-
| '''build_block_radius = <int>'''
| colspan=3 style="text-align: center;" | {{icon|no}}
| Since Military Stations have been reworked, it's still unclear what's the use of this property for now.
| style="text-align: center;" | {{icon|no}}
|-
| '''is_space_station = <yes/no>'''
| colspan=3 style="text-align: center;" | {{icon|no}}
|colspan="2"| Vanilla always have <code>is_space_station = yes</code>. Other Ship Sizes have either <code>is_space_station = no</code> or just have this property undefined.
|-
| '''is_space_object = <yes/no>'''
|colspan="5"| Determines should this Ship Size have trailers when the Ships move in the Space. Space monsters usually have <code>is_space_object = yes</code>.
|-
| '''can_be_inspected = <yes/no>'''
|colspan="5"| Determines should Designs of this Ship Size can be inspected by the player. Some space monsters have <code>can_be_inspected = no</code>.
|-
| '''icon_frame = <int>'''
| Determines the index of the icon of this Ship Size in a shared icon file.
| colspan=4 style="text-align: center;" | {{icon|no}}
|-
| '''is_designable = <yes/no>'''
|colspan="5"| Determines should this Ship Size be designable in the Ship Designer.<br>Among vanilla Ship Sizes, buildable Military Ships, the Juggernaut and buildable Defense Platforms have <code>is_designable = yes</code>.
|-
| '''enable_default_design = <yes/no>'''
|colspan="5"| Determines should an Empire start with an auto-generated design of this Ship Size.<br>All buildable Ship Sizes have <code>enable_default_design = yes</code>, regardless of they are designable or not, or the AI will not be able to build this.
|-
| '''can_have_federation_design = <yes/no>'''
|colspan="5"| Determines if this Ship can have a federation design.<br>Among vanilla Ship Sizes, only buildable Military Ships and the Juggernaut have <code>can_have_federation_design = yes</code>, except for the Colossus being without it.
|-
| '''components_add_to_cost = <yes/no>'''
|colspan="5"| Determines should the Ship Construction Cost and the Ship Upkeep take Ship Components and Ship Sections into account.<br>Among vanilla Ship Sizes, only undesignable but buildable Ship Sizes have <code>components_add_to_cost = no</code>.
|-
| '''auto_upgrade = <yes/no>'''
| colspan="2" | Determines should the design of this Ship Size automatically upgrade based on the recent technologies. Existing ships will also be upgraded.
<br>Among vanilla Ship Sizes, only Civilian Ships and Civilian Stations have <code>auto_upgrade = yes</code>, except for the Observation Station being without it.
!{{icon|no}}
| colspan="2" |Determines should the design of this Ship Size automatically upgrade based on the recent technologies. Existing ships will also be upgraded.
<br>Among vanilla Ship Sizes, only Civilian Ships and Civilian Stations have <code>auto_upgrade = yes</code>, except for the Observation Station being without it.
|-
| '''can_disable = <yes/no>'''
|colspan="5"| Determines should this Ship be disabled rather than be destroyed if at low health.<br>Among vanilla Ship Sizes, only buildable Starbases except for the Juggernaut have <code>can_disable = yes</code>.
|-
| '''flip_control_on_disable = <yes/no>'''
|colspan="5"| Determines can this Ship be captured after it's disabled.<br>Among vanilla Ship Sizes, only buildable Starbases except for the Juggernaut have <code>flip_control_on_disable = yes</code>.
|-
| '''default_behavior = <ship behavior>'''
| Determines the default ship behavior the auto generated designs should try to pick when choosing the combat computer component.
| colspan=4 style="text-align: center;" | {{icon|no}}
|-
| '''section_slots = { <section slot name> = { locator = <locator name> } }'''
|colspan="5"| Determines the [[Ship modding#Ship Sections|Sections]] needed for this Ship Size. The locators are pointers on the Ship entity, see [[Graphics modding]] for details.
|-
| '''base_buildtime = <int>'''
|colspan="4"| Days it takes to build this ship / station or upgrade into this starbase.
| Vanilla civilian stations have this property undefined.
|-
| '''prerequisites = { tech_xxx }'''
|colspan="5"| A list of Technologies required to design and build this Ship Size or upgrade existing Starbases into this level.
|-
| '''class'''
|
* <code>shipclass_military</code>
* <code>shipclass_military_special</code> (the Colossus)
|
* <code>shipclass_constructor</code>
* <code>shipclass_colonizer</code>
* <code>shipclass_science_ship</code>
* <code>shipclass_transport</code>
|
* <code>shipclass_starbase</code>
|
* <code>shipclass_military_station</code>
|
* <code>shipclass_mining_station</code>
* <code>shipclass_research_station</code>
* <code>shipclass_observation_station</code>
|-
| '''construction_type'''
|colspan="2"| <code>starbase_shipyard</code>
| Starbases usually have this field undefined, except the Juggernaut has <code>starbase_shipyard</code>.
| <code>starbase_defenses</code>
| style="text-align: center;" | {{icon|no}}
|-
| '''potential_construction'''
|colspan="2"| A block of [[Conditions]] to check should this Ship Size appear in the construction list of a Starbase or Megastructure. (Starbase or Megastructure scope, use <code>is_scope_type</code> to check scope type; FROM is the builder empire)
|rowspan="2"| Starbases usually have this field undefined, except for the Juggernaut.
| The same. Vanilla Defense Platforms only allow Starbases to build them.
| style="text-align: center;" | {{icon|no}}
|-
| '''possible_construction'''
|colspan="2"| A block of [[Conditions]] to check can this Ship Size be built by a Starbase or Megastructure. If evaluated false, the construction option is still visible but grayed out with a tooltip. (Starbase or Megastructure scope, use <code>is_scope_type</code> to check scope type; FROM is the builder empire)
| The same. Among vanilla Defense Platforms, the Ion Cannon can only be built by Citadel-level Starbases.
| style="text-align: center;" | {{icon|no}}
|-
| '''resources'''
|colspan="5"| An [[Economy modding#Economy Units|Economy Unit]] to determine the construction cost and upkeep of this Ship. This is the final cost if this Ship Size has <code>components_add_to_cost = no</code>. Although vanilla unused, resource productions is also allowed here.
|-
| '''min_upgrade_cost = { <resource key> = <int> }'''
| The minimal cost required to upgrade this Ship. Used to prevent zero-cost upgrades by shifting from a Component to another of exactly same cost.
| colspan=2 style="text-align: center;" | {{icon|no}}
| The same.
| style="text-align: center;" | {{icon|no}}
|-
| '''empire_limit = { base = <int> (max = <int> naval_cap_div = <int>) }'''
|colspan="5"| Determines the max number of Ships of this Size an empire can have at the same time. The number is <code>base</code> plus empire naval capacity divided by <code>naval_cap_div</code>, rounded down, at most <code>max</code>.
|-
| '''required_component_set = <component set key>"
|colspan="5"| Requires a core component with a [[Ship modding#Component Sets|Component Set]]. Multiple allowed. While designing by the Ship Designer, these will be displayed on the right.
|}
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*