Configuration Overview

Configuration Overview

Glamour uses a JSON-based configuration system that makes it easy to customize particle effects without modifying code.

Configuration Directory Structure

All configuration files are stored in config/glamour/:

config/glamour/
├── particles/              # Pokemon sendout/ambient particles
│   ├── confetti_burst.json
│   ├── sparkle_aura.json
│   └── ...
├── persistent_particles/   # Condition-based persistent particles
│   ├── shiny_sparkle.json
│   ├── legendary_aura.json
│   └── ...
└── config.json            # Main mod configuration

Main Configuration File

config/glamour/config.json controls mod-wide settings:

{
  "debug": false,
  "database": {
    "type": "sqlite",
    "path": "glamour_data.db"
  },
  "particleSystem": {
    "maxRenderDistance": 32,
    "defaultInterval": 100
  }
}

Main Config Options

• debug: Enable debug logging
• database: Database configuration for state persistence
• particleSystem: Global particle system settings

Particle Configuration Files

Particle configurations are split into two types:

1. Regular Particles (particles/)

These are manually applied particles that players can select through the GUI or commands.

Structure:

{
  "id": "confetti_burst",
  "displayName": "Confetti Burst",
  "description": "Celebratory confetti explosion on sendout",
  "type": "SENDOUT",
  "particleResourceId": "confetti",
  "category": "celebration",
  "rarity": "COMMON",
  "settings": {
    "intervalTicks": 100,
    "delayTicks": 60,
    "durationTicks": 20
  }
}

2. Persistent Particles (persistent_particles/)

These are condition-based particles that automatically apply when conditions are met.

Structure:

{
  "id": "shiny_sparkle",
  "particleResourceId": "sparkle",
  "priority": 100,
  "settings": {
    "intervalTicks": 40,
    "durationTicks": 10,
    "particleCount": 3,
    "radius": 1.0,
    "followEntity": true,
    "maxDistance": 32
  },
  "conditions": {
    "isShiny": true
  }
}

Configuration Fields Explained

Common Fields

Field	Type	Description
id	String	Unique identifier for the particle effect
particleResourceId	String	Cobblemon snowstorm particle ID
settings	Object	Particle behavior settings

Particle Types

• SENDOUT: Plays when Pokemon is sent out from Pokeball
• AMBIENT: Continuously plays while Pokemon is out

Rarity Levels

Rarity affects GUI sorting and can be used for permissions:

• COMMON - Basic particles available to all
• UNCOMMON - Slightly rare effects
• RARE - Moderately rare effects
• EPIC - Very rare effects
• LEGENDARY - Extremely rare effects
• MYTHICAL - The rarest effects

Particle Settings

Setting	Description	Default
intervalTicks	Ticks between particle spawns	100
delayTicks	Delay before first spawn	0
durationTicks	How long particles last	20
particleCount	Number of particles per spawn	1
radius	Spawn radius around entity	1.0
followEntity	Attach to entity vs world position	true
maxDistance	Max render distance in blocks	32

Categories

Categories help organize particles in the GUI. Common categories include:

• celebration - Party and celebratory effects
• elemental - Fire, water, electric, etc.
• magical - Mystical and arcane effects
• nature - Plants, flowers, leaves
• cosmic - Stars, galaxies, space-themed
• seasonal - Holiday and seasonal effects

You can create custom categories by simply using a new category name in your configs.

Reloading Configuration

After editing configuration files, reload them without restarting:

/particles reload

Or for persistent particles:

/persistentparticles reload

Default Configurations

On first launch, Glamour creates example configurations. You can:

• Edit these examples to customize them
• Delete examples you don’t want
• Create new files following the same structure

Configuration Best Practices

1. Unique IDs: Use descriptive, unique IDs for each particle
2. Test Values: Start with conservative interval/duration values
3. Performance: Higher particle counts and shorter intervals impact performance
4. Permissions: Match category/rarity structure to your permission system
5. Backup: Keep backups of working configurations before experimenting

Next Steps

• Particle Configuration Reference
• Persistent Particle Conditions
• Permission Setup