Mob Stone [Made for 1.21.5]

Welcome to Mob Stone! Unleash the Mayhem!
Hey there, Minecraft adventurer! Ever wished for a bit more BOOM, POW, and TREASURE in your world? Well, get ready to rumble with Mob Stone!

This plugin (inspired by the legendary MMORPG game, Metin2) drops mysterious, sparkling stones into your world. They might look like simple blocks, but oh boy, are they packed with surprises! Think of them like super tough piñatas, but instead of just candy, they're filled with monsters and awesome loot!

Are you brave enough to take on the challenge? Let's find out!

So, What's the Big Idea?
It's simple!

1. Find a Stone: These cool-looking Mob Stones pop up randomly near players exploring the world. Keep your eyes peeled!
   
   
2. Give it a Whack!: Start hitting the Mob Stone! You'll see its health bar appear above it, showing how tough it is.
   
   
3. Monster Mayhem!: As you chip away at the stone's health, WATCH OUT! Angry monsters will suddenly POOF into existence around it, trying to stop you! Different stones might spawn different meanies.
   
   
4. Keep Hitting!: Don't give up! Fight off the monsters and keep hitting that stone. More monsters might appear as it gets weaker!
   
   
5. KABOOM! (and Loot!): Once you break the stone (get its HP to zero), it goes BOOM (visually, don't worry!) and drops a bunch of goodies! This could be anything from shiny diamonds and useful iron to maybe even magical enchanted books! You'll also get some experience points (XP) for your trouble.
   

It's a fun way to add extra challenge, excitement, and rewards to your Minecraft adventures!

Getting Started (Installation)
Getting Mob Stone running is as easy as stacking dirt blocks!

1. Download: Get the MobStoneRandom.jar file (the file name will also contain its version).
   
   
2. Drop it In: Place the .jar file into your server's plugins folder.
   
   
3. Start/Restart: Start or restart your Minecraft server.
   
   
4. Ta-Da! The plugin should load up, and Mob Stones will start appearing randomly (if enabled in the config!). You'll see messages in the server console when it starts and when Mob Stones spawn.
   

How to Play & Use Commands!
Okay, adventurer, here are the magic words (commands) you might need! You usually type these in chat starting with /. The main command is /mobstone, or you can use the shorter /ms.

(Psst! Some commands need special permissions, like being a server Operator (OP) or having specific permission nodes setup by the server owner).

• /ms startRandomSpawning
  
  • What it does: Turns ON the random spawning of Mob Stones in the world (every world). By default it is enabled.
    
    
  • Who can use it: Server Admins (mobstone.admin permission).
    
• /ms stopRandomSpawning
  
  • What it does: Tells the Mob Stones to stop appearing randomly. Maybe you need a break from the mayhem!
    
    
  • Who can use it: Server Admins (mobstone.admin permission).
    
• /ms killAllStones
  
  • What it does: Uh oh! Feeling overwhelmed? This command makes ALL active Mob Stones in the world instantly disappear (poof!). Useful for cleanup or emergencies.
    
    
  • Who can use it: Server Admins (mobstone.admin permission).
    
• /ms spawnStone [type]
  
  • What it does: Want a stone right now? Look at a solid block on the ground, type this command, and a Mob Stone will appear right above where you're looking! You can optionally type a specific stone [type] (like hard or easy, whatever is set up in the config) after the command to choose which kind appears. If you don't enter a type, it usually spawns the default one.
    
    
  • Who can use it: Players with mobstone.spawn permission or Server Admins (mobstone.admin).
    
• /ms reload
  
  • What it does: Tells the plugin to re-read its "recipe book" (the config.yml file). Useful after you've made changes to the config and want them to take effect without restarting the whole server.
    
    
  • Who can use it: Server Admins (mobstone.admin permission).
    
• /ms save (Usually not needed)
  
  • What it does: Tells the plugin to immediately save the current state of all active stones (like their HP). The plugin usually does this automatically, but this forces it.
    
    
  • Who can use it: Server Admins (mobstone.admin permission).
    
• /ms help
  
  • What it does: Shows you a list of the commands in the game!
    

⚙️ The Magic Recipe Book! (Configuring config.yml)
Want to change how Mob Stones work? Maybe make them tougher? Or change the loot? You can! The plugin comes with a file called config.yml (you'll find it in the /plugins/MobStone/ folder after running the plugin once). Think of this file like the plugin's recipe book!

You can open config.yml with a simple text editor (like Notepad, Notepad++, VS Code, etc.). Be careful with spacing (indentation) – YAML files are picky!

Here's what the different sections mean:

idle-removal: (Cleaning Up Forgotten Stones!)

Sometimes, a Mob Stone might spawn, but no one finds it or tries to break it. To keep the world tidy and prevent too many inactive stones from cluttering things up, you can set up automatic removal!

• enabled: true
  
  • Set to true to turn this feature ON. If false, stones will never disappear just because they haven't been hit recently.
    
• timeout-minutes: 30
  
  • If enabled is true, this is how many minutes a stone can sit there without being hit by anyone before the plugin decides it's lonely and makes it vanish (poof!). A value like 30 (half an hour) is usually good.
    
• check-interval-ticks: 6000
  
  • How often (in Minecraft ticks) the plugin checks all the active stones to see if any have passed their idle timeout-minutes. 6000 ticks is 5 minutes (6000 / 20 ticks-per-second / 60 seconds-per-minute = 5). Making this check too frequent could cause a tiny bit of lag on very busy servers with lots of stones. 5 minutes is usually fine.
    

enchantments: (Global Rules for Magic Books!)

This section sets some overall rules for how many enchanted books might drop from any Mob Stone when it's destroyed. Think of it as a baseline range.

• minNumberOfEnchantedBooks: 2
  
  • When a stone does drop items, this is the minimum number it will guaranteed to drop.
    
• maxNumberOfEnchantedBooks: 6
  
  • When a stone does drop items, this is the maximum number it might drop. The actual number dropped will be a random value between this min and max.
    

random-spawning:

This section controls how stones appear randomly in the world.

• enabled-by-default: true
  
  • Set this to true if you want random stones to start appearing as soon as the server starts. Set to false if you want to manually start it later using /ms startRandomSpawning. Stones will only spawn near players, so you need online players for Stones to spawn.
    
• interval-ticks: 600
  
  • How often (in Minecraft ticks) the plugin checks if it should try to spawn a stone near players. There are 20 ticks in a second, so 600 ticks is 30 seconds (600 / 20 = 30).
    
• chance-per-player-per-check: 0.05
  
  • Every time the check interval happens (e.g., every 30 seconds), this is the chance for each player that the plugin will try to spawn a stone near them. 0.05 means a 5% chance. 1.0 would mean a 100% chance (it would always try), 0.0 means 0% chance (never tries).
    
• min-spawn-distance-from-player: 16
  
  • How close (minimum blocks) a stone can randomly spawn to a player. Prevents them popping up right under your feet!
    
• max-spawn-distance-from-player: 64
  
  • How far away (maximum blocks) a stone can randomly spawn from a player.
    
• prevent-clustering-radius: 50
  
  • Stops stones from spawning too close to each other. If a stone tries to spawn, but another stone is already within this many blocks, it won't spawn there. Keeps things spread out!
    
• max-stones-per-world: 50
  
  • The maximum number of Mob Stones allowed to exist in a single world at the same time. Prevents your world from getting too crowded!
    
• valid-ground-materials:
  
  
  • A list of block types that a Mob Stone is allowed to spawn on top of. Usually things like GRASS_BLOCK, DIRT, STONE, SAND, etc.
    

You can check for valid Material types here:
https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

stone-definitions:

This is where you design your different types of Mob Stones! You can have many types, each with its own name and rules. The example config might have default: and hard:, but you can add more like easy:, cave_dweller:, treasure_goblin:, etc. You name it!

Inside each stone type (like default , you set its properties:

• display-name: "&cDefault MobStone"
  
  • What the stone is called. This is displayed above the Stone besides its health bar. The &c part uses Minecraft color codes (like red in this case).
    
• hp: 150
  
  • Health Points! How much damage the stone can take before it breaks. Higher numbers mean it's tougher!
    
• materials:
  
  • What the stone looks like! It's made of two blocks stacked up. This list contains block names (like IRON_ORE, COAL_ORE). The plugin randomly picks two materials from this list each time this type of stone spawns. You can provide as many materials in the list for a single Stone as you would like.
    
• base-particle-1: PORTAL
  
  • The name of a Minecraft particle effect that sparkles around the stone constantly. Find particle names online! (Example: FLAME, HEART, VILLAGER_HAPPY)
    
• base-particle-2: SMOKE_NORMAL
  
  • A second particle effect that plays along with the first one! You can use the same one twice if you like.
    
• waves: (When the Monsters Jump Out!)
  
  • hp-threshold-percent: [80, 50, 20]
    
    • This is super important! It's a list of health percentages. When the stone's HP drops below each number, a wave of monsters spawns. So, for [80, 50, 20]:
      
      • A wave spawns when HP goes below 80%.
        
        
      • Another wave spawns when HP goes below 50%.
        
        
      • A final wave spawns when HP goes below 20%.
        
  • mobs-per-wave: 3
    
    • How many monsters pop out in each wave.
      
  • spawn-radius: 5
    
    • How far away (maximum blocks) from the stone the monsters can appear.
      
  • mob-types:
    
    • A list of monsters that can spawn in the waves for this stone type. The plugin picks randomly from this list for each monster. Use official Minecraft mob names like ZOMBIE, SKELETON, SPIDER, CREEPER, VINDICATOR, PIGLIN.
      
• loot: (The Treasure Inside!)
  
  • items:
    
    • A list of regular items that might drop when the stone breaks.
      
      
    • The format is: - MATERIAL_NAME:minAmount:maxAmount:chance
      
      • MATERIAL_NAME: Like DIAMOND, IRON_INGOT, GOLD_NUGGET.
        
        
      • minAmount: The smallest number of this item that can drop.
        
        
      • maxAmount: The largest number of this item that can drop. (It will pick a random number between min and max).
        
        
      • chance: How likely (from 0.0 to 1.0) this specific item is to drop at all. 1.0 = 100% chance, 0.5 = 50% chance, 0.1 = 10% chance.
        
  • xp: 30
    
    • How many experience points (like the little green orbs) drop when the stone breaks.
      
• drop-loot-on-kill: true
  
  • Should the stone drop enchanted books and the items listed above when destroyed? true = yes, false = no.
    
• drop-xp-on-kill: true
  
  • Should the stone drop the xp listed above when destroyed? true = yes, false = no.
    

You can copy an existing stone definition (like default , paste it below, change the name (e.g., to easy , and tweak all the values to make your own unique Mob Stones!

✨ Stone Mechanics Explained (How they Work!)

• Spawning: Stones appear randomly based on the config.yml rules OR when an admin uses the /ms spawnStone command. They need clear space above them and around them to appear. They only spawn on specific ground materials sepcified in the config. When a stone is spawned you will see a lightning at the spawn location.
  
  
• Look & Feel: They are made of two blocks stacked up (randomly chosen from their materials list in the config) and have cool particle effects swirling around them.
  
  
• Hitting: You damage the stone by hitting it! It doesn't matter where you hit the two blocks. Special invisible helpers (don't worry, you can't see or touch them!) are there to detect your hits.
  
  
• Health Bar: When you hit a stone, a health bar appears above it, showing red for remaining health and gray for missing health. You can only use close-combat methods to hurt the Stone. Potions and other projectiles won't count.
  
  
• Mob Waves: As the health bar goes down, it might trigger monster spawns at the percentages set in the config (hp-threshold-percent). Fight them off! Spawned mobs will not hit each other. Only you can register damage to them. All mobs spawned will automatically try to hurt you.
  
  
• Destruction: When the HP hits zero, the stone breaks! It plays an explosion sound and drops its loot (items, books, XP) if configured to do so.
  
  
• Persistence: Mob Stones stick around! If the server restarts, the stones that were active should reappear right where they were, with the same amount of HP remaining! (Thanks to the magic of saving data!). DO NOT EDIT the stones.yml as it serves like a database for active stones.
  

Tips for Maximum Fun!

• Experiment! Don't be afraid to change the config.yml. Make super easy stones that drop lots of goodies, or incredibly hard ones that spawn waves of Wardens (if you dare!).
  
  
• Events: Create server events around finding and destroying specific types of Mob Stones!
  
  
• Balancing: Adjust the HP, mob types, and loot to match your server's difficulty and economy.
  
  
• Check the server logs: Server logs will announce if you made wrong changes to the config.yml file. Also it provides lot of information.

• Lost configuration: just delete the MobStonePlugin folder in your plugins folder and you will have a blank, fresh config file.

• Use AI: use ChatGPT or Gemini to generate interesting new stone-definitions in the config.

That's the scoop on Mob Stone! Go forth, find those stones, whack 'em hard, fight those mobs, and grab that treasure! Have fun, and watch out for creepers spawning from the waves!

Chat on Discord
If you have ideas, or experienced bugs, chat on Discord, and join the channel called "mobstone": https://discord.gg/UxJFgeTFBA