技术文档
概述
欢迎使用曙光插件文档中心。这里提供曙光团队所有 Minecraft 服务器插件和客户端 MOD 的完整技术文档。
产品涵盖经济系统、游戏玩法、服务器工具等多个领域,为服务器管理员提供稳定、高效、易用的方案。
环境要求
安装前请确认服务器满足以下条件:
服务器环境
- 服务端核心:Spigot 1.16.5+、Paper 1.16.5+、Arclight 1.16.5+
- Java 版本:Java 16+(建议 Java 17/21)
- 内存:建议 4GB 及以上
- 存储空间:每个插件约 5-50MB
客户端要求(MOD)
- Minecraft 版本:1.20.1 及以上
- Forge 版本:Forge 49.0.0+
注意:部分插件可能需要额外依赖(如 Vault、PlaceholderAPI),请查看各插件的具体说明。
安装指南
- 下载插件
从官方渠道下载最新版本的插件 JAR 文件 - 放置文件
将 JAR 文件复制到服务器的plugins/目录下plugins/ ShuguangTP.jar DeathPenalty.jar DogtagShop.jar ... - 重启服务器
使用/reload或完整重启服务器以加载插件 - 初始配置
插件会自动生成配置文件,前往plugins/[插件名]/目录进行自定义配置 - 验证安装
在控制台或游戏中执行/[插件命令] info验证插件是否正常运行
提示:首次安装后建议检查控制台日志,确保没有错误信息。
配置说明
曙光插件采用 YAML 格式配置文件,结构清晰、注释完善。
config.yml(通用配置)
# 插件开关
enabled: true
# 调试模式
debug: false
# 语言设置
locale: "zh_CN"
# 消息前缀
prefix: "&b[曙光]&r"
messages.yml(消息配置)
所有插件消息均可自定义,支持颜色代码和 PlaceholderAPI 占位符:
no-permission: "&c您没有权限执行此命令"
player-only: "&c此命令只能由玩家执行"
reload-success: "&a配置已重载!"
注意:修改配置后,建议使用 /[插件] reload 命令重载,而非直接重启服务器。
常见问题
Q1: 插件加载失败怎么办?
- 确认服务端核心版本与插件兼容
- 检查是否安装了必要的依赖插件
- 查看控制台错误日志
- 尝试使用最新版本的插件
Q2: 插件命令无响应?
- 缺少对应权限(需安装 LuckPerms 等权限插件)
- 命令被其他插件拦截
- 检查插件是否正确加载(
/plugins查看)
Q3: 如何获取技术支持?
- 加入 QQ 反馈群:点击加入
- 发送邮件至:2915948280@qq.com
- 提供服务器日志和插件版本信息以加快处理
Q4: 插件与其他插件冲突?
- 尝试禁用可能冲突的插件逐一排查
- 检查是否有重复功能的其他插件
- 将问题反馈给我们
获取帮助
如本文档未能解决您的问题,可通过以下方式联系我们:
提问技巧:请尽量提供插件版本、服务端核心版本、错误日志截图、操作步骤描述。