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.