Percale Wiki

Percale (mod id percale) is a small serialization and data library mod. Its purpose is to give other mods a ready-made way to read, write and serialize structured data, so mod authors do not have to write that plumbing themselves.

What it provides:

• Helpers for serializing and deserializing structured data (the data-driven content and configuration that mods define).
• Shared data-handling utilities that dependent mods reuse.

Percale has no player-facing content of its own - it adds no gameplay blocks, items, mobs, or mechanics, and it does nothing visible in-game on its own. You only ever install it because another mod lists it as a required dependency.

Install Percale whenever a mod you use lists it as a dependency. If it is missing, those mods will fail to load and the game will report a missing-dependency error for the mod id percale.

• Bountiful uses Percale for its data handling and will not run without it.
• Other data-driven mods by the same author and ecosystem also depend on it.

The rule of thumb is simple: add Percale when a mod tells you to, and leave it out otherwise. The mod that requires it provides the actual gameplay.

Percale is meant to be consumed by other mods as a dependency (mod id percale). Declare it in your mod metadata so the game enforces load order.

What it provides for developers:

• Serialization helpers - utilities for reading, writing and serializing structured data.
• Data-handling utilities - shared helpers for working with the data-driven content mods define.

Consult the upstream Percale source and its use inside Bountiful for the current API surface and version coordinates.

What does Percale do on its own? Nothing visible - it is a library. It only matters when another mod depends on it.

A mod says it needs "percale" / Percale - what do I do? Add Percale to your mods folder alongside that mod, then launch again.

I get a missing-dependency error for percale. A mod needs Percale but it is not installed (or the version is wrong). Install a matching Percale build so the mod can load.

Do I need it if no mod asks for it? No. It has no content, so there is no reason to install it unless a mod requires it.

Is it safe to add or remove? It adds nothing to your world by itself, so it is safe to add or remove as your mod list requires - as long as no installed mod still depends on it.