Plugins StreakRewards | Daily Streaked Rewards | 100% Configurable | NPCs | 1.8-1.19 2.2.7

Native Minecraft Version:Legacy (< 1.13)Tested Minecraft Versions:

• 1.8
• 1.9
• 1.10
• 1.11
• 1.12
• 1.13
• 1.14
• 1.15
• 1.16
• 1.17
• 1.18
• 1.19

Contributors:GaagjesCraft Network Team (GCNT)Languages Supported:All messages are changable in the configDonation Link:https://paypal.me/gcntdev
StreakRewards
Check this plugin out on MyGCNT!




StreakRewards is the best daily rewards plugin you could get on SpigotMC.
Every day, players can claim their daily rewards. Every day that the player claims the daily reward, without missing one day, their claim-streak will be increased. When the player forgets to claim their rewards one day, their streak will be reset and they will start from day one.
By default, the month-cycle is 30 days long. This is configurable in the config as well as all messages and options. This plugin is 100% configurable.
When the last day of the month has been reached, their streak will continue, but the day will be once again 1.

We created some fancy menu layouts for you to use for free. These are listed below. All menu items are configurable in the rewards.yml file.

• Fully GUI based
• 9 Menu shapes
• Create your own menu shape
• Open command
• Manage the streaks via a command
• MySQL and File storage support
• Custom Reward Actions
• Menu Items are configurable
• Menu Item Slots are configurable
• Default menu items to minimize the file size
• Countdown placeholders for the menu lores
• Empty slot items
• Menu size configurable
• Minimum online time to claim rewards
• Join reminders for claimable rewards
• NextReward item for when their next reward is on cooldown.
• Ability to change menu items when the target day is claimable, not-yet-claimable, next-reward, or already-claimed.
• NextReward item updated every second to display the right remaining time for the next reward.
• Boost Player Streaks
• Claim Date Types
• Base the next day on the player's previous reward claim date.
• Base the next day on the server host's time.
• Citizens integration for custom NPCs that open the menu when you click on them.
• PlaceholderAPI placeholders
• MVdWPlaceholderAPI placeholders
• LeaderHeads leaderboards
• Additions+ Integration
• Information stored per UUID; changing nickname won't affect the streak nor the last claim date
• Easy to set up
• Fast (Discord) Support
• 1.8 - 1.19 support
• More coming soon...

About "Minimum online time to claim rewards":
v1.4.3 adds this feature. If you enable it in the config, it will require players to be online at least x minutes (configurable in config) before they can claim their daily reward if available.




PlaceholderAPI:
Type: Soft Dependency
Description: Adds custom placeholders to PAPI. Allows placeholders to be used in the rewards.

MVdWPlaceholderAPI:
Type: Soft Dependency
Description: Adds custom placeholders to MVdWPAPI. Allows placeholders to be used in the rewards.

AdditionsPlus:
Type: Soft Dependency
Description: This overrides the actions of this plugin. You can then use their actions described on their Spigot page.

LeaderHeads:
Type: Soft Dependency
Description: Adds custom leaderboards to the plugin.



[command]:
Description: This performs a command as the player
Example: '[command]say I claimed a reward'

[console]:
Description: This performs a command as the console
Example: '[console]give %player% stick 1'

[message]:
Description: This sends a message to the player
Example: '[message]&b&lYou claimed a reward!'

For more actions, download the AdditionsPlus plugin. If you've installed that plugin, the reward actions of this plugin will be overridden by that plugin's actions. These actions are in both plugins. AdditionsPlus contains 38+ actions.
Do not use Additions (free version) to handle this. That will give errors.



streakrewards.menu.[name]: Use this permission to give a player access to a specific menu. The default permission is "streakrewards.menu.default".

Commands with the permission: streakrewards.player
/daily opens the claim menu.
/daily getstreak [player] get your/a player's streak.
/daily getday [player] get your/a player's day (1-30).

Commands with the permission: streakrewards.admin
/daily reload reloads the plugin.
/daily createnpc create a menu-opening NPC using Citizens.
/daily reset <player> resets the streak a player.
/daily setstreak <player> <streak> sets the streak of a player.
/daily boost <player> <boost> boosts a player by adding x days to their streak.

You can also use /streakrewards, /rewards and /sr instead of /daily.

All NPCs should be fully managed by Citizens. If you remove it using Citizens, it will also be removed from our configuration.



In each spoiler below is a different menu shape. You can set the shape by setting the property menu_shape in the config to the name of the spoiler (TREE, REVERSED_TREE, CIRCLE, CROWN, VICTORY, TORNADO, CHEST or SNAKE).

Spoiler: TREE
Spoiler: REVERSED_TREE
Spoiler: CIRCLE
Spoiler: VICTORY
Spoiler: CROWN
Spoiler: TORNADO
Spoiler: CHEST
Spoiler: SNAKE
Spoiler: CUSTOM


Code (Text):

menu_shape: CROWN # could be either TREE, REVERSED_TREE, CIRCLE, CROWN, VICTORY, TORNADO, CHEST, SNAKE or CUSTOM
menu_title: '&b&lStreakRewards'
menu_size: 54 #Must be either 9, 18, 27, 36, 45, 54
days: 30
claim_type: PER_DAY # could be either PER_DAY or PER_PLAYER
require_minimum_time_online: false # enable if you want players to be online at least x time in order to claim their reward
minimum_time_online: 10 # players must be at least 10 minutes online to claim their reward. (this option is in minutes)
close_menu_on_click: false # if you set this to true, the menu will be closed when the player clicks a non-empty item

mysql:
enable: false
host: localhost
port: 3306
database: streakrewards
username: myuser
password: mypass

already_claimed: '&cYou have already claimed this reward'
come_back_tomorrow: '&cCome back tomorrow to claim this reward'
cant_claim_yet: '&cYou can''t claim this reward yet'
streak: '&aYour current streak is: &b%streak%'
streak_other: '&b%player%&a''s current streak is: &b%streak%'
day: '&aYour current day is: &b%day%'
day_other: '&b%player%&a''s current day is: &b%day%'
invalid_player: '&cThat player is not online'
reload: '&aSuccessfully reloaded the plugin'
must_specify_integer: '&cYou must specify a valid integer'
set_streak: '&aYou set &b%player%&a''s streak to &b%streak%'
boost: '&aYou boosted &b%player% &awith &b%boost% &aextra days'
reset: '&aYou reset &b%player%&a''s streak'
npc_created: '&aYou successfully created a StreakRewards NPC. Use Citizens to customize and remove it.'
must_be_longer_online: '&cYou must be at least %min_time% minutes online in order to claim this reward.'

status_placeholder_claimable: '&a&lYou can claim your next reward!'
status_placeholder_cannotclaim: '&cNext reward in %hours%h %minutes%m %seconds%s'
no_permission: '&cYou are not allowed to claim daily rewards.'

enable_streak_reset_msg: true
streak_reset: '&cYou weren''t able to claim all daily rewards in a row, so your streak will be reset.'

enable_join_reminder: true
join_reminder:
- ' '
- ' '
- '&7You have unclaimed rewards!'
- '&7Use &b/daily &7to claim them.'
- ' '
- ' '

The days property is for setting a custom amount of days. But make sure to only change this when having the shape to CUSTOM as all pre-made shapes are made for 30 days. You can still use a pre-made shape when having a different number set than 30, but shapes may not be fully displayed. If you set it to 30+ and you use a shape, it will most likely give errors.



Each day in the menu can have its own item. Each day has an unclaimed, claimed, and canClaim item that is all configurable.
To edit the items and rewards go to the rewards.yml file inside the plugin folder.

Version 1.4.3 adds default items. So if you are using the latest version, you don't need to specify the unclaimed, claimed and canClaim items for each day individually. Just customize the default items.
If you have default items and daily-customized ones, the items in the day configuration will be set as the slot item. It will override the default item.

Version 1.4.3 also adds empty slot items. This pretty much means that, if you add the 'empty' item to the 'default_items' section in the rewards.yml file, it will fill up all empty slots on the menu.
So if you don't want the empty slots to be filled, just remove it from the config.

Add this to your configuration:
Spoiler: 1.8 - 1.12
Spoiler: 1.13+

The unclaimed items are displayed when the target day is not yet claimed and not possible to be claimed yet.
The claimed items are displayed when the target day has already been claimed.
The canClaim item is displayed if the current day can be claimed.
The nextReward item is displayed as the next reward when it's not yet claimable but will be soon.

Spoiler: old versions

Then when you set all (un)claimed and claimable item options, you can set the rewards for that day. You can do this by adding the property actions to the section of that day (in this case day-5).
The actions are described somewhere on this page. If you have AdditionsPlus installed, you can use their actions as well.
(Make sure all hyphens are under the word 'actions')
Code (Text):
day-5:
actions:
- '[console]give %player% stick 5'
- '[message]&a&lYou successfully claimed the 5th streak reward and received 5 sticks!'
- '[player]say I received 5 sticks '
When you have your shape set to CUSTOM, you will need to add the slot variable to the configuration as well. This will be the slot on the menu where the item will be placed. Note that slots are starting from 0.
Code (Text):
day-5:
slot: 4
Click the spoiler below to see it all together.
Spoiler: full configuration example (v1.4.3+)
Spoiler: full configuration (v1.4.3 and below)


Spoiler: menu
Spoiler: leaderheads


Placeholders (PlaceholderAPI and MVdWPlaceholderAPI)
For PlaceholderAPI, put the strong (bold) marked parts between %. And for MVdWPlaceholderAPI, put them between { }.
%identifier% and {identifier}.

streakrewards_streak returns the streak of a player
streakrewards_day returns the day of a player
streakrewards_remaining returns the remaining time until the next reward can be claimed. This is in the format '10d 10m 10s'
streakrewards_remaining_hours returns the remaining time in hours until the next reward.
streakrewards_remaining_minutes returns the remaining amount in minutes until the next reward.
streakrewards_remaining_seconds returns the remaining time in seconds until the next reward.
streakrewards_status switches between the left time until the next reward, and a message telling you that you can claim your reward. This is configurable in the config.

You can add "_[menu]" at the end of every placeholder to select a specific menu instead of the default one.

Leaderheads
sr-day returns the day's leaderboard (0-30)
sr-streak returns the streak's leaderboard

• Menu items not stopping with counting, so per day items and rewards.
• Multiple menus (e.g. normal, vip, mvp etc.)
• Advent-mode (based on actual dates)
• More...

Have some ideas that are perfect for this plugin? Drop it in the Discussion section or join our Discord.
Do the same if you have any issues with the plugin.
Do not drop a bad review with an issue that you haven't reported before. We are often fixing all reported issues within 24 hours (snapshot versions are available on MyGCNT. Official releases on spigot will be released at least 24 hours after the snapshot.)