Skip to content

Installation

This guide covers installing Glamour on a Fabric server running Cobblemon.

Before installing Glamour, ensure you have:

  • Minecraft Server: Version 1.21.1
  • Fabric Loader: Version 0.16.14 or higher
  • Fabric API: Version 0.116.4+1.21.1 or higher
  • Fabric Kotlin: Version 1.13.0+kotlin.2.1.0 or higher
  • Cobblemon: Version 1.7.0+1.21.1 or higher
  • Ceremony: Version 3.0.7 or higher

Glamour requires these additional mods:

  • SGui: Version 1.6.1+1.21.1 (for GUI system)
  • Adventure Platform Fabric: Version 5.14.2 (for text formatting)
  • Impactor Libraries: Version 5.3.0 (economy and text utilities)
  • LuckPerms: For permission-based particle access control

Download the latest Glamour JAR file from your source and place it in your server’s mods/ folder.

Ensure all required dependencies listed above are installed in your mods/ folder.

Start your Fabric server. On first launch, Glamour will:

  • Create the config/glamour/ directory
  • Generate default particle configuration files
  • Initialize the particle system

Check the server console for Glamour’s initialization messages. You should see:

[Glamour] Initializing Glamour mod
[Glamour] Loaded X particle configurations
[Glamour] Particle system ready

Join your server and run:

/particles gui

If the GUI opens successfully, Glamour is installed correctly!

After first launch, you’ll find these directories:

config/glamour/
├── particles/ # Pokemon particle configs
├── persistent_particles/ # Persistent particle configs
└── config.json # Main configuration

Check Dependencies: Verify all required mods are installed and compatible versions.

Check Logs: Look in logs/latest.log for error messages starting with [Glamour].

Version Mismatch: Ensure you’re using Minecraft 1.21.1 and the correct Fabric Loader version.

Permissions: If using LuckPerms, ensure you have the required permissions:

  • glamour.command.particles - Access to particle commands
  • glamour.command.particles.gui - Access to particle GUI

OP Level: Without LuckPerms, ensure you have the appropriate operator level.

Client-Side: Ensure clients have Cobblemon installed (for snowstorm particle support).

Particle Pack: Verify the particle resource IDs in your configs match Cobblemon’s particle pack.

Distance: Check that you’re within the maxDistance configured for the particle effect.

Glamour includes optional database support for advanced state persistence:

No additional configuration needed - Glamour uses SQLite by default.

Edit config/glamour/config.json:

{
"database": {
"type": "mysql",
"host": "localhost",
"port": 3306,
"database": "glamour",
"username": "your_user",
"password": "your_password"
}
}

Edit config/glamour/config.json:

{
"database": {
"type": "mongodb",
"connectionString": "mongodb://localhost:27017/glamour"
}
}