MrPippi/docs/purpur/storage
docs/purpur/storage/SKILL.md
# Storage Skill — Purpur ## Purpose Reference this skill when implementing storage in a Purpur-targeted plugin. Purpur does not add new storage APIs — all Paper storage mechanisms work identically. This skill documents the `purpur.yml` config file integration and cross-links to Paper storage guides. ## When to Use This Skill - Reading Purpur-specific settings from `purpur.yml` - Storing plugin data on a Purpur server - Deciding between config, PDC, and database on Purpur ## API Quick Referenc
tools
Updated Apr 20, 2026
$ install --global
skillsauthnpx skillsauth add MrPippi/MPS docs/purpur/storageInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 4:14 AM5.5s1 file scanned
SKILL.md
Storage Skill — Purpur
Purpose
Reference this skill when implementing storage in a Purpur-targeted plugin. Purpur does not add new storage APIs — all Paper storage mechanisms work identically. This skill documents the purpur.yml config file integration and cross-links to Paper storage guides.
When to Use This Skill
- Reading Purpur-specific settings from
purpur.yml - Storing plugin data on a Purpur server
- Deciding between config, PDC, and database on Purpur
API Quick Reference
| Class / Method | Purpose | Notes |
|---------------|---------|-------|
| Same as Paper | All Paper storage APIs apply | FileConfiguration, PersistentDataContainer, HikariCP |
| purpur.yml | Purpur's server config | Not directly accessible via API — read via config.yml or own files |
Code Pattern
All Paper storage patterns work unchanged on Purpur. See:
- ../../paper/storage/config-yml.md for YAML config
- ../../paper/storage/pdc.md for PersistentDataContainer
- ../../paper/storage/database-hikari.md for HikariCP + MySQL/SQLite
Reading purpur.yml from a Plugin (Advanced)
Purpur does not expose purpur.yml values through its API. If you need to read Purpur config values:
import org.bukkit.configuration.file.YamlConfiguration;
import java.io.File;
// NOT recommended for production — Purpur may rename keys without notice
File purpurYml = new File("purpur.yml"); // server root, not plugin folder
YamlConfiguration purpurConfig = YamlConfiguration.loadConfiguration(purpurYml);
int afkTimeout = purpurConfig.getInt("gameplay-mechanics.afk-timeout", 0);
Warning: Reading
purpur.ymldirectly is fragile and couples your plugin to Purpur's internal config format. Prefer storing your own settings in your plugin'sconfig.ymland letting server admins cross-referencepurpur.ymlmanually.
Common Pitfalls
- Assuming a Purpur-only API for storage: There is none. Use Paper's APIs.
- Reading
purpur.ymldirectly in production: The file format may change across Purpur versions. Use your plugin's ownconfig.ymlfor plugin settings.
Version Notes
- Purpur 1.21.1: Storage APIs identical to Paper 1.21.1.
PersistentDataType.LIST(Paper 1.21 addition) is available in Purpur 1.21.1.
Related Skills
- ../../paper/storage/SKILL.md — Storage overview and decision guide
- ../../paper/storage/config-yml.md — YAML configuration
- ../../paper/storage/pdc.md — PersistentDataContainer
- ../../paper/storage/database-hikari.md — Database setup
- ../OVERVIEW.md — Purpur platform setup
Related Skills
MrPippi/nms-scoreboard
development
VerifiedTrustedCommunity
透過 NMS Scoreboard/Objective/Team API 操作 sidebar、tablist 顯示名稱與計分板（Paper NMS + Mojang-mapped）/ Operate sidebar, tablist, and scoreboard via NMS Scoreboard/Objective/Team API
SKILL.mdUpdated May 2, 2026
MrPippi/nms-player-profile
research
VerifiedTrustedCommunity
操作 GameProfile 進行 skin 注入，用於 NPC 外觀設定與假玩家實體（Paper NMS + Mojang-mapped）/ Manipulate GameProfile for skin injection used in NPC appearance and fake player entities
SKILL.mdUpdated May 2, 2026
MrPippi/nms-particle-effect
tools
VerifiedTrustedCommunity
透過 ClientboundLevelParticlesPacket 實現進階 NMS 粒子效果：客戶端專屬、大量粒子、自定義參數（Paper NMS + Mojang-mapped）/ Advanced NMS particle effects via ClientboundLevelParticlesPacket with per-client and bulk support
SKILL.mdUpdated May 2, 2026
MrPippi/nms-nbt-manipulation
documentation
VerifiedTrustedCommunity
直接操作 CompoundTag 讀寫物品、實體、方塊實體的 NBT 資料（Paper NMS + Mojang-mapped）/ Read and write NBT data on items, entities, and block entities via CompoundTag
SKILL.mdUpdated May 2, 2026