Pumpkin项目目录结构设计与数据存储方案的技术思考

目录结构设计理念

Pumpkin作为一款Minecraft服务器实现，其目录结构设计体现了模块化与安全性的平衡。经过社区讨论，项目采用了分层权限控制的设计理念：

pumpkin(.exe) [只读执行]
├── config/ [只读]
│   ├── config.toml
│   ├── features.toml
│   └── plugins/
│       ├── example/
│       │   └── config.toml
├── plugins/ [只读执行]
│   ├── example.dll
│   └── example2.dll
└── data/ [读写]
    ├── plugins/
    │   ├── example/
    │   │   └── data.json
    ├── worlds/
    └── logs/

这种结构具有三大优势：

1. 安全性：通过权限分离降低安全风险
2. 可维护性：模块化设计便于管理
3. 容器友好：适合Docker等容器化部署

数据存储方案的演进

项目初期采用JSON文件存储方案，但社区逐渐认识到其局限性：

1. 性能瓶颈：全文件读写模式在Raspberry Pi等低功耗设备上表现不佳
2. 并发控制：原生JSON缺乏原子性操作支持
3. 扩展性：难以适应大型服务器集群需求

新型存储架构设计

经过技术讨论，团队确立了分层存储策略：

核心组件

• SQLite作为默认引擎：提供ACID支持，零配置部署
• JSON Lines备用方案：改进的逐行JSON格式，提升读写效率
• 可插拔存储接口：支持未来扩展其他数据库后端

关键数据模型

1. 玩家管理系统：整合白名单、黑名单、OP权限
2. 世界状态存储：区块数据与玩家进度分离
3. 插件数据仓库：标准化的插件存储接口

技术决策背后的考量

1. 兼容性平衡：在保持Minecraft生态兼容的同时创新存储方案
2. 性能优化：针对不同规模服务器的差异化需求
3. 开发者体验：为插件开发者提供一致的存储抽象层

未来发展方向

项目计划实现：

• 自动化数据迁移工具
• 多级缓存机制
• 分布式存储支持
• 混合存储策略（热数据/冷数据分离）

这种架构设计既满足了家庭服务器用户对简单性的需求，又为大型服务提供商预留了扩展空间，体现了Pumpkin项目"渐进式复杂"的设计哲学。