跳到正文
入门

你的第一个项目

一个真实的第一个项目（Paper 家园插件）的完整演练，从需求到测试过的 JAR。

更新于

本页内容
  1. 需求
  2. 接下来会发生什么
  3. 查看结果
  4. 做点修改
  5. 构建并测试
  6. 下一步

这个演练会构建一个小而真实的插件，让你把每个阶段都看一遍。同样的流程适用于每种项目类型。

#需求

在创建页面，选择 Bukkit/Spigot/Paper 插件（Java），然后写下：

Text
A Paper 1.21.4 plugin called SimpleHomes.
- /sethome saves the player's current location as their home (one home per player).
- /home teleports them there after a 3 second warm-up; moving cancels it.
- 30 second cooldown on /home, configurable in config.yml.
- Homes persist across restarts in a YAML file.
- Permissions: simplehomes.use (default true), simplehomes.bypasscooldown (default op).
- Messages configurable in config.yml, with color codes.

注意它包含了什么：平台和版本、每个命令及其作用、计时规则、存储方式、权限，以及哪些内容应该可配置。正是这些让第一次的结果就能用。

#接下来会发生什么

  1. Codexe 以流式方式写出文件：一个 Maven pom.xml、主类、命令和监听器类、plugin.yml 以及 config.yml。
  2. 横幅先变为正在检查项目…，然后是正在构建…。Codexe 编译插件。
  3. 如果编译器报错（例如导入错误），你会看到正在修复一个问题…。Codexe 修复代码后再构建一次。这不会消耗你的 token。
  4. 项目变为已就绪。

#查看结果

  • 打开 plugin.yml，检查命令和权限是否与你的要求一致。
  • 打开 config.yml：冷却时间和消息应该都在里面。
  • 粗略看一下主类。你不需要看懂每一行，但能发现明显的缺漏。

#做点修改

在项目聊天中输入：

Text
Allow up to 3 named homes per player: /sethome <name>, /home <name>, /delhome <name>, /homes to list them.

Codexe 会修改现有文件，而不是从头开始。后续修改的花费远低于新建项目，因为只会重写受影响的文件。当修改涉及可构建的项目时，Codexe 会再次验证。

#构建并测试

点击编译运行一次全新的构建，然后点击下载 JAR。把 JAR 放进服务器的 plugins/ 文件夹并重启。测试每个命令，包括边界情况（预热期间移动、冷却时间、重启）。

#下一步

你的第一个项目 | Codexe Docs