Tweakin - Minecraft Server Enhancement Plugin

📝 Introduction

Tweakin is a multi-functional enhancement plugin designed for Minecraft servers. It provides various useful game mechanism improvements to make the server gaming experience more convenient and fun.

✨ Features

• 🍁 Falling of Physical Gravity Blocks
  • When gravity blocks such as sand fall, they will break incomplete blocks like torches beneath them.
• 🌱 Auto Planting System
  • Automatically plants dropped seeds and crops
  • Supports all plant types
  • Configurable planting delay
  • Particle effect feedback
• 🚪 Double Door Sync
  • Automatically syncs adjacent door states
  • Supports all wooden door types
• 🌵 Cactus Protection
  • Prevents items from being destroyed by cacti
  • Items bounce away instead of being destroyed
• 🏃 Join/Quit Messages
  • Custom welcome messages
  • Display player online time
  • Beautiful quit notifications
• 🍖 Death Hunger Retention
  • Retains hunger value after death
  • Special handling for starvation deaths
• 🔨 Silk Touch Enhancement
  • Configurable additional blocks for silk touch
  • Supports spawner collection
• 🥚 Dragon Egg Drops
  • Dragon egg drops on every dragon kill
• 🕯️ Dangerous Block Damage
  • Take damage when standing on candles
  • Take damage when standing on stonecutters

📥 Installation

1. Download the latest version of Tweakin.jar
2. Place the file in your server's plugins folder
3. Restart the server
4. Enjoy the enhanced features!

⚙️ Configuration

The plugin will automatically create configuration files on first run:

📁 plugins/Tweakin/
   └── 📄 config.yml    - Main configuration file

Configuration Details

config.yml contains the following main settings:

# Join Message Settings
join-message:
  # Enable join message feature
  enabled: true
  # Join messages
  messages:
    - " "
    - "  &bWelcome back, &f%player_name%"
    - "  &7▶ Playtime: &f%statistic_time_played%"
    - "  &7▶ Online Players: &f%server_online%"
    - "  &7▶ Last Login: &f%player_last_login%"
    - " "
  # Join notification
  join: "&8[&a+&8] &7Player &f%player_name% &7joined the game"

# Quit Message Settings
quit-message:
  # Enable quit message feature
  enabled: true
  # Quit notification
  quit: "&8[&c-&8] &7Player &f%player_name% &7left the game"

# Cactus Protection Settings
cactus-protection:
  # Enable cactus protection for dropped items
  enabled: true

# Falling Block Settings
falling-block:
  # Enable falling block breaking non-full blocks
  enabled: true
  # Enable falling blocks to break non-full blocks instead of becoming items
  # When set to true, falling blocks will break non-full blocks below instead of becoming items
  break-non-full-block: true
  # Enable dropping items when breaking non-full blocks
  drop-items: true
  # Enable breaking effect particles
  particle-effect: true

# Double Door Settings
double-door:
  # Enable double door synchronization
  enabled: true

# Silk Touch Plus Settings
silk-touch-plus:
  # Enable silk touch enhancement
  enabled: true
  # List of blocks that can be obtained with silk touch
  # Format: 
  # "block_id": true/false
  # Example: "minecraft:spawner": true
  blocks:
    "minecraft:budding_amethyst": true # Budding Amethyst
    "minecraft:cobweb": true           # Cobweb
    "minecraft:farmland": true         # Farmland

# Auto Plant Settings
auto-plant:
  # Enable auto planting feature
  enabled: true
  # Delay before attempting to plant dropped items (seconds)
  plant-delay: 15
  # Enable planting success particle effect
  particle-effect: true

# Block Damage Settings
block-damage:
  enabled: true
  damage: 2.0 # Damage per second when standing on dangerous blocks

# Dragon Egg Settings
dragon-egg:
  # Enable dragon egg dropping on every dragon kill
  enabled: true

# Death Hunger Settings
hunger:
  # Enable death hunger retention
  enabled: true
  # Food level when respawning after starvation
  starvation-respawn-food: 4
  # Commands triggered on starvation death
  starvation-commands:
    # [PLAYER] - Execute as player
    # [CONSOLE] - Execute as console
    # [OP] - Execute as OP
    # [MESSAGE] - Send message to player
    # Available variables: %player% - Player name
    - "[CONSOLE] title %player% title {\"text\":\"Starved to death\",\"color\":\"red\"}"
    - "[CONSOLE] playsound minecraft:entity.wither.spawn player %player%"
    - "[PLAYER] me is too hungry..."
    - "[OP] effect give %player% weakness 30 0"
    - "[MESSAGE] §cYou starved to death!" 

📌 Commands

Command	Permission	Description
/tweakin reload	tweakin.reload	Reload plugin configuration

🔧 Requirements

• ☕ Java 17+
• 🎮 Minecraft 1.20.x
• 🛠️ Spigot/Paper Server

💬 Support

Need help? Join our community!

📜 License

This project is licensed under the MIT License.