Other Scripts

Miscellaneous Lua Scripts

The data/tribes/scripting directory provides some global scripts related to the tribes. It contains the following subdirectories:

• data/tribes/scripting/help: These scripts load all information used by the in-game help (‘Tribal Encyclopedia’). Unit-specific help is loaded with the help of each unit’s and tribe’s help texts defined in data/tribes/initialization/<tribe_name>/units.lua.

• worker_help.lua
  • worker_help_producers_string()
  • worker_help_employers_string()
  • worker_help_string()
• ware_help.lua
  • ware_help_general_string()
  • ware_help_producers_string()
  • ware_help_consumers_string()
• time_strings.lua
  • format_seconds()
  • format_minutes()
  • format_minutes_seconds()
• building_help.lua
  • dependencies_basic()
  • item_image()
  • find_resource_indicator()
  • find_created_collected_matches()
  • dependencies_collects()
  • dependencies_creates()
  • building_help_general_string()
  • building_help_dependencies_production()
  • building_help_building_section()
  • building_help_crew_section()
  • building_help_production_section()
  • building_help()
• immovable_help.lua
  • immovable_help_string()
• calculations.lua
  • programs_wares_count()
  • programs_workers_count()
• format_help.lua
  • image_line()
  • plot_size_line()
  • dependencies()
  • help_ware_amount_line()
  • help_worker_experience()
  • help_tool_string()
  • help_consumed_wares_workers()

Non-Scripting User Data

Naming Lists

A user can define custom naming lists for ships and warehouses in their home directory. The files are called ship_names and warehouse_names respectively and placed in the Widelands home directory.

Each file, if present and not empty, may define any number of names, with one name per line, where each name can be used for all tribes or just some tribes. The file is divided with section headers in brackets, where each header is a comma-separated list of tribes. All names in this section are applied to only these tribes. Names outside a section or in sections with an empty name apply to all tribes. Example:

All Tribes 1
All Tribes 2

[barbarians]
Barbarians Only 1
Barbarians Only 2

[empire, barbarians, amazons]
This name applies to these three tribes