Difference between revisions of "IGNFileFormat"

From The Battle for Wesnoth Wiki
m (Use <code> for code snippets (except '?' which looks awkward))
(Default values: Clarified that as of today the default _server.ign is not overridden but extended)
Line 17: Line 17:
 
==== Default values ====
 
==== Default values ====
  
If there is no custom _server.ign file present, a default filter will be used instead, which as of Wesnoth 1.12 is as follows:
+
If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:
  
 
  .*
 
  .*
Line 38: Line 38:
 
  *.vbs
 
  *.vbs
 
  *.o
 
  *.o
 +
*.ini  {{DevFeature1.13|12}}
 
  Thumbs.db
 
  Thumbs.db
 
  *.wesnoth
 
  *.wesnoth
 
  *.project
 
  *.project
  
If there is a custom _server.ign file, the contents of the file are used as the filter '''instead''' of the defaults, so you should include any of the applicable default exclusions patterns in your own file as well.
+
If there is a custom _server.ign file, the contents of the file are used in addition to the defaults listed here.
  
 
== See Also ==
 
== See Also ==

Revision as of 17:38, 8 March 2018

When you upload an add-on, some files and directories are ignored and not uploaded.

If you would prefer to have more control over which files and directories should be ignored, you should provide a _server.ign file containing a list of filter patterns. Each file or directory matching any entry of the _server.ign file will not be included when uploaded to the add-ons server.

Where do I put the file, and what goes in it?

The file should be placed within the root level of your add-on (data/add-ons/addon_name/_server.ign).

A specific format is required:

  • (Version 1.13.0 and later only): Blank lines and lines beginning with '# ' (space required) are ignored.
  • Each line should contain exactly one pattern.
  • * and ? wildcards are supported (? stands for any single character, * stands for any number of any characters).
  • Patterns with a trailing forward slash '/' will match directories; the rest only match files.

Default values

If there is no custom _server.ign file present, a default filter will be used instead, which is as follows:

.*
.*/
__MACOSX/
#*#
*~
*-bak
*.swp
*.pbl
*.ign
_info.cfg
*.exe
*.bat
*.cmd
*.com
*.scr
*.sh
*.js
*.vbs
*.o
*.ini  (Version 1.13.12 and later only)
Thumbs.db
*.wesnoth
*.project

If there is a custom _server.ign file, the contents of the file are used in addition to the defaults listed here.

See Also