Config Files
Shine stores local settings and generated state in the Minecraft instance's config folder. Use Shine Studio to change effect settings; the paths below are primarily useful for backups, transfers, and troubleshooting.
Domain Settings
Shine stores eight effect domains under config/shine/. The index and domain files are saved as one transaction. Files listed under Standalone Settings save separately.
| Path | Contents |
|---|---|
config/shine/index.json | Commit index for the eight effect-domain files. |
config/shine/core.json | Overall effects state. |
config/shine/world.json | World and environment visuals. |
config/shine/lighting.json | Lighting and illumination effects. |
config/shine/particles.json | Particle and ambient-life effects. |
config/shine/interaction.json | Reactive world effects and ground decoration. |
config/shine/weather.json | Rain, snow, and storm effects. |
config/shine/camera.json | Color grading, post effects, and camera behavior. |
config/shine/sound.json | Shine sound settings. |
index.json records the schema and SHA-256 hash of every domain file. Keep these files together and do not hand-edit an individual domain file.
Standalone Settings
| Path | Contents |
|---|---|
config/shine_master.json | Global Shine on/off state. |
config/shine.json | Bloom settings and source strengths. |
config/shine_masks.json | Pixel-level bloom masks. |
config/colored_lighting.json | Colored-light and dynamic-light settings. |
config/rimlight.json | Rim-light settings. |
config/shine_shading.json | Vanilla directional-shading controls. |
config/shine_interface.json | Shine buttons and menu panorama settings. |
config/shine_compatibility.json | Local compatibility rules. See Compatibility. |
Managed State
These files are maintained by Shine and are not part of the effect-domain transaction.
| Path | Contents |
|---|---|
config/shine_preset_state.json | Preset stack, edit layers, exclusions, undo, and resource-pack restoration state. |
config/shine_sodium_compat.json | The saved Sodium fog-occlusion choice. |
config/shine_state.json | Upgrade-migration state. |
Folders
| Path | Contents |
|---|---|
config/shine_presets/ | Local and imported presets. |
config/shine_performance_presets/ | Custom performance presets. |
config/shine/custom_particles/ | Custom-particle definitions and textures. |
config/shine/diagnostics/ | FPS diagnostic reports. |
config/shine/menu_panorama/ | Imported panorama faces named panorama_0.png through panorama_5.png. |
Resource-Pack Paths
| Path | Contents |
|---|---|
assets/<namespace>/shine/presets/ | Resource-pack presets. |
assets/<namespace>/shine/preset_packs/ | Preset Packs and previews. |
assets/<namespace>/shine/pack.json | Shine Pack manifest. |
assets/<namespace>/shine/birds/ | Shine Pack bird definitions. |
assets/<namespace>/shine/flowers/ | Shine Pack interactive-flower definitions. |
assets/<namespace>/shine/compatibility/ | Static feature and content compatibility rules. |
assets/<namespace>/shine/bloom/ | Block and fluid bloom defaults. |
assets/<namespace>/shine/colored_lights/ | Block colored-light defaults. |
See Preset Authoring, Shine Pack Authoring, Compatibility, and Resource Pack Defaults for their file formats.
Recovery
Shine keeps one previous generation beside a live JSON file as <filename>.bak. When a primary file is unreadable and its backup is valid, Shine restores the backup and preserves the unreadable file as <filename>.broken-<timestamp>.
The effect-domain files are validated together through config/shine/index.json. A migrated config/shine_experimental.json is archived under config/shine/legacy/, and any unrecognized legacy settings are retained in config/shine/legacy-unmapped.json.
Close Minecraft before manually editing a standalone JSON file. Change the effect-domain files and their index through Shine Studio.