Minecraft Server Fixscrolls 插件

项目简介

Fixscrolls 是一个针对 Minecraft 1.12.2 服务器的插件，专注于提供高效的物品修复功能，支持修复Mod物品，为服务器玩家提供便捷的装备维护体验。

核心功能

• 全自动检测背包物品耐久度，低于80%时自动修复
• 支持修复Mod物品，适用于各种模组服务器
• 防连点器功能，防止玩家使用连点器作弊
• 灵活的指令系统，方便管理员管理修复卷轴
• 性能优化，减少服务器负担

技术特点

• 使用 JDK 8 开发，兼容 1.12.2 Minecraft 服务器
• 针对 Catserver 1.12.2 Mod 服进行了特别优化
• 实现了对象池化，减少内存占用
• 优化了遍历效率，提高检测速度
• 添加了性能监控，便于服务器管理员识别性能瓶颈

如何获得插件

• 购买构建体：联系作者 QQ 1640946640，支付 10 元即可获得构建好的插件
• 自行构建：克隆本仓库并使用 Maven 构建

安装教程

1. 构建插件：

   # 使用 Maven 构建
   mvn clean package

2. 安装插件：

   • 将构建好的 fixscrolls-1.0-SNAPSHOT-shaded.jar 文件重命名为 fixscrolls.jar
   • 将文件放入服务器的 plugins 文件夹中

3. 启动服务器：

   • 启动服务器，插件会自动加载
   • 首次启动会生成默认配置文件

使用说明

命令系统

命令	描述	权限
/fixscroll help	显示插件帮助信息	所有玩家
/fixscroll give <玩家> <耐久>	给玩家一个指定耐久的修复卷轴	OP
/fixscroll reload	重载插件配置	OP

修复机制

1. 当玩家背包或装备栏中的物品耐久度低于 80% 时，修复卷轴会自动触发
2. 修复卷轴会消耗自身耐久度来修复物品
3. 修复优先级：耐久度低的物品优先修复
4. 支持修复所有类型的物品，包括 Mod 添加的物品

防连点器功能

• 当玩家点击频率过高时，会收到警告
• 多次警告后仍继续使用连点器的玩家会被踢出服务器

配置文件说明

插件首次启动后会在 plugins/FixScrolls 目录生成 config.yml 文件，可根据需要进行修改：

# 支持修复的物品ID列表
# 可以添加更多Minecraft物品ID，包括Mod物品
ids:
  - 257  # 铁镐
  - 270  # 钻石镐
  - 274  # 铁斧
  - 278  # 钻石斧
  - 285  # 铁锄

# 防连点器阈值（毫秒）
# 当玩家点击间隔小于此值时，会被视为使用连点器
threshold: 200

# 修复卷轴的显示名称
# 支持颜色代码，使用&符号
name: "&d&l修理卷轴"

# 修复卷轴的物品类型ID
# 339 代表纸
item: 339

# 修复卷轴的描述文本
# %dur% 会被替换为实际的耐久值
lore:
  - "&e当物品耐久低于80%时"
  - "&e将会自动补满耐久值!"
  - "&a剩余耐久值: %dur%"

性能优化

为了确保插件在大型服务器上的流畅运行，我们进行了以下性能优化：

1. 降低任务调度频率：将检查任务的运行频率从 100 tick 降低到 200 tick
2. 实现对象池化：复用 SyncData、SyncItem 和 SyncMeta 实例，减少对象创建和垃圾收集
3. 优化遍历效率：使用 ConcurrentHashMap.newKeySet() 提高物品ID查找速度
4. 优化字符串操作：减少字符串对象的创建，提高处理速度
5. 添加性能监控：当检查任务执行时间超过 50ms 时，会在控制台输出日志

常见问题

Q: 插件不识别某些 Mod 物品怎么办？

A: 可以在 config.yml 文件的 ids 列表中添加该物品的 ID。

Q: 修复卷轴消耗过快怎么办？

A: 可以通过 /fixscroll give 命令给玩家发放更高耐久值的修复卷轴。

Q: 插件导致服务器卡顿怎么办？

A: 检查控制台是否有性能警告，如执行时间超过 50ms，考虑调整 config.yml 中的设置。

参与贡献

1. Fork 本仓库
2. 新建 Feat_xxx 分支
3. 提交代码
4. 新建 Pull Request

图片展示

联系方式

• 作者：Freak_64
• QQ：1640946640
• 版本：1.0

许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。