About:
MultiPass is a complex, but simple to understand BattlePass plugin, that allows you to tune and tweak the BattlePasses to cater to your playerbase. All of the challenge events have been fine-tuned to create the best server performance and avoid unnecessary hiccups. A deep and explanatory wiki guides you through the extensive plugin. This is also a continuous project, so stuff will be added if this takes off.
Features:
- 19 unique and customizable challenges.
- Customizable UI and commands.
- Individual custom permissions and properties for the BattlePasses, with as many tiers as you want!
- Tweakable performance, based on how often runnables should be updated.
- Navigable UI.
- ChatColor.
- Use any of your server commands as rewards, with helpful syntax.
- Daily and weekly rotations, as well as forced rotations and reload, to be able to change and update the configs at server runtime.
- Block Break Challenge
- Block Place Challenge
- Level Gain Challenge
- Enchantment Challenge
- Play Time Challenge
- Mob Kill Challenge
- Player Kill Challenge
- Flower Pot Challenge
- Fishing Challenge
- Smelting Challenge
- Crafting Challenge
- Travel Challenge
- Player Death Challenge
- Player Damage Challenge
- Consume Challenge
- Shearing Challenge
- Milking Challenge
- Chat Challenge
- Votifier Challenge (only usable with Votifier)
Installation:
Just drag and drop the .jar into the plugins folder, however, the challenges and BattlePasses will have to be configured to gain any function.
Adding your own challenges to the mix:
If you are buying, or have bought, the MultiPass resource, but want to add your own challenges deriving from the unique events from your server (much like the Votifier Challenge), there are two possible challenge types, that can be purchased on top of the resource.
There's the "simple challenge". For a fee of 0.5$ per event, I can add your event as a challenge. The simple challenge has no specific variables (fx. items, conditions) and will not have the ability to be only targetting specific items, however, stuff like player checks and null checks are a possibility if they bear no more complexity than that. This is where the "advanced challenge" comes in. This would be similar to the challenges such as "Player Kill Challenge", "Level Up Challenge" and "Flower Pot Challenge".
For a fee of 1$ per event, I can make your event into a challenge and add specific conditions (such as integrating into a KoTH plugin and only giving progress when the user is wearing certain armor). I will NOT do the event for you, stuff like player info, world info, and generally the info you'd like me to know HAS to be accessible from the event. I will only add incredibly simple code, such as converting entity to player and code that aren't consistent. Please specify this in the message if you recognize this in your event. This compares to challenges such as "Block Break Challenge", "Enchantment Challenge" and "Fishing Challenge".
To summarize:
Simple Challenge : 0.5$ per. challenge
Advanced Challenge : 1$ per. challenge
We might also be able to arrange a bundle discount if you are buying a lot of challenges.
Shoot me a message with something like: "Hey! I need to get x amount of [simple/advanced] made for my plugin(s). My transaction ID on PayPal is [transaction-id]."
You pay me @ PayPal F&F and I will send a unique .jar containing your challenge. You HAVE to provide an eligible transaction ID from buying the resource.
PS. If you don't know whether or not your challenge idea would be classified as a simple or an advanced challenge, then don't be afraid to ask! But please understand that I'm not here to make or fix your plugin, merely integrate it, so if something goes wrong
Interested? Add me on Discord (skype4lifefuccdiscord#9410).
Configuration:
These are the config files, which should give you an impression of all of the customizable properties, but their context is more thoroughly explained in the wiki at https://github.com/vict2292/MultiPass/wiki.
Code:
runnable-interval: 12000
gui-settings:
daily-challenge:
button-name: Daily Challenges
button-lore: $daily-challenges$.
button-material: BOOK
enchanted: false
weekly-challenge:
button-name: Weekly Challenges
button-lore: $weekly-challenges$.
button-material: BOOK
enchanted: false
tiers:
button-name: Tiers
button-lore:
- View the different BattlePasses and your progression.
button-material: GOLD_NUGGET
enchanted: true
backward-button:
name: Backward
lore:
- Go one page to the left.
gui-mat: ARROW
forward-button:
name: Forward
lore:
- Go one page to the right.
gui-mat: ARROW
titles:
fade-in-time: 0.5
fade-out-time: 0.5
showTime: 3.0
rotation:
daily:
rotations-minute: 0
rotation-hour: 20
weekly:
rotation-minute: 0
rotation-hour: 20
rotation-day: SUNDAY
tier-complete-message-type: TITLE
challenge-complete-message-type: CHAT
commands:
admin:
bpadd:
message: Added $add-progress$ to $player$!
help: Command not formatted correctly. Should be either '/bpadd <progress> <pass-id>' for you as target, or '/bpadd <player> <progress> <pass-id>' for target player. ('/bpcheck' to view all BattlePasses and their respective IDs).
battle-pass-id-not-found: The ID provided does not refer to any BattlePasses.
target-receive-message: $player$ has sent you $add-progress$ progression towards the $pass$!
bpreload:
message: Reloading the configs
bppoof:
message: Poof!
user:
bp:
message:
bpcheck:
message: The active BattlePasses and their retrospective IDs are:
bpopen:
message:
help: Command not formatted correctly. Should be '/bpcheck <pass-id>' ('/bpcheck' to view all BattlePasses and their respective IDs)
missing-permission: $player$ does not own $pass$ with the ID $pass-id.
battle-pass-id-not-found: The ID provided does not refer to any BattlePasses.
Code:
max-battlepasses: 9.0
active-battlepasses:
0:
battlepass-settings:
name: "&2Free BattlePass"
description:
- "&2Tier $tier$ / 50
missing-perm-description:
- "&2You do not own this BattlePass"
- "&2You can buy it at www.ourstore.com"
missing-perm-gui-mat: BARRIER
permission:
enchanted: false
gui-mat: DIRT
tiers-amount: 50.0
tier-gui-slots: 36.0
recompile-tiers: true
recompile-settings:
default-tiercap: 200.0
default-name: "&2$tier$."
default-description:
- "&2Gives you nothing"
default-gui-mat: GOLD_BLOCK
default-locked-mat: BARRIER
default-reward: 'bppoof $player$'
default-reward-message: "&2You completed level $tier$ in the $pass$!"
tiers:
8:
battlepass-settings:
name: "&2Premium BattlePass"
description:
- "&2Tier $tier$ / 50
missing-perm-description:
- "&2You do not own this BattlePass"
- "&2You can buy it at www.ourstore.com"
missing-perm-gui-mat: BARRIER
permission: bp.premium
enchanted: false
gui-mat: STONE
tiers-amount: 50.0
tier-gui-slots: 36.0
recompile-tiers: true
recompile-settings:
default-tiercap: 200.0
default-name: "&2$tier$."
default-description:
- "&2Gives you nothing"
default-gui-mat: GOLD_BLOCK
default-locked-mat: BARRIER
default-reward: 'bppoof $player$'
default-reward-message: "&2You completed level $tier$ in the $pass$!"
tiers:
battlepass-template:
battlepass-settings:
name: BattlePass
description:
missing-perm-description:
- "&2You do not own this BattlePass"
- "&2You can buy it at www.ourstore.com"
missing-perm-gui-mat: BARRIER
permission:
enchanted: false
gui-mat: STONE
tiers-amount: 50.0
tier-gui-slots: 36.0
recompile-tiers: true
recompile-settings:
default-tiercap: 200.0
default-name: $tier$.
default-description:
- "&2Gives you nothing"
default-gui-mat: GOLD_BLOCK
default-locked-mat: BARRIER
default-reward: 'bbpoof $player$'
default-reward-message: "&2You completed level $tier$ in the $pass$!"
tiers:
Code:
daily:
max-challenges: 9
challenge-gui-slots: 9
slots:
0: {}
1: {}
2: {}
3: {}
4: {}
5: {}
6: {}
7: {}
8: {}
weekly:
max-challenges: 27
challenge-gui-slots: 27
slots:
0: {}
1: {}
2: {}
3: {}
4: {}
5: {}
6: {}
7: {}
8: {}
9: {}
10: {}
11: {}
12: {}
13: {}
14: {}
15: {}
16: {}
17: {}
18: {}
19: {}
20: {}
21: {}
22: {}
23: {}
24: {}
25: {}
26: {}
all-challenges:
challenge$block-break-challenge:
name: "&2Example"
description:
- "&2This is a template for a blockbreakchallenge. %player% has %progress% / %target%."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: STONE_PICKAXE
repeatable: false
specific-items:
- AIR
challenge$block-place-challenge:
name: "&2Example"
description:
- "&2This is a template for a block-place-challenge. %player% has %progress% / %target%."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: STONE
repeatable: false
specific-items:
- AIR
challenge$level-gain-challenge:
name: "&2Example"
description:
- "&2This is a template for a level-gain-challenge. %player% has %progress% / %target%."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: EXP_BOTTLE
repeatable: false
challenge$enchanment-challenge:
name: "&2Example"
description:
- "&2This is a template for the enchanment-challenge. %player% has %progress% / %target%."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: ENCHANTMENT_TABLE
repeatable: false
specific-items:
- AIR
challenge$play-time-challenge:
name: "&2Example"
description:
- "&2This is a template for the play-time-challenge. %player% has %progress% / %target% minutes."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: WATCH
repeatable: false
challenge$mob-kill-challenge:
name: "&2Example"
description:
- "&2This is a template for the mob-kill-challenge. %player% has %progress% / %target% kills."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: SULPHUR
repeatable: false
specific-mobs:
- AIR
challenge$player-kill-challenge:
name: "&2Example"
description:
- "&2This is a template for the player-kill-challenge. %player% has %progress% / %target% kills."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: DIAMOND_SWORD
repeatable: false
challenge$flower-pot-challenge:
name: "&2Example"
description:
- "&2This is a template for the flower-pot-challenge. %player% has potted %progress% / %target% flowers."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: RED_ROSE
repeatable: false
challenge$fishing-challenge:
name: "&2Example"
description:
- "&2This is a template for the fishing-challenge. %player% has caught %progress% / %target% fish."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: RAW_FISH
repeatable: false
specific-items:
- AIR
challenge$smelting-challenge:
name: "&2Example"
description:
- "&2This is a template for the smelting-challenge. %player% has smelted %progress% / %target% items."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: IRON_INGOT
repeatable: false
specific-items:
- AIR
challenge$crafting-challenge:
name: "&2Example"
description:
- "&2This is a template for the crafting-challenge. %player% has crafted %progress% / %target% items."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: WORKBENCH
repeatable: false
specific-items:
- AIR
challenge$travel-challenge:
name: "&2Example"
description:
- "&2This is a template for the travel-challenge. %player% has walked %progress% / %target% blocks."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: LEATHER_BOOTS
repeatable: false
movement-statistics:
- WALK_ONE_CM
challenge$player-death-challenge:
name: "&2Example"
description:
- "&2This is a template for the player-death-challenge. %player% has died %progress% / %target% times."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: SKULL_ITEM
repeatable: false
challenge$player-damage-challenge:
name: "&2Example"
description:
- "&2This is a template for the player-damage-challenge. %player% has taken %progress% / %target% points of damage."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: ROTTEN_FLESH
repeatable: false
capped: true
damage-causes:
- AIR
challenge$consume-challenge:
name: "&2Example"
description:
- "&2This is a template for a consume-challenge. %player% has eaten %progress% / %target%."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: GRILLED_PORK
repeatable: false
specific-items:
- AIR
challenge$chat-challenge:
name: "&2Example"
description:
- "&2This is a template for the chat-challenge. %player% has chatted %progress% / %target% times."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: PAPER
repeatable: false
challenge$milking-challenge:
name: "&2Example"
description:
- "&2This is a template for the milking-challenge. %player% has milked %progress% / %target% cows."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: MILK_BUCKET
repeatable: false
challenge$shearing-challenge:
name: "&2Example"
description:
- "&2This is a template for the shearing-challenge. %player% has sheared %progress% / %target% sheep."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: WOOL
repeatable: false
specific-mobs:
- SHEEP
- MUSHROOM_COW
challenge$vote-challenge:
name: "&2Example"
description:
- "&2This is a template for the vote-challenge. %player% has voted %progress% / %target% times."
target: 300.0
reward: 200.0
reward-message: "&2You have completed the %name% challenge! You receive %reward% XP toward your battle-pass."
gui-mat: BEACON
repeatable: false
Terms of service
When you purchase this resource, you agree to the following terms:
- You may not redistribute or resell this resource
- Requests for refund or chargeback are often denied
- Any attempt of an unauthorized chargeback will result in termination of your license
- You may not decompile the resource
- Terms of service are subject to change
- I found a bug or my plugin won't launch What do I do?
- Where is this SpigotMC event?
- What MC version is this compatible with?
Contact me
If you need help, contact me at Discord (skype4lifefuccdiscord#9410).
Last edited:
