This is the main repo for Werewolf for Telegram.
For language file updates, please submit the xml file on Telegram to the support chat and ask for assistance
- .NET Framework 4.5.2
- SQL Server (I am using 2014) / SQL Server 2016
- Windows Server
To set up werewolf on a private server, follow these steps:
-
Go to BotFather and create a new bot. Answer all of the questions it asks, and you will receive an API Token.
- On your server, open regedit, and go to
HKLM\SOFTWARE\
, create a new Key namedWerewolf
(HKLM - HKEY_LOCAL_MACHINE) - In the new key create a new string value named
ProductionAPI
. - Paste your API token here.
- On your server, open regedit, and go to
-
Grab the Werewolf Database.sql file from this repository
- Open the file in notepad, notepad++, whatever you use
- Double check the path at the top of the file - update it if you are using a different SQL version
- Run the sql script. This will create the
werewolf
database and all the tables / views / stored procs to go with it - If you already have some admins (including yourself), add their TelegramID's to the
dbo.Admin
table- In order to obtain your ID, headover to your bot in telegram and /Start. After that, toss a random text to it. Enter this URL to your browser (https://api.telegram.org/botYOURTELEGRAMBOTAPIKEY/getUpdates)
-
Now it's time to compile the source code
- In the Database project, you will need to create an Internal.settings file
- In order to create the Internal.settings file, right click on Database -> Add -> New Item
- Under Visual C# Items -> Settings File and name it as stated.
- Create a string setting named
DBConnectionString
, Application Scope, and set the Value to your SQL connection string for the database you created in step 2- Connection String should be this (change the values)
metadata=res:https://*/WerewolfModel.csdl|res:https://*/WerewolfModel.ssdl|res:https://*/WerewolfModel.msl;provider=System.Data.SqlClient;provider connection string="data source=SERVERADDRESS;initial catalog=werewolf;user id=USERNAME;password=PASSWORD;MultipleActiveResultSets=True;App=EntityFramework"
- If you are using Windows Authentication for your MSSQL Server, do take note that the password property will NO Longer be required. You're required to replace it with "Trusted_Connection=True;" instead.
- Connection String should be this (change the values)
- .gitignore has marked this file, so it won't be committed. However, when you create the setting, VS will copy it to the app.config - make sure to remove it if you plan on committing back to your fork
- In Visual Studio, open the solution. Make sure you are set to
RELEASE
build. You may want to go intoWerewolf_Control.Handlers.UpdateHandler.cs
and changeinternal static int Para = 129046388;
to match your id. Also, double check the settings.cs files in both Control and Node. - Build the solution
- In the Database project, you will need to create an Internal.settings file
-
Server directories
- Pick any directory for your root directory
Directory Contents root\Control
Control build root\Node 1
Node build root\Node <#>
Node updates can be added to a new Node folder. Running /replacenodes
in Telegram will tell the bot to automatically find the newest node (by build time) and run itroot\Logs
Node crash directory root\Languages
Language xml files - Note - Once all nodes are running the newest version (Node 2 directory), the next time you update nodes, you can put the new files in Node 1 and
/replacenodes
. Again, the bot will always take whichever node it finds that is the newest, as long as the directory hasNode
in the name. do not name any other directory in the root folder anything withNode
in it
-
Fire up the bot!
In order to use GIFs with the bot, you will need to "teach" the bot the new GIF IDs. From Telegram, run /learngif
, the bot will respond with GIF learning = true
. Now send it a GIF, and the bot will reply with an ID. Send the bot all the GIFs you need. In the Node project, go to Helpers > Settings.cs and find the GIF lists. You'll need to remove all of the existing IDs and put in the IDs you just got from the bot.
You can test these by running /dumpgifs
(preferrably in PM!). Make sure you check out DevCommands.cs, and look at the DumpGifs()
method - most of it is commented out. Uncomment what you need.