mirror of
https://github.com/Cog-Creators/Red-DiscordBot.git
synced 2025-11-06 03:08:55 -05:00
[Docs] Bank user guide (#4149)
* Getting started guide * Remove DigitalOcean referral link * Fix typos and mispells, thanks to @Flame442 * Remove cogs.red hyperlink until it is finished * Add towncrier entry * Add prolog.txt This is not necessary for this PR but all of the other cog guides rely on this file. The cog guides are individual branches based on this one, which is why I'm adding this file right now. * Add Bank cog guide * Add changelog entry * Bank guide * Nope get out from here potato * Remove reference to the payday command * reword + drop a character Co-authored-by: Toby Harradine <Tobotimus@users.noreply.github.com> Co-authored-by: palmtree5 <3577255+palmtree5@users.noreply.github.com>
This commit is contained in:
parent
e9017e8fe2
commit
c8526d42b4
186
docs/cog_guides/bank.rst
Normal file
186
docs/cog_guides/bank.rst
Normal file
@ -0,0 +1,186 @@
|
|||||||
|
.. _bank:
|
||||||
|
|
||||||
|
====
|
||||||
|
Bank
|
||||||
|
====
|
||||||
|
|
||||||
|
This is the cog guide for the bank cog. You will
|
||||||
|
find detailed docs about usage and commands.
|
||||||
|
|
||||||
|
``[p]`` is considered as your prefix.
|
||||||
|
|
||||||
|
.. note:: To use this cog, load it by typing this::
|
||||||
|
|
||||||
|
[p]load bank
|
||||||
|
|
||||||
|
.. _bank-usage:
|
||||||
|
|
||||||
|
-----
|
||||||
|
Usage
|
||||||
|
-----
|
||||||
|
|
||||||
|
This cog manages the bank. It won't be used often by
|
||||||
|
users but this is what makes any interaction with the
|
||||||
|
money possible.
|
||||||
|
|
||||||
|
You will be able to switch between a global and a server-
|
||||||
|
wide bank and choose the bank/currency name.
|
||||||
|
|
||||||
|
.. _bank-commands:
|
||||||
|
|
||||||
|
--------
|
||||||
|
Commands
|
||||||
|
--------
|
||||||
|
|
||||||
|
.. _bank-command-bankset:
|
||||||
|
|
||||||
|
^^^^^^^
|
||||||
|
bankset
|
||||||
|
^^^^^^^
|
||||||
|
|
||||||
|
.. note:: |guildowner-lock|
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Base command for configuring bank settings.
|
||||||
|
|
||||||
|
.. _bank-command-bankset-toggleglobal:
|
||||||
|
|
||||||
|
""""""""""""""""""""
|
||||||
|
bankset toggleglobal
|
||||||
|
""""""""""""""""""""
|
||||||
|
|
||||||
|
.. note:: |owner-lock|
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset toggleglobal [confirm=False]
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Makes the bank global instead of server-wide. If it
|
||||||
|
is already global, the command will switch it back
|
||||||
|
to the server-wide bank.
|
||||||
|
|
||||||
|
.. warning:: Using this command will reset **all** accounts.
|
||||||
|
|
||||||
|
**Arguments**
|
||||||
|
|
||||||
|
* ``[confirm=False]``: Put ``yes`` to confirm.
|
||||||
|
|
||||||
|
.. _bank-command-bankset-creditsname:
|
||||||
|
|
||||||
|
"""""""""""""""""""
|
||||||
|
bankset creditsname
|
||||||
|
"""""""""""""""""""
|
||||||
|
|
||||||
|
.. note:: |owner-lock| However, if the bank is server-wide, the
|
||||||
|
server owner or an administrator can use this command.
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset creditsname <name>
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Change the credits name of the bank. It is ``credits`` by default.
|
||||||
|
|
||||||
|
For example, if you switch it to ``dollars``, the payday
|
||||||
|
command will show this:
|
||||||
|
|
||||||
|
.. TODO reference the payday command
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
Here, take some dollars. Enjoy! (+120 dollars!)
|
||||||
|
|
||||||
|
You currently have 220 dollars.
|
||||||
|
|
||||||
|
**Arguments**
|
||||||
|
|
||||||
|
* ``<name>``: The new credits name.
|
||||||
|
|
||||||
|
.. _bank-command-bankset-bankname:
|
||||||
|
|
||||||
|
""""""""""""""""
|
||||||
|
bankset bankname
|
||||||
|
""""""""""""""""
|
||||||
|
|
||||||
|
.. note:: |owner-lock| However, if the bank is server-wide, the
|
||||||
|
server owner or an administrator can use this command.
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset bankname <name>
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Set bank's name.
|
||||||
|
|
||||||
|
**Arguments**
|
||||||
|
|
||||||
|
* ``<name>``: The new bank's name.
|
||||||
|
|
||||||
|
.. _bank-command-bankset-maxbal:
|
||||||
|
|
||||||
|
""""""""""""""
|
||||||
|
bankset maxbal
|
||||||
|
""""""""""""""
|
||||||
|
|
||||||
|
.. note:: |owner-lock| However, if the bank is server-wide, the
|
||||||
|
server owner or an administrator can use this command.
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset maxbal <amount>
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Defines the maximum amount of money a user can have with the bot.
|
||||||
|
|
||||||
|
If an user reaches this limit, he will be unable to gain more money.
|
||||||
|
|
||||||
|
**Arguments**
|
||||||
|
|
||||||
|
* ``<amount>``: The maximum amount of money for users.
|
||||||
|
|
||||||
|
.. _bank-command-bankset-showsettings:
|
||||||
|
|
||||||
|
""""""""""""""""""""
|
||||||
|
bankset showsettings
|
||||||
|
""""""""""""""""""""
|
||||||
|
|
||||||
|
.. note:: |owner-lock| However, if the bank is server-wide, the
|
||||||
|
server owner or an administrator can use this command.
|
||||||
|
|
||||||
|
**Syntax**
|
||||||
|
|
||||||
|
.. code-block:: none
|
||||||
|
|
||||||
|
[p]bankset showsettings
|
||||||
|
|
||||||
|
**Description**
|
||||||
|
|
||||||
|
Shows the current settings of your bank.
|
||||||
|
|
||||||
|
This will display the following information:
|
||||||
|
|
||||||
|
* Name of the bank
|
||||||
|
* Scope of the bank (global or per server)
|
||||||
|
* Currency name
|
||||||
|
* Default balance
|
||||||
|
* Maximum allowed balance
|
||||||
@ -31,6 +31,7 @@ Welcome to Red - Discord Bot's documentation!
|
|||||||
:caption: User guides:
|
:caption: User guides:
|
||||||
|
|
||||||
getting_started
|
getting_started
|
||||||
|
cog_guides/bank
|
||||||
red_core_data_statement
|
red_core_data_statement
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user