本站为非官方 Pylon 文档站,大量内容均为 AI 生成·前往官方文档站● ● ●This is an unofficial Pylon documentation site, most content is AI-generated·Visit Official Docs● ● ●中文开发者交流·加入 QQ 群● ● ●本站为非官方 Pylon 文档站,大量内容均为 AI 生成·前往官方文档站● ● ●This is an unofficial Pylon documentation site, most content is AI-generated·Visit Official Docs● ● ●中文开发者交流·加入 QQ 群● ● ●
Pylon 中文文档
创建附属更简单的打法

拆解需求

学会把大需求拆成小任务,让 AI 精准理解你的想法。

最后更新时间

迈出正确的第一步

如果你一上来就让 AI "帮我写个 XX 附属",那大概率会翻车——AI 猜不透你的真实意图,写出来的代码往往不符合预期、甚至根本跑不通。

为了避免这种情况,我们需要先拆解需求,把一个大目标拆成多个小任务,每个小任务只做一件事。这样 AI 才能准确理解你想要什么。

在这套教程里,我会带你和 AI 一起做一个经典的例子:筛子附属(Sieve Addon)——一个能让玩家把各种方块"筛"成矿物和种子的功能。

拆解需求

首先,你得先搞清楚自己到底想要什么。拿出纸笔(还是文件传输助手吧),把你的想法写下来:

  1. 核心功能是什么?
  2. 有哪些物品/方块需要自定义?
  3. 交互流程是怎样的?(玩家怎么用)
  4. 有没有概率/数值相关的设定?

然后,你可以找任何 AI 工具(哪怕是 DeepSeek 的网页版都行),跟它讨论一下你的想法。让它帮你:

  • 补充你可能遗漏的细节
  • 把需求拆分成具体的物品列表、方块列表、功能点
  • 标注出哪些地方可能需要特别注意

举个例子,下面是我给 AI 的需求描述:(直接copy无中生有MOD的设定)

我想要创建一个 Minecraft Java 服务端插件(基于 Rebar 框架),实现一个筛子系统:

核心玩法:玩家用筛网右键点击筛子,可以把特定方块筛成矿物和种子等产出物。

操作方式:按住右键 3 秒处理一个方块

筛矿概率表(各事件独立,不可叠加):

泥土 → 小麦种子/草籽(7%)、西瓜/南瓜/甘蔗种子(3%)、萝卜/马铃薯种子(2%)、橡子(2%)、金合欢/云杉/桦木种子(1%) + 石子(必出2个)

沙砾 → 燧石(25%)、煤炭(13%)、青金石(5%)、钻石/绿宝石(1%)、破碎铁/金/铜/锡/铝矿(20%/3%/6%/6%/13%)

尘土 → 骨粉(20%)、红石(13%)、火药(7%)、萤石粉(6%)、烈焰粉(5%)、粉状铁/金/铜/锡/铝矿(20%/3%/6%/7%/13%)

粉碎地狱岩 → 破碎铁/金/铜矿(17%/17%/10%)

灵魂沙 → 地狱疣(5%)、恶魂之泪(2%) + 下界石英(至少1个,33%概率2个)

沙子 → 可可豆/仙人掌种子(3%)、丛林种子(2%)、古代孢子(1%)、破碎铁/金/铜/锡/铝矿(20%/3%/6%/6%/13%)

粉碎末地石 → 破碎锡矿(10%概率1个)

请你根据以上需求,帮我拆分为:
1. 需要创建的自定义物品列表(包含名称、用途)
2. 需要创建的自定义方块列表(包含名称、用途)
3. 每个物品/方块的功能需求清单

我将用这些信息来指导 AI 编写插件代码。

重要提醒

AI 返回的需求拆解不一定完全准确!比如上面的例子中,AI 可能会搞错某些机制细节(比如破碎矿物的合成关系)。你需要审核每一项,根据你的实际需求修正错误的地方

通过多轮对话不断修正,这个需求列表才会变得完善、准确、真正符合你的想法。

关于性能

好消息:对于筛子这种简单插件,你不需要担心性能问题。

Rebar 的 API 已经为你处理了大部分性能陷阱。筛子的触发方式是事件驱动(玩家主动右键),不是每 tick 都执行的循环逻辑,所以即使几十个人同时筛矿也不会造成明显的 TPS 下降。

你只需要注意两点:

  • 使用 ThreadLocalRandom 而不是每次 new Random()
  • 产物尽量直接放入玩家背包,而不是生成掉落物实体

就这些,够了!如果你以后想开发更复杂的系统(比如电网系统、大规模自动化生产线),可以看看进阶性能教程,那里有真正的重型优化场景。

好了,需求拆解完成了。接下来我们去建立代码库和上下文管理,让 AI 真正理解 Rebar 的 API 和用法。

目录