? OmniSuite – 你的全能实用插件
OmniSuite 将 SMP、社区服务器和活动所需的最重要生活质量(QoL)功能打包为一个轻量且模块化的插件。家园与传送点、TPA、RTP、管理、简易经济、邮箱、昵称/隐身、工具箱、背包(预览版)以及来自资源的蓝图——全部开箱即用。
✨ 亮点
• ? 家园:/sethome [name]、/home [name]、/delhome <name>、/homes —— 按玩家存储,数据保存在玩家 YAML 文件中。
• ? 传送点:/setwarp <name>、/warp <name>、/delwarp <name>、/warps —— 全局配置,存储在 config.yml 中。
• ? 出生点与返回:/setspawn、/spawn、/back —— 通过死亡监听器记录最后位置,出生点持久化保存。
• ? TPA 系统:/tpa <player>、/tpaccept、/tpdeny —— 简单稳健的请求机制(基于内存中的待处理映射表)。
• ? RTP:/rtp —— 随机传送,支持从 config.yml 配置半径和最小距离(rtp.radius, rtp.min-distance)。
• ? 实用工具:
• /Fly(切换飞行状态),
• /Gm <0|1|2|3> [player](切换游戏模式),
• /Feed [player](恢复饥饿值),
• /Repair(将物品耐久度重置为 0),
• /Uptime(显示自服务器启动以来的运行时间,格式为 h:m:s),
• /Afk(通过元数据切换 AFK 状态),
• /Hat(将手持物品作为头盔佩戴),
• /Sit(盔甲架坐下;潜行以站起)。
• ?⚖️ 管理功能:
• /Broadcast <message>(全服广播),
• /Mute <player> <seconds> & /unmute <player> —— 通过 mutedUntil 字段和聊天拦截器实现禁言。
• ℹ️ 信息命令:
• /Rules(读取 config.yml.rules 中的规则,支持 § 颜色代码),
• /Playtime(粗略统计自首次加入以来的小时数)。
• ? 邮件系统:/mail send <player> <message>、/mail inbox、/mail clear —— 每个玩家的邮件存储独立保存在玩家 YAML 文件中。
• ? 简易经济:/bal、/pay <player> <amount> —— 极其简单的 YAML 账户系统,无需外部依赖。
• ? 背包(预览版):/backpack —— 27 格背包容量;可从玩家 YAML 加载数据,关闭时自动保存功能尚待完善(需作为事件实现,参见代码注释)。
• ? 工具箱:/kits、/kit <name> —— 基于内存定义的示例工具箱(代码展示了附魔/物品的设置方式)。
• ? 昵称/隐身/PvP:
• /Nick <name>、/unnick,
• /Vanish(完全隐藏,包括标签页列表),
• /Pvp(按玩家切换 PvP 状态)。
• ? 蓝图粘贴:/schem <list|paste> [name]
• 基于资源文件的 .obp 文件(hub.obp、arena.obp、market.obp)+ palette.txt
• 相对于玩家位置的快速粘贴;使用资源块调色板。
⚙️ 配置与存储
• Config.yml:
• 聊天格式(支持 & 颜色代码格式化),
• 加入消息、退出消息,
• Rules:(多行服务器规则,支持 § 颜色代码),
• Rtp.radius、rtp.min-distance、rtp.cooldown-seconds(冷却值已预留,但当前命令尚未连接)。
• 玩家数据:plugins/OmniSuite/players/<uuid>.yml
• 保存内容包括:家园、背包槽位(若可用)、经济余额、邮件收件箱、昵称、PvP 状态等。
? 权限说明(节选)
• Omnisuite.use – 默认权限(default: true)
• Omnisuite.mod – 管理员命令(default: op)
• Omnisuite.admin – 超级管理员权限(default: op)
? 兼容性
• Api-version:1.21(POSTWORLD 加载)
• 已在 Paper / Purple / Folia / Spigot 上测试
• 基于 Java 21 构建
• 无外部依赖
? 已知限制 / 路线图
• 背包持久化:商店功能可用,但在关闭库存时保存数据的功能仍未完成(计划作为监听器实现)。
• RTP 冷却:config.yml 中已存在相关字段,命令挂钩将在后续版本中添加。
• 工具箱管理:目前仅存在于内存中;计划在未来版本中支持在 config.yml 中持久化定义工具箱。
• 邮件“已读”状态:已在命令帮助中提及,但目前尚未实现(当前支持发送、收件箱查看、清空)。
? 安装步骤
-
将 OmniSuite.jar 放入 /plugins 文件夹。
-
启动服务器 → 自动生成 config.yml 和玩家数据文件夹。
-
可选:自定义聊天格式、规则、RTP 参数等。
-
完成。
⸻
? 命令总览(紧凑版)
/Sethome, /home, /delhome, /homes, /setwarp, /warp, /delwarp, /warps , /setspawn, /spawn, /back, /tpa, /tpaccept, /tpdeny, /rtp, /fly, /gm, /feed, /repair, /uptime, /afk, /hat, /sit, /broadcast, /mute, /unmute, /rules, /playtime, /kits, /kits, /nick, /unnick, /vanish, /pvp, /backpack, /mail, /bal, /pay, /schem
⸻
? OmniSuite – Your all-in-one utility plugin
OmniSuite bundles the most important quality-of-life features for SMPs, community servers and events in one lightweight and modular plugin. Homes & Warps, TPA, RTP, Moderation, Economy light, Mailbox, Nick/Vanish, Kits, Backpack (preview) and even blueprints from resources – all out-of-the-box.
✨ Highlights
• ? Homes: /sethome [name], /home [name], /delhome <name>, /homes — per player, stored in player YAML.
• ? Warps: /setwerp <name>, /warp <name>, /delwarp <name>, /warps — serverwide in config.yml.
• ? Spawn & Back: /setspawn, /spawn, /back — last place via death listener, spawn persists.
• ? TPA system: /tpa <player>, /tpaccept, /tpdeny — simple, robust requests (in-memory pending-map).
• ? RTP: /rtp — random teleports with radius & minimum distance from config.yml (rtp.radius, rtp.min-distance).
• ?Utility:
• /Fly (toggle flies),
• /Gm <0|1|2|3> [player] (game mode),
• /Feed [player],
• /Repair (sets item damage to 0),
• /Uptime (since server start, h:m:s),
• /Afk (AFK toggle via metadata),
• /Hat (held item as a helmet),
• /Sit (ArmorStand sitting; sneak to get up).
• ?⚖️ Moderation:
• /Broadcast <message>,
• /Mute <player> <seconds> & /unmute <player> — mute via mutedUntil + chat interceptor.
• ℹ️ Info:
• /Rules (from config.yml.rules with § colour codes),
• /Playtime (rough since first-accession hours).
• ? Mail system: /mail send <player> <message>, /mail inbox, /mail clear — storage per player in player YAML.
• ? Economy light: /bal, /pay <player> <amount> — very simple YAML accounts without external dependencies.
• ? Backpack (Preview): /backpack — 27-slot inventory; Load from player YAML available, save when closing is still “to-do” as an event (see comment in the code).
• ? Kits: /kits, /kit <name> — In-memory-defined example kits (code shows setups with Enchants/Items).
• ? Nick/Vanish/PvP:
• /Nick <name>, /unnick,
• /Vanish (completely hidden, incl. tab),
• /Pvp (per-player toggle).
• ? Blueprint-Pastes: /schem <list|paste> [name]
• Resource-based .obp files (hub.obp, arena.obp, market.obp) + palette.txt
• Fast paste relative to player position; block palette of resources.
⚙️ Configuration & Storage
• Config.yml:
• Chat-format (formatting with & codes),
• Join-message, quit-message,
• Rules: (multi-line server rules, § colour codes supported),
• Rtp.radius, rtp.min-distance, rtp.cooldown-seconds (cooldown value is already prepared; not yet wired in the current command).
• Player data: plugins/OmniSuite/players/<uuid>.yml
• Saves e.o. Homes, Backpack slots (if available), Economy balance, Mail inbox, Nicknames, PvP status.
? Permissions (excerpt)
• Omnisuite.use – Default (default: true)
• Omnisuite.mod – Moderator commands (default: op)
• Omnisuite.admin – Admin rights (default: op)
? Compatibility
• Api-version: 1.21 (POSTWORLD-Load)
• Tested for Paper / Purple / Folia / Spigot
• Java 21 Build
• No external dependencies
? Known boundaries / Roadmap
• Backpack-Persistence: Shop available, Storage at inventory-Close is still open (planned as listener).
• RTP-Cooldown: Field exists in config.yml, hook in the command follows.
• Kits management: Currently in-memory; persistent kit definitions in config are planned.
• Mailbox "read": Mentioned in Command-Help, but currently not implemented (present: send, inbox, clear).
? Installation
-
Place OmniSuite.jar in /plugins.
-
Start server → config.yml & player folders are created.
-
Optionally customise chat format, rules, RTP parameters, etc.
-
Done.
⸻
? Command overview (compact)
/Sethome, /home, /delhome, /homes, /setwarp, /warp, /delwarp, /warps , /setspawn, /spawn, /back, /tpa, /tpaccept, /tpdeny, /rtp, /fly, /gm, /feed, /repair, /uptime, /afk, /hat, /sit, /broadcast, /mute, /unmute, /rules, /playtime, /kits, /kits, /nick, /unnick, /vanish, /pvp, /backpack, /mail, /bal, /pay, /schem
⸻
评论 0
登录后参与评分
还没有评论,来抢沙发吧