编辑“Empire modding”（章节）

== Implementing custom Start Screen introductory text and empire description ==

In Stellaris, every single empire gets auto-generated introductory text when starting a new game, built from 'text pieces' based on [[ethics]], government, planet class, FTL and few other "characteristic traits" of it. However, there is also an option of creating custom introductory text for a custom empire. If you want to do this, you will need to modify few separate files.

=== Prescripted_countries.txt ===

One of the lines in 00_prescripted_countries.txt is mysterious

 flags = { human_1 custom_start_screen }

If you don't want your empire to have unique, custom introduction text, just delete it. Otherwise, leave it in place. Imperial "flag" (in this case human_1) is used to identify the particular empire, so it needs to be the same here and in the next file.

=== Start_screen_messages.txt ===

Go to Stellaris->common->start_screen_messages folder, here is the file '''00_start_screen_messages.txt'''. On the bottom of this file there is code allowing custom introductory text to appear instead of a randomly generated one. 
In case of our example, United Nations of Earth, it is 

 # United Nations of Earth
 part = {
         location = 0
         localization = "START_SCREEN_UNE"	
         trigger = {
                has_country_flag = human_1
         }		
 }

Just copy that code for your custom empire. Location should always be 0. Localization should be exactly the same code as in the localisation files, and has_country_flag has to point at the same "imperial flag" as in prescripted countries.txt

 has_country_flag = human_1
                    human_1 custom_start_screen

=== Localisation ===

Then you just need to create localisation file which will contain introductory text for your empire. All localisation files need to be in YML format (in Stellaris->localisation you can see how do they look, you may copy one of them and remake it) and their names have to end in l_language (l_english, l_russian etc.) to work. For example, introductory text of United Nations of Earth look like this: 

 START_SCREEN_UNE:0 "Much has happened since modern Humans first emerged in Africa (...)"

Just use the same START_SCREEN_CUSTOMEMPIRENAME line here and in Start_screen_messages.txt file.
Also, remember about two things. If you want your text to enter new paragraph, use '''\n\n''' as in

 civilizations took form.\n\nScientific progress has been swift

And as for now, be careful not to create too long introductory text, as it will be cut if not fitting inside of the start screen window. Just make it not much longer than exemplary introduction of UNE.


Each Stellaris empire also may have a description displaying on a new game screen when browsing through playable empires. In case of United Nations on Earth this description is in localisation->prescripted_l_english.yml:

 EMPIRE_DESIGN_humans1:0 "United Nations of Earth"
 EMPIRE_DESIGN_humans1_desc:0 "The myriad Human nations that constitute their interstellar government (...)"
 
You can, of course, do the similar description for your custom empire. Remember about appropriate codename, paragraphs and length (although in case of descriptions, 'too long' ones will display under scrollbar).