Difference between revisions of "CreditsWML"
(Split this section from CampaignWML) |
(Update for 1.14 and later) |
||
Line 1: | Line 1: | ||
{{WML Tags}} | {{WML Tags}} | ||
− | + | CreditsWML provides the list of creators that can be displayed at the end of campaigns and by the title screen's Credits button. The top-level tags that can add a section to the credits are '''[[CampaignWML|[campaign]]]''' and '''[credits_group]'''. | |
− | + | == [credits_group] == | |
− | * '''title''': (translatable) large text used to start a new subsection (writers, artists, units, balancing) in the | + | |
+ | This tag has the following keys: | ||
+ | * '''sort''': if set to yes, the subsections (the [about] tags) will be sorted alphabetically by title. Defaults to no. | ||
+ | * '''[about]''': each of these represents a subsection. | ||
+ | |||
+ | There's no title or section-heading attribute. The effect of splitting credits between separate groups is used so that the credits for translators can be grouped together sorted alphabetically by the name of the language. | ||
+ | |||
+ | == [campaign] == | ||
+ | |||
+ | Any '''[campaign]''' that includes at least one '''[about]''' tag is parsed for the purposes of the credits. | ||
+ | |||
+ | The following keys from [[CampaignWML]] are used in the credits: | ||
+ | * '''id''': Used internally in the engine. | ||
+ | * '''name''': Used as the section header. | ||
+ | * '''[about]''': each of these represents a subsection. | ||
+ | |||
+ | It's unclear whether '''[sort]''' should be supported for this. As of 1.15.12 it's recognised by the engine but not by the schema. | ||
+ | |||
+ | == [about] == | ||
+ | |||
+ | Each '''[about]''' tag forms a subsection of the containing group. | ||
+ | |||
+ | This tag has the following keys: | ||
+ | * '''title''': (translatable) large text used to start a new subsection (writers, artists, units, balancing, etc) | ||
+ | * '''[entry]''': see next section | ||
+ | |||
+ | If an '''[about]''' tag contains no '''[entry]''' tags then its title won't appear either. This is used in about_i18n.cfg - the header is added when a new language is enabled in the translation mechanism but the names are added later. | ||
+ | |||
+ | The following optional attributes are accepted by the schema (at the time of writing, 1.15.12), but won't be shown in-game: | ||
* '''text''': (translatable, but you probably won't want to make it such) smaller text which is displayed before the contributor names | * '''text''': (translatable, but you probably won't want to make it such) smaller text which is displayed before the contributor names | ||
− | |||
− | |||
− | |||
− | |||
− | |||
+ | The '''[about]''' tag can also appear as a stand-alone top level tag. This seems to be a legacy from before the addition of the '''[credits_group]''' tag, so should probably be deprecated; the handling in 1.14 until the time of writing (1.15.12) is that they're all collected into a group which is shown after the '''[credits_group]''' tags and before the '''[campaign]''' tags. | ||
+ | |||
+ | == [entry] == | ||
+ | |||
+ | Contains information about a single contributor. | ||
+ | |||
+ | * '''name''': The text to display. | ||
+ | |||
+ | The following optional attributes are accepted by the schema (at the time of writing, 1.15.12), but won't be shown in-game: | ||
+ | * '''comment''': Optional short note about what that person did | ||
+ | * '''email''' | ||
+ | * '''discorduser''' | ||
+ | * '''ircuser''' | ||
+ | * '''wikiuser''' | ||
== See Also == | == See Also == |
Latest revision as of 14:03, 10 May 2021
CreditsWML provides the list of creators that can be displayed at the end of campaigns and by the title screen's Credits button. The top-level tags that can add a section to the credits are [campaign] and [credits_group].
[credits_group]
This tag has the following keys:
- sort: if set to yes, the subsections (the [about] tags) will be sorted alphabetically by title. Defaults to no.
- [about]: each of these represents a subsection.
There's no title or section-heading attribute. The effect of splitting credits between separate groups is used so that the credits for translators can be grouped together sorted alphabetically by the name of the language.
[campaign]
Any [campaign] that includes at least one [about] tag is parsed for the purposes of the credits.
The following keys from CampaignWML are used in the credits:
- id: Used internally in the engine.
- name: Used as the section header.
- [about]: each of these represents a subsection.
It's unclear whether [sort] should be supported for this. As of 1.15.12 it's recognised by the engine but not by the schema.
[about]
Each [about] tag forms a subsection of the containing group.
This tag has the following keys:
- title: (translatable) large text used to start a new subsection (writers, artists, units, balancing, etc)
- [entry]: see next section
If an [about] tag contains no [entry] tags then its title won't appear either. This is used in about_i18n.cfg - the header is added when a new language is enabled in the translation mechanism but the names are added later.
The following optional attributes are accepted by the schema (at the time of writing, 1.15.12), but won't be shown in-game:
- text: (translatable, but you probably won't want to make it such) smaller text which is displayed before the contributor names
The [about] tag can also appear as a stand-alone top level tag. This seems to be a legacy from before the addition of the [credits_group] tag, so should probably be deprecated; the handling in 1.14 until the time of writing (1.15.12) is that they're all collected into a group which is shown after the [credits_group] tags and before the [campaign] tags.
[entry]
Contains information about a single contributor.
- name: The text to display.
The following optional attributes are accepted by the schema (at the time of writing, 1.15.12), but won't be shown in-game:
- comment: Optional short note about what that person did
- discorduser
- ircuser
- wikiuser