外观
服务器插件开发
本章当前记录旧联机版服务端插件。外部插件和命令由服务端加载，客户端通常不需要单独安装；它适合管理与服务端玩法逻辑，但不能像客户端 MOD 那样自由增加界面和功能方块。
维护路线变化
截至 2026-07，旧联机版仍承载主要联机生态，但后续开发方向将转向插件版的 MP 分支。旧接口文档用于维护存量服务器，新插件应保留源码并避免深度绑定网络内部类，以降低未来迁移成本。参见国内版本生态。
与客户端 MOD 的区别
| 对比 | 客户端 MOD | 服务器插件 |
|---|---|---|
| 运行位置 | API 插件版客户端 | NET 专用服务端 |
| 玩家是否安装 | 通常需要 | 通常不需要 |
| 适合内容 | 方块、界面、模型、客户端系统 | 权限、命令、聊天、领地、事件规则 |
| 主要入口 | ModLoader 与内容文件 | ServerPlugin、事件接口、命令类 |
| 版本约束 | SurvivalcraftApi 分支 | SurvivalcraftNet 服务端分支 |
学习路线
适合从什么功能开始
- 玩家加入/离开提示；
- 基础管理命令；
- 聊天内容检查；
- 告示牌编辑保护；
- 方块放置与破坏审计；
- 简单权限和封禁校验。
不要把领地系统、经济系统或复杂跨服功能作为第一个插件。它们涉及持久化、并发、权限、安全和数据迁移，调试面过大。
相关项目
接口随服务端演进
仓库发布说明已经多次增加或调整终端、命令与事件接口。开发时必须锁定服务端提交或发行标签，不要只写“支持最新版”。