⚡ 布丁服务器 · 开发者中心

Mod 开发者指南

从 Mod 上架、自主授权、自动授权 KEY，到热修补与 delete.txt 规范，一站式掌握在布丁服务器分发与维护 Mod 的全部流程。

📦 上架政策 🔑 如何授权 🩹 热修补
📦

Mod 上架与分发政策

上架前请先了解维护责任、分发方式与流量计费规则

  1. Mod 作者有能力修 BUG 再考虑上架 —— 请确保您有足够时间维护。
  2. 如果您没有足够时间查看手机、回复服务器管理员（腐竹）问题，建议重新考虑是否上架。
  3. 如果 Mod 支持多平台，推荐提供通用版本，避免多选一方案造成用户困扰（授权面板服同时给腐竹一份激活版）。
  4. Mod 分发采用阿里云 OSS 服务，流量按阿里云定价计算：
    • 服务器端安装时间短，每台服务器独立分发；
    • 不同于容器方案，安装速度更快；
    • 免费 Mod 我们会购买部分流量；
    • 如有剩余流量将补贴作者，流量不足按阿里云定价执行。
  5. 如果服务器管理员多次反馈 Mod 问题，我们保留下架 Mod 的权利。
  6. 我们主营服务器销售，Mod 本身不收费，问题处理以象征性支持为主。
🛡️

DLL 要求与收费规范

为保障 Mod 作者权益与平台安全制定的硬性要求

Mod 内 DLL 要求

由于某作者制作开源下载项目导致环境变更，为保障 Mod 作者权益，即日起实施以下要求：

1
禁止混淆。
2
禁止加密。
3
如发现非 Mod 本身必要的授权接口，非游戏本身必要功能拓展，禁止上传。

Mod 对外收费价格

✖

如想卖几百几千，请不要来这里上架。可以自行去中文网打广告售卖。

✖

Mod 授权费用最高 100 元。

上架服务器流量费用

项目标准
分发方式服务器分发 Mod 采用阿里云 OSS，会产生大量流量费
免费额度Mod 大小 150M 内免费
超出收费1G / 50 元，不足 1G 部分按 1G 计算
⚠

后期更新推荐上架升级补丁（见下方「热修补」），相比重新上架整包更省流量。

费用收取

✓

除了上架所需 OSS 流量费，布丁服务器不收取任何其他费用，不抽成。

🔑

如何授权用户使用你的 Mod

在「MOD 自主授权」面板中，为指定用户开通你 Mod 的使用权限

ℹ

在「MOD 自主授权」面板使用账号、密码与验证码登录后，即可为用户开通你 Mod 的使用权限。没有账户或忘记密码请联系售后处理。

手动授权步骤

1

登录授权面板

输入你的账号、密码与验证码登录「MOD 自主授权」面板。没有账户或忘记密码请联系售后处理。

2

进入「授权管理」标签

顶部切换到 授权管理，找到「添加授权」区域。

3

搜索用户并选择授权时长

输入用户名模糊搜索，右侧下拉选择授权时长（永久 / 1 个月 / 3 个月 / 6 个月 / 1 年），默认为永久。

4

点击「授权」生效

在搜索结果中点对应用户的 授权 按钮，即按所选时长开通。已授权用户会显示在「已授权用户」列表中。

5

查看 / 取消授权

在「已授权用户」列表可搜索用户、查看到期信息；点 取消授权 即可收回权限。

面板其他功能

标签页用途
用户查看按用户名搜索已授权用户，查看其服务器、安装痕迹与操作记录。
授权管理手动为用户添加 / 取消授权，设置授权时长。
自动授权批量生成兑换 KEY，发给用户自助激活（见下一节）。
使用记录查看授权用户在哪台服务器、何时安装了你的 Mod（近实时）。
热修补为已上架的七日杀 Mod 提交热修补包（见后文）。
🎫

自动授权 KEY（兑换码）

生成一次性兑换码发给用户，让用户自助激活，无需你逐个手动授权

ℹ

生成 KEY 后发给用户，用户在 【更换 MOD】 页输入 KEY 即可自动获得对应 MOD 的授权。每个 KEY 仅可使用一次。

1

进入「自动授权」标签 → 生成 KEY

选择要绑定的 MOD、生成数量，并设置授权时长（用户兑换后按此时长生效，永久则不过期）。

2

复制 KEY 发给用户

生成后在列表中可复制每个 KEY，并能查看状态（未使用 / 已使用）、被使用用户、使用时间与剩余时间。

3

用户自助兑换

用户在【更换 MOD】页输入 KEY，系统自动为其开通该 MOD 授权，一码一用，省去人工沟通。

⚠

KEY 等同于授权凭证，请妥善保管与分发；已使用的 KEY 无法重复兑换。

🩹

热修补功能

为已上架的七日杀 Mod快速下发增量修复包，无需重新上架整个 Mod

ℹ

热修补流程：通过 OSS 直链上传修补包 → 系统随机抽一台分机做内容安全检测（拦截 exe/dll 等可执行文件）→ 安全后自动下发其余分机 → 用户更换 / 安装该 Mod 时按顺序自动应用（先按 delete.txt 删除、再覆盖）。

提交热修补步骤

1

准备修补包并上传 OSS

将修改 / 新增的文件打成压缩包（支持 zip / 7z / rar / tar.gz），上传到可公网直链下载的对象存储（OSS）。如需删除旧文件，在包根目录放 delete.txt。

2

选择 Mod 并粘贴 OSS 链接

在「热修补」标签选择要修补的七日杀 Mod，粘贴修补包的 OSS 下载直链（http/https），点「提交热修补」。

3

等待安全检测

系统随机一台分机拉取并解压检测，状态会从「待检测 / 检测中」变为结果。可在「文件清单」查看覆盖 / 新增与删除项。

4

启用并调整顺序

检测为安全后，打开「启用」开关即下发其余分机。多个修补包可通过上移 / 下移调整应用顺序。

检测状态说明

状态含义
待检测已提交，等待分机拉取检测。
检测中分机正在下载、解压并扫描内容。
安全未发现可执行文件，可启用并下发。
危险包含 exe/dll 等可执行文件，已拦截，无法启用，可「重检」。
失败链接无法下载或解压失败，请检查链接后「重检」。
⚠

安全提醒：热修补包只允许图片、模型、xml、txt 等资源；若包含 exe / dll 等可执行文件，将被判为「危险」并拦截，无法启用。

☁️

如何申请 OSS（对象存储）

热修补包需放在可公网直链下载的对象存储上

ℹ

推荐免费的 Cloudflare R2；也可用阿里云 OSS / 腾讯云 COS。下面是各家申请与获取直链的步骤。

Cloudflare R2推荐 · 免费
  1. 注册 / 登录 Cloudflare 控制台。
  2. 左侧进入 R2，首次需绑定支付方式（每月 10GB 免费额度，正常用量不扣费）。
  3. 点 Create bucket 创建存储桶（如 mod-hotfix），区域选自动。
  4. 桶 → Settings → Public access 开启 r2.dev 公共访问（或绑定自定义域）。
  5. 上传修补 zip → 复制其公共 URL，粘到面板输入框。
阿里云 OSS国内
  1. 登录 阿里云 OSS 控制台，开通 OSS 服务。
  2. 创建 Bucket，地域选国内（杭州/上海/北京等，无需香港/海外），读写权限设为公共读。
  3. 进入 Bucket → 文件管理 → 上传修补 zip。
  4. 点文件 → 复制文件 URL（公共读的桶为永久直链），粘到面板。
腾讯云 COS国内
  1. 登录 腾讯云 COS 控制台，开通对象存储。
  2. 创建存储桶，地域选国内（广州/上海/北京等），访问权限设为公有读私有写。
  3. 进入存储桶 → 文件列表 → 上传修补 zip。
  4. 点文件 → 详情 → 复制对象地址，粘到面板。
⚠

提示：务必确认链接能匿名直接下载（浏览器无痕窗口能直接下到文件），否则系统无法拉取。包内只放图片/模型/xml/txt 等资源，不要放 exe/dll。

📄

热修补说明 · delete.txt 规范

通过 delete.txt 在热更新时清理实例内已被移除的旧文件 / 目录

发布 Mod 热更新包时，可在修补压缩包根目录放置 delete.txt。 面板解压 / 覆盖更新时会按该文件内容删除实例内对应路径，用于清理已被移除的旧文件或旧目录。 每行写入一条相对 Mod 根目录的路径；注释行以 * 开头，其余非空行视为待删除项。

示例delete.txt 格式

1
* delete.txt 文件格式示例
2
* 注释行以 * 开头
3
4
* 以下是要删除的文件和文件夹示例：
5
6
* 删除文件（使用相对路径）
7
mods/old_mod.dll
8
* 删除配置文件
9
config/obsolete.cfg
10
data/unused.txt
11
12
* 删除文件夹（路径以斜杠结尾）
13
data/unwanted_folder/
14
* 删除 temp 文件夹及其所有内容
15
temp/
16
backup/
17
18
* 多级目录示例
19
resources/images/old/
20
plugins/legacy/module.dll
规则说明
注释行以 * 开头的行会被忽略，其余非空行视为待删除项。
删除文件写相对路径，不要加末尾斜杠，如 mods/old_mod.dll。
删除文件夹路径以 / 结尾，会删除该文件夹及其所有内容，如 temp/。
路径分隔符统一使用正斜杠 /。
大小写路径区分大小写，请与实际文件保持一致。
相对基准所有路径均相对 Mod 根目录。
⚠

注意：路径区分大小写，且使用正斜杠（/）作为路径分隔符。删除文件夹时路径请以 / 结尾；文件路径不要加末尾斜杠。应用顺序为先删除、再覆盖。

📮 如何联系我们

如有任何疑问或需要提交 Mod，请通过以下邮箱联系我们：

budingserver@foxmail.com

我们将在 24-48 小时内回复您的邮件