踏海

Appearance

快速开始 ​

本指南将带你在 5 分钟内体验踏海的完整功能。

访问平台 ​

打开浏览器，访问：https://minecraft-dev-platform.pages.dev

第一步：描述需求 ​

点击"开始对话"进入对话页面，在输入框中描述你的插件需求。

示例需求 ​

请帮我完成一个玩家进服后被踢出并提示正在维护的插件，
并且支持用 /setNotice 命令设置踢出时的提示

需求描述技巧 ​

明确功能点：

  • ● "玩家进服时发送欢迎消息"
  • × "做一个好用的插件"

指定触发条件：

  • ● "玩家右键点击告示牌时传送"
  • × "实现传送功能"

说明配置需求：

  • ● "支持用命令修改欢迎消息"
  • × "可以配置"

提及权限控制（可选）：

  • ● "只有 OP 可以使用 /reload 命令"
  • "所有玩家都可以使用"

第二步：选择核心和版本 ​

AI 分析需求后，会提示你选择：

核心类型 ​

  • Paper（推荐）：性能优化，API 丰富
  • Bukkit：经典核心，兼容性好
  • Spigot：Bukkit 的优化版
  • Forge：模组开发
  • Fabric：轻量级模组开发

MC 版本 ​

  • 1.21、1.20.6、1.20.4、1.20.1
  • 1.19.4、1.18.2、1.17.1、1.16.5
  • 1.12.2、1.8.8、1.7.10

建议：如果不确定，选择 Paper + 1.20.6（最新稳定版）

第三步：查看开发步骤 ​

AI 会生成结构化的开发步骤，展示插件的实现逻辑。

步骤示例 ​

步骤 1：监听玩家加入事件
- 事件：PlayerJoinEvent
- 方法：onPlayerJoin(PlayerJoinEvent event)
- 参数：event - 玩家加入事件对象

步骤 2：从配置文件读取提示消息
- 方法：getConfig().getString("notice")
- 参数：notice - 配置键名

步骤 3：踢出玩家并显示消息
- 方法：player.kickPlayer(String message)
- 参数：message - 踢出时显示的文本

步骤 4：注册 /setNotice 命令
- 命令：/setNotice <消息>
- 权限：maintenance.setnotice
- 功能：更新配置文件中的提示消息

这些步骤帮助你理解插件的工作原理，即使不懂代码也能看懂逻辑。

第四步：生成项目 ​

点击"生成项目 & 构建 JAR"按钮，开始自动生成。

生成过程 ​

系统会依次执行：

  1. 规划阶段（10-20 秒）

    • Planner 分析需求，生成文件树
    • 确定需要哪些 Java 类、配置文件

  2. 生成阶段（1-2 分钟）

    • 逐个生成文件（pom.xml、plugin.yml、Java 代码）
    • 每个文件经过 reChecker 审查
    • 发现问题自动修正

  3. 校验阶段（5 秒）

    • 检查文件完整性
    • 确保所有计划的文件都已生成

  4. 构建阶段（2-3 分钟）

    • 上传到 GitHub 临时分支
    • 触发 Maven 构建
    • 等待 Actions 完成

  5. 完成

    • 显示下载按钮
    • 点击下载 JAR 文件

第五步：下载和使用 ​

下载 JAR ​

点击"下载 JAR"按钮，获得一个 ZIP 文件，解压后得到 .jar 文件。

安装插件 ​

  1. 将 JAR 文件放入服务器的 plugins 目录
  2. 重启服务器或执行 /reload confirm
  3. 插件自动加载

测试功能 ​

测试维护模式：

  1. 玩家尝试进入服务器
  2. 被踢出并显示默认提示："服务器正在维护，请稍后再试"

修改提示消息：

  1. OP 执行命令：/setNotice 服务器升级中，预计 30 分钟后开放
  2. 配置文件自动更新
  3. 下次玩家进服时显示新消息

常见问题 ​

生成失败怎么办？ ​

AI 分析失败：

  • 检查需求描述是否清晰
  • 尝试简化需求，分多次生成

构建失败：

  • 查看日志中的错误信息
  • 可能是 AI 生成的代码有语法错误（极少见）
  • 联系开发者反馈问题

生成的插件不符合预期？ ​

  • 重新描述需求，更详细地说明功能
  • 使用"重新生成"功能，在原需求基础上追加说明
  • 下载源码后手动修改（需要 Java 知识）

支持哪些功能？ ​

适合生成的插件：

  • 事件监听（玩家加入/退出/聊天/破坏方块等）
  • 简单命令（传送、给予物品、修改游戏模式）
  • 配置文件读写
  • 定时任务（每隔 X 秒执行某操作）
  • 权限检查

不适合生成的插件：

  • 复杂的经济系统
  • RPG 系统（技能树、职业、属性）
  • 小游戏（需要复杂的状态管理）
  • 数据库集成（MySQL/MongoDB）

生成的代码安全吗？ ​

  • 所有代码由 DeepSeek AI 生成，经过 reChecker 审查
  • 不包含恶意代码或后门
  • 建议下载后用 IDEA 打开检查
  • 生产环境使用前建议测试

下一步 ​