?️ QTotems
你好!欢迎使用 QTotems——一款高度可定制的 Minecraft 插件,允许你配置拥有独特被动(手持)增益和主动(触发)效果的自定义不死图腾。无论你是想在玩家手持冰之图腾时给予加速效果,还是让他们在复活时产生巨大的吸收之心爆炸,QTotems 都通过一个简单的配置文件直接处理这一切。
没有硬编码的效果。没有混乱的设置。只需自定义、重载并开始触发吧!
✨ 功能概览
- 基于配置的自定义图腾: 直接在
config.yml 下的 totems: 中定义任意数量的自定义图腾。
- 双状态药水效果:
- 装备效果(被动): 当玩家在手中持有/装备图腾时持续施加的增益。
- 触发效果(主动): 当玩家触发图腾以逃避死亡时立即触发的自定义药水效果。
- 精美的 Lore 与名称格式: 完全支持现代 Adventure/MiniMessage 样式(颜色、渐变、加粗)以及旧版 Minecraft 格式化(
& 颜色代码)。
- 动态注册表: 使用
enabled: true/false 配置标志即时启用或禁用图腾。
- 无缝重载: 在游戏中运行
/totems reload 或通过控制台执行,即可即时应用配置更改,无需重启服务器。
- 安全机制: 安全处理缺失的配置参数,在控制台中打印清晰的警告而非崩溃,并在断开连接时安全重置玩家效果。
?️ 命令参考
该插件注册了主命令 /totems,别名包括 /qtotems 和 /qtotem。
| 命令 |
权限 |
描述 |
/totems |
qtotems.command |
显示插件使用说明。 |
/totems reload |
qtotems.command |
重新加载配置并重新注册所有活动的图腾。(可从控制台运行!) |
/totems <totem> |
qtotems.command |
将一个自定义图腾物品生成到你的物品栏中。 |
/totems <totem> <player> |
qtotems.command |
将一个自定义图腾物品生成到目标玩家的物品栏中。 |
标签补全
插件支持完整的标签补全:
- 第一个参数:补全系统中注册的活跃图腾 ID(以及
reload)。
- 第二个参数:补全在线玩家名称(仅在选择有效的图腾 ID 时)。
? 权限
qtotems.command
- 描述: 允许访问主命令结构(
/totems、重载以及给予/生成图腾)。
- 默认值:
op(默认仅限管理员;可通过 LuckPerms 或其他权限管理器分配)。
⚙️ 配置指南 (config.yml)
插件配置文件位于 src/main/resources/config.yml(或在实际服务器上为 plugins/QTotems/config.yml)。
主要部分
prefix: 附加在所有插件消息前的消息前缀。支持 MiniMessage XML 格式化。
totems: 包含图腾 ID 的字典映射:
enabled:如果为 false,则忽略该图腾且不进行注册。
name:物品的显示名称。
lore:物品工具提示中显示的各行文本列表。
popEffects:格式为 "effect_name;amplifier;duration_in_ticks;ambient;particles;icon"。
equipEffects:格式为 "effect_name;amplifier;ambient;particles;icon"。
messages: 用于插件反馈的可定制翻译消息。
格式详情
[NOTE]
- 增强等级(Amplifiers): 在 Minecraft/Spigot 中,增强等级是 从 0 开始索引 的。这意味着
0 代表 I 级,1 代表 II 级,依此类推。
- 持续时间: 触发效果的持续时间以 服务器刻(ticks) 为单位测量(20 刻 = 1 秒)。
?️ QTotems
Hey there! Welcome to QTotems—a highly customizable Minecraft plugin that lets you configure custom Totems of Undying with their own unique passive (equipped) buffs and active (pop) effects. Whether you want to give players a speed boost while holding an Ice Totem or resurrect them with giant explosions of absorption hearts, QTotems handles it all directly via a simple config file.
No hardcoded effects. No messy setups. Just customize, reload, and start popping!
✨ Features at a Glance
- Config-Driven Custom Totems: Define as many custom totems as you like directly under
totems: in config.yml.
- Dual-State Potion Effects:
- Equip Effects (Passive): Buffs applied continuously to the player while they are holding/equipping the totem in their hand.
- Pop Effects (Active): Custom potion effects that trigger immediately when a player pops their totem to cheat death.
- Beautiful Lore & Name Formatting: Full support for modern Adventure/MiniMessage styling (colors, gradients, bolding) and legacy Minecraft formatting (
& color codes).
- Dynamic Registries: Instantly enable or disable totems using the
enabled: true/false config flag.
- Seamless Reloading: Run
/totems reload in-game or from the console to apply configuration changes instantly without server restarts.
- Failsafe Mechanics: Safely handles missing config parameters, prints clear warnings to console instead of crashing, and safely resets player effects on disconnect.
?️ Command Reference
The plugin registers the main command /totems with aliases /qtotems and /qtotem.
| Command |
Permission |
Description |
/totems |
qtotems.command |
Displays plugin usage message. |
/totems reload |
qtotems.command |
Reloads the configuration and re-registers all active totems. (Can be run from console!) |
/totems <totem> |
qtotems.command |
Spawns one custom totem item into your own inventory. |
/totems <totem> <player> |
qtotems.command |
Spawns one custom totem item into target player's inventory. |
Tab Completion
The plugin supports complete tab completion:
- First argument: Completes active totem IDs registered in the system (and
reload).
- Second argument: Completes online player names (only if a valid totem ID is selected).
? Permissions
qtotems.command
- Description: Allows access to the main command structure (
/totems, reload, and giving/spawning totems).
- Default:
op (Admin only by default; can be assigned via LuckPerms or other permission managers).
⚙️ Configuration Guide (config.yml)
The plugin configuration is located at src/main/resources/config.yml (or plugins/QTotems/config.yml on a live server).
Main Sections
prefix: The message prefix prefixed to all plugin messages. Supports MiniMessage XML formatting.
totems: A dictionary map of totem IDs containing:
enabled: If false, the totem is ignored and not registered.
name: The display name of the item.
lore: List of lines shown on the item tooltip.
popEffects: Format "effect_name;amplifier;duration_in_ticks;ambient;particles;icon".
equipEffects: Format "effect_name;amplifier;ambient;particles;icon".
messages: Customizable translation messages for plugin feedback.
Format Details
[NOTE]
- Amplifiers: In Minecraft/Spigot, amplifiers are 0-indexed. This means
0 represents Level I, 1 represents Level II, etc.
- Durations: Pop durations are measured in server ticks (20 ticks = 1 second).
评论 0
登录后参与评分
还没有评论,来抢沙发吧