# configuration-management

> Manages L2J server .properties files and Portuguese BR configuration settings for Tales of Aden.
Use when: modifying server rates, event schedules, player settings, database connections, or custom feature toggles

- Author: valeriybaranyshyn-pixel
- Repository: valeriybaranyshyn-pixel/Tales-of-Aden
- Version: 20260202145225
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/valeriybaranyshyn-pixel/Tales-of-Aden
- Web: https://mule.run/skillshub/@@valeriybaranyshyn-pixel/Tales-of-Aden~configuration-management:20260202145225

---

---
name: configuration-management
description: |
  Manages L2J server .properties files and Portuguese BR configuration settings for Tales of Aden.
  Use when: modifying server rates, event schedules, player settings, database connections, or custom feature toggles
allowed-tools: Read, Edit, Write, Glob, Grep, Bash
---

# Configuration Management Skill

Manages the 35+ `.properties` files that control L2J server behavior, rates, events, and custom features. Configuration files use Java Properties format with Portuguese comments and PascalCase key naming.

## Quick Start

### Reading Configuration

```java
// In Config.java - all configs loaded via ExProperties
private static final void loadServer() {
    final ExProperties server = initProperties(SERVER_FILE);
    RATE_XP = server.getProperty("RateXp", 300.);
    AUTO_LOOT = server.getProperty("AutoLoot", true);
}
```

### Key Configuration Files

| File | Purpose | Key Settings |
|------|---------|--------------|
| `server.properties` | Core rates, database, network | `RateXp`, `URL`, `GameserverPort` |
| `Custom.properties` | Offline trade, enchants, marketplace | `OfflineTradeEnable`, `EnchantSafeMax` |
| `Diversos.properties` | Buff durations, rewards, subclass | `SkillDurationList`, `PvPReward` |
| `events.properties` | Olympiad, Seven Signs, weddings | `AltOlyEndDate`, `AllowWedding` |
| `players.properties` | Karma, inventory, GM settings | `MaxBuffsAmount`, `EverybodyHasAdminRights` |

## Configuration Patterns

### Rate Values

```properties
# Decimal values require trailing period
RateXp = 300.
RateSp = 300.
RateDropAdena = 15.

# Integer values - no period
MaximumOnlineUsers = 2000
DeleteCharAfterDays = 7
```

### Boolean Values

```properties
# Use True/False (case-insensitive) or true/false
AutoLoot = True
OfflineTradeEnable = True
ServerGMOnly = False
```

### List Values

```properties
# Semicolon-separated for complex data
NormalWeaponEnchantLevel = 1,100;2,100;3,100;4,100;5,52;6,52;

# Comma-separated for simple lists
TvTEventInterval = 01:00,03:00,06:00,10:00,14:00,19:00,22:00

# Line continuation with backslash
SkillDurationList = 264,7200;265,7200;266,7200;\
270,7200;271,7200;272,7200
```

### Database Connection

```properties
# MariaDB JDBC format with connection pool settings
URL = jdbc:mariadb://localhost:3306/toa3816?user=root&password=XXX&useUnicode=true&characterEncoding=utf-8&useSSL=false
```

## Key Concepts

| Concept | Pattern | Example |
|---------|---------|---------|
| Rates | Decimal with period | `RateXp = 300.` |
| Toggles | True/False | `AutoLoot = True` |
| Item pairs | `id,amount` | `TvTEventParticipationFee = 57,100000` |
| Schedules | `HH:MM,HH:MM` | `TvTEventInterval = 10:00,14:00,22:00` |
| Coordinates | `x,y,z` | `TeleportRandomSoloFarm1 = 83962,148626,-3405` |

## Hot Reload

```bash
# In-game admin command to reload configs
//reload config
```

## See Also

- [patterns](references/patterns.md) - Value formats and naming conventions
- [workflows](references/workflows.md) - Adding new config values

## Related Skills

- See the **java** skill for Config.java class patterns
- See the **mariadb** skill for database connection strings
- See the **l2j-gameserver** skill for GameServer initialization
- See the **pvp-events** skill for event configuration
- See the **auto-farm** skill for AutoFarm settings
- See the **instance-dungeons** skill for dungeon configuration