Difference between revisions of "CreditsWML"

From The Battle for Wesnoth Wiki
(Split this section from CampaignWML)
 
(Update for 1.14 and later)
 
Line 1: Line 1:
 
{{WML Tags}}
 
{{WML Tags}}
  
== The [about] Tag ==
+
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]'''.
  
The campaign's name automatically is inserted at the top of the rolling credits followed by title/text key pairs. There can be any number of '''[about]''' tags inside a '''[campaign]''' tag. The '''[about]''' tag has the following keys:
+
== [credits_group] ==
* '''title''': (translatable) large text used to start a new subsection (writers, artists, units, balancing) in the rolling credits
+
 
 +
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
* '''[entry]''': Contains information about a single contributor. Only the ''name'' key will be used in-game, the other three keys are for display on the [[Credits]] page ('''note:''' the values of these keys will only display on the Credits page for mainline campaigns; they will not display for UMC campaigns)
 
** '''name''': The name of the contributor
 
** '''comment''': Optional short note about what that person did
 
** '''email''': Optional email address
 
** '''wikiuser''': Optional, the user name on the wiki
 
  
 +
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

[edit]WML Tags

A:

abilities, about, achievement, achievement_group, add_ai_behavior, advanced_preference, advancefrom, advancement, advances, affect_adjacent, ai, allied_with, allow_end_turn, allow_extra_recruit, allow_recruit, allow_undo, and, animate, animate_unit, animation, aspect, attack (replay, weapon), attack_anim, attacks (special, stats), avoid;

B:

base_unit, background_layer, berserk, binary_path, break, brush;

C:

campaign, cancel_action, candidate_action, capture_village, case, chance_to_hit, change_theme, chat, checkbox, choice, choose, clear_global_variable, clear_menu_item, clear_variable, color_adjust, color_palette, color_range, command (action, replay), continue, credits_group, criteria;

D:

damage, death, deaths, default, defend, defends, defense, delay, deprecated_message, destination, difficulty, disable, disallow_end_turn, disallow_extra_recruit, disallow_recruit, do, do_command, drains, draw_weapon_anim;

E:

editor_group, editor_music, editor_times, effect, else (action, animation), elseif, endlevel, end_turn (action, replay), enemy_of, engine, entry (credits, options), era, event, experimental_filter_ability, experimental_filter_ability_active, experimental_filter_specials, extra_anim;

F:

facet, facing, fake_unit, false, feedback, female, filter (concept, event), filter_adjacent, filter_adjacent_location, filter_attack, filter_attacker, filter_base_value, filter_condition, filter_defender, filter_enemy, filter_location, filter_opponent, filter_own, filter_owner, filter_radius, filter_recall, filter_second, filter_second_attack, filter_self, filter_side, filter_student, filter_vision, filter_weapon, filter_wml, find_path, fire_event, firststrike, floating_text, found_item, for, foreach, frame;

G:

game_config, get_global_variable, goal, gold, gold_carryover;

H:

harm_unit, has_ally, has_attack, has_unit, has_achievement, have_location, have_unit, heal_on_hit, heal_unit, healed_anim, healing_anim, heals, hide_help, hide_unit, hides;

I:

idle_anim, if (action, animation, intro), illuminates, image (intro, terrain), init_side, insert_tag, inspect, item, item_group;

J:

jamming_costs, join;

K:

kill, killed;

L:

label, language, leader, leader_goal, leadership, leading_anim, levelin_anim, levelout_anim, lift_fog, limit, literal, load_resource, locale, lock_view, lua;

M:

male, menu_item, message, micro_ai, missile_frame, modification, modifications, modify_ai, modify_side, modify_turns, modify_unit, modify_unit_type, move, move_unit, move_unit_fake, move_units_fake, movement_anim, movement costs, movetype, multiplayer, multiplayer_side, music;

N:

not, note;

O:

object, objective, objectives, on_undo, open_help, option, options, or;

P:

part, petrifies, petrify, place_shroud, plague, poison, post_movement_anim, pre_movement_anim, primary_attack, primary_unit, print, progress_achievement, put_to_recall_list;

R:

race, random_placement, recall (action, replay), recalls, recruit, recruit_anim, recruiting_anim, recruits, redraw, regenerate, remove_event, remove_item, remove_object, remove_shroud, remove_sound_source, remove_time_area, remove_trait, remove_unit_overlay, repeat, replace_map, replace_schedule, replay, replay_start, reset_fog, resistance (ability, unit), resistance_defaults, resource, return, role, rule;

S:

save, scenario, screen_fade, scroll, scroll_to, scroll_to_unit, secondary_attack, secondary_unit, section, select_unit, sequence, set_achievement, set_extra_recruit, set_global_variable, set_menu_item, set_recruit, set_specials, set_variable, set_variables, sheath_weapon_anim, show_if (message, objective, set_menu_item), show_objectives, side, skirmisher, slider, slow, snapshot, sound, sound_source, source (replay, teleport), special_note, specials, split, stage, standing_anim, statistics, status, store_gold, store_items, store_locations, store_map_dimensions, store_reachable_locations, store_relative_direction, store_side, store_starting_location, store_time_of_day, store_turns, store_unit, store_unit_defense, store_unit_defense_on, store_unit_type, store_unit_type_ids, store_villages, story, swarm, sub_achievement, switch, sync_variable;

T:

target, team, teleport (ability, action), teleport_anim, terrain, terrain_defaults, terrain_graphics, terrain_mask, terrain_type, test, test_condition, test_do_attack_by_id, text_input, textdomain, theme, then, tile, time, time_area, topic, toplevel, trait, transform_unit, traveler, true, tunnel;

U:

unhide_unit, unit, unit_overlay, unit_type, unit_worth, units, unlock_view, unpetrify, unstore_unit, unsynced;

V:

value, variable, variables, variant, variation, victory_anim, village, vision_costs, volume;

W:

while, wml_message, wml_schema;

Z:

zoom;

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
  • email
  • discorduser
  • ircuser
  • wikiuser

See Also

This page was last edited on 10 May 2021, at 14:03.