Installation

Installing Titan

Get Titan running on your Cobblemon server in minutes.

Requirements

Before installing, ensure you have:

✅ Minecraft 1.21.1 or higher
✅ Fabric Loader 0.16.0 or higher
✅ Fabric API (latest version)
✅ Cobblemon 1.7.0 or higher
✅ Java 21 or higher
✅ Server-side only (no client mods required)

Installation Steps

Download Titan

Get the latest Titan .jar file.

Install the Mod

Place titan-x.x.x.jar into your server’s mods/ folder:

server/
├── mods/
│   ├── fabric-api-x.x.x.jar
│   ├── cobblemon-fabric-x.x.x.jar
│   └── titan-x.x.x.jar  ← Place here
├── config/
└── ...

Start Your Server

Launch your server normally. Titan will:
- Auto-generate default configs
- Create 32 pre-configured titan fights
- Register custom keyframe types
Look for this in the console:
```
[Titan] Loaded 32 titan fight configurations
[Titan] Registered 8 custom keyframe types
[Titan] Titan initialized successfully
```

Verify Installation

Check that configs were created:

config/titan/
├── fights/
│   ├── charizard.json
│   ├── mewtwo.json
│   └── ... (32 total)
│
data/titan/action_effects/
└── (Generated by mod resources)

Test In-Game

Join the server and run:
```
/titan create @e[type=cobblemon:pokemon,limit=1,sort=nearest]
```
This converts the nearest Pokémon to a titan!

First-Time Setup

1. Permissions

Grant yourself titan commands (if using a permission plugin):

# LuckPerms example
/lp user YourName permission set titan.command.create true
/lp user YourName permission set titan.command.reload true

2. Server Performance

Titan is optimized for performance, but consider:

Recommended Server Specs:

CPU: 4+ cores at 3.0+ GHz
RAM: 6+ GB allocated to Minecraft
Tick Rate: Stable 20 TPS

For Large Bosses (10+ players):

8+ GB RAM recommended
View distance: 8-12 chunks
Entity tracking range: 64-128 blocks

3. Testing Area

Create a safe testing area:

# Teleport to safe location
/tp @s ~ ~100 ~

# Summon test Pokémon
/pokespawn charizard lvl:50

# Convert to titan
/titan create @e[type=cobblemon:pokemon,limit=1,sort=nearest]

Configuration Locations

After first startup, you’ll find configs at:

server/
├── config/titan/
│   └── fights/
│       ├── charizard.json     # Fight configs
│       ├── mewtwo.json
│       └── ... (32 files)
│
├── data/titan/
│   └── action_effects/        # Custom ActionEffects
│       └── moves/
│           ├── charizard_*.json
│           └── ...
│
└── mods/
    └── titan-x.x.x.jar        # Mod file

Updating Titan

Backup First

# Backup your configs
cp -r config/titan config/titan.backup
cp -r data/titan data/titan.backup

Stop Server
Terminal window
```
# Stop gracefully
/stop
```

Replace JAR

# Remove old version
rm mods/titan-old-version.jar

# Add new version
cp titan-new-version.jar mods/

Start Server

Titan will auto-migrate configs if needed.
Reload Configs
```
/titan reload
```

Troubleshooting

Mod Won’t Load

Check Fabric Loader version:

[Fabric] Loading Titan x.x.x
[Fabric] ERROR: Incompatible with Fabric Loader <0.16.0

Solution: Update Fabric Loader to 0.16.0+

Configs Not Generating

Check file permissions:

# Linux/Mac
ls -la config/

# Ensure server can write to config/
chmod 755 config/

Check logs for errors:

[Titan] ERROR: Failed to create config directory

Commands Not Working

Check OP level:

/op YourName

Check command registration:

[Titan] Registered commands: titan

If not present, check for mod conflicts.

Cobblemon Integration Issues

Verify Cobblemon version:

[Cobblemon] Cobblemon 1.7.0+ required
[Titan] Compatible Cobblemon found

If version mismatch:

Update Cobblemon to 1.7.0+
Or use older Titan version for older Cobblemon

Next Steps

Now that Titan is installed:

Quick Start → - Create your first titan
Configuration → - Understand the config structure
Commands → - Full command reference

Installation complete! Ready to create epic boss fights! 🎮