TaxCollector

Minecraft 1.21.8 Folia 税收系统插件

为服务器添加完整的三种税收机制：城镇税收、个人所得税、服务器维护费。支持阶梯税率、定时收取、实时扣税和全面的插件兼容。

功能特性

三种税种

税种	触发方式	说明
城镇税收	每周定时	按城镇银行余额阶梯收取，接管 Towny 税收
个人所得税	每笔收入	系统收购、箱子商店出售、红包收入时实时扣税
服务器维护费	每次交易	转账、发红包、箱子商店购买时扣取

城镇税收阶梯（默认配置）

城镇银行余额	税率
< 1,000	免税
1,001 - 10,000	每周 0.5%
10,001 - 50,000	每周 1%
50,001 - 100,000	每周 5%
100,001 - 500,000	每周 8%
500,001 - 1,000,000	每周 13%
1,000,001 - 5,000,000	每周 30%
> 5,000,001	每周 35%

个人所得税阶梯（默认配置）

单笔收入	税率
< 5,000	免税
5,001 - 20,000	每笔 5%
20,001 - 100,000	每笔 8%
100,001 - 500,000	每笔 13%
> 500,001	每笔 30%

服务器维护费阶梯（默认配置）

交易金额	费率
< 50,000	免费
50,001 - 100,000	每次 5%
100,001 - 500,000	每次 8%
500,001 - 1,500,000	每次 13%
1,500,001 - 5,000,000	每次 26%
> 5,000,001	每次 35%

插件兼容

插件	状态	说明
Vault	必需	经济系统接口
Towny	可选	城镇税收接管
QuickShop-Hikari	可选	箱子商店交易监听
GlobalMarketPlus	可选	全球市场交易监听
PlaceholderAPI	可选	占位符变量支持

命令

命令	权限	说明
/tax	taxcollector.use	查看个人税务信息
/tax info	taxcollector.use	查看税率表
/tax check <玩家>	taxcollector.check	查看其他玩家税务
/tax top	taxcollector.use	纳税排行榜 TOP 10
/tax admin reload	taxcollector.admin	重载配置
/tax admin collect	taxcollector.admin	手动触发城镇税收
/tax admin exempt <玩家>	taxcollector.admin	切换玩家免税状态

PlaceholderAPI 占位符

占位符	说明
%taxcollector_total_paid%	累计缴税总额
%taxcollector_income_tax_paid%	累计所得税
%taxcollector_maintenance_fee_paid%	累计维护费
%taxcollector_town_tax_paid%	累计城镇税
%taxcollector_income_tax_rate%	当前所得税率
%taxcollector_maintenance_fee_rate%	当前维护费率
%taxcollector_town_tax_rate%	当前城镇税率
%taxcollector_last_tax%	上次缴税金额
%taxcollector_exempt%	是否免税

权限节点

权限	默认	说明
taxcollector.use	所有人	基本查询
taxcollector.check	OP	查看他人税务
taxcollector.admin	OP	管理员操作
taxcollector.exempt.income	无	免除所得税
taxcollector.exempt.maintenance	无	免除维护费
taxcollector.exempt.town	无	免除城镇税

安装

1. 将 TaxCollector-1.0.0.jar 放入服务器 plugins/ 目录
2. 确保已安装 Vault 及其经济提供者（如 EssentialsX）
3. 启动服务器
4. 编辑 plugins/TaxCollector/config.yml 调整税率
5. 执行 /tax admin reload 重载配置

构建

./gradlew build

输出文件：build/libs/TaxCollector-1.0.0.jar

环境要求

• Java 21+
• Folia 1.21.8 或兼容的 Paper/Folia 服务端
• Vault + 经济提供者