What Is TRPG?

***What is TRPG?

TRPG is a Twitch bot that creates an RPG world for your Twitch stream! Your viewers can join your TRPG world and wander the world map, gaining experience, leveling up, finding items, battle other players, and stealing items from defeated players!

***Why did you make TRPG?

Reasons for this project:
	* Gain experience in programming
	* Create an active project for resume puroses
	* Create another way for viewers to show support for streamers (you get rewarded for being active in chat, so the higher your level, the longer you've been around in the chat)
	* Create a fun little interactive game for Twitch chat that people would enjoy

***What happens in TRPG?

Every minute, every player who is not AFK (more detail about this below) will receive 1 experience point and may move one space on the world map. If a player levels up, they will have a chance of receiving an item. If that item is better than the one they currently have, they will replace it.

Once every player has gained their experience (and maybe leveled up and maybe found an item) and moved around the map, any space on the world map that has more than 2 players on it will trigger a battle. The game will grab 2 players from that space and have them battle each other. Battling takes place in the form of a dice roll. Each player's level and item levels will be totaled and a random value from 0 to that total will be given to the player. Whichever player has the higher dice roll wins. The winner will then look through the loser's inventory and will steal a random beneficial item from them. (i.e. an item that is a higher level than their own) The loser then gets warped away to a random location on the world map.

***How can I start a world for my stream?

Go to TRPGbot's stream chat (http://www.twitch.tv/trpgbot) and use the command !register to create a world for your stream! The !register command also allows two optional integer parameters that you can use for a custom world map size. Both numbers must be from 5 to 200, inclusive. If you do not provide these optional parameters, your world map will default to a size of 5x5. When deciding on a world map size, keep in mind your regular viewership and how often you would like players to battle each other. Once the !register command is received, TRPGbot will join your stream chat and will start accepting players for your TRPG server. At this point, it is highly suggested that you give moderator privileges to the bot. Doing so will make sure that TRPGbot will be able to function properly and announce game events to the chat. As a word of caution, the bot may seem a tad spammy at times at the beginning of your TRPG server's life, especially if you have a high viewer count and numerous people use the !join command in a short period of time. This possible spam should go away shortly as people who joined in the large group leave your stream or go AFK.

A series of steps you can use to find out a decent world map size is follows:

	* Step 1: Take ~20% of your regular viewership numbers. (e.g. 100 viewers, so 20)
	* Step 2: Double the number from Step 1. (e.g. 40) This is your world map area. The reasoning for this value is that if all players were on separate world map spaces, half of the world map would be populated.
	* Step 3a: If you want a square world map, find the square root of the number from Step 2. (e.g. ~6.3)
	* Step 3b: If you want a rectangular world map, find two numbers that when multiplied give you a number close to the number in Step 2. (e.g. 5 x 8)
	* Step 4a: If you followed Step 3a, then the two !register parameters will be the number from Step 3a. (e.g. !register 6 6 OR !register 7 7)
	* Step 4b: If you followed Step 3b, then the two !register parameters will be the two numbers from Step 3b. (e.g. !register 5 8 OR !register 8 5)

***How can I join a TRPG server that a streamer has created?

Simply type the !tjoin command to get started! Once you join, the game is completely automated. Future plans may incorporate features that players can choose to take part in.

***So I just type !tjoin and that's it?

Pretty much! HOWEVER, you must be active in chat to receive experience and items! If you do not type anything into chat for 5 minutes, you will be "logged out" and will not receive experience or items until you chat again. At that point, your AFK timer will reset. So as long as you're actively participating in chat, you will continue to gain experience and items!

***So I've joined the streamer's TRPG server, what now?

Well, there are a few commands that you can use to see where you are on the map, what items you have, what your level is, etc. You can see what those commands are by typing !trpgcommands in a stream with an existing TRPG server.

***I don't want my TRPG server anymore, how do I delete it?

I'm sorry that you want to delete the server, but you can go to TRPGbot's channel (http://www.twitch.tv/trpgbot) and use the !delete command. This will get rid of your TRPG server and will make the bot leave your stream.

***I don't want to play TRPG anymore, how do I delete my character?

I'm sorry to see you go! To delete your TRPG character, use the !quit command in the stream channel you want to stop playing TRPG in. NOTE: This only applies to the stream chat you are in; you will have to go to each stream channel that you play TRPG in and use the !quit command. I plan on implementing a command to remove you from all TRPG servers in the future.