编辑“Megastructure modding”

{{Version|2.6}}

[[Megastructures]] are massive space objects to be built by Constructor ships.

They are defined at "common/megastructures/xxx.txt".

== Data Structure ==
{| class="wikitable mw-collapsible"
|-
! width="20%" | Property
! width="27%" | Built Around a Planet
! width="27%" | Freely Placed
! width="26%" | Upgraded
|- 
| '''portrait = <GFX entry>'''
| colspan=3 | Determines the image of this Megastructure to be displayed in the GUI.
|- 
| '''entity = <entity key>'''<br>'''construction_entity = <entity key>'''
| colspan=3 | Determines the entity of this Megastructure and the placeholder entity while it's being constructed by the Constructor ship.
|- 
| '''entity_offset = { x = <int>  y = <int> }'''
| Moves the position of this Megastructure relatively to the Planet.
| rowspan=2 colspan=2 style="text-align: center;" | {{icon|no}}
|- 
| '''place_entity_on_planet_plane = <yes/no>'''
| The Habitat has "yes". Actual functionality is unclear.
|- 
| '''show_galactic_map_icon = <yes/no>'''
| colspan=3 | Default yes. If no, having this Megastructure doesn't trigger the Megastructure galaxy view icon.
|- 
| '''potential'''
| colspan=2 | A block of [[Conditions]] to determine should this Megastructure appear in the construction list. (Country scope)
| The similar. If evaluated false, this Megastructure doen't appear as an upgrade option.
|- 
| '''possible'''
| colspan=2 | A block of [[Conditions]] to determine can this Megastructure be built in a solar system. (Solar System scope, FROM is the builder empire)
| The similar. If evaluated false, this Megastructure as an upgrade option will be disabled and grayed out.
|- 
| '''placement_rules'''
* '''planet_possible'''
| A weird nested block. The inner <code>planet_possible</code> is a block of [[Conditions]] to determine can this Megastructure be built on a Planet or Star. (Planet scope, FROM is the builder empire)
| colspan=2 style="text-align: center;" | {{icon|no}}
|- 
| '''build_outside_gravity_well = <yes/no>'''
| style="text-align: center;" | {{icon|no}}
| If yes, this Megastructure is built outside the system gravity well and doesn't need to be built around a Planet.
| style="text-align: center;" | {{icon|no}}
|- 
| '''upgrade_from = { <megastructure key> }'''<br>'''upgrade_desc = <default/hide>'''
| colspan=2 style="text-align: center;" | {{icon|no}}
| A list of Megastructures that can be used as a base to upgrade into This.

Don't specify a Megastructure as a pre-upgrade version of 2 or more Upgraded Megastructures.

If <code>upgrade_desc = hide</code>, this Megastructure doesn't appear in the tooltip in the Megastructure construction view. The level 4 Science Nexus is hidden from tooltip this way, because it can only be obtained by event.
|- 
| '''prerequisites = { <technology key> }'''
| colspan=3 | Technologies required to build or upgrade into this Megastructure.
|- 
| '''show_prereqs = <yes/no>'''<br>'''prereq_name = <localisation key>'''
| colspan=3 | Default no. If yes, this Megastructure will trigger a tooltip in the prerequisite tech that reads "Unlock Megastructure: My Megastructure".

If <code>prereq_name</code> is specified, the tooltip reads "Unlock Megastructure: My Megastructure Prereq Name".
|- 
| '''build_time = <int>'''
| colspan=3 | Days it takes to build this Megastructure or upgrade an existing Megastructure into this.
|- 
| '''resources'''
| colspan=3 | An [[Economy_modding#Economy_Units|Economy Unit]] to determine the cost, production and upkeep of this Megastructure.
|- 
| '''country_modifier'''
| colspan=3 | A block of [[Modifiers]] to be applied to the Empire.
|- 
| '''station_modifier'''
| colspan=3 | Used exclusively by the Mega Shipyard. Only one modifier (<code>starbase_shipyard_capacity_add = <int></code>) is used here to make this Megastructure capable to build Ships.
|- 
| '''ship_modifier'''
| colspan=3 | Used exclusively by the Mega Shipyard. These modifiers apply to the Ships built by this Megastructure.
|- 
| '''bypass_type = <bypass key>'''
| colspan=3 | Specifies a Bypass type of this Megastructure. See [[Bypass modding]] for details.
|- 
| '''sensor_range = <int>'''<br>'''hyperlane_range = <int>'''
| colspan=3 | Determines the sensor range and hyperlane detection range of this Megastructure.
|- 
| '''on_build_start'''
| colspan=3 | A block of [[Effects]] to be executed to the solar system scope when the construction or upgrade begins. Vanilla unused. (Solar System scope, FROM = builder empire, FROMFROM = the megastructure to be upgraded into this)
|- 
| '''on_build_cancel'''
| colspan=2 | A block of [[Effects]] to be executed to the solar system scope when the construction is canceled. Vanilla unused. (Solar System scope, FROM = builder empire)
| style="text-align: center;" | {{icon|no}}
|- 
| '''on_build_complete'''
| colspan=3 | A block of [[Effects]] to be executed to the solar system scope when the construction or upgrade is finished. (Solar System scope, FROM = builder empire, FROMFROM = the megastructure)
|- 
| '''ai_weight'''
| colspan=3 | AI trends to build Megastructures with high weight.
|- 
| '''construction_blocks_others = <yes/no>'''<br>'''construction_blocked_by_others = <yes/no>'''
| colspan=3 | Both default yes.

Megastructures with both property being yes or undefined use megastructure construction capacity.

Megastructures with both property being no doesn't use megastructure construction capacity.

It's not recommended to set one of them to "yes" and another to "no".
|}

== Planetized Megastructures ==
Some Megastructures, namely Habitats and Ringworlds, will be transformed into Planets once built. They spawn planets based on their own positions and then remove themselves by <code>remove_megastructure = FROMFROM</code>.

Additionally, there is an Effect executed on the Ringworld habitable segment: <code>trigger_megastructure_icon = yes</code>. This effect makes it so that having this planet in solar system triggers the Megastructure galaxy view icon, regardless of there being any megastructures-by-technical or not.


{{ModdingNavbox}}
[[Category:Modding]]