Vanilla Core

A Minecraft plugin for Vanilla servers focused on PvP balance, custom mechanics, and server management. Built for Paper/Spigot 1.21.1+.

This project is now open source.

---

Features

Combat & PvP

• Item Limiter: Limit how many of specific items players can carry (gaps, totems, pearls, etc.)
• Mace Limiter: Server-wide mace crafting limit with broadcast announcements
• Netherite Disabler: Prevent use of netherite gear (configurable per item type)
• Shield Mechanics: Add mace shield stun, customize axe stun duration, and toggle each separately

Enchantments

• Custom Anvil Caps: Prevent enchantments from exceeding set levels via anvil/enchanting table
• Enchantment Replacement: Automatically scan and reduce overpowered enchantments on items
• Item Whitelist: Mark specific items as exempt from enchantment scans

Bans

• Item Bans: Ban maces, anchors, crystals, pearls, netherite items
• Potion Effect Bans: Config-driven list of banned potion effects

Dimensions

• Nether Lock: Toggle access to The Nether
• End Lock: Toggle access to The End

Custom Mechanics

• Invisible Kills: Hide killer name in death messages when invisible
• Item Explosion Immunity: Protect dropped items from explosions
• Infinite Restock: Villagers never run out of trades
• One Player Sleep: Only one player needs to sleep to skip night

GUI System

• Main Menu: /vanilla opens a paginated GUI showing all features
• Dynamic Feature Items: Toggle features with left-click, configure with right-click
• Menu Pagination: Automatically handles many features across multiple pages

---

Commands

Command	Description	Permission
/vanilla	Opens the main settings menu	-
/vanilla menu	Opens the main settings menu	-
/vanilla reload	Reloads all configurations	vanillacore.reload
/vanilla enchant <sub>	Enchantment management	vanillacore.enchant
/vanilla mace <sub>	Mace limiter commands	vanillacore.mace
/vanilla netherite <sub>	Netherite disabler commands	vanillacore.netherite

Enchantment Subcommands

• /vanilla enchant limit <enchant> <level> [anvil|replacement|both]
• /vanilla enchant unlimit <enchant> [anvil|replacement|both]
• /vanilla enchant block <enchant> [anvil|replacement|both]
• /vanilla enchant unblock <enchant> [anvil|replacement|both]
• /vanilla enchant list
• /vanilla enchant scan
• /vanilla enchant whitelist

---

Installation

For Server Owners

1. Download from Modrinth
2. Place the JAR in your server's plugins folder
3. Restart or reload your server
4. Configure features in your plugin folder config.yml
5. Use /vanilla reload to apply changes or /vanilla to use the GUI

For Developers

git clone https://github.com/TejasLamba2006/vanilla-core.git
cd vanilla-core

mvn clean package

See CONTRIBUTING.md for development guidelines.

---

Configuration

All features are disabled by default and fully configurable via config.yml.

Example: Item Limiter Configuration

features:
  item-limiter:
    enabled: false
    check-method: "on-hit"
    limits:
      golden_apple: 4
      enchanted_golden_apple: 1
      totem_of_undying: 1
      end_crystal: 2
      ender_pearl: 8

Example: Enchantment Caps Configuration

features:
  custom-anvil-caps:
    enabled: false
    block-enchanting-table: true
    block-anvil: true
    keep-only-best-protection: true
    caps:
      sharpness: 4
      protection: 3
      power: 4
      unbreaking: 2

Example: Mace Limiter Configuration

features:
  mace-limiter:
    enabled: false
    max-maces: 1
    title:
      enabled: true
      title: "§6⚔ MACE CRAFTED ⚔"
      subtitle: "§e{player} §7has crafted mace §e#§6{count}"
    chat:
      enabled: true
      message: "§6{player} §ehas crafted mace #§6{count}§e!"
    sound:
      enabled: true
      sound: "ENTITY_ENDER_DRAGON_GROWL"

---

Requirements

• Server: Paper or Spigot 1.21.1+
• Java: 21 or higher

---

Technical Features

• Thread-Safe: All managers use concurrent data structures
• Performance Optimized: O(1) feature lookups, cached configs, cooldown systems
• Memory Safe: Proper cleanup on player quit, no memory leaks
• Hot Reload: All configs can be reloaded without restart

---

Contributing

You can help by:

• Reporting bugs using issue templates
• Suggesting features using feature requests
• Submitting pull requests following our contributing guidelines
• Improving documentation in the docs folder
• Starring the repository if you find it useful

Development

git clone https://github.com/YOUR_USERNAME/vanilla-core.git

git checkout -b feature/amazing-feature

mvn clean package

git commit -m "Add amazing feature"
git push origin feature/amazing-feature

Read the full Contributing Guide for detailed information.

---

Issues & Support

• Bug Reports: Use our bug report template
• Feature Requests: Use our feature request template
• Discord: Join our Discord server for quick help
• Documentation: Check the full documentation

---

License

This project is licensed under the MIT License - see the LICENSE file for details.

You are free to use, modify, and distribute this software. See docs/license.md for more information.