User Tools

Site Tools


cherrytelegram

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
cherrytelegram [2024/04/03 23:41] – onslaughtcherrytelegram [2024/05/06 22:00] – onslaught
Line 1: Line 1:
-<html><span style="color:red;font-size:150%;"> This addon requires Cherry core, a free store addon. get it <a href="https://wiki.mmominion.com/doku.php?id=cherrycore">here.</a></span></html>+<html><span style="color:red;font-size:150%;"> This addon requires Cherry core, a free store addon. get it <a href="https://wiki.mmominion.com/doku.php?id=cherrycore">Here</a></span></html> 
 + 
 +<html><span style="color:red;font-size:150%;"> Are you a developer and would like enable your addon to send messages to Cherry Telegram? <a href="https://wiki.mmominion.com/doku.php?id=cherrycore">View API Referance</a></span></html> 
  
  
-{{::cherry:telegram_addon_logo.png?150|}} 
  
  
Line 12: Line 14:
  
 ==== Features ==== ==== Features ====
-== Full chat log support ==+=== Full chat log support ===
   * Transfers all chat messages to telegram   * Transfers all chat messages to telegram
   * Filter between all messages or only messages from the categories you want to see   * Filter between all messages or only messages from the categories you want to see
Line 18: Line 20:
  
  
-== Full messaging support ==+=== Full messaging support ===
   * Use the same commands you do in-game to talk to whoever you want, whether they're in your free company, your party, linkshell, or any other chat mode in the game.   * Use the same commands you do in-game to talk to whoever you want, whether they're in your free company, your party, linkshell, or any other chat mode in the game.
   * Activate emotes remotely, make your character dance from your cell phone.   * Activate emotes remotely, make your character dance from your cell phone.
  
  
-== Leverage Telegrams Full Power ==+=== Leverage Telegrams Full Power ===
   * In-game links are automatically converted to website previews in the telegram client, bringing to life links shared by everyone around you.   * In-game links are automatically converted to website previews in the telegram client, bringing to life links shared by everyone around you.
   * Full support for custom Telegram response buttons.   * Full support for custom Telegram response buttons.
Line 29: Line 31:
  
  
-== Add-on Support ==+=== Add-on Support ===
   * Full support for other authors' add-ons to leverage the Telegram engine via registered mods. (Requires implementation by the add-ons author)   * Full support for other authors' add-ons to leverage the Telegram engine via registered mods. (Requires implementation by the add-ons author)
  
Line 37: Line 39:
  
  
-== 1. Create a Telegram Account ==+=== 1. Create a Telegram Account ===
 This add-on requires that you have a Telegram account. Telegram accounts are free and easy to sign up for. This add-on requires that you have a Telegram account. Telegram accounts are free and easy to sign up for.
  
  
-== 2. Create a Telegram Bot ==+=== 2. Create a Telegram Bot ===
  
 Follow this link to create your bot [[https://core.telegram.org/bots/features#creating-a-new-bot|Step-by-step Telegram bot creation]]. The username and description of the bot can be anything you choose and do not affect the operation of the add-on. The important part of this is to get the bot token. Keep the bot token safe as we will be using it in later steps. Follow this link to create your bot [[https://core.telegram.org/bots/features#creating-a-new-bot|Step-by-step Telegram bot creation]]. The username and description of the bot can be anything you choose and do not affect the operation of the add-on. The important part of this is to get the bot token. Keep the bot token safe as we will be using it in later steps.
Line 49: Line 51:
  
  
-== 2. Addon Installation / Initial Settings ==+=== 2. Addon Installation / Initial Settings ===
  
   - Install both this addon as well as [[https://wiki.mmominion.com/doku.php?id=cherrycore|Cherry Core]].   - Install both this addon as well as [[https://wiki.mmominion.com/doku.php?id=cherrycore|Cherry Core]].
Line 70: Line 72:
  
 {{:cherry:commandmenu.png?400|}} {{:cherry:commandmenu.png?400|}}
 +
 +==== Multi-Boxing ====
 +Cherry Telegram supports multi-boxing via multiple bots. Telegram does not allow multiple clients to control a single bot, so you will need a separate Telegram bot token setup for each instance of cherry telegram.
  
 ==== Mod Setup ====  ==== Mod Setup ==== 
Line 77: Line 82:
 Follow the instructions below to build your first mod. Follow the instructions below to build your first mod.
  
-Download {{ :cherry:cherry_modchattest.zip |}} And install it in Mmo Minion in the LuaMods folder. As long as you have Cherry Core installed as well as at least one communication client installed and  configured the sample code should work out of the box.+Download {{ :cherry:modchattest_-_5.6.24.zip |}} And install it in Mmo Minion in the LuaMods folder. As long as you have Cherry Core installed and at least one communication client installed and configured, the sample code should work out of the box.
  
-== CherryConnect API ==+=== CherryConnect API === 
 +Are you a developer and would like enable your addon to send messages to Cherry Telegram? View the API Reference [[cherrycore#Cherry Connect API Referance|Here]] 
  
-The Cherry Connect API is fairly simple and is accessed by the global variable  
  
-<code> Cherry Connect </code>+==== Troubleshooting ==== 
  
-Cherry Connect functions are explained below:+If you have any questions or need help, please visit the Cherry discord server: 
 +[[https://discord.gg/NTnZZAsjHj|Cherry Discord]]
  
 +===Debug Level===
 +By default only severe errors are posted to the console. If you're having issues and you can't figure them out you may want to raise the debug level in the settings. Doing this will result in many more messages being posted to the console and may lead to a solution to your problem.
  
-== CherryConnect.Register == 
  
-Usage: 
-Registers a mod through the Cherry Connect platform to enable an add-on to send/receive messages and commands with a user's installed communication clients. 
-<code> local CherryConnect.Register(author, cmdFunc, modName, desc)</code> 
  
-  * **author** - //required// 
-    * The name of the author of the mod  
-  * **cmdFunc** - //required// 
-    * The function that will be called anytime the user communicates with one of the clients 
-  * **modName** - //required// 
-    * This is the name of the mod and will also become the command that the user will use to communicate with the mod 
-  * **desc** - //required// 
-    * This helps the user understand what the purpose of the mod is and is visible in the mod section of each communication client 
  
-**returns** 
  
-On errors: 
-<code> 
-{ 
-   mode = p_mods.result_modes.error, 
-   err_code = error.error_code, 
-   message = message, 
-} 
-</code> 
  
-On success: 
-<code> 
-{ 
-   mode = "new_id", 
-   message = "MOD_ID", 
-} 
-</code> 
  
  
  
-//Notes// 
  
-The mod name cannot conflict with any other mod or command. Mods do not share a 1 to 1 relationship with an add-on, so a single add-on can register multiple mods. 
-**MOD_ID** Will be used in all the other API calls to identify which mod is making the call. The **MOD_ID** must be saved for as long as Cherry Core is not unloaded or until the mod is unregistered. Once the mod is unregistered you must re-register the mod to access a new **MOD_ID** 
  
- 
- 
- 
-== CherryConnect.Unregister == 
- 
-Usage: 
-<code> CherryConnect.Unregister(mod_id)</code> 
-Unregisters the mod from Cherry Connect 
- 
-  * **id** - //required// 
-    * The mod id that is being unregistered 
- 
-== CherryConnect.Message == 
- 
-Usage: 
-<code> CherryConnect.Message(mod_id, message)</code> 
- 
-== CherryConnect.MessageOptions == 
- 
-Usage: 
-<code> CherryConnect.MessageOptions(mod_id, options, message, callback_func)</code> 
- 
-== CherryConnect.MessageResponse == 
- 
-Usage: 
-<code> CherryConnect.MessageResponse(mod_id, response_id, message)</code> 
- 
- 
-== Results Class == 
- 
-<code>  
-result_modes = { 
-   new_id = "new_id", 
-   success = "success", 
-   error = "error", 
-   message = "message", 
-} 
-</code> 
- 
- 
- 
- 
- 
-==== Troubleshooting ====  
- 
-If you have any questions or need help, please visit the Cherry discord server: 
-[[https://discord.gg/NTnZZAsjHj|Cherry Discord]] 
cherrytelegram.txt · Last modified: 2024/05/07 17:43 by onslaught

Page Tools