KTPlus
适用于 Paper 和 Folia 的增强型击杀特效插件
KTPlus 是 KT 的进化形态:当“几个击杀特效”不再满足需求时,KT 便成为了它。
KT 是起点。KTPlus 则是重构:更多的特效、真正的商店、持久化的货币、可靠的存储、对 Folia 的支持,以及你在繁忙服务器上真正需要的管理工具。
玩家打开 /kt,购买一个特效,获得一次击杀,特效随即播放。对玩家而言简单直观,底层逻辑却严谨扎实。
为什么选择 KTPlus
不是简单的重命名。而是来自 KT 的完整升级路径。
| KT 的起点 |
KTPlus 的演进 |
| 扎实的击杀特效理念 |
71 种内置特效,包含稀有度、价格、加成、会话机制 |
| 基础的选择流程 |
完整的商店 GUI,支持分类、筛选、余额显示 |
| 简单的数据持久化 |
SQLite / MySQL / MariaDB / PostgreSQL + Flyway |
| 仅聚焦 Paper |
支持 Paper 1.21.x 和 26.x,并兼容 Folia |
| 有限的钩子接口 |
Vault, LuckPerms, WorldGuard, PlaceholderAPI |
| 基础的管理功能 |
重载、预览、迁移、奖励审查、性能控制 |
如果你之前运行过 KT:这就是那个既保留原有特色又大幅提升上限的版本。
概览
|
|
| 特效 |
71 种内置,从普通到超级稀有 |
| GUI |
商店与选择器,支持分类、滚动、筛选 |
| 经济系统 |
内置 KillCoins,或对接 Vault |
| 数据库 |
SQLite, MySQL, MariaDB, PostgreSQL |
| 平台 |
Paper 1.21.x / 26.x · Folia · Java 21+ |
| 命令 |
/ktplus · /kt · /killeffect |
击杀特效
插件自带 71 种特效。每种特效都可以拥有独立的价格、高级价格、分类、伤害规则和加成效果。当特效触发时,KTPlus 会开启一个会话:临时方块、粒子、实体,必要时还会加载结构文件(schematics),并在结束后自动清理。
- 稀有度阶梯:从普通到超级稀有
- 管理员预览:使用
/kt test <effect> 查看
- 世界规则:可在大厅、出生点或任何指定世界中禁用特效
- WorldGuard 兼容:针对改变方块的特效提供区域检测,并支持工作人员豁免
在 effects.yml 中调整整个目录。修改价格,重载配置,即刻生效。
商店 GUI
按分类浏览,滚动列表,进行筛选,查看余额,购买并选择。GUI 的设计旨在让玩家首次打开时就能一目了然。底层基于 Inventory Framework 构建,如果库出现异常,则回退到原版库存界面。
想要为特定特效自定义音效?只需将 resource-pack.yml 指向你的资源包,设置哈希值和强制模式,KTPlus 即可在玩家加入时推送该资源包。
经济系统
| 提供者 |
功能说明 |
| KILLCOINS |
在 KTPlus 数据库中内置余额。无需额外插件。 |
| VAULT |
使用现有的经济系统。需要安装 Vault 和经济类插件。 |
为玩家击杀支付奖励(玩家击杀和怪物击杀有独立的调节旋钮),设置初始余额,重命名货币标签。管理员可使用 /kt killcoins 管理余额。
安装 LuckPerms 后,你可以设定当玩家购买某特效时自动授予相应权限。这非常适合用于实现基于等级的外观限制,而无需编写额外的插件。
enabled: true
provider: KILLCOINS
starting-balance: 0
kill-reward:
enabled: true
player: 10
mob: 1
数据库
解锁内容和余额之所以能在重启后保留,是因为它们存储在真正的数据库中。
Flyway 会在启动时应用数据库架构变更。你不需要为了启动服务器而去手动编辑 SQL 文件。
| 引擎 |
运行时支持 |
Flyway 支持 |
游戏内迁移 |
| SQLite |
是(默认) |
是 |
至/从 MySQL |
| MySQL 8+ |
是 |
是 |
至/从 SQLite |
| MariaDB |
是 |
是 |
需外部工具 |
| PostgreSQL |
是 |
是 |
需外部工具 |
打算从单文件数据库扩展?在提交之前,/kt migrate 可以在 Dry Run(试运行)和安全标志的保护下,将 SQLite 迁移至 MySQL(反之亦然)。
/kt migrate <sqlite|mysql> [--dry-run] [--include-temp-blocks]
[--force-pending-inventory] [--allow-nonempty-target]
<confirmation-token>
评价奖励
支持本项目,获取金币。经过验证,而非依赖诚信系统。
| 平台 |
要求 |
奖励 |
| GitHub |
Star KTPlus 仓库 |
500 金币 |
| SpigotMC |
给出 4 星或以上的评论 |
100 x 星级(上限 500) |
- 玩家使用其 平台用户名 开始,而非 Minecraft 游戏 ID (IGN)
- 验证窗口持续 300 秒,每 15 秒 轮询一次
- 验证成功:记录领取状态,支付金币,发送简短广播
- 每个 Minecraft 玩家和每个平台账号仅限领取一次
- 已领取?仅显示领取消息。无垃圾信息轰炸。
/kt review github <github-username>
/kt review spigotmc <spigot-username>
平台与性能
分离的 NMS 桥接。正确的桥接将在运行时加载。
Paper 涵盖 1.21 系列及 Paper 26.x。Folia 在兼容构建版本上支持区域感知调度。
当服务器压力较大时,performance.yml 可确保会话、冷却时间和 TPS 节流处于可控范围。
启动日志会告诉你加载了什么、钩住了哪些插件以及当前使用的是哪种存储。
1.21 · 1.21.1 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6
1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
26.1.x · 26.2.x+ · Folia · Java 21+
集成
| 插件 |
角色 |
| Vault |
当提供程序为 VAULT 时的外部经济系统 |
| LuckPerms |
购买时自动授予权限 |
| WorldGuard |
对改变方块的特效进行区域检查 |
| PlaceholderAPI |
提供 %ktplus_...% 格式的动态占位符 |
此外还包含:更新检查器和 bStats 指标统计。
PlaceholderAPI
| 占位符 |
含义 |
%ktplus_version% |
插件版本 |
%ktplus_name% / %ktplus_plugin% |
插件名称 |
%ktplus_author% |
作者 |
%ktplus_provider% |
经济提供者 |
%ktplus_economy% |
经济系统是否启用(是 / 否) |
%ktplus_effect_count% |
已注册的特效数量 |
%ktplus_balance% / %ktplus_coins% |
玩家余额 |
%ktplus_balance_formatted% |
格式化后的余额 |
%ktplus_selected% / %ktplus_effect% |
已选中的特效 ID |
%ktplus_selected_name% |
已选中的显示名称 |
%ktplus_selected_price% |
已选中的价格 |
%ktplus_selected_category% |
已选中的分类 |
%ktplus_has_selected% |
是否有选中项 |
%ktplus_unlocked_count% |
已拥有数量 |
%ktplus_locked_count% |
未解锁数量 |
%ktplus_owns_<effectId>% |
是否拥有该特效(是 / 否) |
%ktplus_unlocked_<effectId>% |
是否可以激活(是 / 否) |
命令
基础: /ktplus
别名: /kt · /killeffect
| 命令 |
功能 |
权限 |
/kt |
打开特效 GUI |
玩家 |
/kt reload |
重新加载配置 |
ktplus.reload |
/kt set <effect> [player] |
选择特效 |
ktplus.set / .others |
/kt clear [player] |
清除选择 |
ktplus.clear / .others |
/kt test <effect> |
在你所在位置预览 |
ktplus.test |
/kt killcoins bal [player] |
查看余额 |
ktplus.killcoins |
/kt killcoins add|take|set|reset ... |
编辑余额 |
ktplus.killcoins.admin |
/kt review <github|spigotmc> <account> |
领取评价奖励 |
玩家 |
/kt migrate <sqlite|mysql> ... |
迁移数据库 |
ktplus.migrate |
权限
| 权限 |
默认值 |
描述 |
ktplus.admin |
op |
管理访问权限 |
ktplus.admin.bypass |
op |
绕过限制 |
ktplus.reload |
op |
重载配置 |
ktplus.migrate |
op |
数据库迁移 |
ktplus.set |
true |
选择自己的效果 |
ktplus.set.others |
op |
为他人选择效果 |
ktplus.clear |
true |
清除自己的效果 |
ktplus.clear.others |
op |
清除他人的效果 |
ktplus.test |
op |
预览效果 |
ktplus.killcoins |
true |
查看余额 |
ktplus.killcoins.admin |
op |
编辑余额 |
ktplus.worldguard.bypass |
op |
跳过 WorldGuard 检查 |
ktplus.<effectId>.use |
|
单个效果的权限 |
配置
将 jar 文件放入 plugins/ 目录,启动一次后,在 plugins/KTPlus/ 下编辑配置文件。
| 文件 |
用途 |
config.yml |
全局设置、世界、WorldGuard / LuckPerms、结构图(schematics) |
effects.yml |
完整效果目录 |
economy.yml |
经济提供商、奖励、货币标签 |
gui.yml |
商店布局与物品 |
database.yml |
数据库引擎、凭据、连接池 |
messages.yml |
面向玩家的消息 |
performance.yml |
会话限制、冷却时间、TPS 节流 |
| resource-pack.yml | 资源包 URL、哈希值、必需标志、音效键 |
| events.yml | 可选的随机服务器事件 |
快速开始
- 将 jar 文件放入
plugins/ 目录并启动一次
/kt killcoins add <玩家> 1000
/kt
- 购买或选择一项效果
- 击杀一名玩家
首次启动时会下载 Paper 库。PacketEvents 由 KTPlus 自带的加载器提供,请确保第一次启动时环境干净。
依赖要求
| 需求 |
最低要求 |
| 服务器端 |
Paper 1.21.1+ 或 Paper 26.x |
| Java |
21+ |
| Folia |
兼容构建版本支持 |
| 可选软依赖 |
Vault · LuckPerms · WorldGuard · PlaceholderAPI |
链接
|
|
| GitHub |
|
| Issues |
|
| bStats |
|
| License |
GPL 3.0 |
KTPlus
The enhanced kill effects plugin for Paper and Folia
KTPlus is what KT grew into when "a few kill effects" stopped being enough.
KT was the start. KTPlus is the rebuild: more effects, a real shop, money that persists, storage you can trust, Folia support, and the ops tools you actually need on a busy server.
You open /kt, buy an effect, get a kill, and it plays. Simple for players. Serious underneath.
Why KTPlus
Not a rename. A proper upgrade path from KT.
| Where KT started |
Where KTPlus goes |
| A solid kill effects idea |
71 built in effects, rarities, prices, perks, sessions |
| Basic selection flow |
Full shop GUI with categories, filters, balance on screen |
| Simple persistence |
SQLite / MySQL / MariaDB / PostgreSQL + Flyway |
| Paper focused |
Paper 1.21.x and 26.x, with Folia support |
| Few hooks |
Vault, LuckPerms, WorldGuard, PlaceholderAPI |
| Admin basics |
Reload, preview, migrate, review rewards, performance controls |
If you ran KT before: this is the version that keeps the identity and raises the ceiling.
At a glance
|
|
| Effects |
71 built in, common to ultra |
| GUI |
Shop and selector, categories, scroll, filters |
| Economy |
KillCoins built in, or Vault |
| Database |
SQLite, MySQL, MariaDB, PostgreSQL |
| Platform |
Paper 1.21.x / 26.x · Folia · Java 21+ |
| Commands |
/ktplus · /kt · /killeffect |
Kill effects
A catalog that feels like progression, not a dump of icons.
71 effects ship with the plugin. Each one can carry its own price, premium price, category, damage rules, and perks. When an effect runs, KTPlus opens a session: temporary blocks, particles, entities, schematics if needed, then cleans up after itself.
- Rarity ladder from common to ultra
- Admin preview with
/kt test <effect>
- World rules to disable effects in lobby, spawn, or any world you name
- WorldGuard awareness for block changing effects, plus a staff bypass
Tune the whole catalog in effects.yml. Change a price, reload, done.
The shop GUI
Players type /kt. That is usually enough.
Browse by category, scroll the list, filter, see your balance, buy, select. The GUI is meant to be obvious on first open. Under the hood it uses Inventory Framework, with a vanilla inventory fallback if the library stack misbehaves.
Want custom sounds for specific effects? Point resource-pack.yml at your pack, set the hash and required mode, and KTPlus can push it on join.
Economy
Two modes. Pick what already fits your network.
| Provider |
What it does |
| KILLCOINS |
Built in balance in the KTPlus database. No extra plugins required. |
| VAULT |
Uses your existing economy. Needs Vault + an economy plugin. |
Pay players for kills (players and mobs are separate knobs), set a starting balance, rename currency labels. Admins manage balances with /kt killcoins.
With LuckPerms installed, you can grant a permission automatically when someone buys an effect. Useful for rank gated cosmetics without writing a second plugin.
enabled: true
provider: KILLCOINS
starting-balance: 0
kill-reward:
enabled: true
player: 10
mob: 1
Database
Unlocks and balances survive restarts because they live in a real database.
Flyway applies schema on startup. You are not hand editing SQL just to open the server.
| Engine |
Runtime |
Flyway |
In game migrate |
| SQLite |
Yes (default) |
Yes |
To / from MySQL |
| MySQL 8+ |
Yes |
Yes |
To / from SQLite |
| MariaDB |
Yes |
Yes |
External tools |
| PostgreSQL |
Yes |
Yes |
External tools |
Growing past a single file DB? /kt migrate moves SQLite to MySQL (and back) with dry run and safety flags before you commit.
/kt migrate <sqlite|mysql> [--dry-run] [--include-temp-blocks]
[--force-pending-inventory] [--allow-nonempty-target]
<confirmation-token>
Review rewards
Support the project, get coins. Verified, not honour system.
| Platform |
Requirement |
Reward |
| GitHub |
Star the KTPlus repository |
500 coins |
| SpigotMC |
Review with 4 stars or more |
100 x stars (cap 500) |
- Player starts with their platform username, not the Minecraft IGN
- Verification window lasts 300 seconds, polled every 15 seconds
- On success: claim stored, coins paid, short broadcast
- One claim per Minecraft player and per platform account
- Already claimed? Just the claim message. No lecture spam.
/kt review github <github-username>
/kt review spigotmc <spigot-username>
Platform and performance
Separate NMS bridges. The right one loads at runtime.
Paper across the 1.21 line and Paper 26.x. Folia on compatible builds with region aware scheduling.
When the server is under pressure, performance.yml keeps sessions, cooldowns, and TPS throttling under control.
Boot logging tells you what loaded, what hooked, and which storage you are on.
1.21 · 1.21.1 · 1.21.3 · 1.21.4 · 1.21.5 · 1.21.6
1.21.7 · 1.21.8 · 1.21.9 · 1.21.10 · 1.21.11
26.1.x · 26.2.x+ · Folia · Java 21+
Integrations
All optional. Install what you use.
| Plugin |
Role |
| Vault |
External economy when provider is VAULT |
| LuckPerms |
Permission grant on purchase |
| WorldGuard |
Region checks for block changing effects |
| PlaceholderAPI |
Live placeholders under %ktplus_...% |
Also included: update checker and bStats metrics.
PlaceholderAPI
| Placeholder |
Meaning |
%ktplus_version% |
Plugin version |
%ktplus_name% / %ktplus_plugin% |
Plugin name |
%ktplus_author% |
Authors |
%ktplus_provider% |
Economy provider |
%ktplus_economy% |
Economy enabled (yes / no) |
%ktplus_effect_count% |
Registered effects |
%ktplus_balance% / %ktplus_coins% |
Player balance |
%ktplus_balance_formatted% |
Formatted balance |
%ktplus_selected% / %ktplus_effect% |
Selected effect id |
%ktplus_selected_name% |
Selected display name |
%ktplus_selected_price% |
Selected price |
%ktplus_selected_category% |
Selected category |
%ktplus_has_selected% |
Has a selection |
%ktplus_unlocked_count% |
Owned count |
%ktplus_locked_count% |
Locked count |
%ktplus_owns_<effectId>% |
Owns effect (yes / no) |
%ktplus_unlocked_<effectId>% |
Can activate (yes / no) |
Commands
Base: /ktplus
Aliases: /kt · /killeffect
| Command |
What it does |
Permission |
/kt |
Open the effects GUI |
Players |
/kt reload |
Reload configs |
ktplus.reload |
/kt set <effect> [player] |
Select an effect |
ktplus.set / .others |
/kt clear [player] |
Clear selection |
ktplus.clear / .others |
/kt test <effect> |
Preview at your location |
ktplus.test |
/kt killcoins bal [player] |
Show balance |
ktplus.killcoins |
/kt killcoins add|take|set|reset ... |
Edit balances |
ktplus.killcoins.admin |
/kt review <github|spigotmc> <account> |
Claim review reward |
Players |
/kt migrate <sqlite|mysql> ... |
Migrate database |
ktplus.migrate |
Permissions
| Permission |
Default |
Description |
ktplus.admin |
op |
Administrative access |
ktplus.admin.bypass |
op |
Bypass restrictions |
ktplus.reload |
op |
Reload configs |
ktplus.migrate |
op |
Database migration |
ktplus.set |
true |
Select own effect |
ktplus.set.others |
op |
Select for others |
ktplus.clear |
true |
Clear own effect |
ktplus.clear.others |
op |
Clear for others |
ktplus.test |
op |
Preview effects |
ktplus.killcoins |
true |
View balances |
ktplus.killcoins.admin |
op |
Edit balances |
ktplus.worldguard.bypass |
op |
Skip WorldGuard checks |
ktplus.<effectId>.use |
|
Per effect usage |
Configuration
Drop the jar in plugins/, start once, edit under plugins/KTPlus/.
| File |
Job |
config.yml |
Globals, worlds, WorldGuard / LuckPerms, schematics |
effects.yml |
Full effect catalog |
economy.yml |
Provider, rewards, currency labels |
gui.yml |
Shop layout and items |
database.yml |
Engine, credentials, pool |
messages.yml |
Player facing messages |
performance.yml |
Session limits, cooldowns, TPS throttling |
resource-pack.yml |
Pack URL, hash, required flag, sound keys |
events.yml |
Optional random server events |
Most changes apply with /kt reload.
Quick start
- Put the jar in
plugins/ and start once
/kt killcoins add <player> 1000
/kt
- Buy or select an effect
- Get a kill
First boot downloads Paper libraries. PacketEvents is prepared by KTPlus' own loader. Give it a clean first start.
Requirements
| Need |
Minimum |
| Server |
Paper 1.21.1+ or Paper 26.x |
| Java |
21+ |
| Folia |
Supported on compatible builds |
| Optional soft depends |
Vault · LuckPerms · WorldGuard · PlaceholderAPI |
Links
|
|
| GitHub |
|
| Issues |
|
| bStats |
|
| License |
GPL 3.0 |
KTPlus
KT, rebuilt properly.
评论 0
登录后参与评分
还没有评论,来抢沙发吧