MMOBlock is a powerful Bukkit plugin that revolutionizes your Minecraft server by introducing interactive custom entities and blocks. With seamless integration to popular plugins like ModelEngine, MMOItems, ItemsAdder, and PlaceholderAPI, MMOBlock brings a new level of immersion and engagement to your server.
Features
- Custom Entities: Spawn and interact with custom entities that can be configured with various properties.
- Block Placement: Place custom blocks that are invulnerable to damage and can be configured to have specific types and dimensions.
- Holograms: Create and manage holograms that provide information or interact with players.
- Animations: Play custom animations on entity interaction using ModelEngine.
- Drops and Rewards: Configure item drops and rewards for entity interactions, including support for MMOItems and ItemsAdder custom items.
- Cooldowns: Set cooldowns for entity interactions to prevent spamming.
- Integration: Seamlessly integrates with MMOItems, MMOCore, ModelEngine, ItemsAdder, and PlaceholderAPI.
Installation
- Download the MMOBlock plugin from the Polymart resource page.
- Place the downloaded .jar file in the plugins folder of your Minecraft server.
- Start or restart your server to load the plugin.
- Configure the plugin using the config.yml file located in the plugins/MMOBlock directory.
Configuration
The config.yml file allows you to configure various aspects of the plugin, including entity types, models, allowed tools, drops, holograms, conditions, sounds, animations, and block placements. Here is a snippet of the configuration file:
config.yml
#config file version 1.4
debug: false
lang: en-us
cooldown: 1 # in seconds
entity:
example:
send-title: "&eYour tool not matching!" # vanilla color code usage
send-subtitle: "<red>or Tools are too low</red>" # color code usage
decrease_durability: 15
#model: iron_ore #model from modelengine
#on_click: hit;0;0;1 #animaniton_name;lerpin;lerpout;speed
#ondeathanim: hit;0;0;1 #animaniton_name;lerpin;lerpout;speed
respawn: 5
#death_delay: 1
hologram:
enable: true
customHolo:
- '<gradient:#FFA500:#00FF00>Diamond Ore</gradient>' #gradient usage #first line not affect with height
- '<#FFA500>Required Mining Lvl 1</#FFA500>;height=0.3' #hex usage
- '<#00FF00>[Click to Mine]</#00FF00>;height=0.3'
height: 2 #all line height
clickHeight: 1
block:
type: DIAMOND_ORE #for itemsadder custom block use like this <namespace>:<block id>, for Oraxen block use like this <block id>
wide: 0
height: 1
#conditions:
#mmocore-level:
# level: mining:1
# send-title: "&eYour Level Is too Low"
# send-subtitle: "<red>Minimum Level 1</red>"
#condition1: #can make more than 1
# first: '%vault_eco_balance%'
# second: 500
# operator: '>'
# send-title: "&eYour funds not met"
# send-subtitle: "<red>Minimum 500</red>"
sounds:
onClick: block.stone.hit
onDeath: block.stone.break
allowed_tools:
- DIAMOND_PICKAXE;3
# - TOOL:STEEL_PICKAXE;5
- STONE_PICKAXE;8
# - _iainternal:iron_pickaxe_custom;8
drops:
- RAW_IRON;3;0.8
# - TOOL:STEEL_PICKAXE;1;0.1
# - _iainternal:iron_pickaxe_custom;1;1
# - profession;woodcutting;30
- exp;50;1
- command;give %player% diamond 1;1
progressbar:
progressing: "<green>|</green>"
noprogress: "<gray>|</gray>"
barlength: 16
Commands
- /mmoblock place <entityId> [world] [x] [y] [z]: Places a custom entity at the specified location.
- /mmoblock remove <all|entityId>: Removes a custom entity at the specified location.
- /mmoblock reload: Reloads the plugin configuration.
- /mmoblock get: Gives the player a custom item for adjusting entity facing.
Permissions
- mmoblock.place: Permission to use the /mmoblock place command.
- mmoblock.remove: Permission to use the /mmoblock remove command.
- mmoblock.reload: Permission to use the /mmoblock reload command.
- mmoblock.get: Permission to use the /mmoblock get command.
Integration
- MMOItems: Supports custom items from MMOItems for interactions and drops.
- MMOCore: Enforces level requirements for entity interactions.
- ModelEngine: Provides custom models and animations for entities.
- ItemsAdder: Supports custom blocks and items from ItemsAdder.
- ProtocolLib: Provides Block Break Animation.
- PlaceholderAPI: Provides placeholders for entity interaction data.
Support
For support, feature requests, or bug reports, please join our Discord community.
Preview Video
Test on Server Version 1.21
Test on Server Version 1.17-1.20
Detailed Documentation
Visit the MMOBlock Wiki for detailed documentation and guides.