? AlexPlugins – ServerTools
在 7/25 之前更新至 0.0.5 版本
ServerTools
ServerTools 是一款专为 Paper 和 Purpur 26.2 Minecraft 服务器 设计的模块化实用插件。它提供集中的管理工具、玩家时区支持、可配置的自定义物品,以及可选的 Python 扩展系统。
当安装 PlaceholderAPI 时,ServerTools 会与之集成。TAB 等插件可以通过 PlaceholderAPI 显示 ServerTools 的占位符;TAB 并非直接依赖项。
⚠️ ServerTools 处于积极开发中,目前仍被视为进行中的项目。
功能、命令、配置及扩展 API 可能在测试版之间发生变化。
要求
- Paper 26.2 或 Purpur 26.2
- Java 25
- PlaceholderAPI 2.12.3+ — 可选,仅在使用占位符时需要
- TAB — 可选
ServerTools 不支持 Spigot、CraftBukkit、Folia、Sponge、BungeeCord、Velocity 或 Waterfall。
✨ 核心功能
? 玩家时区系统
基于真实 IANA 时区标识符(如 America/New_York 和 Europe/London)的本地化、每位玩家独立的时区系统。
- 每位玩家的时区存储
- 可配置服务器默认时区
- 自动处理夏令时
- 不区分大小写的时区输入
- 为未配置时区的玩家提供加入提醒
- 可配置提醒延迟和时间间隔
- 支持移除时区并回退至服务器默认值
- PlaceholderAPI 集成
示例占位符输出:
6:18 PM [EDT]
时区命令:
/tz
/tz set <ZoneId>
/tz change <ZoneId>
/tz remove
? PlaceholderAPI 集成
当安装 PlaceholderAPI 时,ServerTools 会在运行时自动注册其内部扩展。
无需下载 PlaceholderAPI eCloud 内容。
可用占位符:
%servertools_time%
该占位符返回玩家的本地时间。如果玩家未选择时区,则使用配置的服务器默认时区。
TAB 可以通过其正常的 PlaceholderAPI 支持显示此值。
? 可配置的自定义物品
ServerTools 可以在 servertools.yml 中定义并创建自定义物品。
自定义物品支持:
- 材质选择
- 自定义显示名称
- 可配置堆叠数量
- 自定义模型数据
- 非安全附魔等级
- 持久化的 ServerTools 物品标识符
- 向在线玩家发放物品
- 从玩家库存中移除 ServerTools 物品
- 物品 ID 和玩家名称的 Tab 补全
命令:
/specialitem give <item> [player]
/specialitem list
/specialitem remove <player>
/specialitem reload
随附一个与默认“Owner’s Sword”和“Owner’s Pickaxe”示例相匹配的 Minecraft 26.2 资源包。
? Python 扩展系统
ServerTools 包含一个由 Jython 2.7 驱动的可选扩展系统。
扩展文件可以:
- 注册动态命令
- 注销命令
- 运行控制台命令
- 将消息写入服务器日志
- 使用启动和关闭生命周期函数
- 在运行时禁用自身
扩展文件从以下目录加载:
plugins/ServerTools/expansions/
扩展程序在 Minecraft 服务器内部执行,并可发送控制台命令。请仅安装您完全信任的扩展文件。
管理命令:
/expansions list
/expansions reload
/expansions remove <id>
/expansions dev list
/expansions dev stop <id>
也可以使用更短的 /expans 别名。
?️ 服务器实用工具
ServerTools 目前包括:
/disconnect — 断开连接并显示可配置的消息
/stopserver [seconds] — 计划服务器关闭
/stopserver cancel — 取消计划的关闭
/servertools version — 显示已安装的版本
/servertools reload — 重新加载配置和扩展
/servertools disable — 禁用 ServerTools
/servertools verifyclient — 显示登录验证和客户端品牌信息
/servertools playeridentification — 显示玩家身份信息
/tz — 管理玩家时区
/specialitem — 管理配置的自定义物品
/expansions — 管理 Python 扩展
管理命令受 plugin.yml 中定义的权限保护。
? 模块化配置
ServerTools 将其主要配置存储在:
plugins/ServerTools/servertools.yml
配置默认值会自动加载,同时保留现有的服务器配置值。
示例:
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
? 安装
- 安装 Java 25。
- 下载
ServerTools-0.0.5-Beta.jar。
- 将 JAR 文件放入 Paper 26.2 或 Purpur 26.2 后端服务器的
plugins/ 目录中。
- 可选:安装 PlaceholderAPI 以启用
%servertools_time%。
- 可选:安装 TAB 以显示该占位符。
- 重启服务器。
- 编辑
plugins/ServerTools/servertools.yml。
- 重启服务器或运行
/servertools reload。
如果您的网络使用 Velocity、BungeeCord 或 Waterfall,请将 ServerTools 安装在 Paper/Purpur 后端服务器上,而不是代理服务器上。
描述由 CODEX 编写
? 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:
6:18 PM [EDT]
Timezone commands:
/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:
%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:
/specialitem give <item> [player]
/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:
plugins/ServerTools/expansions/
Expansions execute inside the Minecraft server and can dispatch console commands. Only install expansion files you fully trust.
Management commands:
/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 [seconds] — 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:
plugins/ServerTools/servertools.yml
Configuration defaults are loaded automatically, while existing server configuration values are preserved.
Example:
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
- Install Java 25.
- Download
ServerTools-0.0.5-Beta.jar.
- Place the JAR in the
plugins/ directory of a Paper 26.2 or Purpur 26.2 backend server.
- Optionally install PlaceholderAPI for
%servertools_time%.
- Optionally install TAB to display the placeholder.
- Restart the server.
- Edit
plugins/ServerTools/servertools.yml.
- Restart the server or run
/servertools reload.
If your network uses Velocity, BungeeCord, or Waterfall, install ServerTools on the Paper/Purpur backend servers—not on the proxy.
DESCRIPTION WRITTEN WITH CODEX
评论 0
登录后参与评分
还没有评论,来抢沙发吧