# User's Guide

{% hint style="info" %}
Discoin is meant to supplement user income on each bot. While certain actions, like investments, are encouraged by design, everything has a limit. To keep the economies running in reasonable order, please convert currencies reasonably and responsibly.
{% endhint %}

{% hint style="danger" %}
**The following actions are prohibited on Discoin. Violators will be punished at the discretion of each participating bot owners.**

* Converting any currency, illicitly acquired, within the Discoin system. By "illicitly acquired", actions include, but are not limited to, the following:
  * Automated actions, including macros, selfbotting, etc.;
  * Exploitations of bot mechanisms in any way not intended by bot owners;
  * Acquisitions of currency that are illicitly acquired by other users;
  * Other actions prohibited by terms and conditions imposed by other parties, including but not limited to participating bots and Discord.
* Perform automated transactions, through macros, selfbotting, etc.
* Exploit Discoin mechanisms in any way not intended by developers (e.g. pump & dump).
* Any action that can fall under "Unlawful Access of Computers".
  {% endhint %}

## How can I exchange currency?

### Procedure

1. Create a transaction from the origin bot. See the command list below.
2. Your transaction will be converted [at the rates effective at the moment](https://dash.discoin.zws.im/#/currencies). After a transaction, the rates will [adjust itself](https://github.com/Discoin/docs/tree/ec1c108468a8a89467b81d7b4cd55d8ffb2b9e12/reserve.md).
3. Within 5 minutes, the destination bot will receive your transaction. [Unless...?](#i-did-not-receive-my-payment)

### Commands List

* `<Currency>` means 3-letter currency codes listed [here](https://dash.discoin.zws.im/#/currencies). Exchange rates are listed there too.

| Bot Name                                                         | Command                                       | Note                                                                          |
| ---------------------------------------------------------------- | --------------------------------------------- | ----------------------------------------------------------------------------- |
| [BattleBanana#0764](https://battlebanana.xyz)                    | `!exchange <Amount> <Currency>`               | Max 500k BBT per transaction                                                  |
| [ChaosRPG#3409](https://top.gg/bot/603974948335124491)           | `?convert <Amount> <CURRENCY>`                | <p>Rates: <code>?rates</code>.<br>Must create account:<code>?start</code></p> |
| [Dice#6134](https://dice.js.org)                                 | `$$convert-oats <Amount> <Currency>`          | Rates: `$$discoin-rates`                                                      |
| [DTel#6675](https://dtel.austinhuang.me)                         | `>convert <Amount> <Currency>`                | Command without argument for rates                                            |
| [Elite Looter#8634](http://sjustein.com/html/elitelooter.html)   | `;exchange <Amount> <Currency>`               | Info: `;discoin`                                                              |
| [KekBot#2918](https://discordbots.org/bot/213151748855037953)    | `$shop` then react 3                          |                                                                               |
| [Lootcord#6294](https://lootcord.com)                            | `t-convert <Amount> <Currency>`               | Send/Receive limited to 1 million LCN per day                                 |
| [Murder Mystery Bot#7898](https://top.gg/bot/319204121393496064) | `mm!convert <Currency> <Amount>`              | Must create account:`mm!globalgames`                                          |
| [Nova#2243](https://top.gg/bot/460952742672990217)               | `n!convert <Currency> <Amount>`               |                                                                               |
| [Pinocchio#5540](https://pinocchiobot.xyz/)                      | `=exchange <Amount> <Currency>`               | Info: `=discoin`                                                              |
| [Restaurant#4079](https://top.gg/bot/648065060559781889)         | `r!dsc exchange <Currency> <Amount>`          | Rates: `r!dsc bots`                                                           |
| [TheelUtil#6258](https://dueutil.org)                            | `!exchange <Amount> <Currency> <TUT/TTC/TUP>` | Send/Receive limited to 10 transactions per 24h, sending limit exists         |

## Can I get/spend Discoins?

No. Discoin only exists during the transaction process and statistics: As a universal *unit* for calculating currency, it is only used for calculating exchange rates as well as currency reserves. The real world equivalent example would be [XDR](https://en.wikipedia.org/wiki/Special_drawing_rights).

## Can I have a transaction record?

<https://dash.discoin.zws.im/#/transactions>

## I did not receive my payment!

1. Check [the Transaction Record](https://dash.discoin.zws.im/). If it says the transaction isn't handled, the receiving bot hasn't processed it yet.
2. If it has been more than 5 minutes and the transaction still isn't handled, check if there are any restrictions in place, which are usually announced on this page as well as the support server. Still no avail? Contact the developer(s) of the receiving bot.

## Suggested uses of each currency

Here's a table on the earning and spending mechanisms of each bot.

| <p>Bot (Currency</p><p>Code)</p> | How to Earn (Except voting and daily)                                                                                                                                                                                                                | How to Spend                                                                                                   |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- |
| BattleBanana (BBT)               | Quests and `!blackjack`                                                                                                                                                                                                                              | `!shop`                                                                                                        |
| ChaosRPG (CPG)                   | `?battle`                                                                                                                                                                                                                                            | `?shop`                                                                                                        |
| Dice (OAT)                       | `$$dice-game` if won                                                                                                                                                                                                                                 | Gambling in `$$dice-game`                                                                                      |
| DTel (DTS)                       | `>lottery` if won                                                                                                                                                                                                                                    | [Renewing your DTel service](https://dtel.austinhuang.me/en/latest/Payment/), `>message` as well as `>lottery` |
| Elite Looter (ELT)               | `;open`ing crates gained by chatting, also `;games`                                                                                                                                                                                                  | `;shop`ing upgrades as well as `;games` to get more crates                                                     |
| KekBot (KEK)                     | `$lottery` if won, also `$game`                                                                                                                                                                                                                      | `$shop` profile decorations as well as`$lottery`                                                               |
| Gami (GBC)                       | `-beg`, `-steal`, `-work`                                                                                                                                                                                                                            | `-gamble`                                                                                                      |
| Lootcord (LCN)                   | `t-trivia`, `t-scramble`, `t-gamble`as well as by`t-sell` items/boxes and`t-use` items to loot other users, as well as [depositing in a clan to earn interest](https://github.com/blobfysh/Lootcord/wiki/Clans), see [FAQ](https://lootcord.com/faq) | `t-shop`, `t-bm`, `t-trade`                                                                                    |
| Murder Mystery Bot (MMB)         | Typing `mm!globalgames` daily                                                                                                                                                                                                                        | `mm!globalgames` => Shop                                                                                       |
| Nova (SPN)                       | `n!work`, as well as taking chances in `n!crime` and `n!rob`                                                                                                                                                                                         | `n!shop` for profile decorations                                                                               |
| Pinocchio (PIC)                  | Chat rewards, as well as coin drops if enabled                                                                                                                                                                                                       | `=waifu`, `=rr`, as well as `=paidroles` if set                                                                |
| Restaurant (RBC)                 | `r!work`, `r!slots`, `r!trivia`, `r!beg`, as well as receiving 50% from other users' `r!dine` orders in your restaurant                                                                                                                              | `r!buy` and `r!dine`                                                                                           |
| TheelUtil (TUT)                  | Quests, `!joinjob`                                                                                                                                                                                                                                   | `!shop` for upgrades                                                                                           |
| \~ (TTC)                         | Quests                                                                                                                                                                                                                                               | `!teamshop`                                                                                                    |
| \~ (TUP)                         | `!prestige`                                                                                                                                                                                                                                          | `!prestigeshop`                                                                                                |

## Credits (aka. "How can I support Discoin?")

Discoin is a cooperative project, combining efforts of many developers from diverse backgrounds across the globe.

* Discoin v3 is written and hosted by [Jonah Snider](https://jonah.pw) (Dice). Subdomain provided by [Zero Width Shortener](https://zws.im). Consider supporting him on [Patreon](https://www.patreon.com/pizzafox) or [Open Collective](https://opencollective.com/zws) to help paying for server cost!
* The concept, math, and non-technical documentation of Discoin is developed by [Austin Huang](https://austinhuang.me) (DTel), with help from [Mitchell Rademaker](https://github.com/mitchell3514) (DTel).
* Currency graphics (except Discoin logo) created by [Lucas Flicky](http://lucasflicky.com/) (Pollux). Discoin logo created by ImRock ([Welcomer](https://welcomer.gg)).
* [Ari Gami](https://github.com/dr-ari-gami), [DeveloperAnonymous](https://github.com/DeveloperAnonymous) (BattleBanana), [Godson](https://github.com/Godson777) (Kekbot) and [Theelgirl](https://github.com/Theelgirl) (TheelUtil) contributed to the [libraries](https://discoin.gitbook.io/docs/developers/guide#libraries).
* [Discoin is open source.](https://github.com/discoin/api-v3) If you cannot contribute financially, consider contributing your time reviewing the code!
* And of course, you can easily support Discoin by spreading the word to the world! Convince the developers of your favourite bot(s) to implement Discoin by showing this guide to them.
