ModsJava
✨MMOItemsStationGui✨ | MMoitems Station with fully configurable
Upgrade MMOItems items using a GUI, with customizable success rates and costs.
⬇ Download on SpigotDependencies
MMoitems (6.10) | Vault | Playerpoints
I. INTRODUCTION
This plugin allows you to add MMOItems' equipment upgrade feature to your server, featuring a fully customizable interface, support for custom model data, adjustable success rates, and much more.
II. FEATURES
1. Gem Socket
This feature allows you to create a socketing interface with configurable success rates and costs—supporting Vault and PlayerPoints—and accepts both vanilla items and MMOItems as materials.
You can also define a blacklist of items that players are prohibited from socketing.
Code (Text):
socket:
enabled: true
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
max-sockets: 5
cooldown-seconds: 3
levels:
1:
success-rate: 100
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
2:
success-rate: 90
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items:
type: DIAMOND
amount: 1
mmoitems: {}
enabled: true
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
max-sockets: 5
cooldown-seconds: 3
levels:
1:
success-rate: 100
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
2:
success-rate: 90
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items:
type: DIAMOND
amount: 1
mmoitems: {}
2. Item Upgrading
- The equipment upgrade interface is fully customizable using MMOItems templates, allowing you to define success rates and specific requirements, as well as the level-drop penalty for failed upgrades.
- You can configure the system so that items lose levels upon a failed upgrade at specific tiers. Additionally, you can designate any Vanilla or MMOItems item as a "protection charm" to prevent the item from losing levels if the upgrade fails.
- A blacklist feature is available, allowing you to specify items that players are prohibited from upgrading.
Code (Text):
upgrade:
enabled: true
# Blacklist only checks MMOItems type, for example: SWORD, ARMOR, TOOL.
# Vanilla blacklist was intentionally removed because vanilla items are blocked
# from equipment slots by default.
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
protection-charm:
# Vanilla items allowed in the protection charm slot.
vanilla:
- NETHER_STAR
# MMOItems protection charm format: TYPE:ID
# Example:
# mmoitems:
# - MATERIAL:PROTECTION_CHARM
mmoitems: []
min-level: 0
max-level: 1
cooldown-seconds: 3
template:
1:
success-rate: 80
# Failure mode:
# "0" = keep the same level on failure.
# "-1" = downgrade one level on failure.
# Protection charm prevents downgrade and is consumed only when it protects.
failure-mode: "-1"
requirements:
permission: ""
money: 0
playerpoints: 0
# Vanilla requirement example:
# vanilla-items:
# type: DIAMOND
# amount: 1
vanilla-items: {}
# MMOItems requirement example:
# mmoitems:
# gem1:
# type: MATERIAL
# id: UPGRADE_STONE
# amount: 1
mmoitems: {}
enabled: true
# Blacklist only checks MMOItems type, for example: SWORD, ARMOR, TOOL.
# Vanilla blacklist was intentionally removed because vanilla items are blocked
# from equipment slots by default.
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
protection-charm:
# Vanilla items allowed in the protection charm slot.
vanilla:
- NETHER_STAR
# MMOItems protection charm format: TYPE:ID
# Example:
# mmoitems:
# - MATERIAL:PROTECTION_CHARM
mmoitems: []
min-level: 0
max-level: 1
cooldown-seconds: 3
template:
1:
success-rate: 80
# Failure mode:
# "0" = keep the same level on failure.
# "-1" = downgrade one level on failure.
# Protection charm prevents downgrade and is consumed only when it protects.
failure-mode: "-1"
requirements:
permission: ""
money: 0
playerpoints: 0
# Vanilla requirement example:
# vanilla-items:
# type: DIAMOND
# amount: 1
vanilla-items: {}
# MMOItems requirement example:
# mmoitems:
# gem1:
# type: MATERIAL
# id: UPGRADE_STONE
# amount: 1
mmoitems: {}
3. Upgrading Transfer
- Transfer one piece of equipment to another, with full support for transferring levels and gems, and fully customizable settings.
- Supports transferring levels, gem sockets, or both simultaneously.
- Includes a blacklist feature to specify items that players are prohibited from converting.
Code (Text):
transfer:
enabled: true
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
transfer-mode: "UPGRADE_AND_SOCKET"
cooldown-seconds: 3
modes:
socket-only:
success-rate: 100
transfer-mode: "SOCKET_ONLY"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
upgrade-only:
success-rate: 100
transfer-mode: "UPGRADE_ONLY"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
upgrade-and-socket:
success-rate: 100
transfer-mode: "UPGRADE_AND_SOCKET"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
enabled: true
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
transfer-mode: "UPGRADE_AND_SOCKET"
cooldown-seconds: 3
modes:
socket-only:
success-rate: 100
transfer-mode: "SOCKET_ONLY"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
upgrade-only:
success-rate: 100
transfer-mode: "UPGRADE_ONLY"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
upgrade-and-socket:
success-rate: 100
transfer-mode: "UPGRADE_AND_SOCKET"
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
4. Gem Removal
- Create a GUI for removing gems from equipment, with fully customizable rates and requirements.
- Customize the chance of the gem shattering during removal, the success rate, and more.
Code (Text):
remove:
enabled: true
success-rate: 100
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
# Removal modes:
# RETURN_GEM = remove the gem and return it to the player's inventory.
# DESTROY_GEM = remove the gem and delete it.
removal-mode: "RETURN_GEM"
cooldown-seconds: 3
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
enabled: true
success-rate: 100
blacklist:
# Example:
# mmoitems:
# - MATERIAL
# - CONSUMABLE
mmoitems: []
# Removal modes:
# RETURN_GEM = remove the gem and return it to the player's inventory.
# DESTROY_GEM = remove the gem and delete it.
removal-mode: "RETURN_GEM"
cooldown-seconds: 3
requirements:
permission: ""
money: 0
playerpoints: 0
vanilla-items: {}
mmoitems: {}
4. Gui Effects
Customize GUI effects to your liking!
Code (Text):
fill:
slots: [0,1,2,3,4,5,6,7,8,9,14,15,16,17,18,26,27,35,36,37,38,39,40,41,42,43,44]
states:
ready:
material: LIME_STAINED_GLASS_PANE
not-ready:
material: RED_STAINED_GLASS_PANE
processing:
material-a: LIGHT_BLUE_STAINED_GLASS_PANE
material-b: CYAN_STAINED_GLASS_PANE
blinks: 5
interval-ticks: 4
success:
material: LIME_STAINED_GLASS_PANE
hold-ticks: 20
failure:
material: RED_STAINED_GLASS_PANE
hold-ticks: 20
slots: [0,1,2,3,4,5,6,7,8,9,14,15,16,17,18,26,27,35,36,37,38,39,40,41,42,43,44]
states:
ready:
material: LIME_STAINED_GLASS_PANE
not-ready:
material: RED_STAINED_GLASS_PANE
processing:
material-a: LIGHT_BLUE_STAINED_GLASS_PANE
material-b: CYAN_STAINED_GLASS_PANE
blinks: 5
interval-ticks: 4
success:
material: LIME_STAINED_GLASS_PANE
hold-ticks: 20
failure:
material: RED_STAINED_GLASS_PANE
hold-ticks: 20
III. PLACEHOLDER
Built-in GUI placeholders:
- %player_name%: Player name.
- %lim_id%: LagoonItemManager (ItemID) item ID, or None when the item has no LIM ID.
- %mmoitems_name%: MMOItems display name of the current item.
- %mmoitems_type%: MMOItems type of the current item.
- %mmoitems_id%: MMOItems ID of the current item.
- %upgrade_level%: Current upgrade level on the item.
- %socket_count%: Current socket count on the item.
- %upgrade_success_rate%: Success rate for the next upgrade template. Shows 0 when no item is placed.
- %socket_success_rate%: Success rate for the next socket level. Shows 0 when no item is placed.
- %remove_success_rate%: Gem removal success rate. Shows 0 when no item is placed.
- %transfer_success_rate%: Success rate for the currently selected transfer mode. Shows 0 until transfer items are placed.
- %transfer_socket_only_success_rate%: Success rate for SOCKET_ONLY transfer mode.
- %transfer_upgrade_only_success_rate%: Success rate for UPGRADE_ONLY transfer mode.
- %transfer_upgrade_and_socket_success_rate%: Success rate for UPGRADE_AND_SOCKET transfer mode.
- {money_require}: Required Vault money for the current action.
- {points_require}: Required PlayerPoints for the current action.
- %ingredients% or %ingredient_lines%: One lore line per required ingredient.
1. Command
- /mis open - open gui
- /mis status - dependencies status
- /mis open remove|socket|upgrade|transfer - open gui
- mmoitemsstationgui.admin
- mmoitemsstationgui.open - true in default
Soft-dependencies (require):
Dependencies:
- Vault (https://www.spigotmc.org/resources/vault.34315/)
- Playerpoints (https://www.spigotmc.org/resources/playerpoints.80745/)
- ItemID (comming soon)
If you have any feedback regarding bugs or would like to suggest new features, please message me directly on Discord. This is a free product, but I still provide support to the best of my ability.
Donate: https://taphz.github.io/iSynX_/
Discord: #1msynx_
Thank you for using my product!
✨MMOItemsStationGui✨ | MMoitems Station with fully configurable is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 13 times (via Spigot). Download it and open it directly in the game.