# MUNchkin

A discord bot for Model United Nations.

## Commands

The 'Chair' role is required to use Chair commands. Delegate commands can used by anyone.

MUNchkin has a variety of commands used to aid online MUN sessions in discord. To start a session, join a voice channel and write:

```
!startSession
```
This enables the rest of the commands for use.

MUNchkin has a help facility which can be used by calling !help to list all commands. Help on a command can be retrieved by calling:
```
!help
```
MUNchkin's default prefix is ! which can be changed using:
```
!prefix [new prefix]
```
Below is the list of help information for each command:

```
Chair Commands:

!startSession 
Enables all commands for a session and invites bot to voice channel.

!register [delegate name] [status]
Status can be present (p),present and voting(pv) or absent (a)

!viewRegister
Displays all registered delegations and their statuses.

!GS
Prints out the current general speakers list.

!popGS
Remove first delegate from general speakers list.
Used just after a speaker has finished.

!speak [delegate name] [time in seconds]
Yields the floor to the delegate. Starts a timer.

!propose mod [total time in min] [speakers time in sec] [country proposed] [topic]
Propose a moderated caucus.

!propose [unmod or other] [total time in min] [country proposed]
Propose an unmod or other type of caucus.

!mod [total time in min]
Starts a timer for Mod. Sending the word 'cancel' will cancel it, 'pause' will pause it.

!unmod [total time in min]
Starts a timer for Unmod. Sending the word 'cancel' will cancel it, 'pause' will pause it.

!voting [topic]
Starts a non-caucus vote. Useful for final vote or amendments.

!endSession
Disables session commands and disconnects bot from voice channel.
Clears GS list.

!chair [@member]
Gives chair role to another member.

!resume
Resume a previously paused caucus.

Delegate Commands:

!addGS
Adds your name to the general speakers list.

!tap
Alerts that you support the current debate.

!preamble
Displays list of phrases, useful for preambulatory clauses.

!operative
Displays list of phrases, useful for operative clauses.

!about
Provides information about MUNchkin.

!rules
Provides simplified ruleset for Harvard style MUN.

!notebook
Enable/disable notepassing for yourself.

!note [@user] message
Send a note to a user (you and them both need notepassing enabled).
```

To end a session and disconnect the bot, run:
```
!endSession
```
This disables the session commands.

## FAQs

_Why didn't MUNchkin respond to some commands?_
Make sure you call ```!startSession``` In a voice channel, and that you have the role 'Chair'.

_MUNchkin randomly stopped responding, went offline and reset all lists?_
Unfortunately, this is part of running the bot on Heroku. The Heroku environment needs a restart everyday so it may randomly restart the bot, which is unlucky if you're in the middle of a session when it happens. It should only take a few minutes to restart.

_MUNchkin was down for a significant period of time, why?_
I've seen logs where Heroku has an internal server error. This is out of my control and it depends when Heroku fixes their problems. It may take a few hours for their engineers to fix internal problems.

MUNchkin

A discord bot for managing Model United Nations sessions. (Harvard Style).

Voting for MUNchkin

Do you want to support us?