# Feature Update: Invoice Note
* When you send an invoice, you can optionally attach a note to it for the payer (which can be used as purpose of the invoice)

## How to use?
* Re-activate the invoice plugin in `/admin-plugins`
* use `/invoice`

## Logged
The invoice note will also be logged in case you enabled logging in your server

## Persists
The invoice note will remain after the invoice got paid, for the history.

# Feature Update: Invoice Note

a new update to allow your users to claim income based on their roles

How to use?
Activate the plugin with name 'Income Roles' in /admin-plugins
Configure the roles and the income in /admin-settingsyour users can claim the income with /claim-income
Access Roles
You can decide which role or roles can claim the income

Access Channels
You can decide which channel the user must use /claim-income in to claim his income.

Claim Interval
You can decide how often the user can claim that income

Claim Amount & Account
The admin can decide how much and where to deposit the money in the user account like (500 Bank) or decide to give him a random amount like (500-1000 Bank).


Feedback
After use, i believe this feature can be improved a lot, but needs your feedback about potential improvement to suit your RP.

New Feature: Income Roles Plugin

a new update to allow your users to submit in applications designed by you, like staff application, apply for order and whatever

How to use?
Activate the plugin with name 'Custom Applications' in /admin-plugins
Configure the applications in /admin-settingsyour users can apply in the configured applications with /apply
Access Roles
You can decide which role or roles can apply in the application

Submission channel
You can decide which channel to forward the submission to. 

New Feature: Custom Applications Plugin

a new update to allow the user to provide his own input and it get printed in the response message
How to use?
admin can use configure any /action with /admin-actions and select Set Custom Inputs, then write the questions that will be asked to the user when he uses /action
then in /admin-actions select Set Response Message and put the placeholder anywhere in the message and it will get replaced later on when user answers it.

Update Feature: Custom Input for /action

* a new command added `/sell-item` where user can sell items within his main inventory
* updated `/admin-edit item` and added new optional inputs:
  * `sellable`: to determine if item can be sold or not
  * `sell-price`: to determine the sell price of that item
  * `sell-account`: to determine the balance account the system will set the balance in

### Existing Items
All items by default are not sellable, you can modify the item to be sellable through `/admin-edit item`

### Balance Account
By default, the reward balance of sale will be deposited in the main account of the user, but you can modify that in `/admin-edit item` and specify the `sell-account`. if the user does not have that account, the system will reject his sell attempt.

New Feature: Sell Item to the system

* admin command `/admin-log` was redesigned to allow you to link to specific channel
* the logs content were redesigned to include the channel and the message relevant to the log

## Webhook
* For a newly linked channel after this post, the bot will use webhook to send the logs to that channel
* You don't need to worry about the webhook creation and use, the bot will automatically do it in your behalf when you link
* Previously linked log channels, will still work for now, but this might be depreciated in the future, So i recommend re-link your log channel.

Update Feature: Bot Logs Redesign

* The admin can view the latest jail/cuff/unjail/uncuff of a user through /admin-check, detailing the time and the user who performed the action.

## How to see the Jail/Cuff History of a user?
* Assuming that CAD plugin is enabled, Use `/admin-check`
* You will find a new button `Cuff/Jail History`, Click on it.

## CAD's plugin
This feature is only visible when CAD is activated, you can activate the CAD through `/admin-plugins`.



Update Feature: CAD's Jail/Cuff History Of User

 * The admin can set an owner of a job, so the payments comes from that job's owner and not from the system
* The admin can set which balance account to use to reward the user (and deduct from job owner)
* If the job owner does not have sufficient balance, his balance will go to negative
* The admin can set maximum clockin duration, which means the user will be considered clocked out after that duration and will not be rewarded after that duration.
* `/job` has be redesigned to allow user to select from a menu, the jobs that he can use.

## Setting Job's owner
The admin can set a job owner by following these steps:
* use `/admin-create job` or `/admin-edit job` (for existing job)
* specify the `owner` optional input

## Setting Job's maximum clockin duration
The same steps as **Settings Job's owner**, but fill in the `max-duration` input instead, setting it to 0, will be considered no limit.

## Setting Job's Payment Balance Account
The same steps as **Settings Job's owner**, but fill in the `account` input instead.
By default it will be set to the primary account (CASH)

Update Feature: Job's Owner, Maximum Clockin Duration, /job redesign

 * The command `/recipe` has been redesigned, to allow user to select a recipe from a menu
* The default description of the recipe can be changed to a custom one set by the admin through `/admin-edit recipe` or `/admin-create recipe`.

## Recipe's Description
* By default, the recipe takes the item's description unless you set a custom one with `/admin-edit recipe` or `/admin-create recipe`

Update Feature: Recipe Redesign and Recipe's Description


 * The command `/action` has been redesigned, to allow user to select from a menu when using `/action`
* A description can be set for action by the admin, to explain the use of it to your users

## For users
* Use `/action`

## For admins
* Set the description of each action inside `/admin-actions`

Update Feature: Action redesign and Action's Description

User will be able to view the item information inside their inventory with /item-info

Listed Information
The following can be viewed by the user:

    Item description (that was set by admin)
    Item Tradable Status
    Item Usable Status
    Item Usable Cooldown Information


Limit

    The user will be able to view items in their own inventories only.


The command

    The user can use /item-info

New Feature: Item inspection

Shop owner / Admin can set 3 managers for the shop, a manager can be a role or user where he gain access to /manage-shop to help you managing the shop in general.

How to set managers?

    For shop's owner, use /manage-shop and click Set Shop Managers
    For Admins, you can use /admin-edit shop for existing shop or use /admin-create shop for new shops. then fill out the manager options


What is the difference between Owner and Managers?

    The owner must be a user, to receive the purchase payments in his account
    The managers can be role or user, but does not receive any payments
    The owner has the permissions to set the managers of their own shop.



Update Feature: Shop Managers

Now admin can send a random messages when user do /action

How to make an action send random message?

    Go to /admin-actions
    Select your action or create new one
    Select Set Random Message



Update Feature: Random Message in Actions

In the past, you can set a cool down for a period of time after single use of the action, but now the admin can control after how many uses the cooldown start, by default it is 1.

Example
Let is say, you want to set a cooldown for an action called Farm, but you want to make it that after user farm 3 times, it goes to cooldown.


How to use the changes

    In /admin-actions
    Select the action, then select Set Cooldown

Update Feature: Action Cooldown After certain uses

2 more options are added to actions, where you can decide:

    To make a requirement of balance that user must have to use the action
    Roll a number and send a custom message with it, like: You rolled {num}


How to use the changes

    In /admin-actions

Update Feature: Required Balance and Random Number for /action

A few commands were modified to accept multiple items selection instead of one by adding , (comma) between each item

Changed Commands

    /send item
    /store
    /retrieve
    /admin-give

Update Feature: Sending Multiple Items

the body search was a great feature to view items, but it lacked 2 points:

    if the inventory is too big, it will only show you the first few items
    you cannot do to take the items except of using /admin-give


with this update, the body search was redesigned to enable the authorized users to view the items no matter how big the inventory is, through pages.
In addition to that, you can also seize item in the same time if you would like to.

How to use it?

    Make sure CAD plugin is activated in /admin-plugins
    use /body-search and select the inventory


Searchable Inventories

    The admin can control which inventory is searchable in /admin-settings > Select CAD


Where seized items go?

    It get transferred to the person who used /body-search


Log

    Any successful item seizure will be logged

Feature Update: Body Search & Item Seizure

This update allows the admin to set a cooldown on the recipe creation to limit how often a user use it, as well as decide how long it takes to create the recipe and be placed in the user inventory.

How to use it?

    Use /admin-edit recipe and Select Change Cooldown or Change Duration


How about existing recipes?

    By default, it will be set with no cooldown and duration 0 (which means it instantly get placed in the user inventory)


Log

    Any successful recipe use will be logged

New Feature: Recipe Cooldown & Duration

Allows your users to trade with each others, similar to /send but it allow the bot be the middleman for a fair trade of items and balance, to make sure that both parties agrees before it finalize the transaction


How to use?

    Use /trade to start the trade process with another user


Tradable

    The command obeys the item tradable property, which means you can forbid the users from trading a certain item if you make the tradable option of that item to false in /admin-create item or /admin-edit item


Log

    Any successful trade will be logged, so the admin of RP can be aware of any movements of items and funds

New Feature: Trade

A new plugin that allows your users to buy and sell items in a public marketplace, the user can list an item for a price, the other users can choose to buy or not with `/marketplace`

## How to activate?
* You can activate this plugin in your RP by using `/admin-plugins` and Select `Marketplace` then Click `Activate`

## Who can sell?
* By default, anyone can sell item but the admin can adjust the user/roles that can sell with `/admin-settings`

## Sales Fee
* By default, the system takes 10% of each sale as fee, but the admin can adjust that percentage in `/admin-settings`

New Feature: Marketplace

CAD plugin has now additional 2 commands, where the authorized users can jail/unjail a user for a period of time, after that time expires, the user will be automatically unjailed.

## How to activate?
It is part of CAD plugin, you can find it in `/admin-plugins`
> For already activated CAD plugin, re-activate CAD plugin to get the new commands installed

## How to use?
* For jailing user, use `/jail` and provide the jail time in minutes
* to unjail user before the expire time, you can use `/unjail`

New Feature: Jail a user for CAD plugin

This project has leaderboards highlighting the top players within either the server or globally

Leaderboards

Allows the user to use separate personas in parallel during sessions

Persona Support

This bot offers extra features or perks that can be unlocked through optional payments or subscriptions.

Paid Features Available

Whether the current project contains any paid features, is paid only, or is 100% free to use.

This project is free to use and contains no paywalls for core functionality.

Has Paid Features

Helps you create your own RP world for your immersion!

# Features
## Multiple Languages Supported
![](https://i.imgur.com/TzOYguU.png)

## Create your item that users can get
Make your own items\
![](https://i.imgur.com/vnK9BGQ.png)

## Giving item
Don't be stingy, and be magnanimous \
![](https://i.imgur.com/n9OaIjS.png)

## AI Assistant
Equipped with AI to give your users a personal agent to interact with and provide information. \
![](https://i.imgur.com/YaxJxX6.png)

## Decide the currency
Bored of the default currency? Make your own one!\
![](https://i.imgur.com/ICVcIsc.png)

## Feeling rich?
Send your money to other user!\
![](https://i.imgur.com/5cj4Mo6.png) 

## Rename the balance accounts
The accounts names doesn't suit your RP? CHANGE IT!\
![](https://i.imgur.com/nKlYZqk.png)

## Let's go shopping!
It will be so boring without shops for user to shop in\
![](https://i.imgur.com/FsP4sG9.png)

## Life without job?!!
Of course not, people need to make a living from respectable occupations!\
![](https://i.imgur.com/gvgzZdd.png)

## Do some actions
You can also make a cool actions for your users to enjoy!\
![](https://i.imgur.com/YPiOlst.png)

## Make use of items!
Items aren't just decoration, they must be used!\
![](https://i.imgur.com/2XE61j5.png)

![](https://i.imgur.com/ovJOiE7.png)

## Time for Recipes!!
Make a recipes, so users create items with it!
![](https://i.imgur.com/bup8Z0F.png)

## Change the bot messages
Imagine if you are able to change the bot messages itself with `/admin-messages`
![](https://i.imgur.com/T6MOn55.png)

## Extend Bot Functionality!!
There's also plugin system which allows you to add more features like CAD System, Payment Invoice, User profile, Rob a user, Marketplace.
![](https://i.imgur.com/WwaatVl.png)
![](https://i.imgur.com/vhyrrSG.png)
![](https://i.imgur.com/DruwUBy.png)
## Missing a feature?
No worries, join this server and let me know!\
[Click here](https://discord.gg/HjbZwUPqHv)

# Commands
## User Commands
/911: Call 911 and file a report!
/action: Perform an action
/ai: Beta, ask AI anything in your RP, such as balance, inventories and so on.
/balance: Show your balance
/deposit: Deposit currency to your secondary account (like a bank)
/get-started: Your friendly guide as a first step to enjoying the role playing
/help: See my guides and commands list
/inv: Shows your inventory content
/item-info: Show information about an item in your inventory.
/job: Helps you earn balance by clocking in and out from jobs
/leaderboard: Show the server's top users
/manage-shop: Manage your shops
/server-status: Check the server status
/premium: Get premium and gain more perks across servers
/recipe: Create an item from a recipe
/retrieve: Retrieve an item from a secondary inventory to your main inventory
/send: Send balance or items to another user
/shop: Buy an item from a shop inside this server
/store: Store an item from your main inventory to a secondary one
/trade: Trade items, balances with another user.
/use: Use an item from your inventory
/vote: Support the bot by upvoting it and get unique benefits.
/withdraw: Withdraw balance from your secondary account to your main account
/body-search: Body search a user's inventory and seize items
/cuff: Cuff a user
/jail: Jail a user
/uncuff: Uncuff a user
/unjail: Unjail a user
/invoice: Send a payment invoice to a user
/marketplace: Sell and buy items from the marketplace
/profile: View your profile
/rob: Rob a user

## Admin Commands
/admin-accounts: Change this server accounts name and emoji
/admin-actions: Manage action settings
/admin-add: admin command to add shop items/categories
/admin-check: check user data
/admin-create: Creates features like item, account, shop, job, recipe.
/admin-currency: Change this server currency name and emoji
/admin-edit: admin command to edit features such as item, shop, job,..
/admin-give: Give/Take currency, items... out of thin air
/admin-item-list: show the server created items list
/admin-lock: Lock or unlock the commands for users
/admin-log: manage log channel
/admin-mass-action: perform mass action on all users in your server
/admin-messages: edit the bot messages
/admin-onuse: change on use behavior of items
/admin-plugins: Manage the server plugins
/admin-delete: delete an item, shop...
/admin-reset: general command to reset users like inventory, balance
/admin-settings: Allow you edit the settings of features
/admin-tier: admin command to check the tier
/admin-language: Change your server bot language!

## Owner Commands
/admin-restore: Helps you restore your server data to the past (in case you ruined up something).
/admin-trusted: manage trusted users to be able to use admin commands
# Links
[Support Server](https://discord.gg/sT3bFgFa8r)\
[Bot Invitation](https://discord.com/api/oauth2/authorize?client_id=989598165399400518&permissions=412585609296&scope=applications.commands%20bot)

RP Sentry

Helps you create your own RP world, actions, usable items, inventories,AI, shops, jobs, gta, CAD...

Voting for RP Sentry

Do you want to support us?