Skip to content

Council Configuration

leeyi45 edited this page Aug 15, 2018 · 10 revisions

Configuring your council

conf.xml

Upon loading, the program automatically searches for an xml file called "conf.xml" from which it will load its settings. If you don't have a conf.xml file set up, or if you would like to see an example, you can always just download the default one and use it.

Inside the program itself you can also manually load a settings file, so you don't have to restart the program even if you need to change the settings.

Each conf.xml has four separate sections, which will be explained in more detail below

Council And Topics

This section contains the display information needed for the program

Under the council element, the <Name> element is used to specify the name that is displayed by the program while it is running.

You can also specify the different issues that your council will be debating upon in the topics, section, which looks something like this:

<Topics>
  <Topic>Issue 1</Topic>
  <Topic>Issue 2</Topic>
  <Topic>Issue 3</Topic>
</Topics>

You can specify any number of topics that you'd like, and you will be able to select from all of them from inside the program

Delegations

This section contains all the data for the different countries, or delegations that will be available within your council. Each country element looks something like this:

<Delegation>
  <Name>Islamic Republic of Afghanistan</Name>
  <Shortf>Afghanistan</Shortf>
  <Observer>false</Observer>
  <P5Veto>false</P5Veto>
</Delegation>

<Name> specifies the full name of that country, while <Shortf> gives the short form that is used to make selecting that delegation a lot easier.

<Observer>, when set to true, does exactly what it says and excludes them during substantive votes. <P5Veto>, when set to true, gives that delegation veto powers, much like in the UNSC. Note that you can give any number of delegations the veto power, but by default it is given to the UK, US, Russia, France and China.

If you place a flag image file in the flags folder with the name you use in <Shortf>, the program will automatically display that flag when that delegation is making a speech.

However, some countries may have odd names that cannot be used as a file name, so to manually specify a flag file name to look for you use the <AltName> tag, just like with Ivory Coast.

<Delegation>
  <Name>Republic of Côte d’Ivoire</Name>
  <Shortf>Côte d’Ivoire</Shortf>
  <AltName>Ivory Coast</AltName>	
  <Observer>false</Observer>
  <P5Veto>false</P5Veto>
</Delegation>

Then, instead of looking for Côte d’Ivoire.jpg, the program uses Ivory Coast.jpg instead.

There's no limit to how many delegations you can add to a council, so add as many as you like!

Settings

The settings section contains the various settings that the program will load as a default. You can change this while the program is running, but they won't be saved to the file.

The section looks something like this:

<Settings>
  <FiftyPlus1>false</FiftyPlus1>
  <TwoThirdPlus1>false</TwoThirdPlus1>
  <GSLSpeakTime>90</GSLSpeakTime>
  <UnmodSpeakTime>300</UnmodSpeakTime>
  <UnmodSummaryTime>60</UnmodSummaryTime>
  <ModSpeakTime>60</ModSpeakTime>
  <ModTotalTime>600</ModTotalTime>
  <DebateSpeakTime>90</DebateSpeakTime>
  <ResoReadTime>180</ResoReadTime>
  <SaveSpeakTime>true</SaveSpeakTime>
  <SaveMotions>true</SaveMotions>
  <TrackDebate>false</TrackDebate>
  <DebateSpeakCount>2</DebateSpeakCount>
</Settings>

Noting that all time settings are in seconds, going through each setting:

  1. FiftyPlus1 - When set to true, procedural votes will require 1 more vote for than a 50% majority to pass
  2. TwoThirdPlus1 - When set to true, substantive votes will require 1 more vote for than two thirds majority to pass
  3. GSLSpeakTime - Default value for speaking time on the GSL
  4. UnmodSpeakTime - Default value in for unmoderated caucuses
  5. UnmodSummaryTime - Default value in for time given to the speaker to summarize an unmoderated caucus
  6. ModSpeakTime - Default value given for each speaker in a moderated caucus
  7. ModTotalTime - Default value given for the total duration of a moderated caucus
  8. DebateSpeakTime - Default value for speakers during closed debate
  9. ResoReadTime - Default value for reading a resolution after it has been introduced
  10. SaveMotions - When set to true, the program will save the different motions raised by delegates, regardless of whether they pass or fail
  11. TrackDebate - When set to true, the program will generate a text file containing the events of the council as tracked by itself
  12. DebateSpeakCount - Default number of speakers per side for closed debate

Motions

You can also customize how motions behave using the motions section. By default, the usual motions are already there, and they have to be there for the program to load, but you can add on other motions as well.

Every motion consists of the following:

<Motion>
  <Disruptiveness>3</Disruptiveness>
  <Text>to divide the question</Text>
  <Id>divide_qn</Id>
  <Name>Divide the Question</Name>
  <Duration>false</Duration>
  <SpeakTime>false</SpeakTime>
  <Topic>false</Topic>
</Motion>
  1. Disruptiveness - An integer value indicating how disruptive the motion is relative to others. This controls how the motions are sorted on the motions page.

  2. Text - A rough description of the motion (this tag is currently not in use and will likely be removed in the future. It is okay to leave this blank)

  3. Id - The unique ID for the motion type. The default motions already have predefined IDs, so if you are creating a custom motion, do not use the existing IDs, and if you are changing the default ones do not change this value

  4. Name - The name of the motion, pretty self-explanatory

  5. Duration - When set to true, the motion requires a total duration to be specified upon creation

  6. SpeakTime - When set to true, the motion requires a specific time to be specified for individual speakers upon creation

  7. Topic - When set to true, the motion requires a topic to be specified upon creation

Creating your own custom motions will make them available on the motions page to be added and voted upon.

Clone this wiki locally