🔧 Configuration

World Dimension Nexus can be customized through configuration files and in-game settings to match your server's specific needs.

📁 Configuration Files

The mod creates configuration files in the config/worlddimensionnexus/ directory:

• dimension-config.json - Dimension creation and management settings
• teleport-config.json - Teleportation behavior and cooldowns
• portal-config.json - Portal system configuration
• auto-teleport-config.json - Auto-teleport system settings

⚙️ Key Configuration Options

Dimension Settings

{
  "defaultGameMode": "survival",
  "defaultWorldType": "void",
  "maxDimensions": 50,
  "enableAutoSave": true,
  "autoSaveInterval": 300
}

Options:

• defaultGameMode - survival, creative, adventure, spectator
• defaultWorldType - void, flat, normal, skyblock
• maxDimensions - Maximum custom dimensions (1-100)
• autoSaveInterval - Save frequency in seconds (60-3600)

Teleportation Settings

{
  "playerCooldown": 5,
  "moderatorCooldown": 2,
  "adminCooldown": 0,
  "enableSafetyChecks": true,
  "maxSearchRadius": 16,
  "preventSuffocation": true
}

Key Features:

• Cooldowns - Different delays by permission level
• Safety Checks - Prevent void/suffocation teleports
• Search Radius - Distance to find safe landing spots

Auto-Teleport Settings

{
  "enableJoinTeleport": true,
  "enableDeathTeleport": true,
  "delayJoinTeleport": 1,
  "showTeleportMessages": true
}

Portal Settings

{
  "enablePortals": true,
  "portalActivationDelay": 2,
  "portalCooldown": 5,
  "maxPortalDistance": 1000
}

🔐 Permission Levels

• Level 0-1: Regular players (no mod commands)
• Level 2: Moderators (teleport, view info)
• Level 3: Gamemasters (create/modify dimensions)
• Level 4: Administrators (all features)

🎯 Common Server Configurations

High-Traffic Server

{
  "playerCooldown": 10,
  "maxConcurrentTeleports": 5,
  "unloadEmptyDimensions": true
}

Creative Building Server

{
  "defaultGameMode": "creative",
  "defaultWorldType": "void",
  "playerCooldown": 2,
  "enableSafetyChecks": false
}

Minigame Server

{
  "defaultGameMode": "adventure",
  "defaultWorldType": "flat",
  "playerCooldown": 1,
  "delayJoinTeleport": 0
}

🔄 Applying Changes

Most configuration changes require a server restart:

# Reload some settings (if supported)
/wdn debug reload config

# Full restart (recommended)
/stop

The mod validates configuration on startup and replaces invalid values with defaults.

🛠️ Advanced Features

• Custom World Types - Integration with datapacks
• Mod Integration - Compatibility settings for other mods
• Performance Tuning - Memory and cache optimization

For detailed configuration examples and troubleshooting, see the Troubleshooting guide.