MeowTools Plugin

MeowTools is a utility plugin for Paper 1.21.11 servers, designed to provide a set of lightweight, configurable and modular features for survival and mini‑game servers.

Name: MeowTools
Author: xiaoyiluck
Platform: Paper / Spigot (Paper 1.21.11 recommended)
Build Tool: Gradle

Features Overview

1. Shortcut System

MeowTools provides a flexible shortcut system based on the player's F key and view direction. All shortcuts are configurable in config.yml, and commands are executed as the player.

Supported triggers (configurable):

F
Shift + F
Look Up + F
Look Down + F
Look Up + Shift + F
Look Down + Shift + F

This is ideal for binding frequently used actions such as:

Teleport to spawn
Open GUI menus
Home / warp commands
Custom server commands

2. Multi‑Language Support

Language files are stored in the lang folder (e.g. zh_cn.yml, en_us.yml).
All messages are handled through a centralized language manager.
Missing keys are auto‑filled to language files on load.
Supports & color codes (e.g. &a, &b) and renders them as colored text.

3. Config Versioning & Auto‑Update

config.yml contains a config-version field.
When the plugin updates and config structure changes, MeowTools:
- Backs up the old config,
- Merges new options,
- Writes the new version.
This greatly reduces manual configuration migration work.

4. Server Gameplay Tweaks

4.1 Keep Health & Food After Death

Optional feature to preserve the player’s health and food level on death.
If health or food was 0 before death, a minimal safe value is granted to prevent instant death loops.

4.2 Fast Leaf Decay

Toggle to enable fast decay of unattached leaves.
Only leaves not connected to logs will decay faster.
Player‑placed decorative leaves are not affected.

5. Admin & Utility Commands

All commands are unified under:

Main command: /meowtools
Recommended alias: /mt

Sub‑commands include:

5.1 Ping (Latency)

/mt ping [player]
Without argument: shows your own ping.
With player name: shows that player's ping.
Messages are fully localized.

5.2 Inventory View (with Armor & Offhand)

/mt inv <player>
Opens a custom 6‑row GUI that shows:
- Main inventory,
- Hotbar,
- Helmet, chestplate, leggings, boots,
- Offhand item.
When the GUI is closed, all changes are synced back to the target player’s real inventory.
Useful for staff to inspect or help player inventories.

5.3 Vanish System

/mt vanish – toggle self vanish.
/mt vanish on – force enable vanish.
/mt vanish off – force disable vanish.
/mt vanish <player> – toggle vanish for another player (extra permission required).

Vanish behavior:

Vanished players are completely hidden from players without the proper permission.
Joining players will not see already‑vanished players.
A BossBar is shown at the top of the screen indicating “vanished” state.
Night vision can be automatically granted while vanished, controlled by vanish_settings.night_vision in config.yml (enabled by default).

6. Join / Quit Message Control

Join and quit messages can be controlled separately.
Example: disable quit messages while keeping join notifications.

7. Command Blocking

Configure blocked commands in config.yml, such as:
- plugins, pl, me, bukkit:plugins, etc.
When a blocked command is executed by a player:
- The original command is cancelled,
- A custom message from the config is shown.
Helps keep survival / public servers clean and less “technical” for regular players.

8. Explosion & World Rule Settings

8.1 Fine‑Grained Explosion Control

Configure explosion behavior per source (TNT, creepers, others):
- Whether blocks are broken,
- Whether entities are damaged.
Logic is optimized for performance under heavy explosion scenarios to reduce TPS impact.

8.2 Per‑World Gamerule Configuration

Configure gamerules for each world (overworld, nether, end, etc.) under world_settings in config.yml.
Examples:
- doDaylightCycle
- doWeatherCycle
- keepInventory
- doMobSpawning
- doMobGriefing
Rules are applied on server startup, reload, and world load.

Permission Nodes (Examples)

meowtools.admin – admin operations (e.g. /mt reload).
meowtools.ping – use /mt ping.
meowtools.inv – use /mt inv.
meowtools.vanish – use /mt vanish for self.
meowtools.vanish.other – toggle vanish for other players.
meowtools.vanish.see – see vanished players.
meowtools.bypass.blocked_commands – bypass blocked commands.

Use Cases

Multi‑world survival servers needing fine control over explosions and rules.
Lightweight administrative tool for small servers needing vanish, inventory view, and shortcuts.
Public / community servers that care about localization, clean command feedback and quality of life.

Feedback

If you encounter issues or have feature requests while using MeowTools, feel free to open issues or suggestions so we can improve the plugin together.

Meowtools