AlexPlugins - ServerTools

# 🧰 AlexPlugins – ServerTools ## Update to 0.0.5 Release before 7/25 # ServerTools **ServerTools** is a modular utility plugin for **Paper and Purpur 26.2 Minecraft servers**. It provides focused administrative tools, player timezones, configurable custom items, and an optional Python expansion system. ServerTools integrates with **PlaceholderAPI** when installed. Plugins such as **TAB** can display ServerTools placeholders through PlaceholderAPI; TAB is not a direct dependency. > ⚠️ **ServerTools is actively developed and considered a work in progress.** > Features, commands, configuration, and expansion APIs may change between beta releases. --- ## Requirements - **Paper 26.2** or **Purpur 26.2** - **Java 25** - **PlaceholderAPI 2.12.3+** — optional, required only for placeholders - **TAB** — optional ServerTools does not support Spigot, CraftBukkit, Folia, Sponge, BungeeCord, Velocity, or Waterfall. --- ## ✨ Core Features ### 🕒 Player Timezone System A local, per-player timezone system using real **IANA timezone identifiers**, such as `America/New_York` and `Europe/London`. - Per-player timezone storage - Configurable server-default timezone - Automatic daylight-saving-time handling - Case-insensitive timezone input - Join reminders for players without a configured timezone - Configurable reminder delay and interval - Timezone removal and fallback to the server default - PlaceholderAPI integration Example placeholder output: ```text 6:18 PM ``` Timezone commands: ```text /tz /tz set <ZoneId> /tz change <ZoneId> /tz remove ``` --- ### 🧩 PlaceholderAPI Integration When PlaceholderAPI is installed, ServerTools automatically registers its internal expansion at runtime. No PlaceholderAPI eCloud download is required. Available placeholder: ```text %servertools_time% ``` The placeholder returns the player’s local time. If the player has not selected a timezone, the configured server default is used. TAB can display this value through its normal PlaceholderAPI support. --- ### 🎨 Configurable Special Items ServerTools can create custom items defined in `servertools.yml`. Special items support: - Material selection - Custom display names - Configurable stack amounts - Custom model data - Unsafe enchantment levels - Persistent ServerTools item identifiers - Giving items to online players - Removing ServerTools items from player inventories - Tab completion for item IDs and player names Commands: ```text /specialitem give <item> /specialitem list /specialitem remove <player> /specialitem reload ``` A matching Minecraft 26.2 resource pack is included for the default Owner’s Sword and Owner’s Pickaxe examples. --- ### 🐍 Python Expansion System ServerTools includes an optional expansion system powered by **Jython 2.7**. Expansion files can: - Register dynamic commands - Unregister commands - Run console commands - Write messages to the server log - Use startup and shutdown lifecycle functions - Disable themselves at runtime Expansion files are loaded from: ```text plugins/ServerTools/expansions/ ``` > Expansions execute inside the Minecraft server and can dispatch console commands. Only install expansion files you fully trust. Management commands: ```text /expansions list /expansions reload /expansions remove <id> /expansions dev list /expansions dev stop <id> ``` The shorter `/expans` alias is also available. --- ### 🛠️ Server Utilities ServerTools currently includes: - `/disconnect` — disconnect yourself with a configurable message - `/stopserver ` — schedule a server shutdown - `/stopserver cancel` — cancel a scheduled shutdown - `/servertools version` — display the installed version - `/servertools reload` — reload configuration and expansions - `/servertools disable` — disable ServerTools - `/servertools verifyclient` — show login verification and client-brand information - `/servertools playeridentification` — show player identification information - `/tz` — manage player timezones - `/specialitem` — manage configured custom items - `/expansions` — manage Python expansions Administrative commands are protected by permissions defined in `plugin.yml`. --- ## 📋 Modular Configuration ServerTools stores its primary configuration in: ```text plugins/ServerTools/servertools.yml ``` Configuration defaults are loaded automatically, while existing server configuration values are preserved. Example: ```yaml plugin: enabled: true disconnect: enabled: true message: "Disconnected!" timezones: enabled: true default: "America/New_York" request-on-join: true reminder-delay-seconds: 2 reminder-interval-seconds: 30 expansions: enabled: true developer-mode: false special-items: owners_sword: material: NETHERITE_SWORD amount: 1 display-name: "&6Owner's Sword" custom-model-data: 1001 enchants: SHARPNESS: 255 SMITE: 5 ``` --- ## 📦 Installation 1. Install **Java 25**. 2. Download `Server