Skip to content

Configuration

Drehverschluss edited this page Nov 14, 2026 · 2 revisions

Configuration

Packscope has one config file and one data file, both in the config folder:

File Content
config/packscope-client.toml Options (client config, created on the first start)
config/packscope-intended.json The intended markings (see Intended conflicts)

In the game: Mods → Packscope → Config opens NeoForge's config screen with all options of packscope-client.toml (lists such as ignoredPaths have their own "Edit list" page). You can also edit the TOML file with a text editor.

No restart needed. Packscope reads the values each time it uses them:

Option Takes effect
showInVanillaScreen, showInPackedPacks the next time the pack screen is opened
ignoreIdentical, ignoredPaths, allLanguages, showModOverridesInTooltip, showIntendedSymbol, cacheEnabled with the next evaluation: when the pack screen is opened, or with the next report
previewSize with the next texture preview
autoExportReport with the next resource reload
reportListModOverrides with the next report

Turning cacheEnabled off does not delete packscope/cache/; it is just no longer used.

packscope-client.toml

All options are on the top level of the file (no section).

Option Default What it does
showInVanillaScreen true Icons, tooltips and the "Conflicts" button in the vanilla resource pack screen. false: Packscope leaves the vanilla screen alone
showInPackedPacks true Icons, tooltips, right-click items and the "Conflicts" button in the Packed Packs screen (only if Packed Packs is installed)
ignoreIdentical true Byte-identical files (same size and CRC32) and language entries with the same text are listed as harmless duplicates, not as conflicts. false: they count as normal conflicts
showModOverridesInTooltip true The grey info lines "Replaces n elements of mods/Minecraft (…)" and "n elements overridden by mods" in the icon tooltip
ignoredPaths [] Files that never count as a conflict (see below)
previewSize 64 Size of the texture preview in the detail window, in pixels (16 to 256)
cacheEnabled true Keep scan results in memory and the checksums of folder packs in packscope/cache/ in the game folder. false: every evaluation reads the packs again
autoExportReport false Write packscope/reports/packscope-report.md and .json after every resource reload (see Reports and commands)
reportListModOverrides false List every replaced mod and vanilla file in the report, not only the numbers per mod
allLanguages false Count language keys of all languages. false: only en_us and the selected game language, the ones the game loads
showIntendedSymbol true Grey icon for packs whose conflicts are all marked as intended. false: no icon for them

ignoredPaths

A list of patterns. A file that matches one of them is left out completely.

  • * matches any characters (also /), ? exactly one character.
  • With a : the pattern is matched against namespace:path, without it against the path only.
ignoredPaths = ["minecraft:textures/gui/title/*", "*.txt"]

The first pattern ignores the title screen textures of Minecraft, the second every .txt file in any namespace.

allLanguages

Minecraft only loads en_us and the language you selected. Language files of other languages have no effect, so by default Packscope skips them: no conflict, no info, and they do not count for "Completely covered". Turn allLanguages on if you want to see every language, for example to check a pack before you publish it. With many languages the evaluation takes longer and needs more memory.

Changing the game language reloads the resources; Packscope then counts the new language.

Example

showInVanillaScreen = true
showInPackedPacks = true
ignoreIdentical = true
showModOverridesInTooltip = true
ignoredPaths = []
previewSize = 64
cacheEnabled = true
autoExportReport = false
reportListModOverrides = false
allLanguages = false
showIntendedSymbol = true

Other files Packscope writes

Path (game folder) Content
packscope/reports/ packscope-report.md and packscope-report.json
packscope/cache/ Checksums of folder packs
config/packscope-intended.json Markings, written when you mark or remove something

Packscope writes nothing else. It never changes packs, options.txt or the pack order.

Clone this wiki locally