Ruby-Cogs/bankdecay/README.md
2025-05-23 02:30:00 -04:00

62 lines
2.7 KiB
Markdown

Economy decay!<br/><br/>Periodically reduces users' red currency based on inactivity, encouraging engagement.<br/>Server admins can configure decay parameters, view settings, and manually trigger decay cycles.<br/>User activity is tracked via messages and reactions.
# [p]bankdecay
Setup economy credit decay for your server<br/>
- Usage: `[p]bankdecay`
- Restricted to: `ADMIN`
- Aliases: `bdecay`
- Checks: `server_only`
## [p]bankdecay toggle
Toggle the bank decay feature on or off.<br/>
- Usage: `[p]bankdecay toggle`
## [p]bankdecay setdays
Set the number of inactive days before decay starts.<br/>
- Usage: `[p]bankdecay setdays <days>`
## [p]bankdecay setpercent
Set the percentage of decay that occurs after the inactive period.<br/>
**Example**<br/>
If decay is 5%, then after the set days of inactivity they will lose 5% of their balance every day.<br/>
- Usage: `[p]bankdecay setpercent <percent>`
## [p]bankdecay resettotal
Reset the total amount decayed to zero.<br/>
- Usage: `[p]bankdecay resettotal`
## [p]bankdecay initialize
Initialize the server and add every member to the config.<br/>
**Arguments**<br/>
- as_expired: (t/f) if True, initialize users as already expired<br/>
- Usage: `[p]bankdecay initialize <as_expired>`
## [p]bankdecay getexpired
Get a list of users who are currently expired and how much they will lose if decayed<br/>
- Usage: `[p]bankdecay getexpired`
## [p]bankdecay ignorerole
Add/Remove a role from the ignore list<br/>
Users with an ignored role will not have their balance decay<br/>
- Usage: `[p]bankdecay ignorerole <role>`
## [p]bankdecay logchannel
Set the log channel, each time the decay cycle runs this will be updated<br/>
- Usage: `[p]bankdecay logchannel <channel>`
## [p]bankdecay cleanup
Remove users from the config that are no longer in the server or have no balance<br/>
- Usage: `[p]bankdecay cleanup <confirm>`
## [p]bankdecay seen
Check when a user was last active (if at all)<br/>
- Usage: `[p]bankdecay seen <user>`
## [p]bankdecay bulkaddpercent
Add a percentage to all member balances.<br/>
Accidentally decayed too many credits? Bulk add to every user's balance in the server based on a percentage of their current balance.<br/>
- Usage: `[p]bankdecay bulkaddpercent <percent> <confirm>`
## [p]bankdecay bulkrempercent
Remove a percentage from all member balances.<br/>
Accidentally refunded too many credits with bulkaddpercent? Bulk remove from every user's balance in the server based on a percentage of their current balance.<br/>
- Usage: `[p]bankdecay bulkrempercent <percent> <confirm>`
## [p]bankdecay decaynow
Run a decay cycle on this server right now<br/>
- Usage: `[p]bankdecay decaynow [force=False]`
## [p]bankdecay view
View Bank Decay Settings<br/>
- Usage: `[p]bankdecay view`