How it works?

The server admin installs and configures the plugin and gives players a link to download the MC ADs Android application ( available on Google Play).

The player downloads and installs the application, enters a command on the server to get the item (this is configured by the admin).

The player receives a map with a qr code, which must be considered by the MC ADs application, watches an advertisement and within 30 seconds after watching an advertisement, he receives an automatic issue.



The plugin does not require permissions.

The plugin has two commands:

/ getad <item> - get the qr code to view ads and get the selected <item>

/ getadlst - get a list of available <item>



config.yml of the plugin is located in your server folder / plugins / adsdonate

the file is automatically generated and contains multiple lines.

strings with keys android and ios are needed to specify the advertising id (details below).

a string with the apple key - an example of creating an item name and specifying an auto-issue command.

The name item is a key, and the value of this key is an auto-issue command, which in turn is any available console command.

To insert a username into the issue command, use the $user variable, which is automatically replaced with the player's nickname.

There is NO need to restart the server after making changes to config.yml. The settings are applied immediately after saving the file.



Monetization is done using Unity ADs.

To start using the plugin - register for unity ads using the link - https://unity.com/products/unity-ads

After registering and confirming your mail, follow this link - https://dashboard.unity3d.com/monetization

In the Monetize block, click Explore, enter a project name and click create project.

The next page will open.

Under the Monetization label, click on the Enable Ads button. In the window that opens, under Mediation Partner, select I'm not using Mediation, only Unity Ads and press the ok button.

If the Ad Units page does not open, in the left side menu we find the Ad Units item and click on it.

On the right we find the Add Ad Unit button, click and in the window that opens, indicate:

in Ad Unit Name - rewardedVideo

in Platform - Android

in Ad Format - Rewarded

Click the create button, and then the done button.



Under the Game IDs: we see two advertising IDs. Copy the one with the android icon and paste it into the plugin's config.yml (android key)

Later, you will need to configure the withdrawal method (I recommend PayPal).