.cfg and .pbl?

Discussion and development of scenarios and campaigns for the game.

Moderator: Forum Moderators

Post Reply
The Killing Nun
Posts: 16
Joined: March 26th, 2007, 3:07 am

.cfg and .pbl?

Post by The Killing Nun »

What do .cfg and .pbl mean? the tutorial online say that each should be added on to the end of a saved file for creating a campaign, but it doesn't say if it is just in the name alone or if .cfg and .pbl are two different kinds of programs.
also when listing an icon in the .pbl file the example is something like images/lighthouse, but I was wondering how far back in the file name I had to put. like data/vcampaigns/images...etc.

I would greatly appreciate any help.
Sr. Bigfoot the Killing Nun
User avatar
Eleazar
Retired Terrain Art Director
Posts: 2481
Joined: July 16th, 2004, 1:47 am
Location: US Midwest
Contact:

Re: .cfg and .pbl?

Post by Eleazar »

The Killing Nun wrote:What do .cfg and .pbl mean?
both are plain text files.
Feel free to PM me if you start a new terrain oriented thread. It's easy for me to miss them among all the other art threads.
-> What i might be working on
Attempting Lucidity
The Killing Nun
Posts: 16
Joined: March 26th, 2007, 3:07 am

writing a campaign

Post by The Killing Nun »

I don't mean to be a pain, but I wanted to ask a few more clarifying question on the online explinations of how to write a campaign.

(1)So, could I used Microsoft Word to write the campaign and scenarios so that all I would have to do would be to add .pbl to the name of the proper file and .cfg to the name of the other file? (I tried writing just a one scenario piece but when I try to get it to log to my campaign list in the Wesnoth game it doesn't appear. I'm assuming its my .pbl or .cfg files somehow so I'm working on making sure all the WML and the saved folders are correct.)

(2)When I insert a map into the scenario it should be written map_data=�{
plus what and where do I find that information on my usermade maps? The online explanation said something about a list of a whole bunch of numbers (from the grid I'm assuming), but I couldn't find that list on the usermap I made.

(3) Do I have to upload my campaign to the server in order to use it and to check it periodically while I'm working on it?

Thanks for your time.
Sr. Bigfoot the Killing Nun
Glowing Fish
Posts: 855
Joined: October 3rd, 2004, 4:52 am
Location: Portland, OR
Contact:

Re: writing a campaign

Post by Glowing Fish »

The Killing Nun wrote:I don't mean to be a pain, but I wanted to ask a few more clarifying question on the online explinations of how to write a campaign.

(1)So, could I used Microsoft Word to write the campaign and scenarios so that all I would have to do would be to add .pbl to the name of the proper file and .cfg to the name of the other file? (I tried writing just a one scenario piece but when I try to get it to log to my campaign list in the Wesnoth game it doesn't appear. I'm assuming its my .pbl or .cfg files somehow so I'm working on making sure all the WML and the saved folders are correct.)
No, Microsoft Word is a word processor, not a text editor. That means, even if you can't see it, there are lots of other characters that get saved in your file. All the formatting that tells the text what it is supposed to look like gets counted as characters, which don't make any sense to the WML reader, of course.
So, the short answer is, you use notepad, which is a pure text editor.
Make sense?
User avatar
Viliam
Translator
Posts: 1341
Joined: January 30th, 2004, 11:07 am
Location: Bratislava, Slovakia
Contact:

Post by Viliam »

Using Windows with the file extension hiding feature, be careful whether you really save your file as "example.cfg", or if it gets automatically added "example.cfg.txt" or "example.cfg.doc".

The PBL file is used only for publishing. You do not need it to play on your own computer; it is only used when you publish the game on the internet server. To make a new campaign appear in the list in game, you only need a campaign CFG file, which looks like this:

Code: Select all

[textdomain]
  name="my-campaign"
[/textdomain]
[campaign]
  #textdomain my-campaign
  id=my_campaign
  icon=HttT_campaign_icon.png
  name= _ "My Campaign"
  define=CAMPAIGN_MY_CAMPAIGN
  first_scenario=my_scenario
  description= _ "This is my first campaign."
  image=HttT_campaign_image.png
[/campaign]

#...some code here to include scenario files
If you make this, the campaign should appear in the game menu.
User avatar
Viliam
Translator
Posts: 1341
Joined: January 30th, 2004, 11:07 am
Location: Bratislava, Slovakia
Contact:

Post by Viliam »

The map is simply a grid of characters. There are two ways to use it. One (used mostly in examples, and some older scenarios) is to put those characters directly in the scenario CFG file, which looks like this:

Code: Select all

[scenario]
id=my_first_scenario
name= _ "My First Scenario"
map_data="aaabba
a1bb2b
bbaaab"
#... some more things
[/scenario]
The second option is to have the characters in the separate file. The advantage is that you can edit that file with Map Editor. The scenario CFG then looks like this:

Code: Select all

[scenario]
id=my_first_scenario
name= _ "My First Scenario"
map_data="{campaigns/My_Campaign/maps/First_Scenario}"
#... some more things
[/scenario]
And the map file looks like this:

Code: Select all

aaabba
a1bb2b
bbaaab
Post Reply