Tweakin - Minecraft Server Enhancement Plugin

!License

📝 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) License.